Project instructions for any agent Factual
- Claude Code
- Loaded into the context when the session starts, every time.
- Codex
- Loaded into the context when the session starts, every time.
- Shared with your team
- Yes, committed to Git.
What it is for
The map of the project: how to build and test it, rules that are easy to break, and where the deeper documents live. Shared by every agent and every teammate.
A small example
# My app - Run `npm test` before you call anything done. - Never edit files in `generated/`. - Architecture: docs/architecture.md
Common mistakes
- Writing an encyclopedia. Every line is paid for on every turn of every session.
- Restating what the code already shows.
- Rules that a script could check instead.
How we know: Codex: AGENTS.md documentation. Claude Code: tested in fresh headless sessions of 2.1.319 on 2026-11-08 with codeword files. With no CLAUDE.md, AGENTS.md loaded at the start. With a CLAUDE.md beside it and no import line, AGENTS.md was ignored.
- Custom instructions with AGENTS.md OpenAI
- How Claude remembers your project Anthropic