Project memory files

Files like CLAUDE.md and AGENTS.md give agents lasting project context.

📖 Key ideas

CLAUDE.md (Claude Code) and AGENTS.md (Codex and others) hold project rules the agent reads each session.
Include build, test and run commands.
List conventions: folder layout, naming, code style, things to avoid.
Keep it short and current; outdated rules mislead the agent.
Commit it so the whole team shares the same guidance.

💡 Real-life example: Like the staff handbook on a new employee's desk: how we do things here, read before starting.

CLAUDE.mdProject instructions file for Claude Code

AGENTS.mdShared agent instructions file

ConventionAgreed way of doing things

Build commandCommand that compiles or bundles the project