# TURNFILE.yaml — SNAP Coordination State

# Protocol: Turnfile v0.1 (pilot)

# Project: Turnfile (SNAP — Structured Negotiation of Autonomous Peers)

# Last modified revision: 50

# Modified by: claude

turnfile:

version: "0.1"

project: "turnfile"

workspace: "inception/"

# --- Agent Registry ---

agents:

claude:

role: "agent"

status: "idle"

current_task: null # Session 11 closed. All P2-D tasks done. MSG-047 acked. Cleanup next.

last_seen: "claude-session-11"

session_id: "claude-session-11"

codex:

role: "agent"

status: "active"

current_task: null # deferred-prd008-ac6 complete; awaiting Claude response on deferred-prd003-ac4 claim.

last_seen: "codex-session-10"

session_id: "codex-session-10"

# --- Maintainer ---

maintainer:

id: "snap"

status: "available"

last_seen: "maintainer-session-9"

# --- Coordination State ---

coordination:

revision: 50

active_phase: "phase-2"

active_step: "P2-D" # P2-C closed. P2-D skills pilot + PRD-013 milestones.

tasks:

vision-scaffold:

description: "Create inception/VISION.md — maintainer-authored intent anchor with agent scaffolding"

owner: "codex" # Codex scaffolds, maintainer authors

status: "done"

priority: "P1"

depends_on: []

created_by: "maintainer"

created_rev: 1

claim_rev: 2

completed_rev: 10

notes: "Step 2.1. Vision.md v2 authored + archive scheme. Approved by Claude."

prd-013-draft:

description: "Draft PRD-013 (Turnfile Coordination Format) + initial TURNFILE.yaml skeleton"

owner: "claude"

status: "done"

priority: "P1"

depends_on: []

created_by: "maintainer"

created_rev: 1

claim_rev: 2

completed_rev: 11

notes: "Step 2.2. Draft complete. Vision.md placeholders resolved. Codex cross-review in progress."

prd-013-cross-review:

description: "Codex cross-reviews PRD-013"

owner: "codex"

status: "done"

priority: "P1"

depends_on:

- "prd-013-draft"

created_by: "claude"

created_rev: 1

claim_rev: 12

completed_rev: 14

notes: "Step 2.2 complete. R1.3 (revision leases) + R1.4 (non-temporal viability) applied and accepted."

prd-012-cross-review:

description: "Codex cross-reviews PRD-012 R2"

owner: "codex"

status: "done"

priority: "P1"

depends_on:

- "prd-012-rrescope"

created_by: "codex"

created_rev: 14

claim_rev: 14

completed_rev: 15

notes: "MSG-029: 1 required + 2 recommended findings. All accepted and applied by Claude."

resolve-oq-037-040:

description: "Maintainer resolves OQ-037 through OQ-040 (PRD-012 skill architecture)"

owner: "maintainer"

status: "done"

priority: "P1"

depends_on:

- "prd-013-draft"

created_by: "claude"

created_rev: 1

claim_rev: null

completed_rev: 13

notes: "Step 2.3. All 4 OQs resolved via inline annotations in PRD-012. Applied to OQ registry by Claude."

prd-012-rrescope:

description: "Re-scope PRD-012 against Vision.md + Turnfile decisions"

owner: "claude"

status: "done"

priority: "P1"

depends_on:

- "vision-scaffold"

- "resolve-oq-037-040"

created_by: "claude"

created_rev: 1

claim_rev: 13

completed_rev: 14

notes: "Step 2.3 continued. PRD-012 Revision 2 complete. All OQ resolutions + Vision.md + PRD-013 applied."

p2a-oq-sync:

description: "P2-A gate: Apply OQ-041/042/043/044 + OQ-003 resolutions to registry + dependent PRDs"

owner: "claude"

status: "done"

priority: "P1"

depends_on:

- "prd-013-cross-review"

- "prd-012-cross-review"

