Plan mode and implementation

Start in Plan mode

Open a session in the correct project. Use the mode menu under the prompt composer and select Plan mode. Describe what you want to achieve and which decisions you want to discuss first.

Plan a settings page for this app.
Inspect the existing components, identify the screens and data needed,
and explain the approach before implementing it.

Use the planning conversation to resolve scope, constraints, and acceptance criteria. Ask what files are affected and how the work will be tested.

Refine the proposal

Read the proposal as a set of intended changes. Add missing requirements, reject unnecessary scope, and resolve important tradeoffs. A useful plan makes it clear what a successful result looks like.

Planning can involve reading files and using tools for research. Continue to read permission prompts; choosing a mode does not remove the need to understand an action.

Begin implementation

When satisfied, use Start work when offered by the plan interface, or exit Plan mode and explicitly request implementation. Follow the changes and approval requests as work proceeds.

If the mode control is unavailable while a response is running, wait for the response to finish or stop it before changing modes.

Review before shipping

Ask the agent to explain what changed and which checks passed. Review the diff and try the affected workflow yourself. Deployment, committing, and publishing are separate instructions; include them in the task only when you intend them.