| name | ralphharness-design |
| description | This skill should be used only when the user explicitly asks to use `$ralphharness-design`, or explicitly asks RalphHarness in Codex to run the design phase. |
| metadata | {"surface":"helper","action":"design"} |
RalphHarness Design
Use this for the design phase.
Contract
- Resolve the active spec by explicit path, exact name, or
.current-spec
- Require
requirements.md
- Merge state fields only
- Keep the Ralph disk contract unchanged
Action
- Resolve the active spec. If none exists, stop.
- Require
requirements.md. Read research.md when present, .progress.md, and current state.
- Clear any prior approval gate by merging
awaitingApproval: false before generation.
- Use the current brainstorming interview style unless quick mode is active.
- Write or rewrite
design.md.
- Merge state with
phase: "design" and awaitingApproval: true.
- Update
.progress.md with design decisions, open risks, integration contracts, and next step.
- If spec commits are enabled, commit only the spec artifacts.
- In quick mode, continue directly into tasks.
Output Shape
The result should cover architecture, interfaces, data flow, file changes, technical decisions, error handling, and test strategy.
Response Handoff
- After writing
design.md, reference design.md and summarize the design briefly.
- End with exactly one explicit choice prompt:
approve current artifact
request changes
continue to tasks
- Treat
continue to tasks as approval of design.md.