The Docs Nobody Read
Two hundred pages of hard-won patterns. Every one of them paid for in production incidents. Nobody opened them.
AI Agents¶
Designing Error Messages AI Agents Can't Misinterpret
AI coding assistants are increasingly the first responders to pre-commit failures and CI errors. The error messages your CLI produces directly influence how these agents attempt fixes. Often, these fixes happen without human review.
Here's how to design CLI output that guides AI agents toward correct remediation.