colibri/docs
Sam & Claude 7abe8c4d4c
Some checks failed
CI / markdown (pull_request) Has been cancelled
CI / rust (pull_request) Has been cancelled
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
..
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 docs: purge all Herdr references, consolidate into AGENTS.md + README (Sam & Hermes) 2026-06-14 14:04:49 +02:00
COLIBRI-EXTERNAL-MCP-PROTOTYPE.md docs: document jail root_path + staged env payloads 2026-06-14 01:38:30 +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
HEADROOM-SIDECAR.md fix(headroom): harden sidecar protocol and timeout (Sam & Codex) 2026-06-14 01:30:45 +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 docs: purge all Herdr references, consolidate into AGENTS.md + README (Sam & Hermes) 2026-06-14 14:04:49 +02:00
ISO-SERVICE-LAYOUT.md chore: adopt markdown formatting gate + one-shot prettier sweep (Sam & Claude) 2026-06-04 20:13:47 +02:00
PRIORITY-HANDOFF-ISO-SPAWN-COST.md docs: tidy formatting, add docs index, and refresh README status line 2026-06-14 13:35:37 +02:00
README.md docs: purge all Herdr references, consolidate into AGENTS.md + README (Sam & Hermes) 2026-06-14 14:04:49 +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