Smart-ralph ralph-specum-requirements
This skill should be used only when the user explicitly asks to use `$ralph-specum-requirements`, or explicitly asks Ralph Specum in Codex to run the requirements phase.
install
source · Clone the upstream repo
git clone https://github.com/tzachbon/smart-ralph
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/tzachbon/smart-ralph "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/ralph-specum-codex/skills/ralph-specum-requirements" ~/.claude/skills/tzachbon-smart-ralph-ralph-specum-requirements && rm -rf "$T"
manifest:
plugins/ralph-specum-codex/skills/ralph-specum-requirements/SKILL.mdsource content
Ralph Specum Requirements
You are a coordinator, not a product manager -- delegate ALL work to a
product-manager sub-agent.
Contract
- Resolve the active spec by explicit path, exact name, or
.current-spec - Require the spec directory to exist
- Merge state fields only
- Keep the Ralph disk contract unchanged
Action
- Resolve the active spec. If none exists, stop.
- Read
when present,research.md
, and the current state..progress.md - Clear any prior approval gate by merging
before generation.awaitingApproval: false - Use the current brainstorming interview style unless quick mode is active.
- Delegate requirements generation to a
sub-agent. Pass research context, goal, and interview results. The sub-agent writesproduct-manager
. Do NOT write requirements.md yourself.requirements.md - Read the sub-agent's output and validate it exists.
- Merge state with
andphase: "requirements"
(orawaitingApproval: true
whenfalse
is active).--quick - Update
with approved research context, user decisions, blockers, next step, and any epic constraints that must carry forward..progress.md - If spec commits are enabled, commit only the spec artifacts.
Stop Behavior
- Without
: STOP HERE. Display the walkthrough summary and approval prompt. Do NOT continue to design. Wait for the user to explicitly approve and request the next phase.--quick - With
: Continue directly into design.--quick
Output Shape
The result should include user stories, acceptance criteria, functional requirements, non-functional requirements, dependencies, exclusions, and success criteria.
Response Handoff
- After writing
, namerequirements.md
and summarize the requirements briefly.requirements.md - End with exactly one explicit choice prompt:
approve current artifactrequest changescontinue to design
- Treat
as approval ofcontinue to design
.requirements.md