Cursor rule

1---
2description: "Link story IDs from specs/release-plan.yaml + epic capsule directories to the implementing code and tests. Produces specs/TRACEABILITY_LATEST.md. Use when you want to verify coverage of a release plan, audit which stories are implemented, or find \"dark\" stories with no code."
3alwaysApply: false
4---
5 
6# Trace Requirement
7 
8Build a traceability matrix from `specs/release-plan.yaml + epic capsule directories` to implementing code and tests. Surfaces gaps in both directions: stories with no code, and code with no story.
9 
10## Pre-flight
11 
12> **HARD GATE** — `specs/release-plan.yaml + epic capsule directories` must exist. If it doesn't, run `plan-release` first.
13 
14→ verify: `test -f specs/release-plan.yaml && test -d specs/epics`
15 
16Read `specs/release-plan.yaml + epic capsule directories` fully before proceeding.
17 
18## Process
19 
20### 1. Extract story IDs
21 
22From release-plan.yaml, collect all story IDs (e.g. `1.1`, `1.2`, `2.1`).
23 
24→ verify: `grep -rho 'e[0-9]\+s[0-9]\+' specs/release-plan.yaml specs/epics/*/epic.yaml 2>/dev/null | sort -u | head -1 | grep -q .`
25 
26### 2. Search for story tags in code
27 
28Look for `// story: X.Y` or `# story: X.Y` comments in source files and tests:
29 
30```
31grep -rn "story: " . --include="*.ts" --include="*.js" --include="*.py" --include="*.sh" | grep -v node_modules
32```
33 
34→ verify: `[ "$(grep -rl "story: " . --include="*.ts" --include="*.sh" --include="*.py" 2>/dev/null | wc -l | tr -d " ")" -gt 0 ]`
35 
36### 3. Build the matrix
37 
38For each story ID:
39- **Implemented**: list files that contain `// story: X.Y`
40- **Tested**: list test files that contain `// story: X.Y`
41- **Dark**: story has no tag in any file — flag as unimplemented
42 
43For each tagged file with no matching story ID in release-plan.yaml:
44- **Orphan**: code exists but story was removed or never planned — flag for cleanup
45 
46### 4. Write specs/TRACEABILITY_LATEST.md
47 
48```
49## Story Coverage
50 
51| Story | Title              | Files | Tests | Status    |
52|-------|--------------------|-------|-------|-----------|
53| 1.1   | [title]            | 2     | 1     | Covered   |
54| 1.2   | [title]            | 0     | 0     | Dark      |
55 
56## Orphan Code (no story tag)
57- [file]: contains untagged implementation
58 
59## Gaps (dark stories)
60- Story 1.2: no implementation found → run plan-work
61 
62## Coverage summary
63Stories: [X] covered / [Y] dark / [Z] total
64```
65 
66→ verify: `grep -c "Covered\|Dark" specs/TRACEABILITY_LATEST.md`
67 
68Suggest `plan-work` for each dark story found.
69