popoffvg/code

Code — subcommand router

Read first: @workflow — pipeline, agents contract, notes structure, hard rules.

/code <subcommand>. Pick the operation, read its reference, follow it. Default is new.

Subcommands

| /code … | You need to… | Reference | |---|---|---| | new (default) | Full spec pipeline: write spec.md (if missing) → grill loop (ask→answer→note) → produce spec-notes/ → auto-write TODO bodies. One command, end to end. | references/new.md · references/note-format.md · references/flow.md · references/todo.md | | verify | Audit spec before implementation — completeness, per-TODO files, execution readiness, scope discipline, test honesty. Returns READY / NEEDS REVISION. | references/verify.md | | revise | Rewrite spec.md + todos/TODO-N.md to match what the last commit for TODO-N actually shipped. No source edits. | references/revise.md | | prototype | Settle an OPEN design decision by spawning the implementer to make small, visible code changes. | references/prototype.md | | code-map | Produce a D2 + SVG architecture map (package or component/type map) as visual aid. | references/code-map.md | | impl | Execute one TODO — read context, replan guard, implement, autotest, commit, report. Delegates to impl skill for work/squash routing. | ../impl/SKILL.md | | fix | Fix behavior — analyze root cause, mark wrong notes, write corrected thoughts, fix code. | references/fix.md | | help | This page — list all subcommands with descriptions. | (self) |

Internal reference: references/flow.md — TS pseudocode patterns for ## Changes. Used by new.

How they combine

research → new → verify → impl → revise (iterate)

• new is the default. It writes spec.md (if missing), runs the grill loop to empty Open Questions, produces spec-notes/ thought graph, and auto-writes TODO bodies. One command replaces the old write → new → todo sequence.
• verify is the static audit gate. A spec with open questions cannot pass verify; run new again if the audit fails.
• impl executes one TODO end-to-end. Delegates to the impl skill.
• fix fixes broken behavior — analyze cause, correct thoughts, fix code.
• prototype and code-map are aids invoked mid-spec.
• revise runs after implementation, when what shipped diverged from the spec.
• help shows this page.

Output shape

new and revise edit <notes-dir>/spec.md and todos/TODO-N.md. new produces <notes-dir>/spec-notes/NNN-{decision,fact,impl-decision}-slug.md (format: references/note-format.md). verify writes <notes-dir>/spec-verify.md. fix writes <notes-dir>/spec-notes/NNN-*-slug.md (corrected thoughts). All write only under <notes-dir>/ — never touch source code.