skinny.

Latest / Outgrowing the Vibe Code

Writing One That Actually Works

Knowing what belongs in an AGENTS.md and actually writing a good one are two different skills. Ada and Boris cover the four cardinal rules: keep it under sixty lines (research out of ETH Zurich found that agent-generated instruction files actually degraded performance by over twenty percent), be concrete instead of abstract, make it iterative, and don't duplicate what a linter already enforces. They walk through progressive disclosure — giving the agent the essentials up front and pointing to deeper docs only when needed — plus what never belongs (decision history, aspirational goals…

The skinny

The skinny isn't ready yet — notes appear once the transcript is processed.