Commit Graph

1 Commits

Author SHA1 Message Date
Jonah Schulte 1031b1cd21 feat: add story/epic revalidation with gap filling
Implements user-requested revalidation capability to verify checkbox accuracy.

Use Case:
"I am uncertain about the real status of some stories and epics that I've
worked on and would love a re-check" - User

FEATURE: /revalidate-story
-------------------------
Clears all checkboxes and re-verifies each item against codebase:

1. Clear Phase:
   - Uncheck all boxes in ACs, Tasks, DoD
   - Start from clean slate

2. Verification Phase:
   - For each item: search codebase with Glob/Grep
   - Read files to verify actual implementation (not stubs)
   - Check for tests and verify they pass
   - Re-check verified items: [x] verified, [~] partial, [ ] missing

3. Gap Reporting:
   - Report what exists vs what's documented
   - Calculate accuracy (before % vs after %)
   - Identify over-reported (checked but missing) and under-reported (exists but unchecked)

4. Gap Filling Mode (optional):
   - Implement missing items
   - Run tests to verify
   - Commit per gap or all at once
   - Re-verify after filling

Token Cost Analysis:
- Verify-only: ~30-45K tokens (just scan and report)
- Verify-and-fill (10% gaps): ~35-55K tokens
- Verify-and-fill (50% gaps): ~60-90K tokens
- Compare to full re-implementation: ~80-120K tokens
- Savings: 40-60% when gaps <30%

FEATURE: /revalidate-epic
------------------------
Batch revalidation of all stories in an epic using semaphore pattern:

- Maintain pool of N concurrent workers
- As worker finishes → immediately start next story
- Constant concurrency until all stories revalidated
- Epic-wide summary with health score
- Stories grouped by completion %

Usage:
```bash
# Verify only
/revalidate-story story_file=path/to/story.md

# Verify and fill gaps
/revalidate-story story_file=path/to/story.md fill_gaps=true

# Revalidate entire epic
/revalidate-epic epic_number=2

# Revalidate epic and fill all gaps
/revalidate-epic epic_number=2 fill_gaps=true max_concurrent=5
```

Files Created:
- revalidate-story/workflow.yaml: Story revalidation config
- revalidate-story/instructions.md: 10-step revalidation process
- revalidate-epic/workflow.yaml: Epic batch revalidation config
- revalidate-epic/instructions.md: Semaphore pattern for parallel revalidation

Files Modified:
- dev.agent.yaml: Added RVS and RVE menu items
- sm.agent.yaml: Added RVS and RVE menu items

Next: Reverse gap analysis (detect orphaned code with no stories)
2026-01-07 20:33:18 -05:00