Agent
Planning
For anything non-trivial, have the agent think first: a concrete, step-by-step plan you can read and edit before a single line changes.
Plan before building
Pick Plan from the composer mode menu and describe the goal. Instead of editing straight away, the agent produces a concrete plan — the files it intends to touch, the order of operations, and the risks it sees — and stops for your review.
Review and steer
- Read the plan and reply in the same thread to adjust scope, drop a step, or add a constraint. The agent revises the plan in place.
- Attach context with @-mentions — the files, symbols, or docs the plan should account for.
- Happy with it? Switch to Build and the agent executes the plan end-to-end, or hand the plan to a background agent.
When to plan
Plan mode pays off on large refactors, ambiguous tasks, and anything that spans many files. For a small, well-scoped change, skip straight to Build — it plans briefly on its own before implementing.
Next