A proposed convention for the .agents/ directory to prevent context bloat and improve agent reasoning in complex codebases.

Stop agents from over-engineering. Inspired by Ponytail, but without the plugin madness. Just one AGENTS.md file.

Air traffic control discipline for agent output. Written for a reader with ADHD.

HERO = Hashing · Edge cases · Rubrics · Overbuild — the four shapes coding agents over-defend in. A paste-in contract that stops them. Works with Claude Code, Codex, Antigravity, Cursor, Copilot, Windsurf, Gemini CLI.