spec-lean

Show SDD progress across all specs in the current project, or drill into one feature's per-story status. Reads docs/specs/*/spec-status.md and renders a done/in-progress/blocked/not-started summary table. Read-only — never modifies files.

Phase 2 of the SDD cycle. Use when the user invokes /spec-lean:build <feature> to implement the spec at docs/specs/<feature>/spec.md story-by-story. Performs git pre-checks (offers git init if missing), scaffolds .gitignore for the language detected, implements bottom-up per User Story, writes per-feature artifacts to docs/specs/<feature>/spec-status.md, updates project-wide docs/codebase-map.md, and prompts a recommended-keep-branch rollback path on hard failure.

Orchestrator for the full SDD cycle. Use when the user invokes /spec-lean:run <feature> to chain spec → build → validate → ship end-to-end. Pauses for explicit user confirmation between every phase (y / edit / stop). Resumable — detects existing artifacts (spec.md, spec-status.md) and offers to skip already-completed phases.

Phase 4 of the SDD cycle. Use when the user invokes /spec-lean:ship <feature> to review, commit, push, PR, and merge. Performs an SDD-aware pre-commit code review of the local diff (BLOCK/CAUTION/GO verdict) — checking story deviations against US-N IDs in spec-status.md, runtime-artifact leaks, and the standard security / data-loss / concurrency issues. Only on GO does it dispatch commit-commands:commit (no remote) or commit-commands:commit-push-pr (with remote), then runs the marketplace /code-review on the PR diff as a second pass before asking for explicit merge permission.

Phase 1 of the SDD cycle. Use when the user invokes /spec-lean:spec <feature> to interactively author a feature spec at docs/specs/<feature>/spec.md (amendments to an existing spec go through /spec-lean:update instead). Produces the SDD 6-section template (Goal, Requirements, User Stories with US-N IDs and optional Done-when checks, Technical details, Out of scope, Edge cases). Sub-capabilities of one feature go in one spec as separate US-IDs — never multiple specs. Pauses at a checkpoint so the user can review before implementation.

Iteration handler for the SDD cycle. Use when the user invokes /spec-lean:update <feature> to amend an existing spec mid-cycle. Snapshots the current spec to spec.md.prev, lets the user revise interactively, diffs the two versions to identify changed US-N IDs, and marks affected stories as in-progress in spec-status.md so the next /spec-lean:build only redoes what changed.