colibri/docs/README.md

# Colibri Docs Index

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

| Document                                                                       | One-liner                                                                    | Audience        |
| ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------- | --------------- |
| [`CLAWDIE-INSTALLER-HANDOFF.md`](CLAWDIE-INSTALLER-HANDOFF.md)                 | FreeBSD validation handoff for the `clawdie` installer                       | Codex (FreeBSD) |
| [`CLAWDIE-STUDIO-PROPOSAL.md`](CLAWDIE-STUDIO-PROPOSAL.md)                     | Zed/Claude Code + control plane integration (bare-metal deployment option)   | Sam & agents    |
| [`COLIBRI-EXTERNAL-MCP-PROTOTYPE.md`](COLIBRI-EXTERNAL-MCP-PROTOTYPE.md)       | Colibri as MCP host for external stdio servers (jailed, 3-tier trust)        | Agents          |
| [`COLIBRI-JAILED-AGENT-SPAWN-DESIGN.md`](COLIBRI-JAILED-AGENT-SPAWN-DESIGN.md) | FreeBSD jail confinement for spawned agents — accepted & implemented         | Rust agents     |
| [`COLIBRI-SKILLS-PLAN.md`](COLIBRI-SKILLS-PLAN.md)                             | Skills catalog roadmap: read-only Phase 1, write-gated Phase 2+              | Agents          |
| [`COLIBRI-TOKENOMICS-TRIFECTA.md`](COLIBRI-TOKENOMICS-TRIFECTA.md)             | Strategic vision: useful tokens, cost-per-intelligence, measurement          | All             |
| [`HEADROOM-SIDECAR.md`](HEADROOM-SIDECAR.md)                                   | Optional `headroom-ai` tool-result compression sidecar                       | Agents          |
| [`INTEGRATION-LAYERED-SOUL.md`](INTEGRATION-LAYERED-SOUL.md)                   | How Colibri consumes `layered-soul` reviewed context today vs planned        | Agents          |
| [`ISO-ACCEPTANCE-RUNBOOK.md`](ISO-ACCEPTANCE-RUNBOOK.md)                       | Post-boot acceptance commands after staging Colibri into an ISO              | Codex (FreeBSD) |
| [`ISO-SERVICE-LAYOUT.md`](ISO-SERVICE-LAYOUT.md)                               | `rc.conf` service layout for the ISO image                                   | All             |
| [`PRIORITY-HANDOFF-ISO-SPAWN-COST.md`](PRIORITY-HANDOFF-ISO-SPAWN-COST.md)     | **Current sprint**: ISO staging wiring, Pi spawn path, cost mode enforcement | All agents      |
docs: tidy formatting, add docs index, and refresh README status line 2026-06-14 13:35:37 +02:00			`# Colibri Docs Index`

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

docs: purge all Herdr references, consolidate into AGENTS.md + README (Sam & Hermes) Deleted 8 stale docs (~1,700 lines) and merged their essential intent into AGENTS.md and README.md: Merged into AGENTS.md: - Architecture Roles section (zot=agent, Colibri=control plane, pi=backend) - ISO Takeover Gates table (Gates 1-5 with status) Merged into README.md: - glasspane row names zot/pi (not just Pi) - architecture diagram names zot/pi JSONL - removed Herdr dependency reference Deleted (content merged or obsolete): - docs/HERDR-VS-COLIBRI-GRAPH.md (migration artifact) - docs/ADR-agent-harness-consolidation.md (merged into AGENTS.md) - docs/COLIBRI-GLASSPANE-DESIGN.md (merged into README, rest in code) - docs/COLIBRI-DAEMON-GLASSPANE-INTEGRATION.md (code is source of truth) - docs/MULTIAGENT-WORKFLOW-IMPROVEMENTS.md (already in AGENTS.md) - docs/T1.4-PROMPT-DISCIPLINE-PLAN.md (gaps tracked in priority handoff #3) - docs/ISO-INTEGRATION-PLAN.md (gates merged into AGENTS.md) - .hermes/plans/2026-05-27-colibri-cutover.md (old plan, superseded) Also cleaned Herdr references from Rust doc comments in colibri-glasspane/src/lib.rs and colibri-client/src/lib.rs. Result: 18 docs → 11 docs, 66 Herdr references → 0. Gates: fmt/clippy/test all green. 2026-06-14 14:04:49 +02:00			`\| Document \| One-liner \| Audience \|`
			`\| ------------------------------------------------------------------------------ \| ---------------------------------------------------------------------------- \| --------------- \|`
			\| [`CLAWDIE-INSTALLER-HANDOFF.md`](CLAWDIE-INSTALLER-HANDOFF.md) \| FreeBSD validation handoff for the `clawdie` installer \| Codex (FreeBSD) \|
			\| [`CLAWDIE-STUDIO-PROPOSAL.md`](CLAWDIE-STUDIO-PROPOSAL.md) \| Zed/Claude Code + control plane integration (bare-metal deployment option) \| Sam & agents \|
			\| [`COLIBRI-EXTERNAL-MCP-PROTOTYPE.md`](COLIBRI-EXTERNAL-MCP-PROTOTYPE.md) \| Colibri as MCP host for external stdio servers (jailed, 3-tier trust) \| Agents \|
			\| [`COLIBRI-JAILED-AGENT-SPAWN-DESIGN.md`](COLIBRI-JAILED-AGENT-SPAWN-DESIGN.md) \| FreeBSD jail confinement for spawned agents — accepted & implemented \| Rust agents \|
			\| [`COLIBRI-SKILLS-PLAN.md`](COLIBRI-SKILLS-PLAN.md) \| Skills catalog roadmap: read-only Phase 1, write-gated Phase 2+ \| Agents \|
			\| [`COLIBRI-TOKENOMICS-TRIFECTA.md`](COLIBRI-TOKENOMICS-TRIFECTA.md) \| Strategic vision: useful tokens, cost-per-intelligence, measurement \| All \|
			\| [`HEADROOM-SIDECAR.md`](HEADROOM-SIDECAR.md) \| Optional `headroom-ai` tool-result compression sidecar \| Agents \|
			\| [`INTEGRATION-LAYERED-SOUL.md`](INTEGRATION-LAYERED-SOUL.md) \| How Colibri consumes `layered-soul` reviewed context today vs planned \| Agents \|
			\| [`ISO-ACCEPTANCE-RUNBOOK.md`](ISO-ACCEPTANCE-RUNBOOK.md) \| Post-boot acceptance commands after staging Colibri into an ISO \| Codex (FreeBSD) \|
			\| [`ISO-SERVICE-LAYOUT.md`](ISO-SERVICE-LAYOUT.md) \| `rc.conf` service layout for the ISO image \| All \|
			\| [`PRIORITY-HANDOFF-ISO-SPAWN-COST.md`](PRIORITY-HANDOFF-ISO-SPAWN-COST.md) \| Current sprint: ISO staging wiring, Pi spawn path, cost mode enforcement \| All agents \|