How this skill is triggered — by the user, by Claude, or both
Slash command
/ralph-swarm:requirementsThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Run the requirements planning phase. This command takes the research output and produces detailed requirements. It is the second step in the incremental planning flow.
Run the requirements planning phase. This command takes the research output and produces detailed requirements. It is the second step in the incremental planning flow.
.ralph-swarm-state.json from the project root using the Read tool.Error: No active swarm found. Run /ralph-swarm:start "your goal" first.
phase, pausedAfter, planning, specPath, goal, and name.phase is not "planning", output this error and stop:
Error: Cannot run requirements phase. Current phase is "<phase>".
Requirements can only run during the planning phase.
planning.research is not "complete", output this error and stop:
Error: Research phase must complete first. Run /ralph-swarm:start "your goal" to begin.
pausedAfter is set but planning.research is "pending", this is a corrupt state. Output:
Warning: State inconsistency detected (pausedAfter is set but research is pending). Run /ralph-swarm:cancel to reset.
Then stop.If planning.requirements is already "complete":
Warning: Requirements phase already completed. Re-running will invalidate downstream phases.
planning.design to "pending"planning.tasks to "pending"<specPath>/design.md if it exists<specPath>/tasks.md if it existspausedAfter to null.CLAUDE.md exists in the project root. If it does, read it with the Read tool.<specPath>/research.md using the Read tool.flags.swarm from the state file (parsed in Step 1).Error: Research file not found at <specPath>/research.md. The research phase may have failed.
Run /ralph-swarm:cancel to reset and start over.
pausedAfter to null in the state file (clear any previous pause).planning.requirements to "in-progress" in the state file.Pre-merge check (if flags.swarm is true): Before spawning parallel agents, check <specPath> for partial files from a prior interrupted attempt:
requirements-functional.md, requirements-nonfunctional.md) exist AND requirements.md does NOT exist: skip agent delegation, proceed directly to merge. Read skills/start/SKILL.md and follow the Merge Protocol section.If flags.swarm is true: Spawn 2 parallel Task calls using swarm-requirements agent type:
| Agent | Focus | Output File |
|---|---|---|
| A | Functional: user stories (happy paths), core acceptance criteria, scope boundaries, dependencies between features | <specPath>/requirements-functional.md |
| B | Non-functional & edge cases: edge case analysis, performance/security NFRs, error scenarios, backwards compatibility | <specPath>/requirements-nonfunctional.md |
<specPath>/research.md, produce requirements for: <goal>. Focus specifically on . Save to <output file>."skills/start/SKILL.md and follow the Merge Protocol section to combine partial files into <specPath>/requirements.md. Partial files: requirements-functional.md, requirements-nonfunctional.md.planning.requirements to "failed" and stop.If flags.swarm is false (default): Single-agent delegation:
swarm-requirements agent type (subagent_type: ralph-swarm:swarm-requirements) via the Task tool:
<specPath>/research.md, produce detailed requirements for: <goal>. Save to <specPath>/requirements.md."Regardless of path, the requirements.md must include:
After delegation (both paths):
5. Verify <specPath>/requirements.md exists by reading it.
6. If verification fails, set planning.requirements to "failed" and stop with an error.
7. Set planning.requirements to "complete" in the state file.
pausedAfter to "requirements" in the state file.Requirements phase complete.
Review the output at: <specPath>/requirements.md
Next: Run /ralph-swarm:design to continue planning.
Or edit the requirements file first, then run /ralph-swarm:design.
pausedAfter is set.planning.requirements to "failed" in the state file, report the error, and stop.npx claudepluginhub divkix/ralph-swarm --plugin ralph-swarmInterrogates requirements via structured one-question Q&A to validate before swarm decomposition, ambiguous feature design, or high scope creep risk.
Assesses information completeness for specs, PRDs, tickets, RFCs, and multi-step tasks via reverse thinking, blocking planning until prerequisites verified.
Decomposes problems, scans stakeholders, and structures requirements into a Phase 1 lifecycle document (1-requirements.md). Use before tech spec or feasibility study.