Fixing a bug — brainstorming's bug branch
Entry: a bug report, with the task-spec open (spine step 3). Saves: the task-spec's Bug section. Next: spine step 8 (Build) — or spine step 5 when the "bug" turns out to be a feature.
A bug is a gap between what the product is meant to do and what it does. Settle the intended behavior before touching the code: it is confirmed and recorded in the task-spec here, which leads the fix the way a design leads a feature. The durable specs are amended at spine step 9, as for every change, so they describe what was actually built.
- Pin the report. Symptom (what happens), expected behavior (what should happen instead), and how to trigger it. Infer them from the request; ask only what is missing, in one round per the asking-user-questions concept skill.
- Reproduce when a safe command can show it — a failing test is best. Never run a destructive command to reproduce. If it can't be reproduced, record that and carry on.
- Locate the code that produces the behavior and the specs that govern that area (spec-graph).
- Classify by what those specs say about the expected behavior:
- Silent — no spec covers it. The intended behavior is a product decision: confirm it with the user as an inference; spine step 9 adds it to the spec that should have stated it.
- Wrong — a spec states the buggy or an outdated behavior. Confirm the correction with the user; spine step 9 corrects that spec.
- Right — the spec already states the expected behavior; only the code is wrong. No question needed.
- Feature — the code does what the specs intend, and the expected behavior was never intended. Tell the user it is a new capability and continue at spine step 5. Ask about the classification itself only when the evidence genuinely supports two of them.
- Record symptom, expected behavior, reproduction (or "unreproduced"), classification, and the confirmed intended behavior in the task-spec's Bug section. The intended behavior is the accepted design — there is no separate design review for a bug.
- Fix it test-first when practical: a regression test that fails before the fix and passes after. Continue at spine step 8.