clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 30
colibri/docs
History
Sam & Claude affee26afa
Some checks failed
CI / rust (pull_request) Has been cancelled
Details
CI / markdown (pull_request) Has been cancelled
Details
CI / port (pull_request) Has been cancelled
Details
CI / agent-jail-pkgs (pull_request) Has been cancelled
Details
docs(wiki): A2A complexity audit — when it pays off vs when it adds weight 
Full protocol surface audit across Colibri's 5 current protocols
  (~5,324 lines). Key finding: A2A is an interoperability play, not a
  complexity reduction play.

  Replaced:
  - Mother MCP-over-SSH bridge → A2A HTTP endpoint (−160 lines, +380 lines)
  - External MCP discovery → Agent Card (future, zero adopters today)
  - Ad-hoc cost format → typed A2A part (negligible code impact)

  Not replaced: Unix socket (local IPC), spawner (process lifecycle),
  glasspane (PTY observer), store (SQLite), MCP editor bridge (human↔tool).

  Net delta: ~0 lines (moves code, doesn't shrink it). Protocol count: 5→6.

  Recommendation: A2A is Phase 3 — not Phase 2, not 0.12. The current
  MCP-over-SSH bridge (437 lines) works for 4 nodes. A2A pays off at 10+
  nodes or when third-party tools ship A2A support. The Agent Card design
  in HIVE-PANE.md stays as a north star.

  Cross-linked from hive-pane.md + wiki index. 182 refs, clean lint.
2026-06-27 13:12:39 +02:00
..
guide docs: rename PLAN/PROPOSAL/HANDOFF/ENHANCEMENT → implementation names 2026-06-26 17:32:39 +02:00
wiki docs(wiki): A2A complexity audit — when it pays off vs when it adds weight 2026-06-27 13:12:39 +02:00
CLAWDIE-INSTALLER-VALIDATION.md docs: rename PLAN/PROPOSAL/HANDOFF/ENHANCEMENT → implementation names 2026-06-26 17:32:39 +02:00
CLAWDIE-STUDIO.md docs: rename PLAN/PROPOSAL/HANDOFF/ENHANCEMENT → implementation names 2026-06-26 17:32:39 +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 fix(spawner): stage jail spawn files under daemon-owned home, not /var/run 2026-06-21 17:37:32 +02:00
COLIBRI-TOKENOMICS-TRIFECTA.md docs: fix stale references in COLIBRI-TOKENOMICS-TRIFECTA.md 2026-06-26 21:23:41 +02:00
FREEBSD-BUILD-LANE.md docs: rename PLAN/PROPOSAL/HANDOFF/ENHANCEMENT → implementation names 2026-06-26 17:32:39 +02:00
ISO-ACCEPTANCE-RUNBOOK.md test: rename 'fake' test agent → 'sample' (lighter, less loaded) 2026-06-23 18:19:49 +02:00
ISO-SERVICE-LAYOUT.md test: rename 'fake' test agent → 'sample' (lighter, less loaded) 2026-06-23 18:19:49 +02:00
MULTI-AGENT-HOST.md docs: rename PLAN/PROPOSAL/HANDOFF/ENHANCEMENT → implementation names 2026-06-26 17:32:39 +02:00
README.md fix(skills): correct source-of-truth — colibri, not clawdie-ai 2026-06-26 21:43:08 +02:00
VAULT-PROVISION-RUNBOOK.md docs: harness-agnostic + plainer doc names; codify naming principle 2026-06-24 16:33:40 +02:00
WIKI-CLAWDIE-SI.md docs: rename PLAN/PROPOSAL/HANDOFF/ENHANCEMENT → implementation names 2026-06-26 17:32:39 +02:00

README.md

Colibri Docs Index

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

Document One-liner Audience
CLAWDIE-INSTALLER-VALIDATION.md FreeBSD validation handoff for the clawdie installer Codex (FreeBSD)
CLAWDIE-STUDIO.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-TOKENOMICS-TRIFECTA.md Strategic vision: useful tokens, cost-per-intelligence, measurement All
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.md Current sprint: multi-agent task-board tests + CLI surface gaps All agents
VAULT-PROVISION-RUNBOOK.md First-proof runbook: vault → jail → .env chain (clean CLI) Agents, Sam