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.

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 — system overview
• workspace-isolation.md — why Linux users; what POSIX guarantees
• attention-gating.md — the 5-level ladder, discriminator prompt
• linq-protocol.md — what Linq's events look like

Inheritance & positioning

• cortex-inheritance.md — R1-R19 adopt/adapt/reject/defer map
• piyush-era-design.md — study of pre-container Cortex; source of Option 2
• relationship-to-noos.md — what picortex shares with noos, and what it doesn't
• openchat-adapter.md — future third channel
• repo-versions.md — GitHub latest-sha pins for every referenced repo

Ops

• 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 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.