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 session
  • AGENTS.mdCodex rules, with shared references for both agents.every session
  • .claude/reference/
    • architecture.mdHow the project fits together, and why.this taskskipped
    • pitfalls.mdKnown failures, their causes, and verified fixes.this taskskipped
    • commands.mdBuild and test commands. Check them against the current project.this taskskipped
    • deployment.mdRelease requirements. Deployment still needs authorization.this taskskipped
    • tech-stack.mdProject tools and versions. Current source takes priority.this taskskipped
    • secrets.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 LIFECYCLE

MEMORY 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.