Cursor rule

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