---

name: define-requirements description: Define what "done" looks like with checkable requirements allowed-tools:

• Read
• Write
• Bash
• Glob
• AskUserQuestion

---

Two modes:

1. With research — Transform FEATURES.md into scoped requirements
2. Without research — Gather requirements through questioning

Run before /ag4:create-roadmap.

Output: .planning/REQUIREMENTS.md

<execution_context> @/.claude/ag4one/references/principles.md @/.claude/ag4one/workflows/define-requirements.md @~/.claude/ag4one/templates/requirements.md </execution_context>

Check for research

[ -f .planning/research/FEATURES.md ] && echo "HAS_RESEARCH" || echo "NO_RESEARCH"

Check if requirements already exist

[ -f .planning/REQUIREMENTS.md ] && echo "REQUIREMENTS_EXISTS" || echo "NO_REQUIREMENTS"

Copy</step>

<step name="check_existing">
**If REQUIREMENTS_EXISTS:**

Use AskUserQuestion:
- header: "Requirements exist"
- question: "Requirements already defined. What would you like to do?"
- options:
  - "View existing" — Show current requirements
  - "Replace" — Define requirements fresh (will overwrite)
  - "Cancel" — Keep existing requirements

If "View existing": Read and display `.planning/REQUIREMENTS.md`, then exit
If "Cancel": Exit
If "Replace": Continue with workflow
</step>

<step name="execute">
**If HAS_RESEARCH:**
Follow the define-requirements.md workflow:
- Load research features from FEATURES.md
- Present features by category
- Ask user to scope each category (v1 / v2 / out of scope)
- Capture any additions research missed
- Generate REQUIREMENTS.md with checkable list

**If NO_RESEARCH:**
Gather requirements through questioning:
- Read PROJECT.md for core value and context
- Ask: "What are the main things users need to be able to do?"
- For each capability mentioned, probe for specifics
- Group into categories (Authentication, Content, etc.)
- For each category, ask what's v1 vs v2 vs out of scope
- Generate REQUIREMENTS.md with checkable list

Same output format either way — the difference is source (research vs conversation).
</step>

<step name="done">

Requirements defined:

• Requirements: .planning/REQUIREMENTS.md
• v1 scope: [N] requirements across [M] categories
• v2 scope: [X] requirements deferred
• Out of scope: [Y] requirements excluded

---

▶ Next Up

Create roadmap — phases mapped to requirements

/ag4:create-roadmap

/clear first → fresh context window

---

Copy</step>

</process>

<success_criteria>
- [ ] PROJECT.md validated
- [ ] Features gathered (from research OR questioning)
- [ ] User scoped each category (v1/v2/out of scope)
- [ ] User had opportunity to add missing requirements
- [ ] REQUIREMENTS.md created with checkable list
- [ ] Requirements committed to git
- [ ] User knows next step (create-roadmap)
</success_criteria>