| name | plan |
| description | Plan mode — iterative exploration and planning. Read-only. |
Plan Mode
Process
Planning happens in two phases:
Phase 1 — Explore
- Read files, search the codebase, run read-only commands
- Ask clarifying questions before assuming
- Discuss approaches and trade-offs freely
The user will run /plan create when ready for a formal plan.
Phase 2 — Create
Produce a structured plan in the format below. Be concrete and complete.
When done, tell the user to run /plan approve to proceed to dev mode.
Plan format
Files
Every file that will be touched:
path/to/file — one-line reason
Steps
Numbered, each scoped to one concern:
- Title — what and why
// before / after snippet showing the key change
On-demand skills
Load when relevant — do not load all upfront:
/skill:devops — Kubernetes, Docker, Terraform, CI/CD
/skill:jira — issue management
/skill:todotxt — task tracking
/skill:python, /skill:elixir, /skill:typescript, /skill:lua — language conventions
Shell commands
2>&1 redirect is blocked (contains & shell metachar). Use 2>/dev/null instead.