colibri/docs/README.md
Sam & Claude 064079e3fc
Some checks failed
CI / rust (pull_request) Has been cancelled
CI / markdown (pull_request) Has been cancelled
CI / port (pull_request) Has been cancelled
CI / agent-jail-pkgs (pull_request) Has been cancelled
docs: harness-agnostic + plainer doc names; codify naming principle
- ZOT-RPC-TRANSCRIPT.md → AGENT-EVENTS-REFERENCE.md: neutral, per-harness event
  reference (currently documents zot; pi uses pi --mode json). Avoids baking the
  current default harness into a name — same lesson as the pi_* renames. Adds a
  'Developer reference — operators can skip' header.
- VAULT-PROVISION-FIRST-PROOF.md → VAULT-PROVISION-RUNBOOK.md: it's a runbook;
  'first-proof' was redundant.
- Updated referrers: spawner.rs, wiki/agent-harness.md, docs/README.md.
- wiki/naming-decisions.md: new 'Naming principle — harness-agnostic by default'
  section (neutral concept → neutral name + configurable value; harness-specific
  → harness in the name, kept symmetric zot_/pi_).
- Fixed US/ISO prose dates → DD.mon.YYYY (21.jun.2026) per AGENTS.md; left the
  literal JSON "time" timestamps in the captured transcript as-is (data).

Gates: wiki-lint --strict clean; markdown format clean.
2026-06-24 16:33:40 +02:00

3 KiB

Colibri Docs Index

A quick-reference guide to every document in this folder.

Document One-liner Audience
CLAWDIE-INSTALLER-HANDOFF.md FreeBSD validation handoff for the clawdie installer Codex (FreeBSD)
CLAWDIE-STUDIO-PROPOSAL.md Zed/Claude Code + control plane integration (bare-metal deployment option) Sam & agents
COLIBRI-EXTERNAL-MCP-PROTOTYPE.md Colibri as MCP host for external stdio servers (jailed, 3-tier trust) Agents
COLIBRI-JAILED-AGENT-SPAWN-DESIGN.md FreeBSD jail confinement for spawned agents — accepted & implemented Rust agents
COLIBRI-SKILLS-PLAN.md Skills catalog roadmap: read-only Phase 1, write-gated Phase 2+ Agents
COLIBRI-TOKENOMICS-TRIFECTA.md Strategic vision: useful tokens, cost-per-intelligence, measurement All
HEADROOM-SIDECAR.md Optional headroom-ai tool-result compression sidecar Agents
INTEGRATION-LAYERED-SOUL.md How Colibri consumes layered-soul reviewed context today vs planned Agents
ISO-ACCEPTANCE-RUNBOOK.md Post-boot acceptance commands after staging Colibri into an ISO Codex (FreeBSD)
ISO-SERVICE-LAYOUT.md rc.conf service layout for the ISO image All
MULTI-AGENT-HOST-PLAN.md Current sprint: multi-agent task-board tests + CLI surface gaps All agents
PLAN-MOTHER-MCP-VAULT-KEYS.md Vaultwarden pubkey exchange for mother MCP link (direction B) Sam & Hermes
PRIORITY-HANDOFF-ISO-SPAWN-COST.md ISO boot validation, Pi spawn path, cost mode enforcement (P2/P3 done) All agents
TRUSS-SPAWN-ANALYSIS.md truss trace of jail-spawn Permission Denied — root cause + fix Debugging
VAULT-PROVISION-RUNBOOK.md First-proof runbook: vault → jail → .env chain (clean CLI) Agents, Sam