Plan Mode

Overview

Provide a concise workflow for producing actionable plans and keeping them updated during execution.

Decide Whether to Plan

• Use plan mode when the task is multi-step, risky, cross-cutting, or explicitly requests a plan.
• Skip planning for trivial or single-action tasks.

Create the Plan

• Identify the smallest set of steps that cover the full task end-to-end.
• Use 3-7 steps; avoid single-step plans.
• Write outcome-based steps (verb + object), not low-level implementation details.
• Include a verification step when testing or validation is expected.
• Initialize all steps as pending; set only one step to in_progress at a time.
• Use the plan tool to publish the plan.