Skip to content

Commit 896cc77

Browse files
wphillipmoorewphillipmoore-claude
andauthored
docs: ban MEMORY.md usage in CLAUDE.md (#339)
Add auto-memory policy requiring agents to discuss behavioral rules with the human rather than storing them in unmanaged MEMORY.md files. Co-authored-by: wphillipmoore-claude <255925739+wphillipmoore-claude@users.noreply.github.com>
1 parent 7f8962f commit 896cc77

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

CLAUDE.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,26 @@
22

33
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
44

5+
## Auto-memory policy
6+
7+
**Do NOT use MEMORY.md.** Claude Code's auto-memory feature stores behavioral
8+
rules outside of version control, making them invisible to code review,
9+
inconsistent across repos, and unreliable across sessions. All behavioral rules,
10+
conventions, and workflow instructions belong in managed, version-controlled
11+
documentation (CLAUDE.md, AGENTS.md, skills, or docs/).
12+
13+
If you identify a pattern, convention, or rule worth preserving:
14+
15+
1. **Stop.** Do not write to MEMORY.md.
16+
2. **Discuss with the user** what you want to capture and why.
17+
3. **Together, decide** the correct managed location (CLAUDE.md, a skill file,
18+
standards docs, or a new issue to track the gap).
19+
20+
This policy exists because MEMORY.md is per-directory and per-machine — it
21+
creates divergent agent behavior across the multi-repo environment this project
22+
operates in. Consistency requires all guidance to live in shared, reviewable
23+
documentation.
24+
525
## Documentation Strategy
626

727
This repository uses two complementary approaches for AI agent guidance:

0 commit comments

Comments
 (0)