Windsurf rules

1---
2name: fix-bug
3model: sonnet
4description: "Bug fix orchestrator — active_flow fix_bug; reads specs/bugs/BUG-*.md; chains investigate-bug, develop-tdd, validate-fix. Use when user reports a defect."
5---
6 
7# Fix Bug
8 
9**Boundary**: Orchestrator flow — chains `investigate-bug` (entry point + RCA via `diagnose-root`) → `develop-tdd` → `validate-fix`. Does not implement RCA or write bug files directly.
10 
11Orchestrates **fix_bug** flow without mixing epic build state.
12 
13> **HARD GATE** — Set `specs/state.yaml` `active_flow: fix_bug` and `bug_cycle.current_step: 1` before starting.
14 
15## Discovered gate failures (e51s04)
16 
17Valid entry **without a user-reported bug** when:
18 
19- **Preflight** or **CI** is red at kickoff or verify-work
20- **Golden suite** or project baseline is red (`bash scripts/run-verification-gates.sh` or equivalent)
21- A reproducible gate failure during unrelated epic work exceeds quick-fix guardrails
22 
23Create `specs/bugs/BUG-*.md` via `investigate-bug` (or inline in fix-bug step 1) describing the gate failure, then run the standard fix_bug chain.
24 
25## Five steps (`bug_cycle` in state.yaml)
26 
27| Step | Skill / action |
28|------|----------------|
29| 1 | `investigate-bug` — create BUG-*.md with RCA |
30| 2 | `diagnose-root` — 4-phase root cause analysis |
31| 3 | `develop-tdd` — red-green against bug file verify steps |
32| 4 | `validate-fix` — re-run failing test, full suite, lint |
33| 5 | `release-branch` — PR or solo land the fix |
34 
35### Checkpoint / resume
36 
37Track progress via `specs/state.yaml` `bug_cycle`:
38- `bug_cycle.current_step`: current step (1–5)
39- `bug_cycle.completed_steps`: completed step numbers
40- `handoff.next_skill`: skill for the current step
41- On resume, read `bug_cycle.current_step` and continue from there
42 
43## Process
44 
451. **Step 1 — investigate-bug:** If no `specs/bugs/BUG-*.md`, run `investigate-bug` first — it handles history check, RCA (via `diagnose-root`), fix approach, and writes the bug file. Increment `bug_cycle.current_step` to 2 on completion.
462. **Step 2 — diagnose-root:** Run 4-phase RCA (reproduce → isolate → hypothesize → verify). Record findings in the bug file. Increment to step 3.
473. **Step 3 — develop-tdd:** `develop-tdd` against the bug file's verify steps. Increment to step 4 on all-green.
484. **Step 4 — validate-fix:** `validate-fix` — re-run failing test, full suite, typecheck, lint. Increment to step 5.
495. **Step 5 — release-branch:** Land the fix via `release-branch`. Clear `bug_cycle` and `active_flow` when done.
50 
51## Bug file SoT
52 
53One markdown file per bug with frontmatter:
54 
55```yaml
56---
57bug_id: BUG-001
58status: open
59severity: high
60scope: api
61title: Short title
62---
63```
64 
65## Verify
66 
67→ verify: `test -d specs/bugs && test -f scripts/run-skill-verify.sh`
68