← ClaudeAtlas

cm-planninglisted

You MUST use this before any creative work or multi-step task. Explores intent, requirements, and design before implementation. Then documents the plan before coding.
tody-agent/codymaster · ★ 45 · AI & Automation · score 72
Install: claude install-skill tody-agent/codymaster
# Planning — Brainstorm + Write Plans ## TL;DR - **Use before** any feature, behavior change, or 3+ step task - **Phase A (Brainstorm)**: clarify intent → 2-3 options → recommend → scope - **Phase B (Write)**: emit `openspec/changes/<name>/{design.md,tasks.md}` - **Handoff out**: `.cm/handoff/plan.json` (goal, decisions, first 3 tasks) - **Next**: `cm-tdd` or `cm-execution` ## When to Use - Creating features, components, or functionality - Modifying behavior; multi-step tasks; user-visible change - Skip only for trivial single-line edits or pure questions ## Full Protocol ### Phase A: Brainstorm 1. **Intent** — Ask clarifying questions. Don't assume scope. Surface hidden requirements. 2. **Options** — List 2-3 approaches with pros/cons. Recommend one with reasoning. 3. **Scope** — Must-have vs nice-to-have; edges to handle vs explicitly skip. 4. **Design** — Data flow, component boundaries, API contracts. UI work → `cm-ui-preview`. **Red flags (STOP)**: code before brainstorm; assuming intent; skipping scope; "it's simple." ### Phase B: Write Plan (OpenSpec format) Write to `openspec/changes/<initiative-name>/`: `design.md` ```markdown # Design: [Goal] ## Context & Technical Approach ## Proposed Changes ### [Component/File] ## Verification ``` `tasks.md` ```markdown # Implementation Checklist - [ ] 1.1 ... - [ ] 1.2 ... - [ ] Verification testing ``` **Plan rules**: small testable steps (15-30 min each), order by dependency, verification per step. No vague steps.