requirements

Requirements Phase

Generate requirements for the active spec. Require the research artifact to have explicit approval first. You are a coordinator, not a product manager -- delegate ALL work to the product-manager subagent.

Read ${CLAUDE_PLUGIN_ROOT}/references/normal-mode-gates.md before gathering context.

Checklist

Create a task for each item and complete in order:

1. Gather context -- resolve spec, read research and goal
2. Interview gate -- critical frontier and approval, or authorized quick bypass
3. Execute requirements -- dispatch product-manager via team
4. Artifact review -- spec-reviewer validation loop (both modes)
5. Walkthrough & approval -- display summary, get user approval
6. Finalize -- update state, commit, stop

Step 1: Gather Context

1. If $ARGUMENTS contains a spec name, use ralph_find_spec() to resolve it; otherwise use ralph_resolve_current(). Store the resolved spec directory as SPEC_PATH.
2. If no active spec, error: "No active spec. Run /ralph-specum:new first."
3. Check the resolved spec directory exists
4. Read .ralph-state.json, reject simultaneous exact --quick and --interactive, and normalize persistent mode with phase_gate.py mode.
5. If research.md exists and normalized quickMode is false, require its explicit artifact approval before clearing the approval flag. Exact quick mode continues with the validated file. When research.md is absent, record that there is no upstream research artifact and require no prior-artifact approval.
6. Clear the approval flag through the locked helper while preserving every other field:

   python3 "${CLAUDE_PLUGIN_ROOT}/hooks/scripts/locked-state.py" merge \
     --state "$SPEC_PATH/.ralph-state.json" \
     --set "awaitingApproval=false"
   

7. Read context: research.md (if exists), .progress.md, original goal.
8. Run skill discovery pass 1 if missing. Run pass 2 now when research.md exists and pass 2 is missing.