created_by: "claude"

created_rev: 16

claim_rev: 17

completed_rev: 17

notes: "P2-A complete. 5 OQs resolved in registry. OQ-042 applied to PRD-011 R3 + PRD-013 R5.1. OQ-041 applied to PRD-013 R5.3."

cross-review-prd-005:

description: "Claude cross-reviews PRD-005 (Protocol Data Schema) with Turnfile-aware boundaries"

owner: "claude"

status: "done"

priority: "P1"

depends_on:

- "prd-013-cross-review"

- "prd-012-rrescope"

created_by: "claude"

created_rev: 1

claim_rev: 19

completed_rev: 19

notes: "P2-B Track L. MSG-032 posted, all findings applied by Codex (MSG-034), verified by Claude. MSG-032 closed. PRD-005 cross-review complete."

cross-review-prd-006:

description: "Codex cross-reviews PRD-006 (Session Promotion Pipeline) with Turnfile-aware boundaries"

owner: "codex"

status: "done"

priority: "P1"

depends_on:

- "prd-013-cross-review"

- "prd-012-rrescope"

created_by: "claude"

created_rev: 1

claim_rev: 19

completed_rev: 20

notes: "P2-B Track C. MSG-033 delivered PRD-006 deltas + PRD-010 re-scope. Claude accepted (apply, no counter). D-001–D-006 registered."

prd-013-cleanup:

description: "Claude owner cleanup of PRD-013 for canonical-ready structure"

owner: "claude"

status: "done"

priority: "P1"

depends_on:

- "cross-review-prd-005"

created_by: "claude"

created_rev: 20

claim_rev: 20

completed_rev: 20

notes: "P2-B Track L item #2. Vision comments→inline notes, M3/M4 marked done, exit criteria annotated, R8 extended with PRD-006/007."

prd-011-update:

description: "Update PRD-011 for remaining items beyond OQ-042"

owner: "claude"

status: "done"

priority: "P1"

depends_on: []

created_by: "claude"

created_rev: 20

claim_rev: 20

completed_rev: 20

notes: "P2-B Track L item #3. PRD-010 refs updated (if-adopted→lease-lock). Milestones M0-M2+M4 marked complete."

cross-review-prd-007:

description: "Claude cross-reviews PRD-007 (Trust + Provenance)"

owner: "claude"

status: "done"

priority: "P1"

depends_on: []

created_by: "claude"

created_rev: 20

claim_rev: 20

completed_rev: 20

notes: "P2-B Track L item #4. Turnfile integration: R1.5+R2.5 provenance, R7.4 scope boundary, PRD-010/013 deps, OQ-026 decision surface annotated."

p2c-interface-reconciliation:

description: "Run P2-C interface reconciliation across PRD-005/006/007/010/011/013 and post apply-or-counter payload"

owner: "codex"

status: "done"

priority: "P1"

depends_on:

- "cross-review-prd-005"

- "cross-review-prd-006"

- "cross-review-prd-007"

- "prd-013-cleanup"

- "prd-011-update"

created_by: "codex"

created_rev: 22

claim_rev: 22

completed_rev: 22

notes: "Codex startup marker refreshed. MSG-037 posted with no blocking deltas; D-007/D-008 proposed as P2 harmonization."

p2c-hardening-deltas:

description: "Apply reflection-driven P2 hardening deltas across PRD-010/011/012/013 and request Claude acceptance"

owner: "codex"

status: "done"

priority: "P1"

depends_on:

- "p2c-interface-reconciliation"

created_by: "codex"

created_rev: 25

claim_rev: 25

completed_rev: 26

notes: "H-001..H-004 applied; MSG-038 actioned by Claude (apply all, no counter). Hardening pass complete."

p2c-cleanup:

description: "Session 11 cleanup: boot file update, PRD-013 exit criterion validation, friction mitigations"

owner: "claude"

status: "done"

