Creates comprehensive implementation plans with exact file paths, complete code examples, and verification steps for engineers with zero codebase context.
Inherits all available tools
Additional assets for this skill
This skill inherits all available tools. When active, it can use any tool Claude has access to.
name: writing-plans description: | Creates comprehensive implementation plans with exact file paths, complete code examples, and verification steps for engineers with zero codebase context.
trigger: |
skip_when: |
sequence: after: [brainstorming, pre-dev-trd-creation] before: [executing-plans, subagent-driven-development]
This skill dispatches a specialized agent to write comprehensive implementation plans for engineers with zero codebase context.
Announce at start: "I'm using the writing-plans skill to create the implementation plan."
Context: This should be run in a dedicated worktree (created by brainstorming skill).
Step 1: Dispatch write-plan agent via Task(subagent_type: "write-plan", model: "opus") with instructions to create bite-sized tasks (2-5 min each), include exact file paths/complete code/verification steps, and save to docs/plans/YYYY-MM-DD-<feature-name>.md.
Step 2: Ask user via AskUserQuestion: "Execute now?" Options: (1) Execute now → subagent-driven-development (2) Parallel session → user opens new session with executing-plans (3) Save for later → report location and end
Context preservation (reading many files keeps supervisor clean) | Model power (Opus for comprehensive planning) | Separation of concerns (supervisor orchestrates, agent plans)
Explore codebase → identify files → break into bite-sized tasks (2-5 min) → write complete code → include exact commands → add review checkpoints → verify Zero-Context Test → save to docs/plans/YYYY-MM-DD-<feature>.md → report back
Every plan: Header (goal, architecture, tech stack) | Verification commands with expected output | Exact file paths (never "somewhere in src") | Complete code (never "add validation here") | Bite-sized steps with verification | Failure recovery | Review checkpoints | Zero-Context Test | Recommended agents per task
| Task Type | Agent |
|---|---|
| Backend API/services | backend-engineer-{golang,typescript} |
| Frontend/BFF | frontend-bff-engineer-typescript |
| Infra/CI/CD | devops-engineer |
| Testing | qa-analyst |
| Reliability | sre |
| Fallback | general-purpose (built-in, no prefix) |
| Option | Description |
|---|---|
| Execute now | Fresh subagent per task, code review between tasks → subagent-driven-development |
| Parallel session | User opens new session, batch execution with human review → executing-plans |
| Save for later | Plan at docs/plans/YYYY-MM-DD-<feature>.md, manual review before execution |
This skill uses these universal patterns:
skills/shared-patterns/state-tracking.mdskills/shared-patterns/failure-recovery.mdskills/shared-patterns/exit-criteria.mdskills/shared-patterns/todowrite-integration.mdApply ALL patterns when using this skill.