---

date: 2026-07-16 tags: [reasoning, problem-solving, bias, meta] status: graduated graduated_to: CLAUDE.md

Fix before you fall back — reverting is the reflex trap, not the fix

Symptom — A committed Pest 5.x-dev spike hit a CI failure (composer plugin-activation fatal). At the first failure — and again when explicitly asked to resolve it — the agent recommended reverting/scrapping Pest 5, and every option it surfaced was a variant of giving up (revert / accept-red / hold). It never proposed "keep trying," then argued against testing the maintainer's alias idea before grudgingly running it. The alias — a 2-minute, one-push, fully reversible experiment — fixed it. The resolution came entirely from the maintainer, past the point where the agent had stopped.

Root cause — Reversion is safe, always-available and requires zero problem-solving, so it became the reflexive default and got dressed up as prudence. "Experimental / unstable" was misread as a reason to abandon rather than licence to try janky workarounds. The agent's own confidence ("the alias won't work — it's a label, not code") suppressed a cheap experiment instead of prompting it. And the decision was framed as how to give up, silently removing the persistence path that actually won.

Fix — n/a (a reasoning disposition, not a code change). The experiment that resolved the underlying blocker: commit 1e22607, inline alias pestphp/pest-plugin: "5.x-dev as 5.0.0", which let CI's composer activate the plugin.

Guard — Graduated to CLAUDE.md Key Conventions ("Fix before you fall back"): on an obstacle, try cheap/reversible fixes before proposing revert; run a reversible experiment you can't verify locally rather than reasoning it away; always put "keep trying" on the menu when surfacing a post-failure decision. The behavioural trigger is catching yourself about to recommend revert / scrap / split — that's the cue to first list what hasn't been tried. Inverse of 2026-06-14-green-spike-breeds-false-confidence.md: a red result breeds false defeatism the same way a green one breeds false confidence.