Sam & Claude
b8d499e85c
7 renames (no plan/proposal/handoff/enhancement in filenames):
CLAWDIE-INSTALLER-HANDOFF.md → CLAWDIE-INSTALLER-VALIDATION.md
CLAWDIE-STUDIO-PROPOSAL.md → CLAWDIE-STUDIO.md
COLIBRI-SKILLS-PLAN.md → COLIBRI-SKILLS.md
FREEBSD-BUILD-LANE-HANDOFF.md→ FREEBSD-BUILD-LANE.md
GLASSPANE-TUI-ENHANCEMENTS.md→ GLASSPANE-TUI-DESIGN.md
MULTI-AGENT-HOST-PLAN.md → MULTI-AGENT-HOST.md
PLAN-WIKI-CLAWDIE-SI.md → WIKI-CLAWDIE-SI.md
16 cross-references updated across 10 files.
wiki-lint --strict: PASS (146 refs, 0 failures).
6.8 KiB
| title | description |
|---|---|
| Colibri Wiki | Zbirka znanja o odločitvah in arhitekturi Colibri — utemeljitve, ki jih koda ne more izraziti. |
Zbirka znanja o Colibrijevih odločitvah in arhitekturi — po vzoru vzorca LLM Wiki Andreja Karpathyja.
Vsak večji podsistem ima stran, ki beleži zakaj je bil zgrajen tako, kot
je — utemeljitve, ki jih koda ne more izraziti. Izvedbena dokumentacija v
docs/ pokriva kako; te strani pokrivajo zakaj.
Zakaj to obstaja
Zastarele odločitve se kopičijo hitreje, kot jih kdorkoli ročno pregleda:
preimenovanje, ki je bilo samo napol uporabljeno, dokument, ki še vedno
opisuje staro zasnovo, privzetek, ki je ostal od presežene izbire. Več
nedavnih prehodov je bilo porabljenih prav za iskanje tega (pi → zot,
usb_nodes → hive_nodes, podedovano preimenovanje v sample). Ta wiki naredi
knjigovodstvo skoraj brezstroškovno: eno mesto, ki beleži kaj je bilo
odločeno, povezuje na kje v kodi živi in ga je mogoče lintati za odmik.
Konvencije (shema)
Ta pravila ohranjajo wiki kot vzdržljiv artefakt, ne kot drugi vir resnice:
- Koda je vir resnice. Strani opisujejo odločitve in kje živijo; povezujejo na kodo/dokumentacijo, namesto da bi ponovno razlagale izvedbo. Ko je odločitev dostavljena, skrči stran na "kako deluje + povezava."
- Povezuj, ne podvajaj. Sklicevanje na kodo kot
pot/do/datoteke.rs:vrsticain druge wiki strani z relativnimi povezavami ([oznaka](./stran.md)) — klikljivo v Forgeju, ustreznik Obsidianovih[[wikipovezav]], prilagojen repozitoriju. - Ena odločitev na stran, kjer je to izvedljivo; obilno navzkrižno povezuj.
- Označi, ne tiho prepiši. Ko nova koda nasprotuje strani, zabeleži nasprotje (in ga razreši), namesto da bi tiho urejal zgodovino.
- Lintaj, ne zaupaj. Stran je trditev, ki jo je treba preveriti proti kodi, ne jamstvo.
Potek dela za lint
Skripta wiki-lint preveri vsako stran proti
trenutni kodi: viseče reference, obujena stara imena (iz imenika poimenovanj)
in osirotele strani. Teče kot del ci-checks.sh --strict in je zapahnjena s
kljuko pred potiskom — napaka odmika blokira potisk, enako kot opozorilo
clippy.
Strani
| Stran | Kaj pokriva |
|---|---|
| agent-harness | Razcep zot (agent) + Colibri (krmilna ravnina); vprega, samodejni zagon + gonilnik RPC |
| agent-events-reference | Referenca dogodkov zot po opremi, preslikave Glasspane in preverjena polja prepisa |
| cost-model | Bajtno stabilne predpone, merjenje zadetkov predpomnilnika, samodejno stopnjevanje, stiskanje T14 |
| glasspane | Avtomat stanj agenta, pretakanje JSONL, taksonomija AgentRuntime, API posnetkov |
| operator-attention | Izpeljan pogled "potrebuje operaterja": predikat pozornosti, vrstica/skok/filter TUI, robno sprožena terminalska opozorila |
| headroom-sidecar | Neobvezni stranski vagon za stiskanje rezultatov orodij in njegov protokol Unix vtičnice |
| jail-confinement | Trajne proti prehodnim ječam, pravilnik načina priv, ponovna uporaba omejitve zaganjalnika za strežnike MCP |
| mother-hive | Arhitektura matičnega MCP — SSH s prisiljenim ukazom, enojni-dom-v-colibri, peer avtentikacija, ključ-na-semenu |
| naming-decisions | Imenik preimenovanj, nevtralnih glede na opremo / arhitekturnih — dostavljenih in v teku |
| daemon-not-demon | Zakaj rečemo daemon (duh pomočnik) in ne demon (hudič) — angleško + slovensko |
| layered-soul | Kako Colibri danes uporablja repozitorij pregledanega konteksta layered-soul proti načrtovanemu |
| task-board | Točkovanje po zmožnostih, cron razporejanje, praznjenje vnosne vrste, podlaga SQLite |
| quality-gates | ci-checks.sh kot preverjanje pred združitvijo; zakaj je odmik prej dosegel main |
| contracts | Stabilne JSON sheme (run-manifest, runtime-inventory, provider-smoke), zlati testi |
| store-schema | Usklajevalna shema SQLite in disciplina migracij |
| external-mcp | Most MCP za urejevalnike + zunanji gostitelj stdio MCP; dovoljenja za branje/pisanje/zunanji-klic |
| operator-cli | CLI colibri kot tanek tipiziran odjemalec Unix vtičnice prek API procesa v ozadju |
| tui | Odjemalec terminalske nadzorne plošče (colibri-tui) proti avtomatu stanj colibri-glasspane |
| terminal | Odločitev o terminalski zmožnosti (Kitty, razširjeno poročanje tipk, prehod tmux, SSH terminfo) |
| runtime-inventory | Popis izvajalnega okolja gostitelja + bralnik statusa čuvaja; aditivne, bralne integracije |
| skills-catalog | Bralni izvajalni porabnik za pregledane artefakte veščin Clawdie-AI |
| vault-provision | Oskrba datotek env, gnana z Vaultwarden, v ječe po zagonu agenta |
| deployment | Nameščevalnik gostitelja (clawdie): postavitev ZFS, storitev rc.d/systemd, varnost suhega teka |