Every major coding agent automatically reads one file before it looks at a single line of your code — Claude Code reads CLAUDE.md, Codex reads AGENTS.md, Cursor reads .cursorrules. It's the one piece of context you're guaranteed the agent has every session, which means every line in it competes for space the agent needs to read your actual code. Ada and Boris break down the six things that actually belong in that file: build and test commands (the highest-impact section, because it lets the agent verify its own work instead of guessing), project structure as a mental model rather than a file listing, coding conventions the linter doesn't already catch, the three to five most critical architecture rules, git workflow, and a Common Mistakes section that starts empty and grows with every real correction.
From Chapter 6 of *Harness Engineering for Vibe Coders* by J.M. Crider — hamiltonroadagility.com/vibe
## Chapters
- 0:00 — Intro- 1:39 — The File the Agent Always Reads- 3:39 — Build and Test Commands- 5:20 — Structure, Conventions, and Architecture- 7:11 — Git Workflow and Common Mistakes- 8:37 — Recap- 9:51 — Wrap-up