kronic
4ac1ae5a2e
Realigns the skill with how sessions actually run now — it predated the Workflow tool and the ultracode two-review practice. Driven by an analysis of the full session history + the 26-file memory corpus + skill-authoring research, adversarially reviewed. Key changes: - Workflow-first orchestration: drop the dead manual "swarm (<=N agents)" model and the impossible 3-5-agent impl swarm; implementation is serial orchestrator MCP edits. New references/workflow-patterns.md (ground fan-out + design-review lens/critic) replaces agent-briefs.md. - Pre-code design-review + post-impl diff-review are now first-class gated phases (the spine that catches what green tests + a clean Play miss). - Size by blast-radius / netcode-heaviness, not time estimates. - Lean SKILL.md (222 -> 131 lines, -25% KB): leans on CLAUDE.md instead of duplicating its MCP cheat-sheet / anti-patterns / error-recovery. - ctx7 CLI / find-docs mechanism (the MCP verbs are gone); live-verified 6.5-era library pins; kill the dead NetCodeTestWorld test path. - Encode operator gates (no-time-estimates, present-forks, never-defer, tuning-autonomy) + the highest-recurrence MCP-edit / Workflow gotchas. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2.6 KiB
Memory & Documentation Protocol
How /dots-dev reads and writes knowledge. CLAUDE.md's "Memory — four layers" section is authoritative for the layer definitions and the which-tool-when routing (in-repo vault · basic-memory · serena · native memory/) — this file does not re-table them; it carries the session bookends and the fallback chain.
Cross-machine rule: anything that must be true on both the Mac and Windows machines goes in the vault (Docs/Vault/) or CLAUDE.md (both committed). Native memory/ is machine-local convenience — never the sole home of a decision or design fact.
Session bookends (non-negotiable for non-trivial work)
Start — scan (read-only):
CLAUDE.md(repo root).- Vault map of content + latest session log (
07_Sessions/<year>/). - Open decision records (
_Decisions/status: proposed) + roadmap/backlog. basic-memoryrecall on the goal's nouns; nativeMEMORY.md+memory/.
End — update (Phase 8):
- Session log → the vault (obsidian-cli or direct Write).
- Firm decisions → decision records, back-referenced from the log. The kept design-review Build Spec feeds the DR (don't re-derive it).
- Touched design docs edited in place (wikilink, don't duplicate into the log).
- Durable cross-machine knowledge → a
basic-memorynote in the vault; machine-local facts/feedback → nativeMEMORY.md(+ a memory file if substantive). - CLAUDE.md self-maintenance — if a new build gotcha or convention emerged, fold it in under the 40 KB budget (archive the displaced detail to the gotchas archive, don't delete). Never silently defer this — do it now or explicitly ask the operator to defer.
If the operator says "skip the protocol," still write a one-line stub session log so the gap is visible, and record the preference as a native feedback memory.
Fallbacks
- No obsidian-cli configured → direct
Read/WriteonDocs/Vault/**(it's plain markdown; Obsidian/basic-memory pick up changes on next index). This is the operative path on a fresh machine. - basic-memory down → obsidian-cli search +
Grepover the vault. - serena C# unavailable / stalls on the Unity solution →
Glob/Grep(orclaude-context/LanceDB if it was added as the documented fallback).
Setup pointer
The vault scaffold, the basic-memory/serena .mcp.json entries (using ${CLAUDE_PROJECT_DIR}), and CLAUDE.md are created by the one-time project setup task (Docs/dots-setup-task.md), not by this skill. If this skill runs and the vault or memory MCPs are missing, it notes the gap and points to that setup task.