spec-to-ralphlisted

# Spec-to-Ralph Skill Reference knowledge for bridging Spec Kit to Ralph Wiggum. ## Spec Kit Structures ### Flat Structure (simple projects) ``` .specify/ ├── constitution.md ├── spec.md ├── plan.md └── tasks.md ``` ### Feature-Based Structure (recommended) ``` .specify/ ├── constitution.md # Global rules for all features └── features/ ├── 001-user-auth/ │ ├── spec.md │ ├── plan.md │ └── tasks.md ├── 002-payment-flow/ │ ├── spec.md │ ├── plan.md │ └── tasks.md └── 003-dashboard/ ├── spec.md ├── plan.md └── tasks.md ``` ### Feature Selection | Selection | Meaning | |-----------|---------| | `--feature all` | All features in numerical order | | `--feature 001` | Match by number prefix | | `--feature user-auth` | Match by name | | `--feature 001-user-auth` | Match by full ID | | `--feature 001,002,003` | Multiple specific features | | (none) | Auto-detect or prompt | ## Core Concepts ### Ralph Prompt Requirements Ralph prompts must have: 1. **Context pointing to state files** - Ralph reads specs, not memory 2. **Explicit process steps** - Numbered, repeatable per iteration 3. **Backpressure commands** - Tests/lint that MUST pass 4. **Completion promises** - Exact string matching with `<promise>` tags 5. **Escape hatches** - What to do when stuck ### Spec Kit → Ralph Mapping | Spec Kit Artifact | Ralph Usage | |-------------------|-------------| | constitution.md | Constraints section (no