colibri/docs
Sam & Claude a368df45e4
Some checks failed
CI / rust (pull_request) Has been cancelled
CI / markdown (pull_request) Has been cancelled
docs(vault): first-proof runbook for the spawn->provision chain
Documents how to prove the spawn -> vault-provision -> .env chain live on osa,
honestly surfacing that it isn't CLI-drivable yet:
- the chain is wired + unit-tested, but tenant registration is raw-SQLite-only
  (#101) and jailed spawn is raw-socket-JSON-only (#102)
- runbook uses the interim manual path (sqlite insert + raw spawn-agent JSON)
- scratch jail + test collection per first-proof policy; bootstrap creds never
  enter the jail
- documents exact resolution: collection name = tenant_id, jail_root must match

Continues an osa-agent investigation (verified against origin/main).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-20 08:37:48 +02:00
..
CLAWDIE-INSTALLER-HANDOFF.md docs: tidy clawdie handoff — reflect hardening applied (PR #53) 2026-06-14 00:49:52 +02:00
CLAWDIE-STUDIO-PROPOSAL.md feat(rc): rename test agent and load provider env (Sam & Codex) 2026-06-15 07:35:44 +02:00
COLIBRI-EXTERNAL-MCP-PROTOTYPE.md feat(rc): rename test agent and load provider env (Sam & Codex) 2026-06-15 07:35:44 +02:00
COLIBRI-JAILED-AGENT-SPAWN-DESIGN.md docs: document jail root_path + staged env payloads 2026-06-14 01:38:30 +02:00
COLIBRI-SKILLS-PLAN.md chore: adopt markdown formatting gate + one-shot prettier sweep (Sam & Claude) 2026-06-04 20:13:47 +02:00
COLIBRI-TOKENOMICS-TRIFECTA.md docs: remove stale Herdr hub runbook + T1.4 cache-warming design 2026-06-13 21:42:42 +02:00
FREEBSD-BUILD-LANE-HANDOFF.md docs(freebsd): stamp zot build version in handoff (Sam & Codex) 2026-06-15 19:09:50 +02:00
HEADROOM-SIDECAR.md feat(rc): rename test agent and load provider env (Sam & Codex) 2026-06-15 07:35:44 +02:00
INTEGRATION-LAYERED-SOUL.md fix(import): treat each SKILL.md as one skill (not every .md) 2026-06-14 02:08:12 +02:00
ISO-ACCEPTANCE-RUNBOOK.md fix(rc): FreeBSD rc.d deep-audit — cost mode naming, chmod cleanup, health check, docs (Sam & Hermes) 2026-06-15 08:28:20 +02:00
ISO-SERVICE-LAYOUT.md fix(daemon): fail closed when socket ownership is unsafe (Sam & Codex) 2026-06-15 09:08:56 +02:00
PRIORITY-HANDOFF-ISO-SPAWN-COST.md chore: drop stale duplicate stage-colibri-iso.sh (#79) 2026-06-15 18:10:36 +02:00
README.md docs: purge all Herdr references, consolidate into AGENTS.md + README (Sam & Hermes) 2026-06-14 14:04:49 +02:00
VAULT-PROVISION-FIRST-PROOF.md docs(vault): first-proof runbook for the spawn->provision chain 2026-06-20 08:37:48 +02:00

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
PRIORITY-HANDOFF-ISO-SPAWN-COST.md Current sprint: ISO staging wiring, Pi spawn path, cost mode enforcement All agents