Windsurf rules

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