Getting good at evals: Build a taxonomy of failure modes

realmadhuguru · x · 2026-08-20

Part 3 of a series on getting good at evals. The author advises that once you have v1 of your evals, the first thing to do is build a taxonomy of your AI system's failure modes. The process involves studying the last 500-1000 production traces, focusing on failures, and clustering/naming them. The article emphasizes specificity: instead of "bad answer," failures should be categorized precisely, such as "wrong document retrieved," "right document but irrelevant section," "failed to ground to context and hallucinated," "failed to punt and instead made stuff up," or "ambiguous question with poor assumptions." Precise naming allows for designing eval tests to catch specific failures, bridging the gap to an improvement flywheel.

Related event: Eval Guide: Build a Failure Taxonomy to Drive AI Improvements(2 posts)→

Original post →

More from coding & agent

coding & agent channel →