agents-project-memory

# Project Memory for Claude Code + Codex (Jan 2026) Configure project memory so Claude Code and Codex get stable, scoped instructions across sessions while keeping token cost low. Use a single source of truth: keep `AGENTS.md` as primary and symlink `CLAUDE.md` to it. ## Quick Reference | Memory Type | Typical Location | Purpose | |------------|------------------|---------| | Managed policy | OS-dependent (see official docs) | Organization-wide standards (security, compliance) | | Project memory | `./AGENTS.md` (primary) + `./CLAUDE.md` (symlink → AGENTS.md) | Shared project context and conventions | | Project rules | `./.claude/rules/*.md` | Modular, topic-focused rules (testing, security, style) | | User memory | `~/.claude/CLAUDE.md` | Personal preferences across projects | | Project memory (local) | `./CLAUDE.local.md` (git-ignored) | Local-only, project-specific preferences | ### How Loading Works (High Level) **Claude Code (CLAUDE.md symlink)**: - **Recursive loading**: from the current working directory up to (but not including) filesystem root (`/`). - **On-demand loading**: nested `CLAUDE.md` files under the cwd are loaded only when Claude reads files in those subtrees. - **Imports**: `@path/to/file` pulls in additional context (max depth: 5; `~` supported). **Codex (AGENTS.md primary)**: - Reads `AGENTS.md` in the repo root or working directory. - Keep it concise; mirror the same content as `CLAUDE.md` when supporting both tools. ## Workflow (Best Practice) ...