# Architecture

## Three layers

### 1) Raw sources (`../raw/`)
- Curated, **immutable** source documents.
- Articles, papers, transcripts, images, datasets.
- The “source of truth”.

### 2) Wiki layer (`./`)
- LLM-maintained markdown pages: summaries, concept pages, entity pages, comparisons, synthesis.
- This is what we query most of the time.
- Updated incrementally as new sources arrive.

### 3) Schema (conventions)
- The rules that govern structure, naming, page types, and workflows.
- In this repo, start with: [[05 NoxPKB/README]] (can evolve).

## Why this architecture
- Shifts work from repeated query-time synthesis to **one-time ingest + ongoing maintenance**.
- Enables compounding knowledge via cross-links and curated pages.
- Makes contradictions and gaps visible and actionable.
