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>
38 lines
1.8 KiB
Markdown
38 lines
1.8 KiB
Markdown
---
|
|
tags:
|
|
- meta
|
|
- protocol
|
|
updated: 2026-05-29
|
|
permalink: 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 native `MEMORY.md`.
|
|
|
|
Driven by the `/dots-dev` skill; this scaffold was created by the one-time setup task. |