agents-reverse-engineer: Command for Claude Code

Reads MILESTONE-AUDIT.md, groups gaps into logical phases, creates phase entries in ROADMAP.md, and offers to plan each phase.

One command creates all fix phases — no manual /gsd:add-phase per gap.

<execution_context>

</execution_context>

Original intent (for prioritization): @.planning/PROJECT.md @.planning/REQUIREMENTS.md

Current state: @.planning/ROADMAP.md @.planning/STATE.md

1. Load Audit Results

# Find the most recent audit file
ls -t .planning/v*-MILESTONE-AUDIT.md 2>/dev/null | head -1

Parse YAML frontmatter to extract structured gaps:

• gaps.requirements — unsatisfied requirements
• gaps.integration — missing cross-phase connections
• gaps.flows — broken E2E flows

If no audit file exists or has no gaps, error:

No audit gaps found. Run `/gsd:audit-milestone` first.

2. Prioritize Gaps

Group gaps by priority from REQUIREMENTS.md:

Priority	Action
must	Create phase, blocks milestone
should	Create phase, recommended
nice	Ask user: include or defer?

For integration/flow gaps, infer priority from affected requirements.

3. Group Gaps into Phases

Cluster related gaps into logical phases:

Grouping rules:

• Same affected phase → combine into one fix phase
• Same subsystem (auth, API, UI) → combine
• Dependency order (fix stubs before wiring)
• Keep phases focused: 2-4 tasks each

Example grouping:

Gap: DASH-01 unsatisfied (Dashboard doesn't fetch)
Gap: Integration Phase 1→3 (Auth not passed to API calls)
Gap: Flow "View dashboard" broken at data fetch

→ Phase 6: "Wire Dashboard to API"
  - Add fetch to Dashboard.tsx
  - Include auth header in fetch
  - Handle response, update state
  - Render user data