kronic
7b64c1caa3
Serena dropped from .mcp.json + .serena/ untracked (unused in practice, flaky on Unity per CLAUDE.md's own caveat); memory stack is now three layers. Standing auths recorded in the skill: docs auto-commit + auto-push main->gitea (origin stays ask-first). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1.8 KiB
1.8 KiB
tags, updated, permalink
| tags | updated | permalink | ||
|---|---|---|---|---|
|
2026-05-29 | gamevault/meta/documentation-protocol |
Documentation Protocol
How knowledge is read and written for Project M. Four layers, each with a distinct job; the in-repo vault is the single source of human-facing, cross-machine truth.
Layers
| Layer | Holds | Crosses machines? |
|---|---|---|
This vault (Docs/Vault/) |
Design docs, decision records, session logs, roadmap | Yes (git) |
| basic-memory MCP | Semantic + wikilink recall over these same vault files | Yes (indexes the vault) |
| Native Claude memory | Machine-local facts / preferences (memory/, MEMORY.md) |
No |
serena MCP (C# symbol nav) REMOVED 2026-07-07 — unused in practice + flaky on Unity; C# navigation =
Grep/Glob.
Cross-machine rule: durable truth → vault or repo CLAUDE.md (both committed). Native memory is local-only, never the sole home of a decision or design fact.
Which tool when
- Where is X defined / who calls it → Grep / Glob.
- What did we decide / how does system Z work → basic-memory recall → read the note here.
- Literal string / asset GUID → Grep / Glob.
- Current DOTS / Netcode API → context7 (never memory).
- Conventions / preferences → repo
CLAUDE.md+ native memory.
Session bookends
- Start (read-only):
CLAUDE.md→ Home + latest session log → open decision records + Backlog → basic-memory recall on the goal's nouns. - End: write a session log (
07_Sessions/<year>/) → firm decisions to DR records → edit touched design docs in place (wikilink, don't duplicate) → durable knowledge to basic-memory, machine-local facts to nativeMEMORY.md.
Driven by the /dots-dev skill; this scaffold was created by the one-time setup task.