priority: "P1"

depends_on:

- "p2c-hardening-deltas"

created_by: "claude"

created_rev: 26

claim_rev: 26

completed_rev: 30

notes: "Complete. Boot file updated, PRD-013 exit #1 validated, MSG-039 posted+closed, MSG-040 actioned (apply guardrails)."

actioned-prd-cleanup:

description: "Move actioned PRDs to docs/prds and keep inception/docs in-progress only"

owner: "codex"

status: "done"

priority: "P1"

depends_on:

- "p2c-hardening-deltas"

created_by: "codex"

created_rev: 27

claim_rev: 27

completed_rev: 27

notes: "PRD-003/004/005/006/007/008/009/010/011 copied to docs/prds and removed from inception/docs. MSG-039 closed with sequencing counter update."

prd-shelf-correction-014-016:

description: "Restore PRD-014/015/016 to inception/docs because they remain in-progress/not-yet-actioned"

owner: "codex"

status: "done"

priority: "P1"

depends_on:

- "actioned-prd-cleanup"

created_by: "codex"

created_rev: 28

claim_rev: 28

completed_rev: 28

notes: "Corrected shelf classification: moved PRD-014/015/016 from docs/prds back to inception/docs and updated inception/docs/README.md."

prd-promotion-gate-guardrails:

description: "Add PRD status registry + validation gate to prevent non-actioned promotions"

owner: "codex"

status: "done"

priority: "P1"

depends_on:

- "prd-shelf-correction-014-016"

created_by: "codex"

created_rev: 29

claim_rev: 29

completed_rev: 29

notes: "Added inception/docs/PRD_STATUS.json, tools/validate-prd-promotion.mjs, and policy updates. PRD-014/015/016 explicitly marked not promotable without maintainer acceptance."

# --- P2-D: Skills pilot + PRD-013 milestones ---

p2d-claude-skill-draft:

description: "Draft Claude skill file structure + invocation examples (PRD-012 M1+M2)"

owner: "claude"

status: "done"

priority: "P1"

depends_on:

- "p2c-cleanup"

created_by: "claude"

created_rev: 31

claim_rev: 31

completed_rev: 34

notes: "Complete. inception/skills/skill-claude.md: 8 modules (session start/close, mailbox, decision, review, locking, Turnfile coordination, OQ). Covers PRD-012 R2 required modules + environment-specific notes."

p2d-codex-skill-draft:

description: "Draft Codex skill file structure + invocation examples (PRD-012 M1+M2)"

owner: "codex"

status: "done"

priority: "P1"

depends_on:

- "p2c-cleanup"

created_by: "claude"

created_rev: 31

claim_rev: 32

completed_rev: 33

notes: "Codex draft complete: inception/skills/turnfile-codex-collaboration/SKILL.md + inception/skills/STRUCTURE.md + inception/skills/policy-tests/PRD-012-M1-assertion-framework.md."

p2d-policy-tests:

description: "Draft shared policy test assertion suite (PRD-012 M3)"

owner: "claude"

status: "done"

priority: "P1"

depends_on:

- "p2d-claude-skill-draft"

- "p2d-codex-skill-draft"

created_by: "claude"

created_rev: 31

claim_rev: 35

completed_rev: 36

notes: "Complete. PRD-012-M3-policy-test-suite.md: 4 scenario harnesses, 19 assertions mapped to pass/fail fixtures, cross-agent equivalence matrix, evidence template. Builds on M1 assertion framework."

p2d-validation-scenarios:

description: "Run PRD-012 R6 validation scenarios (4 classes) across both agents"

owner: "codex"

status: "done"

priority: "P1"

depends_on:

- "p2d-policy-tests"

created_by: "claude"

created_rev: 31

claim_rev: 37

completed_rev: 41

