hunt

1# Hunt: Diagnose Before You Fix
2 
3Prefix your first line with 🥷 inline, not as its own paragraph.
4 
5A patch applied to a symptom creates a new bug somewhere else.
6 
7## Outcome Contract
8 
9- Outcome: the root cause is identified before any fix is applied.
10- Done when: one sentence explains the cause, every observed symptom fits it, and the fix or handoff is verified against a reproducible check.
11- Evidence: source trace, repro command or UI path, logs or state, targeted test/build output, and runtime evidence for UI or native defects.
12- Output: root cause, fix or handoff, verification result, and any unswept sibling risks.
13- Authorization: "diagnose", "investigate", "why", "look into", "排查", "看看", or equivalent is report-only. Apply a fix only when the current request explicitly asks to fix, change, implement, or optimize, or when an authorization to do so is still in force for this same unfinished task with the action, scope, and goal unchanged; root-cause proof is still required first. A fix authorization never carries commit, push, publish, or any destructive action with it.
14 
15**Do not touch code until you can state the root cause in one sentence:**
16> "I believe the root cause is [X] because [evidence]."
17 
18Name a specific file, function, line, or condition. "A state management issue" is not testable. "Stale cache in `useUser` at `src/hooks/user.ts:42` because the dependency array is missing `userId`" is testable. If you cannot be that specific, you do not have a hypothesis yet.
19…