docs(wiki): LLM-Wiki pilot — decisions/architecture knowledge base #162

Merged

clawdie merged 2 commits from wiki-pilot into main

2026-06-24 10:16:01 +02:00

clawdie commented

2026-06-24 09:58:58 +02:00

Owner

Pilot step 1 of the Karpathy LLM-Wiki pattern, scoped to decision-dense areas — a starting point to discuss, not a finished system.

What it is

An agent-maintained docs/wiki/ that records what was decided and links to where it lives in code. Code stays the source of truth; pages link rather than duplicate (per the decisions-match-shipped-code principle).

index.md — purpose, conventions (the "schema" that keeps the LLM a maintainer), the lint workflow, and the page catalog.
agent-harness.md — zot (agent) + Colibri (control plane) split; autospawn + the RPC driver (colibri#143); links to AGENTS.md, spawner.rs, socket.rs, the transcript, the smoke test.
naming-decisions.md — a living ledger of renames from superseded assumptions: shipped (COLIBRI_AUTOSPAWN_PI→, pi_session_id→session_id, fake→sample, …), in-flight (usb_nodes→hive_nodes, #161), and known residue (pi_type, FEATURE_COLIBRI, clawdie-startx, the dangling ADR-agent-harness-consolidation.md).
quality-gates.md — ci-checks.sh as the pre-merge gate and why drift reached main.

Why

Directly targets the "lingering old decisions" pain: one lintable place that ties decisions ↔ code, so half-finished renames and stale docs surface cheaply. It already captures real open drift found during the sweep.

Deliberately NOT included yet

The lint tool (an agent pass that diffs pages vs code, advisory/flag-only) — pilot step 2.
A mother-hive page — waits on #161.
Whole-repo coverage — pilot is intentionally narrow.

Markdown gate green. Uses Forge-clickable relative links as the wikilink convention (Obsidian [[ ]] adapted to a repo).

🤖 Generated with Claude Code

Pilot step 1 of the [Karpathy LLM-Wiki pattern](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f), scoped to decision-dense areas — a starting point to discuss, not a finished system. ## What it is An agent-maintained `docs/wiki/` that records **what was decided** and links to **where it lives in code**. Code stays the source of truth; pages link rather than duplicate (per the `decisions-match-shipped-code` principle). - `index.md` — purpose, conventions (the "schema" that keeps the LLM a *maintainer*), the **lint** workflow, and the page catalog. - `agent-harness.md` — zot (agent) + Colibri (control plane) split; autospawn + the RPC driver (colibri#143); links to `AGENTS.md`, `spawner.rs`, `socket.rs`, the transcript, the smoke test. - `naming-decisions.md` — a **living ledger** of renames from superseded assumptions: shipped (`COLIBRI_AUTOSPAWN_PI→`, `pi_session_id→session_id`, `fake→sample`, …), in-flight (`usb_nodes→hive_nodes`, #161), and known residue (`pi_type`, `FEATURE_COLIBRI`, `clawdie-startx`, the dangling `ADR-agent-harness-consolidation.md`). - `quality-gates.md` — `ci-checks.sh` as the pre-merge gate and why drift reached `main`. ## Why Directly targets the "lingering old decisions" pain: one lintable place that ties decisions ↔ code, so half-finished renames and stale docs surface cheaply. It already captures real open drift found during the sweep. ## Deliberately NOT included yet - The **lint tool** (an agent pass that diffs pages vs code, advisory/flag-only) — pilot step 2. - A `mother-hive` page — waits on #161. - Whole-repo coverage — pilot is intentionally narrow. Markdown gate green. Uses Forge-clickable relative links as the wikilink convention (Obsidian `[[ ]]` adapted to a repo). 🤖 Generated with [Claude Code](https://claude.com/claude-code)

clawdie added 1 commit 2026-06-24 09:59:02 +02:00

docs(wiki): LLM-Wiki pilot — decisions/architecture knowledge base

CI / rust (pull_request) Has been cancelled

Details

CI / markdown (pull_request) Has been cancelled

Details

CI / port (pull_request) Has been cancelled

Details

CI / agent-jail-pkgs (pull_request) Has been cancelled

Details

5b5058cff4

Pilot step 1 of the Karpathy LLM-Wiki pattern, scoped to decision-dense areas:
an agent-maintained docs/wiki/ that records WHAT was decided and links to WHERE
it lives in code (code stays the source of truth; pages link, don't duplicate).

Pages:
- index.md       — purpose, conventions (the 'schema'), lint workflow, catalog
- agent-harness  — zot (agent) + Colibri (control plane); autospawn + RPC driver
- naming-decisions — ledger of harness-neutral/architecture renames (shipped,
                   in-flight, and known residue) — the drift tracker
- quality-gates  — ci-checks.sh as the pre-merge gate; why drift reached main

Intent: make the 'lingering old decision' bookkeeping near-zero-cost and
lintable. Lint tool itself (advisory, flag-don't-rewrite) is the next pilot step.
Already records real open drift (e.g. the dangling ADR reference).

Markdown gate green.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

claude-domedog added 1 commit 2026-06-24 10:14:15 +02:00

docs(wiki): ledger entry — single home for mother infra (colibri)

CI / rust (pull_request) Has been cancelled

Details

CI / markdown (pull_request) Has been cancelled

Details

CI / port (pull_request) Has been cancelled

Details

CI / agent-jail-pkgs (pull_request) Has been cancelled

Details

ddc0780d66

Records the dedup decision + the cross-repo drift lesson (an injectable
node-register-mcp copy reached iso main). The kind of regression a lint pass
should catch.