concept-doc-store
Installation
SKILL.md
Concept doc store (vectorless)
Maintain documentation as a git-native, linkable lattice—not an embedding index. Agents and humans navigate by role and question, then jump to code, examples, and tests for behavior.
Reference layout: structured repository documentation directories (docs/start_here/docs_map.mdx, docs/decisions/, docs/superpowers/). Complements faq-driven-docs (package-level DESIGN_FAQ / DX_FAQ).
Core rule — three sources of truth
| Need | Authoritative source | Docs must… |
|---|---|---|
| How code behaves | Code, examples, tests | Link (Authoritative source: path/) — never paraphrase implementation |
| Why we chose X | ADRs, DESIGN_FAQ | Compress decision + trade-off only |
| How to use the product | DX_FAQ, guides, skills | Patterns and commands; defer API detail to examples |
If a doc paragraph could be replaced by reading a file or running an example, delete the paragraph and add a link.
Doc lattice (layers)
Build only layers the repo needs. See references/layer-catalog.md.