Update or create documentation so Cursor, Claude Code, and humans can orient fast. Prefer accurate, short, linked text over long dumps that will go stale.
- Preferred: Add or update
AGENTS.mdat the repository root. Many tools and agents treat this as the machine-oriented map. Keep it factual: build, test, layout, conventions. - If the repo already has a strong human
README.md: Add a short “For contributors / agents” subsection that links toAGENTS.mdinstead of duplicating everything.