Before touching code

Planning

  1. 1 Ask mode

    Explain the idea and revise until it makes sense.

    Use the conversation to clarify the goal, context, constraints, and open questions. The idea should become simple enough to turn into work.

  2. 2 Plan mode

    Ask for a coherent roadmap divided into phases.

    Each phase should be small, testable, and have clear acceptance criteria. If a phase feels too large, ask the agent to split it.

  3. 3 Agent mode

    Ask the agent to create a .md doc with the plan.

    The document becomes the execution reference. It should capture phases, criteria, risks, and development order.

One phase at a time

Execution

  1. 1 Ask mode

    Ask the agent to analyze the .md plan.

    Before implementation, the agent needs to understand the scope, the current project state, and what has already been decided.

  2. 2 Plan mode

    Ask the agent to analyze the current phase and plan the work.

    The phase plan should cover likely files, work sequence, risks, and how the result will be validated.

  3. 3 Agent mode

    Ask the agent to review, execute, and validate this phase plan.

    The phase is only done when the agent implements, tests what it can, and clearly explains what changed.