preference-and-memorylisted

# 04 — Preference and Memory ## Auto-memory system Persistent file-based memory at `/Users/Apple/.claude/projects/<encoded-path>/memory/`. Write directly via Write tool. ## Memory types - **user** — role, goals, responsibilities, knowledge - **feedback** — guidance on how to approach work (corrections AND confirmations) - **project** — ongoing initiatives, bugs, incidents, who/why/when - **reference** — pointers to external resources ## Capture triggers - User explicitly says "remember X" / "save Y" → save immediately - Correction ("no not that", "don't") → feedback memory - Confirmation of unusual approach ("yes exactly", "perfect") → feedback memory - New role / preference / responsibility detail → user memory - Project milestone / decision / deadline → project memory - External system reference ("check the Linear project X") → reference memory ## Memory file format ```markdown --- name: {short-kebab-case-slug} description: {one-line summary — used for relevance ranking} metadata: type: {user | feedback | project | reference} --- {memory content} ``` For feedback/project: lead with rule/fact, then `**Why:**` line + `**How to apply:**` line. ## Memory routing - **Universal (across all projects)** → `~/.claude/` - **Project-specific** → `./.claude/` (path-scoped) - **Project memory file** → `~/.claude/projects/<encoded-path>/memory/<name>.md` + index in `MEMORY.md` ## MEMORY.md index One-line pointer per file: ```md - [Title](file.md) — one-line hook ``` Kee