refactor: remove dead code, improve execute-phase UX, fix requirements flow

- Remove phantom status.md command (background agent model abandoned)
- Remove agent-history.md template (unused)
- Remove _archive/ directory
- Add narration to execute-phase (describe what's being built before/after waves)
- Update new-project to offer define-requirements as fast path
- Make define-requirements work without research (gather through questioning)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Lex Christopherson
2026-01-15 01:04:41 -06:00
parent 73083db966
commit bd4bd9db53
8 changed files with 153 additions and 1209 deletions

View File

@@ -10,14 +10,13 @@ allowed-tools:
---
<objective>
Define concrete, checkable requirements from research findings.
Define concrete, checkable requirements for v1.
Research answers "what do products like this have?"
Requirements answers "what are WE building?"
Two modes:
1. **With research** — Transform FEATURES.md into scoped requirements
2. **Without research** — Gather requirements through questioning
Transforms research features into scoped v1/v2 requirements that roadmap phases map to.
Run after `/gsd:research-project`, before `/gsd:create-roadmap`.
Run before `/gsd:create-roadmap`.
Output: `.planning/REQUIREMENTS.md`
</objective>
@@ -30,8 +29,8 @@ Output: `.planning/REQUIREMENTS.md`
<context>
@.planning/PROJECT.md
@.planning/research/FEATURES.md (required)
@.planning/research/SUMMARY.md
@.planning/research/FEATURES.md (if exists)
@.planning/research/SUMMARY.md (if exists)
</context>
<process>
@@ -41,8 +40,8 @@ Output: `.planning/REQUIREMENTS.md`
# Verify project exists
[ -f .planning/PROJECT.md ] || { echo "ERROR: No PROJECT.md found. Run /gsd:new-project first."; exit 1; }
# Verify research exists
[ -f .planning/research/FEATURES.md ] || { echo "ERROR: No research found. Run /gsd:research-project first."; exit 1; }
# 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"
@@ -66,12 +65,24 @@ If "Replace": Continue with workflow
</step>
<step name="execute">
**If HAS_RESEARCH:**
Follow the define-requirements.md workflow:
- Load research features
- 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">
@@ -101,8 +112,7 @@ Requirements defined:
<success_criteria>
- [ ] PROJECT.md validated
- [ ] Research FEATURES.md loaded
- [ ] Features presented by category
- [ ] 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

View File

@@ -144,15 +144,6 @@ Options (via `.planning/config.json` parallelization section):
- `skip_checkpoints`: Skip human checkpoints in background (default: true)
- `min_plans_for_parallel`: Minimum plans to trigger parallelization (default: 2)
**`/gsd:status [--wait]`**
Check status of background agents from parallel execution.
- Shows running/completed agents from agent-history.json
- Uses TaskOutput to poll agent status
- With `--wait`: blocks until all agents complete
Usage: `/gsd:status` or `/gsd:status --wait`
### Roadmap Management
**`/gsd:add-phase <description>`**

View File

@@ -300,15 +300,15 @@ Project initialized:
Choose your path:
**Option A: Research first** (recommended for new domains)
Research the ecosystem before creating roadmap. Discovers standard stacks, expected features, architecture patterns, and common pitfalls.
**Option A: Research first** (recommended)
Research ecosystem → define requirements → create roadmap. Discovers standard stacks, expected features, architecture patterns.
`/gsd:research-project`
**Option B: Create roadmap directly** (for familiar domains)
Skip research if you know this domain well or have a clear spec.
**Option B: Define requirements directly** (familiar domains)
Skip research, define requirements from what you know, then create roadmap.
`/gsd:create-roadmap`
`/gsd:define-requirements`
<sub>`/clear` first → fresh context window</sub>