kb-template CLAUDE.md

Knowledge Base — Schema

Portability note: This file is named CLAUDE.md for Claude Code. Rename it to match your LLM agent's convention (e.g. AGENTS.md for Codex). The instructions are AI-agnostic.

This is an LLM-maintained knowledge base. The LLM writes and maintains all wiki content. The human curates sources, directs analysis, and asks questions. All data is stored as plain files in universal formats (markdown, images) — the human owns the data and can use any AI agent or tool over it.

Architecture

Three layers:

• raw/ — Immutable source documents. Articles, papers, images, data files. The LLM reads from these but never modifies them. This is the source of truth.
• wiki/ — LLM-generated and LLM-maintained markdown files. Summaries, entity pages, concept pages, comparisons, synthesis. The LLM owns this layer entirely.
• output/ — Generated artifacts (reports, slide decks, charts). These are outputs of Q&A and analysis operations.

Wiki conventions

Page format

Every wiki page must have YAML frontmatter:

---
tags: [topic-a, topic-b]
date: YYYY-MM-DD
sources: 3
---

• tags: relevant topic tags
• date: creation date of the page
• sources: count of raw sources that contributed to this page

Links

Use [[wikilinks]] for all internal links. Never use [text](path.md) style.

Page structure

Each page should follow this pattern:

---
frontmatter
---

# Page Title

Main content with [[wikilinks]] to related concepts.

## Sources

- [[raw/articles/source-file]]

Special files

• wiki/index.md — Content catalog. Every wiki page listed with a link, one-line summary, and metadata. Organised by category. The LLM reads this first when answering queries.
• wiki/overview.md — Top-level synthesis page. A narrative that ties together the main themes, key findings, open questions, and tensions across all sources. Not a table of contents — that's the index. Update this whenever an ingest shifts the big picture.
• wiki/log.md — Append-only chronological record of operations. Each entry uses the format ## [YYYY-MM-DD] type | Title where type is one of: ingest, query, lint, update. This format is grep-friendly: grep "^## \[" wiki/log.md | tail -5.