helpmeplan — guided planning workflow

Guide the user from raw idea to a build-ready spec/ folder, one phase at a time.

This skill is fully self-contained. All phase definitions, questions, and templates live in phases.md in this skill folder. Never depend on any file outside this folder for workflow rules — the project may not have a WORKFLOW.md, and that's fine.

Core model: planning/ is the "src" of planning (working files, messy is fine); spec/ is the "dist" (distilled build plan — per-area plans, project structure, roadmap — the only thing coding needs). Work happens in planning/, conclusions get promoted to spec/. If it's not in the spec, it doesn't get built.

Invocation modes

• (no args) — detect state, then resume the active phase
• status — detect state, report it, stop. No work.
• spec — jump to spec/ distillation. If phases are incomplete, list the gaps and get explicit confirmation before proceeding.
• redo <n> — reopen completed phase n: flip its status back to in-progress and resume it. Warn that later phases may need revisiting.

Step 1 — Detect state (always, before anything else)

The filesystem is the state. No memory needed.