new file mode 100644
index 0000000..48ed856
@@ -0,0 +1,54 @@
+---
+visibility: public
+---
+
+# picortex LLM Wiki — Index
+
+This wiki is maintained primarily by coding agents (Claude Code, Codex CLI). It is a graph of cross-linked concept pages — not a linear narrative. When a new source is ingested, the responsible agent updates affected pages and appends an entry to [`log.md`](log.md).
+
+Style: Karpathy-ish. Pages are short, focused, opinionated, cross-referenced. When a claim should link to a file, it links to a file.
+
+## Categories
+
+### Core concepts
+
+- [architecture.md](architecture.md) — system overview
+- [workspace-isolation.md](workspace-isolation.md) — why Linux users; what POSIX guarantees
+- [attention-gating.md](attention-gating.md) — the 5-level ladder, discriminator prompt
+- [linq-protocol.md](linq-protocol.md) — what Linq's events look like
+
+### Inheritance & positioning
+
+- [cortex-inheritance.md](cortex-inheritance.md) — R1-R19 adopt/adapt/reject/defer map
+- [relationship-to-noos.md](relationship-to-noos.md) — what picortex shares with noos, and what it doesn't
+- [openchat-adapter.md](openchat-adapter.md) — future third channel
+- [repo-versions.md](repo-versions.md) — GitHub latest-sha pins for every referenced repo
+
+### Ops
+
+- [observability-patterns.md](observability-patterns.md) — placeholder; populated when implementation starts
+
+## Maintenance protocol
+
+When a coding agent completes a significant unit of work:
+
+1. Update the affected wiki pages (no more than necessary).
+2. Append to [`log.md`](log.md) with format:
+ ```
+ ## [YYYY-MM-DD] <kind> | <short description>
+ - what changed
+ - which pages updated
+ - beads ticket(s)
+ ```
+3. Don't delete pages — mark them deprecated with a header banner and a pointer to the replacement.
+
+## Search
+
+Until a real search exists: `rg -n` against `docs/wiki/`.
+
+## Orphan / lint policy
+
+Quarterly, an agent runs:
+- Find pages with no inbound links (orphans) — decide: keep as reference, link from relevant pages, or deprecate.
+- Find broken cross-references — fix.
+- Find contradictions — flag for human review.
\ No newline at end of file