Ralph Specum Research
You are a coordinator, not a researcher -- delegate ALL work to a research-analyst sub-agent.
Contract
- Resolve the active spec by explicit path, exact name, or
.current-spec
- Respect
.claude/ralph-specum.local.md when present
- Default specs root is
./specs
- Keep the canonical Ralph file names
- Merge state fields only
Action
- Resolve the active spec. If none exists, stop and tell the user to start a spec first.
- Read the goal,
.progress.md, current state, indexed codebase context, related specs, and epic context when present.
- Use the current brainstorming interview style unless quick mode is active.
- Delegate research generation to a
research-analyst sub-agent. Pass the goal, existing context, and interview results. The sub-agent writes research.md in the spec directory. Do NOT write research.md yourself.
- Read the sub-agent's output and validate it exists.
- Merge state with
phase: "research" and awaitingApproval: true (or false when --quick is active).
- Update
.progress.md with the research summary, blockers, learnings, next step, and verification tooling notes when relevant.
- If spec commits are enabled, commit only the spec artifacts.
Stop Behavior
- Without
--quick: STOP HERE. Display the walkthrough summary and approval prompt. Do NOT continue to requirements. Wait for the user to explicitly approve and request the next phase.
- With
--quick: Continue directly into requirements.
Output Shape
The result should identify existing code patterns, external references, constraints, related specs, risks, verification tooling, and a clear recommendation for the next phase.
Response Handoff
- After writing
research.md, name research.md and summarize the research briefly.
- End with exactly one explicit choice prompt:
approve current artifactrequest changescontinue to requirements
- Treat
continue to requirements as approval of research.md.
1---2name: ralph-specum-research-23description: This skill should be used only when the user explicitly asks to use `$ralph-specum-research`, or explicitly asks Ralph Specum in Codex to run the research phase.4---56# Ralph Specum Research78You are a **coordinator, not a researcher** -- delegate ALL work to a `research-analyst` sub-agent.910## Contract1112- Resolve the active spec by explicit path, exact name, or `.current-spec`13- Respect `.claude/ralph-specum.local.md` when present14- Default specs root is `./specs`15- Keep the canonical Ralph file names16- Merge state fields only1718## Action19201. Resolve the active spec. If none exists, stop and tell the user to start a spec first.212. Read the goal, `.progress.md`, current state, indexed codebase context, related specs, and epic context when present.223. Use the current brainstorming interview style unless quick mode is active.234. **Delegate** research generation to a `research-analyst` sub-agent. Pass the goal, existing context, and interview results. The sub-agent writes `research.md` in the spec directory. Do NOT write research.md yourself.245. Read the sub-agent's output and validate it exists.256. Merge state with `phase: "research"` and `awaitingApproval: true` (or `false` when `--quick` is active).267. Update `.progress.md` with the research summary, blockers, learnings, next step, and verification tooling notes when relevant.278. If spec commits are enabled, commit only the spec artifacts.2829### Stop Behavior3031- **Without `--quick`**: STOP HERE. Display the walkthrough summary and approval prompt. Do NOT continue to requirements. Wait for the user to explicitly approve and request the next phase.32- **With `--quick`**: Continue directly into requirements.3334## Output Shape3536The result should identify existing code patterns, external references, constraints, related specs, risks, verification tooling, and a clear recommendation for the next phase.3738## Response Handoff3940- After writing `research.md`, name `research.md` and summarize the research briefly.41- End with exactly one explicit choice prompt:42 - `approve current artifact`43 - `request changes`44 - `continue to requirements`45- Treat `continue to requirements` as approval of `research.md`.
majiayu000