git:20260408.1b33202 to git:20260828.cbfd12c
12 added, 13 removed. Audit A to A.
# Ralph Specum Project Guidance
Use Ralph Specum as the spec workflow for this repo.
## Preferred Entry Surface
- `$ralph-specum` for the general flow
- - `$ralph-specum-start` to create, resume, or run in quick mode, then stop unless quick or autonomous flow was explicit
+ - `$ralph-specum-start` to create, resume, or run in quick mode. Only exact `--quick` enables quick mode; exact `--interactive` clears it
- `$ralph-specum-research`
- `$ralph-specum-requirements`
- `$ralph-specum-design`
- `$ralph-specum-tasks`
- `$ralph-specum-implement`
- `$ralph-specum-status`
## Project Contract
- Specs live in `./specs` unless `.claude/ralph-specum.local.md` defines `specs_dirs`
- `.current-spec` lives in the default specs root
- `.ralph-state.json` is transient execution state
- `.progress.md` persists learnings and blockers
## Flow
- 1. Start or resume a spec
- 2. Stop and ask whether to continue to research
- 3. Research
- 4. Approve the artifact, request changes, or continue to requirements
- 5. Requirements
- 6. Approve the artifact, request changes, or continue to design
- 7. Design
- 8. Approve the artifact, request changes, or continue to tasks
- 9. Tasks
- 10. Approve the artifact, request changes, or continue to implementation
- 11. Implement
+ 1. Start or resume a spec, then grill critical goal decisions
+ 2. Approve the phase plan and delegate research
+ 3. Approve the artifact, request changes, or continue to requirements
+ 4. Grill, approve, and delegate requirements
+ 5. Approve the artifact, request changes, or continue to design
+ 6. Grill, approve, and delegate design
+ 7. Approve the artifact, request changes, or continue to tasks
+ 8. Grill, approve, and delegate tasks
+ 9. Approve the artifact, request changes, or continue to implementation
+ 10. Implement
- Quick mode may generate missing artifacts and continue straight into implementation in one run only when the user explicitly asks for quick or autonomous flow.
+ Exact `--quick` may generate missing artifacts and continue straight into implementation in one run. Natural-language requests and `-q` do not enable quick mode.