Knowledge Vault

**English** | [中文](README.zh-CN.md)

Knowledge Vault — AI-agent-operated cross-project knowledge system

An Obsidian vault template designed to be operated by Claude Code as an agent. Mirrors docs from multiple code projects into a read-only area, then distills cross-project patterns into a writeable notes area. Ships with sync scripts and a behavior contract ([`AGENT-GUIDE.md`](AGENT-GUIDE.md)) for the agent. Methodology only — no real project docs included; bring your own.

---

Why this vault exists

Every code project has its own `docs/`. But cross-project insight has no home:

• The same class of bug that multiple projects independently stepped on (missing format conversions at boundaries, baseline contamination…)
• Engineering consensus that multiple projects independently arrived at ("use name, not UUID, for cross-roundtrip identity")
• Evolution asymmetries — one project solved it, another hasn't hit it yet

These cross-project insights are worth more than any single-project doc, but nobody maintains them by hand — unless there's a stable place for them and someone whose job is to distill.

**This vault gives cross-project insight a home and puts an AI agent in charge of distilling it — so you don't have to copy-paste it by hand.**

---

How it works

┌────────────────────┐  sync (one-way force overwrite)  ┌─────────────────────┐
│ your project/docs/ │ ────────────────────────────────→│ vault/mirror//│  ← read-only
└────────────────────┘                                  └─────────────────────┘
                                                                  │
                                                                  │ agent reads + distills
                                                                  ↓
                                                        ┌─────────────────────┐
                                                        │ vault/notes/        │  ← agent's only