Codex Instructions Template
An AGENTS.md-skeleton tuned for OpenAI Codex CLI: same identity-layer content, Codex-specific execution notes. Copy it below, fill the bracketed fields, delete what you don't need.
# AGENTS.md (Codex)
## Project overview
[Two sentences: what this is, what must not break.]
## Commands
- Build: `[command]`
- Test: `[command]` (Codex: run before proposing any diff)
- Lint: `[command]`
## Conventions
- [Rules a linter does not enforce]
## Directory map
- `src/` - [what lives here]
## Do not touch
- `[path]` - [why]
## Codex-specific notes
- Sandbox: [what network/file access the environment allows]
- Approval mode: [suggest / auto-edit / full-auto, and when each is acceptable]
- Diff etiquette: [patch size limits, one-concern-per-diff rules]
Field notes
| Field | Why it matters |
|---|---|
| Approval mode | Codex's approval levels are its permission profile. State which mode is acceptable for which work; this is a governance decision, not a convenience setting. |
| Sandbox | Codex environments vary in network and filesystem access; stating it here prevents the agent discovering limits mid-task. |