An agent-friendly project is not a project with the most documentation. It is one where the documents closest to a decision are current, modest, and easy to verify.
What changes in practice
Make the intended path easier to find than the clever path.
$ codex exec "review the changed boundary"
→ reading the scoped files
✓ focused checks passedMake the intended path easier to find than the clever path.
Keep an example payload beside an interface, a visual reference beside a visual component, and a focused test command beside a fragile behavior. These are navigation aids, not bureaucracy.
The result is a calmer workflow for everyone. Contributors spend less time guessing which patterns are alive, and reviewers spend more time on actual tradeoffs.
Keep this close
- Current examples beside contracts
- Screenshots for visual intent
- Focused checks beside fragile behavior