diff --git a/CHANGELOG.md b/CHANGELOG.md index 91085e7..b4ac739 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,17 @@ See [ADR 0009](./adr/0009-methodology-as-versioned-dependency.md). ## [Unreleased] +### Added + +- **Personal memex pointer in the global summary** — + `templates/global-CLAUDE.md` gains a clearly-labeled *personal tooling* + section wiring AI agents to the memex MCP memory server (search at the + start of substantial work, write at the end), with the guardrail that + durable decisions stay in the repo artifacts, not memex (ADR 0022). **Not + a methodology change** — `methodology.md` stays tool-agnostic. *Adoption: + none — personal wiring; consuming projects copy `project-CLAUDE.md`, not + the global summary.* + ## [0.12.0] - 2026-06-21 ### Added diff --git a/templates/global-CLAUDE.md b/templates/global-CLAUDE.md index 81e2667..823716b 100644 --- a/templates/global-CLAUDE.md +++ b/templates/global-CLAUDE.md @@ -95,3 +95,19 @@ sign-off, never folded into an implementation PR; show "done" by citing the passing test (for a fix, also the failing run before it), don't assert it; re-read a file before you edit it; surface drift you notice rather than papering over it. + +## Personal tooling — agent memory (memex) + +*Not part of the shared methodology (`methodology.md` stays tool-agnostic); +this is my personal wiring — drop it if you copy the methodology.* When the +**memex** MCP server is connected, use it as cross-session working memory: + +- **Starting substantial work:** `mcp__memex__memory_search` (and + `memory_get_project`) for relevant prior context before diving in. +- **Finishing substantial work:** `memory_write` / + `memory_summarize_and_store` what's worth recalling later — open threads, + gotchas, where things live. +- **Guardrail — memex is recall, not the record.** Durable decisions, terms, + and structure still live in the repo's artifacts (ADRs, glossary, specs, + `architecture.md`). memex points at and recalls them; it never becomes a + second, un-versioned home for them (single source of truth, ADR 0022).