Truffle Hunting

Overview

A bug class is one mechanism that recurs across many codebases. Hunting it is different from debugging: you already know the shape of the bug, and the work is finding every instance, proving each one, and not fooling yourself about the ones that look clean.

This skill is the reusable machinery — the dog, not the truffle. The scents — the specific APIs, the mechanism, the measurements — live in a per-class scent library, a companion skill naming one bug class and everything learned hunting it. Pair this skill with whichever scent library matches the class you are chasing; if none exists yet, §1 is how you start one.

Core principle: the hunt's output is a set of labelled verdicts, not a list of bugs. A dependency cleared by execution is as valuable as a bug found, and an unlabelled claim is worth nothing. Most of the discipline below exists to stop a broken thing from looking clean.