Workflows
The Kit ships three workflows: the initiation cycle (once per project), the feature cycle (once per feature), and the maintenance skills (as needed).
Initiation cycle
Run once, right after scaffold. Produces the three foundational documents that gate every future feature.
/spec-requirementsCross-questions until the SRS is complete, then freezes claude/srs.md. Refuses on empty load-bearing categories./spec-designBuilds design/design.md from user-supplied references or, when none are provided, proposes one from the SRS./spec-planEmits claude/plan.md with 8-10 step deliverables, each ending in a standalone, testable, runnable outcome.Feature cycle
/spec-feature runs six ordered steps against a single item from the plan. Skipping a step requires an explicit --skip <step> flag AND a logged entry in design-decisions.md.
1
Requirements
Cross-question transcript → features.md. Locked-in problem statement for this step.
2
Architecting
≥2 architectural options with tradeoffs. Rejected options are recorded, not deleted.
3
Product Specs
UI, UX, entities, DB schema - everything the code needs to be unambiguous.
4
Tech Specs
Concrete stack + deploy targets; rejected alternatives noted.
5
Planning
Step-by-step plan with acceptance criteria; each step verifiable end-to-end.
6
Writing Code
Implement → test → refactor → memory update. Memory is written in a fixed order: context.md → features.md → design-decisions.md → learnings.md → CHANGELOG.md.
Diff-scoped refactor
/spec-refactor cleans only files touched by the current cycle. It refuses to open files outside the diff, and writes an audit log to .claude/refactor-audits/ so drift becomes observable at review time.
Maintenance skills
Four skills keep the project honest after the initial build.
/spec-bugReproduction-first bug workflow: recipe → failing regression test → smallest possible diff → CHANGELOG entry./spec-docsReconciles README + memory files against the code. Never modifies source. Flags features no longer present./spec-refactorDiff-scoped cleanup. Only files in the current cycle’s changed list./spec-syncReconciles context.md drift and compresses any memory file past 1,500 lines with a compressed-from audit trail.