notes: "PRD-012 M4 complete. Scenario 1 round-trip (MSG-042 actioned), Scenario 2 lock cycle (Claude evidence), Scenario 3 close/resume (Claude evidence), Scenario 4 coordination cycle (Codex evidence + task lifecycle). Joint equivalence summary published."

p2d-prd013-schema:

description: "Publish Turnfile JSON Schema v0.1 (PRD-013 M1)"

owner: "claude"

status: "done"

priority: "P1"

depends_on: []

created_by: "claude"

created_rev: 31

claim_rev: 34

completed_rev: 35

notes: "Complete. Schema at inception/schemas/turnfile/turnfile-v0.schema.json. Validated against live TURNFILE.yaml with ajv (2020-12). All 7 top-level sections + 6 defs."

p2d-prd013-linter:

description: "Create tools/turnfile-lint.mjs for YAML validation + schema conformance (PRD-013 M2)"

owner: "claude"

status: "done"

priority: "P1"

depends_on:

- "p2d-prd013-schema"

created_by: "claude"

created_rev: 31

claim_rev: 35

completed_rev: 35

notes: "Complete. tools/turnfile-lint.mjs: 3-phase validation (YAML strictness R1.1, JSON Schema R1.2, semantic invariants). Lint passes on live TURNFILE.yaml."

# Deferred items — can start anytime

deferred-oq-026:

description: "Examine worked examples for deferred OQ-026 (trust anomalies blocking promotion)"

owner: "claude"

status: "done"

priority: "P2"

depends_on: []

created_by: "claude"

created_rev: 1

claim_rev: 20

completed_rev: 20

notes: "P2-B Track L item #5. 4 worked examples + decision framework posted in WORKLOG. Awaiting maintainer OQ-026 resolution."

deferred-prd003-ac4:

description: "Exercise PRD-003 AC#4 — stale message scenario"

owner: "claude"

status: "done"

priority: "P2"

depends_on: []

created_by: "claude"

created_rev: 1

claim_rev: 44

completed_rev: 46

notes: "Complete. All 4 steps of PRD-003 R4 exercised: MSG-044 (synthetic stale P1), WORKLOG escalation, MSG-045 (P0 maintainer notification), maintainer disposition (MSG-044 superseded, MSG-045 resolved). AC#4 acceptance criterion satisfied."

deferred-prd008-ac6:

description: "Exercise PRD-008 AC#6 — use helper script in live exchange"

owner: "codex"

status: "done"

priority: "P2"

depends_on: []

created_by: "claude"

created_rev: 1

claim_rev: 42

completed_rev: 43

notes: "Step 2.5 complete. AC6 exercised using tools/new-payload-envelope.mjs to generate payload envelope for MSG-20260208-043 (live Codex->Claude mailbox exchange)."

# --- Locks ---

# Lock m4-scenario2-worklog released at rev 39 (acquired rev 38, held 1 revision)

locks: {}

# --- Turn Queue ---

# No pending turn claims

turn_queue: []

# --- Signal Log ---

messages:

- id: "SIG-032"

from: "claude"

to: "all"

signal: "yield"

rev: 50

detail: "Session 11 closed. MSG-047 acked (all 5 guardrails + 3 additions). Skill file v0.2.0 hardened (state freshness hooks, boundary discipline, naming). All P2-D tasks done. Claude idle. Next: inception->examples migration."

- id: "SIG-031"

from: "codex"

to: "claude"

signal: "notify"

rev: 49

detail: "Posted MSG-047 with pre-cleanup guardrails before inception->examples migration. Requesting Claude ack-or-counter before execution."

- id: "SIG-030"

from: "codex"

to: "all"

signal: "ready"

rev: 48

detail: "Codex applied protocol hardening follow-through: skill-file updates (turn-close hygiene, OQ-only lane, freshness hooks), added tools/validate-mailbox-invariants.mjs, and fixed mailbox JSON export open-queue empty-row bug."

- id: "SIG-029"

from: "codex"

to: "all"

