Vault Layout

中文 | English

Default vault structure for this skill:

<vault-root>/
├── .git/
├── AGENTS.md
├── raw/
├── wiki/
│   ├── answers/
│   ├── concepts/
│   ├── entities/
│   ├── sources/
│   └── topics/
├── index.md
└── log.md

Global skill defaults live outside the vault:

~/.llm-wiki/
└── config.json

Suggested global config shape:

{
  "root": "/absolute/path/to/your/wiki-vault",
  "raw_dir": "raw",
  "wiki_dir": "wiki",
  "index_file": "index.md",
  "log_file": "log.md",
  "schema_file": "AGENTS.md"
}

Meaning of each layer:

• git repo: versioned history of the vault
• raw sources: source-of-truth material whose substance stays stable even if paths are reorganized
• wiki pages: LLM-maintained summaries, entities, concepts, syntheses
• index: stable entry point into the wiki
• log: reverse-chronological operational history
• AGENTS.md: vault-specific maintenance rules

Recommended source-to-page mapping:

• one raw source file
• one corresponding wiki/sources/*.md page
• zero or more updates to concept, entity, and topic pages

Optional raw-media conventions:

• raw/screenshots/ for standalone screenshot sources
• raw/assets/ for local image attachments referenced from markdown raw sources

Recommended categories:

• concepts/ for reusable ideas or frameworks
• entities/ for people, orgs, tools, products, projects
• topics/ for broader domains that aggregate many concepts
• sources/ for per-source notes and citations
• answers/ for durable outputs created during query work