bug-autopsy

The key words MUST, MUST NOT, SHOULD, SHOULD NOT and MAY in this skill are to be interpreted as described in BCP 14 (RFC 2119, RFC 8174) when, and only when, they appear in all capitals.

feynman-walkthrough's sibling for failures. Where that skill walks a learner through a healthy system, this one walks a failure that already happened — trigger → propagation → detection → fix — and leaves behind a blameless post-mortem the next engineer can audit link by link. The failure is treated as material to learn from, not a fire to fight: if the incident is still burning, triage first and come back.

Locating this skill's helpers (do this first). The steps below run bundled scripts. You execute from the target repo, not from this skill's directory, so a path written relative to this skill will not resolve. Resolve the base directory once and use it everywhere — including in any subagent prompt, which MUST receive the literal absolute path: