These files are artifacts from the first real-world use of Turnfile (then called "Consensus Collaboration Protocol"). They were produced during a Claude + Codex + Human Maintainer session on the ai-feature-tracker project (link checker replacement milestone).
They are preserved here as a reference example — not as active protocol documents.
| File | What it is |
|---|---|
COLLAB_PROTOCOL.md |
Protocol index with version history (v1 through v5) |
COLLAB_PROTOCOL_CORE.md |
Battle-tested v5 core rules (evolved from real collaboration) |
COLLAB_PROTOCOL_PROJECT.md |
Project profile: lane assignments, domain contract, handshakes |
COLLAB_PROTOCOL_v2.md |
Archived v2 protocol snapshot |
COLLAB_RETRO.md |
Final retrospective with cross-agent analysis |
COLLAB_RETRO_v1.md |
Archived v1 retrospective snapshot |
LLM_ONBOARDING.md |
Onboarding guide (progression path, shadow review, rollback) |
WORKLOG.md |
Full session worklog (handoffs, decisions, counter-recommendations) |
SESSION_HANDOFF_2026-02-07.md |
Context handoff document for session continuity |
The protocol in docs/ is the generalized framework. These example files show what a real instantiation looks like — including the messy, useful parts:
- How lane ownership actually prevented collisions (zero merge conflicts)
- A real counter-recommendation that saved speculative work
- How WORKLOG verbosity scaled poorly and led to protocol improvements
- The full progression from v1 (initial) through v5 (refined)
- Retrospectives that drove concrete protocol changes