think-before-coding

Overview

AI agents default to writing code immediately — even when the request is ambiguous, the context is incomplete, or multiple valid interpretations exist. This skill forces a deliberate thinking phase before any implementation begins.

The result: fewer rewrites, fewer wrong-direction implementations, and fewer "I assumed X" surprises.

When to Use

Activate this skill before writing any code when:

• The request is ambiguous or underspecified
• Multiple valid implementations exist
• You are unsure about an existing system's constraints
• The task touches security, data integrity, or public APIs
• You feel the urge to "just start coding" to make progress

Process

Phase 1: Understand the Request

1. Read the full request — Do not skim. Re-read once.
2. Identify ambiguities — List every decision you would have to make silently:
   • What counts as "success"?
   • What are the inputs and expected outputs?
   • What should NOT change?
   • Are there existing patterns to follow?
3. Surface assumptions — Write them out: "I am assuming X because Y."
4. Check for contradictions — Does the request contradict itself or existing code?

Verify: Can you state the goal in one clear sentence? If not, ask before proceeding.

Phase 2: Clarify Before Acting

1. If genuinely ambiguous, ask a focused clarifying question — not a list of 10 questions. Pick the one blocker.
2. If multiple valid approaches exist, present 2–3 options with tradeoffs, then ask which to proceed with.
3. If something seems wrong with the request, say so directly — don't silently work around it.

Verify: You have a clear, agreed-upon interpretation of the task.

Phase 3: State Your Plan

1. Before writing code, state:
   • What you will build
   • What you will NOT touch
   • What success looks like (your verification criteria)
2. For multi-step tasks, write a brief plan:

   1. [Step] → verify: [check]
   2. [Step] → verify: [check]
   3. [Step] → verify: [check]