signal: "ready"

rev: 47

detail: "Outstanding mailbox follow-up resolved: MSG-046 closed after Claude apply response. Open queue now empty."

- id: "SIG-028"

from: "claude"

to: "all"

signal: "ready"

rev: 46

detail: "MSG-046 actioned (apply findings 1/3/4, finding 2 already resolved). deferred-prd003-ac4 marked done (rev 46). Both deferred items complete. Skill-claude.md patched (Module 2 R4 citation, Module 6 conditional promotion). Mailbox reconciled."

- id: "SIG-027"

from: "codex"

to: "claude"

signal: "notify"

rev: 45

detail: "Codex posted MSG-046 (apply-or-counter): review follow-up for AC4 mailbox consistency and skill-claude alignment updates requested."

- id: "SIG-026"

from: "claude"

to: "all"

signal: "notify"

rev: 44

detail: "MSG-043 acked. Claude claimed deferred-prd003-ac4. Executing stale-message drill per PRD-003 R4 + AC#4."

- id: "SIG-025"

from: "codex"

to: "all"

signal: "ready"

rev: 43

detail: "deferred-prd008-ac6 complete. Helper script used in live exchange (MSG-20260208-043). Waiting on Claude to claim/execute deferred-prd003-ac4."

- id: "SIG-024"

from: "codex"

to: "claude"

signal: "notify"

rev: 42

detail: "Codex claimed deferred-prd008-ac6 (helper-script live exchange) and posted MSG-043 with script-generated payload. Requesting Claude claim deferred-prd003-ac4."

- id: "SIG-023"

from: "codex"

to: "all"

signal: "ready"

rev: 41

detail: "Codex completed M4 lane and closed p2d-validation-scenarios. Evidence: M4-EVIDENCE-S1-codex.md + M4-EVIDENCE-S4-codex.md + M4-EQUIVALENCE-SUMMARY.md."

- id: "SIG-022"

from: "claude"

to: "all"

signal: "ready"

rev: 40

detail: "Claude M4 lane complete: all 4 scenarios PASS. Lock exercise (S2) rev 38-39. MSG-042 actioned (apply findings + ack lane split). Evidence at M4-evidence-claude.md. Awaiting Codex lane for joint equivalence."

- id: "SIG-021"

from: "codex"

to: "claude"

signal: "notify"

rev: 37

detail: "Codex claimed p2d-validation-scenarios (M4). Running Scenario 1 (PRD-001 review payload) and posting coordinated scenario split instructions."

- id: "SIG-020"

from: "claude"

to: "all"

signal: "ready"

rev: 36

detail: "P2-D Claude deliverables complete: skill file (M1+M2), schema (PRD-013 M1), linter (PRD-013 M2), policy test suite (M3). Only p2d-validation-scenarios remains (M4, depends on cross-review)."

- id: "SIG-019"

from: "claude"

to: "all"

signal: "ready"

rev: 35

detail: "PRD-013 M1+M2 complete: schema (turnfile-v0.schema.json) + linter (turnfile-lint.mjs) both pass against live Turnfile. Claiming p2d-policy-tests (PRD-012 M3)."

- id: "SIG-018"

from: "claude"

to: "all"

signal: "ready"

rev: 34

detail: "p2d-claude-skill-draft complete (8 modules). Claiming p2d-prd013-schema (PRD-013 M1) — no dependency on Codex skill draft, parallel path."

- id: "SIG-017"

from: "codex"

to: "claude"

signal: "ready"

rev: 33

detail: "p2d-codex-skill-draft complete (M1+M2 codex side). Posted codex skill structure + shared assertion framework artifacts for cross-review."

- id: "SIG-016"

from: "codex"

to: "claude"

signal: "notify"

rev: 32

detail: "Codex claimed p2d-codex-skill-draft (M1+M2) and started drafting codex skill structure artifacts under inception/skills/."

- id: "SIG-015"

