kortex

Personal knowledge base powered by the LLM Wiki protocol.

Wiki pages use Open Knowledge Format (OKF) v0.2 for structured frontmatter, including provenance (generated), human sign-off (verified), and freshness expiry (stale_after) fields.

Structure

kortex/
├── CLAUDE.md        ← operational schema (read first)
├── raw/             ← immutable source documents
├── wiki/            ← LLM-maintained synthesis
│   ├── index.md     ← content catalog
│   ├── log.md       ← activity log
│   ├── schema.md    ← page templates
│   └── <domain>/    ← knowledge domain directories
└── docs/            ← project documentation (Diátaxis)
    ├── tutorials/   ← learning-oriented
    ├── how-to/      ← task-oriented
    ├── reference/   ← information-oriented
    └── explanation/ ← understanding-oriented

Workflow

Operation	Trigger
Ingest	Drop file in raw/, say "Ingest raw/<file>"
Query	Ask any question — relevant wiki pages are consulted
Lint	Say /lint — checks for broken links, stale pages, orphans
File back	Insights from conversation get filed as new wiki pages

Documentation

Project documentation lives in docs/ and follows the Diátaxis framework, which organizes docs by user need rather than by file layout:

Type	Purpose	When to read
Tutorials	Learning-oriented, hands-on lessons	New to Kortex — start here
How-to Guides	Task-oriented, goal-driven steps	You know the basics, need a task done
Reference	Information-oriented specifications	Look up entity types, frontmatter, skills
Explanation	Understanding-oriented background	Understand the architecture and design choices

Start at docs/README.md for the navigation index. Architectural decisions are recorded as ADRs under docs/decisions/adr/.

Getting Started

1. Read CLAUDE.md — the operational protocol
2. Add a source to raw/
3. Say: "Ingest raw/<filename>"