The Case for Contract-Style Comments: Making Implicit Assumptions Explicit
By Jeffrey Sabarese (@ajaxStardust)
With foundational work by Claude Sonnet, and insights from Claude Haiku via Zed Editor

Preamble: How This Started
I was debugging a complex LLM integration in an app with many-to-many relationship tables when I realized something: most of my code's failures weren't syntax errors—they were contract violations. Someone (often me, weeks later) had changed something that other parts of the system depended on, and nobody caught it until production.
The key insight: CONTRACT comments ...