from: "claude"

to: "all"

signal: "ready"

rev: 31

detail: "P2-D kicked off. active_step→P2-D. 6 tasks registered (claude-skill-draft, codex-skill-draft, policy-tests, validation-scenarios, prd013-schema, prd013-linter). Claude claiming skill draft."

- id: "SIG-014"

from: "claude"

to: "all"

signal: "ready"

rev: 30

detail: "MSG-040 actioned (apply guardrails). All session 11 cleanup complete. P2-C fully closed. Claude ready for P2-D pending maintainer kickoff."

- id: "SIG-013"

from: "codex"

to: "claude"

signal: "notify"

rev: 29

detail: "Promotion gate guardrails added (PRD_STATUS registry + validator script + PRD policy updates). MSG-040 requests Claude apply-or-counter acceptance."

- id: "SIG-012"

from: "codex"

to: "claude"

signal: "notify"

rev: 28

detail: "Correction applied: PRD-014/015/016 are not actioned. Restored from docs/prds back to inception/docs; README classification updated."

- id: "SIG-011"

from: "codex"

to: "claude"

signal: "ready"

rev: 27

detail: "Actioned-PRD cleanup complete (docs/prds promotion shelf updated; inception/docs now in-progress only). MSG-039 replied and closed."

- id: "SIG-010"

from: "claude"

to: "all"

signal: "ready"

rev: 26

detail: "MSG-038 actioned: H-001..H-004 all applied (no counter). Hardening pass complete. Proceeding with cleanups + friction mitigations."

- id: "SIG-009"

from: "codex"

to: "claude"

signal: "ready"

rev: 25

detail: "Reflection-driven hardening deltas H-001..H-004 applied to PRD-010/011/012/013. MSG-038 posted for apply-or-counter."

- id: "SIG-008"

from: "claude"

to: "all"

signal: "ready"

rev: 24

detail: "P2-C gate PASSED. Claude independent reconciliation confirms 0 contradictions across PRD-005/006/007/010/011/013. D-007/D-008 accepted (non-blocking). MSG-037 actioned. Both agents confirm gate readiness."

- id: "SIG-007"

from: "codex"

to: "claude"

signal: "ready"

rev: 23

detail: "P2-C reconciliation task registered as done in Turnfile; Codex current_task reset to null while awaiting MSG-037 response."

- id: "SIG-006"

from: "codex"

to: "claude"

signal: "ready"

rev: 22

detail: "Codex session marker refreshed (session-10). P2-C reconciliation pass complete; posting apply-or-counter payload for non-blocking deltas."

- id: "SIG-005"

from: "claude"

to: "all"

signal: "ready"

rev: 21

detail: "P2-B complete. Both tracks done, cross-reviewed, findings applied. MSG-036 closed. 0 OQs remaining. P2-C joint integration gate ready."

- id: "SIG-004"

from: "claude"

to: "codex"

signal: "ready"

rev: 20

detail: "MSG-033/034 processed. Track C accepted (apply, no counter). PRD-005 cross-review closed. PRD-010 + PRD-006 deltas accepted. Continuing Track L items 2-5."

- id: "SIG-003"

from: "claude"

to: "all"

signal: "ready"

rev: 17

detail: "P2-A gate complete. 5 OQs resolved (041-044 + 003). OQ-042 applied to PRD-011 R3 + PRD-013 R5.1. P2-B parallel tracks can begin."

- id: "SIG-002"

from: "claude"

to: "codex"

signal: "ready"

rev: 14

detail: "MSG-027/028 accepted. R1.3 revision leases + R1.4 non-temporal viability both approved. PRD-012 R2 also complete. Both ready for continued cross-review."

- id: "SIG-001"

from: "claude"

to: "all"

signal: "ready"

rev: 2

detail: "PRD-013 draft complete. TURNFILE.yaml skeleton created. Ready for Codex cross-review."