Colibri AMS

Skill-driven•Cryptographically auditable•Legitimate by design

An MCP orchestration runtime uniting task execution, multi-model routing, audit trails, and Merkle-anchored proof generation. Phase 0 is code-complete — 28 of 28 non-deferred tasks shipped (R75 Wave I, 2026-04-18), 14 MCP tools live, 8 of 15 Greek concepts ship code.

▶ Your First PR Agent Bootstrap Prompt MCP Tools Reference

Click any Greek letter to open its concept · execution · intelligence · legitimacy

Colibri Documentation

Colibri is an MCP orchestration runtime uniting task orchestration, multi-model routing, audit trails, and cryptographic proof generation. Three axes: execution + intelligence + legitimacy. Phase 0 sealed at 28/28 on non-deferred tasks (R75 Wave I, 2026-04-18); 14 MCP tools live, 8 of 15 Greek concepts ship code (colibri_code: partial).

→ Start here: colibri-system.md — the canonical vision document.

Three reading paths

Path 1 — Operator

Who: you run Colibri.

• (1) Understand how a session boots + what writebacks must exist — start with 2-plugin/boot.md (bootstrap), 2-plugin/modes.md (runtime modes), and agents/writeback-protocol.md (what every task owes back).
• (2) Run through the Phase 0 bootstrap per 5-time/roadmap.md; guides/quick-start.md gets you to first boot, guides/first-pr.md walks the first contribution, and 1-transport/index.md lists the 14 Phase 0 MCP tools.
• (3) Consult guides/troubleshoot.md + guides/backup.md for operational failures — recovery, rollback, and DB-corruption handling before escalating.

Path 2 — Contributor

Who: you add code or specs.

• (1) Start at agents/executor-contract.md for the 5-step chain (audit → contract → packet → implement → verify); the packet gates implementation.
• (2) Pick a Phase 0 task from guides/implementation/task-breakdown.md; follow the per-task prompts in guides/implementation/index.md and the bootstrap in guides/agent-bootstrap.md.
• (3) Writeback contract: agents/writeback-protocol.md — task_update + thought_record are mandatory; for proof-grade work, thought_record must precede merkle_finalize.

Path 3 — Designer

Who: you shape Colibri’s future.

• (1) Read colibri-system.md + world-schema.md for the big picture — three axes, 15 Greek concepts, the layered spine from 0-mutate through 5-time.
• (2) Read 5-time/roadmap.md for phase sequencing — which concepts activate in which round, and the roadmap past Phase 0.
• (3) Read spec/ for the legislative invariants — s01 (constitution, 7 axioms) through s19, plus architecture/decisions/ for the ADRs that lock them in.

World Schema tree

Documentation is organized by the layers a mutation passes through:

• 0-mutate/ — foundational mutation model
• 1-transport/ — MCP + JSON-RPC + 14 tools
• 2-plugin/ — server boot, modes, database, middleware (5-stage α chain)
• 3-world/ — runtime model: physics/, social/, execution/
• 4-additions/ — ν integrations: Git, Obsidian, Claude API
• 5-time/ — session → round → task → roadmap

Law library

• spec/ — 19 normative specs (s01–s19)
• architecture/decisions/ — ADRs (ADR-001 through ADR-006)
• agents/ — sigma, pm, executor, writeback contracts

Phase 0 execution

Phase 0 execution is tracked in the 28 sub-task Phase 0 plan (a subset of the 63-task full breakdown). See guides/implementation/task-breakdown.md and guides/implementation/index.md.

Reference / lookup

• reference/glossary.md — vocabulary
• reference/cross-reference.md — reverse index
• reference/design-system.md — hero, logo, typography
• reference/mcp-tools-phase-0.md — Phase 0 MCP surface
• reference/extractions/ — 49 heritage algorithm extractions

Planning

• PLAN-RED.md — this restructure plan (R75)
• world-schema.md — organizational spine v3
• colibri-system.md — canonical vision

---

Updated R82 — 2026-04-19 (R82.B Wave 1). Hero subtitle + body intro reconciled to Phase 0 seal reality (28/28 on non-deferred tasks, R75 Wave I, 2026-04-18); tool-count references updated from the pre-ship “19” plan to the shipped “14”. R75 pedigree preserved: World Schema v3 master hub rebuilt in sub-phase 4D; reading paths expanded to 3-bullet descriptions in the R75 depth pass. Governed by colibri-system.md and world-schema.md.

---