Only what the task needs
Two root files. Only the references your task needs.
Project memory
2 of 6 topic files loaded
CLAUDE.mdCore Claude Code rules, with links to references the task needs.every sessionAGENTS.mdCodex rules, with shared references for both agents.every session.claude/reference/architecture.mdHow the project fits together, and why.this taskskippedpitfalls.mdKnown failures, their causes, and verified fixes.this taskskippedcommands.mdBuild and test commands. Check them against the current project.this taskskippeddeployment.mdRelease requirements. Deployment still needs authorization.this taskskippedtech-stack.mdProject tools and versions. Current source takes priority.this taskskippedsecrets.mdSecret names and locations only. Never credential values.this taskskipped
Root files are read every session.
Fix a bug → architecture.md + pitfalls.md
One lesson
Across sessions
STAGE 01 OF 04 · PICK A STAGE TO STOP AUTOPLAY
MEMORY LIFECYCLEMEMORY RULES
What earns a place
Worth saving +
A confirmed pitfall that cost a retry, a backed-out change, or a user correction is saved without asking; other facts need permission. Every save meets all three:
- Changes future decisions; costly to rediscover.
- A lasting constraint, decision, or recurring pitfall.
- Evidence supports it; uncertainty stays clear.
Keep it focused +
Keep task updates and one-off errors in working notes. Keep local details out of root instructions and secret values out of memory. Saving grants no permission to commit, push, or share across repos.
Review what gets used +
The audit counts recorded reads, writes, and skill use in local Claude transcripts. Coverage is partial; Codex is excluded. Review unread notes before removing them.
Keep it current +
Check notes against current code and behavior. Before a pull request, notes that cite a changed file are re-read, then kept, amended, or retired. Retain exceptions and refresh dated evidence.