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 |
||
|---|---|---|
| .. | ||
| guide | ||
| wiki | ||
| CLAWDIE-INSTALLER-VALIDATION.md | ||
| CLAWDIE-STUDIO.md | ||
| COLIBRI-EXTERNAL-MCP-PROTOTYPE.md | ||
| COLIBRI-JAILED-AGENT-SPAWN-DESIGN.md | ||
| COLIBRI-TOKENOMICS-TRIFECTA.md | ||
| FREEBSD-BUILD-LANE.md | ||
| ISO-ACCEPTANCE-RUNBOOK.md | ||
| ISO-SERVICE-LAYOUT.md | ||
| MULTI-AGENT-HOST.md | ||
| README.md | ||
| VAULT-PROVISION-RUNBOOK.md | ||
| WIKI-CLAWDIE-SI.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 |