Windsurf rules

1---
2name: quick-fix
3model: sonnet
4description: "Streamlined fast-path for trivial data-only fixes — no TDD, no branching ceremony. Collapses 6 skills into 2 for changes that are purely data with no logic risk. Aborts with fallback to investigate-bug if guardrails trigger."
5---
6 
7# Quick Fix
8 
9> **HARD GATE** — ALL entry criteria must pass before invoking quick-fix. If any guardrail triggers during execution, abort immediately and fall back to `investigate-bug`. Do NOT use quick-fix for logic changes, multi-file edits, or diffs > 5 lines.
10 
11Fast-track for trivial data-only fixes that do not require the full bug-fix chain.
12 
13When a bug fix is purely data — an add-missing-key, a typo correction, a config value update — the standard 6-skill chain (investigate-bug → diagnose-root → develop-tdd → kickoff-branch → verify-work → release-branch) is wasteful overhead. Quick-fix collapses it to 2 skills: **quick-fix** then **release-branch**.
14 
15## Discovered gate failures (e51s04)
16 
17A **Preflight**, **golden suite**, or **baseline red** failure discovered during unrelated work is valid quick-fix entry when the root cause is a data-only gap (missing key, typo, stale config) — **no user-reported bug required**. If guardrails abort (logic change, >1 file, >5 lines), fall back to `fix-bug` instead of narrating and continuing.
18 
19## Entry Criteria (ALL must be true)
20 
21Before invoking quick-fix, evaluate every item in this checklist:
22 
231. **Purely data change** — adding a missing key, fixing a typo, updating a config value, correcting a constant
242. **No logic change** — no function signature, condition, loop, or control flow is modified
253. **No refactor risk** — the change does not reorganize or rename existing structures
264. **No API surface change** — no exported symbol, interface, or contract changes
275. **Verifiable with a single assertion** — one test, one curl, one grep can prove it works
286. **Affects ≤ 1 file**
297. **Affects ≤ 5 lines changed**
30 
31## Guardrails (HARD ABORT — all must pass)
32 
33If ANY guardrail triggers, **abort immediately** and suggest `investigate-bug` instead:
34 
35| Guardrail | Check |
36|-----------|-------|
37| **>1 file** | The fix touches more than one file |
38| **>5 lines** | The diff exceeds 5 lines |
39| **Logic change** | Any function signature, condition, or loop is modified |
40| **Complex verify** | The verify command is more than one pipeline |
41| **Test breakage** | Running `npm test` or equivalent breaks any existing test |
42 
43> **Fallback:** If any guardrail triggers, tell the user: *"This fix exceeds quick-fix guardrails. Use `investigate-bug` for the full TDD bug-fix chain instead."*
44 
45## Fast-Path Workflow
46 
47Only 2 skills needed for eligible fixes:
48 
49```
50quick-fix  →  apply change, run one-line verify, commit with fix:
51release-branch  →  merge and ship (existing skill)
52```
53 
54**Skipped skills (with justification):**
55 
56| Skipped skill | Why skipped |
57|---------------|-------------|
58| `investigate-bug` | Root cause is obvious (data gap, not logic error) |
59| `diagnose-root` | No isolation needed — the data point is the root cause |
60| `develop-tdd` | No logic to test — single assertion proves correctness |
61| `kickoff-branch` | Change is so small it does not warrant a separate worktree |
62 
63> Justification is included in the `fix:` commit body so the audit trail is preserved.
64 
65## Process
66 
67### 1. Evaluate entry criteria
68 
69Run the entry criteria checklist above. If any criterion fails → abort, suggest `investigate-bug`.
70 
71### 2. Apply the fix
72 
73Make the data change — add the missing key, fix the typo, update the value. Keep it to ≤5 lines in 1 file.
74 
75### 3. Verify
76 
77Run the single-assertion verify command. Example:
78 
79```bash
80grep -q "Bosnia" src/flags.js && echo "FIX VERIFIED" || echo "FIX FAILED"
81```
82 
83### 4. Commit
84 
85```bash
86git add <file>
87git commit -m "fix(<scope>): <description>"
88git commit --amend -m "fix(<scope>): <description>
89 
90Skipped skills (justified for data-only change):
91- investigate-bug: root cause is a data gap, not a logic error
92- diagnose-root: the missing data point is the root cause
93- develop-tdd: single assertion proves correctness
94- kickoff-branch: change is too small for a separate worktree"
95```
96 
97### 5. Release
98 
99Invoke `release-branch` to merge and ship.
100 
101 
102## Example
103 
104### Bosnia flag missing from FLAGS dictionary
105 
106```gherkin
107Given a bug where FLAGS dictionary is missing entry "Bosnia"
108And no logic depends on the missing entry (purely a data gap)
109When the agent invokes quick-fix
110Then the missing entry is added to the dictionary
111And a one-line verify confirms the key exists: grep -q "Bosnia" src/flags.js
112And a fix: commit is created with the skipped-skills rationale in the body
113And the change is ready for release-branch
114```
115