colibri/docs
Sam & Claude 4be669aa3f
Some checks failed
CI / rust (pull_request) Has been cancelled
CI / markdown (pull_request) Has been cancelled
CI / port (pull_request) Has been cancelled
CI / agent-jail-pkgs (pull_request) Has been cancelled
docs(wiki): add comprehensive PR workflow guide
Document day-to-day PR workflow used throughout the project:
- What is a PR and why we use them
- Complete workflow from branch creation to merge
- Branch naming conventions (fix/, feat/, docs/, refactor/, test/)
- Commit message format with good/bad examples
- Review checklist and common patterns
- Merging strategy (squash vs regular)
- After merge cleanup steps
- Troubleshooting guide
- Real examples from recent PRs (eval-harness-phase1, smoke-to-test, sl-wiki-cross-links)

Captures the practical PR workflow we use daily in chat and makes
it accessible as reference documentation.

Sam & Claude
2026-06-28 10:27:32 +02:00
..
guide rename golden tests to fixtures tests 2026-06-28 10:19:00 +02:00
wiki docs(wiki): add comprehensive PR workflow guide 2026-06-28 10:27:32 +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

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