@bradheitmann/odin-sentinel 0.4.11 → 0.4.13

package/protocol/closeout.yaml

@@ -1,4 +1,4 @@
-version: 0.4.11
+version: 0.4.13
 active_watch_terminal_states:
   - RELEASED_BY_OPERATOR
   - HANDED_OFF

package/protocol/delegation.yaml

@@ -1,4 +1,4 @@
-version: 0.4.11
+version: 0.4.13
 delegation_contract:
   required_fields:
     - receipt_type

package/protocol/model-profiles.yaml

@@ -1,4 +1,4 @@
-version: 0.4.11
+version: 0.4.13
 policy:
   semantics: Recommended starter profiles, not bundled dependencies or availability guarantees.
   runtime_requirement: Users must install and configure their own harnesses. Launchers must verify local harness/model availability before dispatch and apply fallbacks when unavailable.
@@ -29,7 +29,7 @@ policy:
     - mcp_tool_hydration
     - governed_role_ready
   non_governed_one_shot_only: Harnesses without MCP access, native SCP skill, or full injected protocol text must be classified NON_GOVERNED_ONE_SHOT_ONLY and must not hold persistent governed roles.
-  scp_skill_install_recommendation: Skill-capable harnesses should install the sentinel-coordination-protocol skill before governed launch; native skill discoverability improved compliance in observed runs.
+  scp_skill_install_recommendation: Skill-capable harnesses should install the odin-scp skill before governed launch; native skill discoverability improved compliance in observed runs.
 harness_capabilities:
   Codex:
     can_hydrate_deferred_mcp_tools_at_boot: true

package/protocol/receipts/team-manifest.yaml

@@ -45,6 +45,6 @@ watcher_assignments:
       - heartbeat_ledger
 minimum_compatible_mcp_version: 0.4.5
 scp_context_sources:
-  - native sentinel-coordination-protocol skill
+  - native odin-scp skill
   - odin-sentinel MCP at or above minimum version
   - full injected SCP protocol text

package/protocol/roles.yaml

@@ -1,4 +1,4 @@
-version: 0.4.11
+version: 0.4.13
 roles:
   EXEC_PM:
     title: EXEC PM

package/protocol/skill-references/boot-receipt-examples.md

@@ -0,0 +1,439 @@
+# SCP Boot Receipt Examples
+
+Use these as patterns. Replace placeholder values with live command output.
+
+## Minimal Bootstrap Receipt
+
+Use this only for initial pane readiness and parking. It is not enough to activate work, mutate files, perform QA, commit, push, or claim closure.
+
+```yaml
+SCP_MIN_BOOT_RECEIPT:
+  agent_id: c-dev-1
+  team: C
+  role: DEV WORKER
+  reports_to: C/TEAM-PM
+  cwd: <pwd or EXEC PM supplied>
+  branch: <branch or EXEC PM supplied>
+  head_sha: <sha or EXEC PM supplied>
+  may_implement: false
+  may_qa_accept: false
+  permission_mode: READ_ONLY
+  current_state: BOOTSTRAPPED_IDLE
+  terminal_locator:
+    terminal_app: cmux
+    terminal_adapter: cmux
+    workspace_ref: <workspace:1>
+    workspace_id: <uuid-or-unavailable>
+    window_ref: <window-or-unavailable>
+    window_id: <uuid-or-unavailable>
+    pane_ref: <pane>
+    pane_id: <uuid-or-unavailable>
+    surface_ref: <surface>
+    surface_id: <uuid-or-unavailable>
+    tab_ref: <tab-or-unavailable>
+    tab_id: <uuid-or-unavailable>
+    surface_type: terminal
+    title: C/DEV-1
+    route_command: cmux send --workspace <workspace> --surface <surface>
+    locator_source: EXEC PM supplied from cmux --json --id-format both
+    locator_captured_at: <ISO-8601 timestamp>
+  target_sha_or_base: <declared base>
+  proof_source: EXEC PM supplied branch/SHA/cwd/locator plus pane role acknowledgment
+  next_expected_receipt: SCP_BOOT_RECEIPT before activation
+```
+
+## EXEC PM
+
+```yaml
+SCP_BOOT_RECEIPT:
+  agent_id: a-exec-pm
+  terminal_locator:
+    terminal_app: cmux
+    terminal_adapter: cmux
+    workspace_ref: <workspace:1>
+    workspace_id: <uuid>
+    window_ref: <window:1>
+    window_id: <uuid>
+    pane_ref: <pane:47>
+    pane_id: <uuid>
+    surface_ref: <surface:40>
+    surface_id: <uuid>
+    tab_ref: <tab:40>
+    tab_id: <uuid>
+    surface_type: terminal
+    title: A/EXEC-PM
+    route_command: cmux send --workspace <workspace> --surface <surface>
+    locator_source: cmux --json --id-format both identify
+    locator_captured_at: <ISO-8601 timestamp>
+  vt_state_snapshot:
+    vt_provider: unavailable
+    vt_api_stability: unknown
+    terminal_instance_ref: unavailable
+    terminal_instance_id: unavailable
+    pty_ref: unavailable
+    capture_source: cmux read-screen
+    formatter_format: plain
+    rows: unavailable
+    cols: unavailable
+    total_rows: unavailable
+    scrollback_rows: unavailable
+    width_px: unavailable
+    height_px: unavailable
+    active_screen: unavailable
+    cursor_x: unavailable
+    cursor_y: unavailable
+    cursor_visible: unavailable
+    cursor_pending_wrap: unavailable
+    title: A/EXEC-PM
+    pwd: unavailable
+    render_dirty: unavailable
+    semantic_prompt_observed: unavailable
+    semantic_input_observed: unavailable
+    semantic_output_observed: unavailable
+    paste_safety_checked: unavailable
+    paste_safe: unavailable
+    key_encoding_provider: unavailable
+    mouse_encoding_provider: unavailable
+    focus_encoding_provider: unavailable
+    snapshot_captured_at: <ISO-8601 timestamp>
+  team: A
+  role: EXEC PM
+  authority_layer: executive
+  model_harness: <model>/<harness>
+  cost_tier: high_reasoning
+  capability_profile: orchestration, authorization, branch-visible claim framing
+  cwd: <pwd>
+  branch: <git branch --show-current>
+  upstream: <git rev-parse --abbrev-ref --symbolic-full-name @{u}>
+  head_sha: <git rev-parse HEAD>
+  target_sha_or_base: <declared base>
+  may_implement: false
+  may_qa_accept: false
+  delegates_to: [EXEC ASST, EXEC RSCH, EXEC QA, TEAM PM, TEAM SENTINEL]
+  reports_to: human operator
+  worker_exception_authority: human operator only
+  write_scope: governance/control artifacts explicitly assigned
+  read_scope: active repo, evidence, panes, handoffs
+  prohibited_paths: product source, runtime mutation, holdout, secrets, design unless authorized
+  evidence_path: <control evidence or handoff path>
+  terminal_state_vocabulary: READINESS_ONLY, FROZEN, QUARANTINED, DEV_COMPLETE_QA_PENDING
+  proof_source: pwd; git status; git rev-parse HEAD @{u}
+  permission_mode: <declared mode>
+```
+
+## TEAM PM
+
+```yaml
+SCP_BOOT_RECEIPT:
+  agent_id: c-team-pm
+  terminal_locator:
+    terminal_app: cmux
+    terminal_adapter: cmux
+    workspace_ref: <workspace:1>
+    workspace_id: <uuid>
+    window_ref: <window:1>
+    window_id: <uuid>
+    pane_ref: <pane>
+    pane_id: <uuid>
+    surface_ref: <surface>
+    surface_id: <uuid>
+    tab_ref: <tab>
+    tab_id: <uuid>
+    surface_type: terminal
+    title: C/TEAM-PM
+    route_command: cmux send --workspace <workspace> --surface <surface>
+    locator_source: EXEC PM supplied from cmux --json --id-format both
+    locator_captured_at: <ISO-8601 timestamp>
+  vt_state_snapshot:
+    vt_provider: unavailable
+    vt_api_stability: unknown
+    terminal_instance_ref: unavailable
+    terminal_instance_id: unavailable
+    pty_ref: unavailable
+    capture_source: cmux read-screen
+    formatter_format: plain
+    rows: unavailable
+    cols: unavailable
+    total_rows: unavailable
+    scrollback_rows: unavailable
+    width_px: unavailable
+    height_px: unavailable
+    active_screen: unavailable
+    cursor_x: unavailable
+    cursor_y: unavailable
+    cursor_visible: unavailable
+    cursor_pending_wrap: unavailable
+    title: C/TEAM-PM
+    pwd: unavailable
+    render_dirty: unavailable
+    semantic_prompt_observed: unavailable
+    semantic_input_observed: unavailable
+    semantic_output_observed: unavailable
+    paste_safety_checked: unavailable
+    paste_safe: unavailable
+    key_encoding_provider: unavailable
+    mouse_encoding_provider: unavailable
+    focus_encoding_provider: unavailable
+    snapshot_captured_at: <ISO-8601 timestamp>
+  team: C
+  role: TEAM PM
+  authority_layer: pod_assignment_owner
+  model_harness: <model>/<harness>
+  cost_tier: high_reasoning_or_mid_reasoning
+  capability_profile: pod routing, worker activation, pod status, escalation
+  cwd: <pwd>
+  branch: <branch>
+  upstream: <upstream>
+  head_sha: <sha>
+  target_sha_or_base: <declared base>
+  may_implement: false
+  may_qa_accept: false
+  delegates_to: [C/DEV-1, C/QA-1, C/SHADOW-1]
+  reports_to: EXEC PM
+  worker_exception_authority: human operator or EXEC PM with branch-visible exception record
+  write_scope: pod ledger, prompts, pod handoff only
+  read_scope: assigned pod panes, assigned artifacts, validators
+  prohibited_paths: worker deliverables, product source, QA acceptance artifacts unless assigned
+  evidence_path: <pod ledger or handoff>
+  terminal_state_vocabulary: BOOTSTRAPPED_IDLE, READINESS_ONLY, FROZEN, QUARANTINED
+  proof_source: pwd; git status; git rev-parse HEAD @{u}; cmux read-screen
+  permission_mode: <declared mode>
+```
+
+## TEAM SENTINEL
+
+```yaml
+SCP_BOOT_RECEIPT:
+  agent_id: c-team-sentinel
+  terminal_locator:
+    terminal_app: cmux
+    terminal_adapter: cmux
+    workspace_ref: <workspace:1>
+    workspace_id: <uuid>
+    window_ref: <window:1>
+    window_id: <uuid>
+    pane_ref: <pane>
+    pane_id: <uuid>
+    surface_ref: <surface>
+    surface_id: <uuid>
+    tab_ref: <tab>
+    tab_id: <uuid>
+    surface_type: terminal
+    title: C/TEAM-SENTINEL
+    route_command: cmux send --workspace <workspace> --surface <surface>
+    locator_source: cmux --json --id-format both identify
+    locator_captured_at: <ISO-8601 timestamp>
+  vt_state_snapshot:
+    vt_provider: unavailable
+    vt_api_stability: unknown
+    terminal_instance_ref: unavailable
+    terminal_instance_id: unavailable
+    pty_ref: unavailable
+    capture_source: cmux read-screen
+    formatter_format: plain
+    rows: unavailable
+    cols: unavailable
+    total_rows: unavailable
+    scrollback_rows: unavailable
+    width_px: unavailable
+    height_px: unavailable
+    active_screen: unavailable
+    cursor_x: unavailable
+    cursor_y: unavailable
+    cursor_visible: unavailable
+    cursor_pending_wrap: unavailable
+    title: C/TEAM-SENTINEL
+    pwd: unavailable
+    render_dirty: unavailable
+    semantic_prompt_observed: unavailable
+    semantic_input_observed: unavailable
+    semantic_output_observed: unavailable
+    paste_safety_checked: unavailable
+    paste_safe: unavailable
+    key_encoding_provider: unavailable
+    mouse_encoding_provider: unavailable
+    focus_encoding_provider: unavailable
+    snapshot_captured_at: <ISO-8601 timestamp>
+  team: C
+  role: TEAM SENTINEL
+  authority_layer: team_control_lead
+  model_harness: <model>/<harness>
+  cost_tier: high_reasoning
+  capability_profile: watchdog control, polling, intervention, scope control
+  cwd: <pwd>
+  branch: <branch>
+  upstream: <upstream>
+  head_sha: <sha>
+  target_sha_or_base: <declared base>
+  may_implement: false
+  may_qa_accept: false
+  delegates_to: [C/TEAM-PM, C/DEV-1, C/QA-1, C/SHADOW-1]
+  reports_to: EXEC PM
+  coordination_note: C/TEAM-PM owns normal worker activation; TEAM SENTINEL may relay corrective prompts and freeze unsafe lanes.
+  worker_exception_authority: human operator or EXEC PM with branch-visible exception record
+  write_scope: control ledger, prompts, lane handoff only
+  read_scope: assigned pod panes, assigned artifacts, validators
+  prohibited_paths: worker deliverables, product source, QA acceptance artifacts unless assigned
+  evidence_path: <lane ledger or handoff>
+  terminal_state_vocabulary: READINESS_ONLY, FROZEN, QUARANTINED
+  proof_source: pwd; git status; git rev-parse HEAD @{u}; cmux read-screen
+  permission_mode: <declared mode>
+```
+
+## DEV WORKER
+
+```yaml
+SCP_BOOT_RECEIPT:
+  agent_id: c-dev-1
+  terminal_locator:
+    terminal_app: tmux
+    terminal_adapter: tmux
+    workspace_ref: <session-name>
+    workspace_id: unavailable
+    window_ref: <window-index-or-name>
+    window_id: <window-id-or-unavailable>
+    pane_ref: <%pane-id>
+    pane_id: <%pane-id>
+    surface_ref: <%pane-id>
+    surface_id: unavailable
+    tab_ref: unavailable
+    tab_id: unavailable
+    surface_type: terminal
+    title: C/DEV-1
+    route_command: tmux send-keys -t <session:window.%pane> '<message>' Enter
+    locator_source: tmux display-message -p
+    locator_captured_at: <ISO-8601 timestamp>
+  vt_state_snapshot:
+    vt_provider: terminal-capture
+    vt_api_stability: unknown
+    terminal_instance_ref: unavailable
+    terminal_instance_id: unavailable
+    pty_ref: <tty or unavailable>
+    capture_source: tmux capture-pane
+    formatter_format: plain
+    rows: <tmux pane_height or unavailable>
+    cols: <tmux pane_width or unavailable>
+    total_rows: unavailable
+    scrollback_rows: unavailable
+    width_px: unavailable
+    height_px: unavailable
+    active_screen: unavailable
+    cursor_x: unavailable
+    cursor_y: unavailable
+    cursor_visible: unavailable
+    cursor_pending_wrap: unavailable
+    title: C/DEV-1
+    pwd: <pane_current_path or unavailable>
+    render_dirty: unavailable
+    semantic_prompt_observed: unavailable
+    semantic_input_observed: unavailable
+    semantic_output_observed: unavailable
+    paste_safety_checked: false
+    paste_safe: unavailable
+    key_encoding_provider: terminal
+    mouse_encoding_provider: terminal
+    focus_encoding_provider: terminal
+    snapshot_captured_at: <ISO-8601 timestamp>
+  team: C
+  role: DEV WORKER
+  authority_layer: worker
+  model_harness: <model>/<harness>
+  cost_tier: bounded_execution
+  capability_profile: implementation inside exact write scope, evidence capture
+  cwd: <pwd>
+  branch: <branch>
+  upstream: <upstream>
+  head_sha: <sha>
+  target_sha_or_base: <declared base>
+  may_implement: true
+  may_qa_accept: false
+  delegates_to: []
+  reports_to: C/TEAM-SENTINEL
+  worker_exception_authority: not_applicable
+  write_scope: <exact files or directories from slice>
+  read_scope: <required reading list>
+  prohibited_paths: outside write scope, holdout, secrets, unrelated design/runtime
+  evidence_path: <dev evidence path declared by dispatch>
+  terminal_state_vocabulary: DEV_COMPLETE_QA_PENDING, BLOCKED_BY_LIMIT, FROZEN
+  proof_source: assigned slice; pwd; git status; validators
+  permission_mode: <declared mode>
+```
+
+## QA WORKER
+
+```yaml
+SCP_BOOT_RECEIPT:
+  agent_id: c-qa-1
+  terminal_locator:
+    terminal_app: unknown
+    terminal_adapter: unavailable
+    workspace_ref: unavailable
+    workspace_id: unavailable
+    window_ref: unavailable
+    window_id: unavailable
+    pane_ref: unavailable
+    pane_id: unavailable
+    surface_ref: unavailable
+    surface_id: unavailable
+    tab_ref: unavailable
+    tab_id: unavailable
+    surface_type: unknown
+    title: C/QA-1
+    route_command: unavailable
+    locator_source: self-reported; not independently verified
+    locator_captured_at: unavailable
+  vt_state_snapshot:
+    vt_provider: unavailable
+    vt_api_stability: unknown
+    terminal_instance_ref: unavailable
+    terminal_instance_id: unavailable
+    pty_ref: unavailable
+    capture_source: unavailable
+    formatter_format: unavailable
+    rows: unavailable
+    cols: unavailable
+    total_rows: unavailable
+    scrollback_rows: unavailable
+    width_px: unavailable
+    height_px: unavailable
+    active_screen: unavailable
+    cursor_x: unavailable
+    cursor_y: unavailable
+    cursor_visible: unavailable
+    cursor_pending_wrap: unavailable
+    title: C/QA-1
+    pwd: unavailable
+    render_dirty: unavailable
+    semantic_prompt_observed: unavailable
+    semantic_input_observed: unavailable
+    semantic_output_observed: unavailable
+    paste_safety_checked: unavailable
+    paste_safe: unavailable
+    key_encoding_provider: unavailable
+    mouse_encoding_provider: unavailable
+    focus_encoding_provider: unavailable
+    snapshot_captured_at: unavailable
+  team: C
+  role: QA WORKER
+  authority_layer: worker
+  model_harness: <model>/<harness>
+  cost_tier: bounded_review
+  capability_profile: adversarial qa-review, evidence authenticity, independent gates
+  cwd: <pwd>
+  branch: <branch>
+  upstream: <upstream>
+  head_sha: <sha>
+  target_sha_or_base: <dev commit or evidence base>
+  may_implement: false
+  may_qa_accept: true
+  delegates_to: []
+  reports_to: C/TEAM-SENTINEL or EXEC QA
+  worker_exception_authority: not_applicable
+  write_scope: QA report/evidence paths only
+  read_scope: DEV evidence, changed files, validators, slice contract
+  prohibited_paths: product implementation, own lifecycle closure, hidden holdout, secrets
+  evidence_path: <qa evidence path declared by dispatch>
+  terminal_state_vocabulary: QA_INCOMPLETE, FROZEN, ACCEPT, REJECT
+  proof_source: qa-review; independent validator commands; git status
+  permission_mode: <declared mode>
+```

package/protocol/skill-references/canonical-introduction-prompt.md

@@ -0,0 +1,118 @@
+# Canonical SCP v3.5 Introduction Prompt For `EXEC PM`
+
+Use this prompt to introduce SCP to the `EXEC PM` pane in any repository. It is intentionally explicit because the dangerous failures are premature activation, narrative closure, role blurring, stale QA, hidden capacity, and unsupported harness assumptions.
+
+```text
+EXEC PM - SCP v3.5 generic policy introduction, repo preflight, adoption-gate bootstrap, and controlled dissemination.
+
+You are the repo-capable pre-activation executive PM for this task. This is not an activation order unless the user explicitly says SCP is active. This is a governance-package landing, verification, and startup-planning task.
+
+Use the `odin-scp` skill if available. Also read local project authority files when present:
+- AGENTS.md
+- CLAUDE.md
+- config/constitutional/constitutional-agent.md
+- project-local governance or constitution files declared by the repository
+- .odin/handoffs/
+- .odin/audit/
+
+Authority boundary:
+- SCP is not active until adoption/startup gates are branch-visible or explicitly acknowledged, adversarial QA accepts any governance/package mutation, and the user authority explicitly declares activation or asks you to operate under SCP.
+- Until activation, the user's active directives, AGENTS.md, project-local lifecycle/governance rules, and task-specific scope remain controlling.
+- Do not announce transition. Do not instruct panes to switch behavior under SCP until activation authority is explicit.
+- Do not run a pilot wave unless the user explicitly asks for execution.
+
+Hard no:
+- No product code edits unless separately authorized.
+- No lifecycle closure based only on SCP narration.
+- No bare completion language. Use observed, branch-visible, QA-accepted, blocked, or pending labels.
+- No self-acceptance. Governance or package changes require adversarial QA before adoption can clear.
+- No secret output. Do not print tokens, API keys, OAuth tokens, or config secret values.
+- No hidden subagents or off-ledger workers while SCP is active.
+
+Core objective:
+Load SCP v3.5, discover repo state and handoffs, bootstrap the executive office plus the requested number of development pods, and stop before product execution unless the user explicitly gave an execution task.
+
+Phase 0 - live preflight:
+1. Confirm current repo and worktree:
+   - pwd
+   - git status --short --branch --untracked-files=all
+   - git branch --show-current
+   - git rev-parse HEAD
+   - git rev-parse @{u}, if upstream exists
+2. Discover handoffs and audit state:
+   - .odin/handoffs/
+   - .odin/audit/
+3. If no handoff exists, treat the repo as a fresh SCP bootstrap.
+4. Record exact assumptions before creating teams.
+
+Phase 1 - default startup topology:
+1. Unless the user says otherwise, create the executive office and one development pod.
+2. If the user says "spin up N dev pods", create the executive office and N development pods.
+3. Required executive office roles:
+   - A/EXEC-PM
+   - A/EXEC-ODIN
+   - A/EXEC-ASST
+   - A/EXEC-RSCH
+   - A/EXEC-QA
+4. Required development pod roles per pod:
+   - <TEAM>/TEAM-PM
+   - <TEAM>/ODIN
+   - <TEAM>/DEV-1
+   - <TEAM>/QA-1
+   - <TEAM>/SHADOW-1
+
+Phase 2 - default model/harness profile:
+Use exact model names when available. When a named family version is unavailable, use the latest available same-family model and record the substitution.
+
+- A/EXEC-PM: Codex CLI, GPT-5.5, high reasoning.
+- A/EXEC-ODIN: Codex CLI, GPT-5.5, xhigh/max-equivalent reasoning.
+- A/EXEC-ASST: Claude Code, latest available Claude Haiku.
+- A/EXEC-RSCH: Droid, Kimi K2.6, high reasoning.
+- A/EXEC-QA: Droid, Kimi K2.6, high reasoning.
+- <TEAM>/TEAM-PM: Claude Code, Claude Opus 4.7 or latest available Opus, high reasoning when supported.
+- <TEAM>/ODIN: Codex CLI, GPT-5.5, low reasoning.
+- <TEAM>/DEV-1: Droid, Kimi K2.6, high reasoning.
+- <TEAM>/QA-1: Crush, GLM-5.1, high reasoning.
+- <TEAM>/SHADOW-1: Droid, Kimi K2.6, high reasoning.
+
+Fallback:
+- If Crush fails for a worker-style role, try Droid.
+- If Crush and Droid both fail, use Claude Code with Claude Sonnet 4.6 or latest available Sonnet.
+- Record every substitution in the team manifest and boot receipt.
+
+Phase 3 - role interchangeability contract:
+Record this in the startup artifact and dissemination text:
+- Any supported agent can serve any SCP role when assigned that role and booted with the correct role contract.
+- Role is per-assignment. Harness identity, model family, pane name, or vendor brand does not grant authority.
+- Use generic role names in panes/tabs where possible: `EXEC PM`, `EXEC ODIN`, `EXEC ASST`, `EXEC RSCH`, `EXEC QA`, `TEAM PM`, `TEAM ODIN`, `DEV WORKER`, `QA WORKER`, and `SHADOW REVIEWER`.
+- ODIN roles are meta-control roles accountable to user authority. They coordinate with PM roles but are not PM subordinates.
+- Control-plane roles do not implement worker deliverables, author worker evidence, or perform QA acceptance by default.
+- An agent may not QA and close the same deliverable.
+- Text left in a terminal input bar is not delivery. Terminal delegation requires enter/send plus screen confirmation and later ack observation or follow-up.
+
+Phase 4 - receipts:
+1. Create `SCP-TEAM-MANIFEST` before dispatching product work.
+2. Require `SCP_BOOT_RECEIPT` from every role before activation.
+3. Minimal parking receipts may be used during initial setup, but real work requires full receipt.
+4. Control/sentinel panes must emit `[SCP-POLL]`, `[SCP-DELEGATE]`, `[SCP-TERMINAL-DELIVERY]` or `[SCP-CMUX-DELIVERY]`, `[SCP-COORDINATION]`, `[SCP-IDLE]`, `[SCP-FREEZE]`, and `[SCP-FINISH]` receipts as applicable.
+
+Phase 5 - ODIN mesh:
+1. At bootstrap, every ODIN sends every other ODIN a short identity and team-composition message.
+2. During active execution, run the default 10-minute ODIN round-robin health/status cadence unless the user changes it.
+3. The executive ODIN compiles the round-robin report and delivers it to EXEC PM after checking for outstanding dispatch/switchboard communications.
+
+Phase 6 - closeout:
+`$odin-scp --finish` starts controlled closeout, not product work.
+
+Use one of two modes:
+- `PARK_FOR_CONTINUITY`: keep CMUX role slots open, reset/park occupants, and preserve continuity for restart.
+- `FULL_SESSION_SHUTDOWN`: after handoffs and snapshots, quit each live agent occupant with the correct harness/app exit path, verify exit, then close its CMUX surface/pane, leaving only the user-designated final surface.
+
+Final report:
+- State branch, HEAD, upstream, clean/dirty status.
+- State handoffs discovered and which one controlled startup.
+- State exact team topology and model/harness substitutions.
+- State startup/activation status.
+- State what was not touched.
+- State what remains pending before product execution.
+```

package/protocol/skill-references/harness-skill-targets.md

@@ -0,0 +1,56 @@
+# SCP Harness Skill Targets
+
+This file records local skill/adapters for SCP policy access. Verify live paths before claiming a harness uses a native skill loader.
+
+## Source Of Truth And Sync Policy
+
+Master editable source:
+
+- `~/.agents/skills/odin-scp/`
+
+Runtime copies are synchronized snapshots, not independent policy forks. Edit the master first, then run `scripts/sync-installations.sh` from the master directory to copy the full directory to each native `SKILL.md` target and verify hashes.
+
+After every sync, verify all native `SKILL.md` files have the same SHA-256 hash and that adapters mention the current mandatory markers: `SCP_BOOT_RECEIPT`, `SCP-TEAM-MANIFEST`, `[SCP-DELEGATE]`, `[SCP-CMUX-DELIVERY]`, `[SCP-FINISH]`, `$odin-scp --finish`, `HOOK-EXCEPTION`, `BLOCKED_BY_LIMIT`, control-plane non-implementation, self-bootstrap, and post-run hygiene reset.
+
+## Native or Apparent SKILL.md Targets
+
+Install the `odin-scp` skill directory into:
+
+- Codex: `~/.codex/skills/odin-scp`
+- Claude Code: `~/.claude/skills/odin-scp`
+- Shared agent pool: `~/.agents/skills/odin-scp`
+- Goose: `~/.config/goose/skills/odin-scp`
+- KiloCode: `~/.kilocode/skills/odin-scp`
+- Cursor shared skills: `~/.cursor/skills/odin-scp`
+- Cursor-specific skills: `~/.cursor/skills-cursor/odin-scp`
+- OpenHands: `~/.openhands/skills/odin-scp`
+- Pi: `~/.pi/agent/skills/odin-scp`
+
+## Adapter Targets
+
+These harnesses were present locally but do not expose the same verified native skill directory in the inspected configuration:
+
+- OpenCode: install adapter prompt at `~/.config/opencode/skills/odin-scp/SKILL.md` and `~/.opencode/skills/odin-scp/SKILL.md`.
+- Droid: use `--append-system-prompt-file` with the canonical prompt adapter, or paste the Boot Block plus role assignment into the pane.
+- Crush: install a command adapter at `~/.crush/commands/odin-scp.md`.
+- Zed: install a file adapter at `~/.zed/skills/odin-scp/SKILL.md`; Zed/ACP agents can also be started with the canonical prompt pasted into the agent panel.
+
+## Fallback Rule
+
+If a harness cannot load SKILL.md directly, it is still eligible for any SCP role when the dispatch prompt embeds:
+
+1. The active role.
+2. The `SCP_BOOT_RECEIPT`.
+3. `authority_layer`, `may_implement`, `may_qa_accept`, `delegates_to`, `reports_to`, and `worker_exception_authority`.
+4. The exact write scope.
+5. The canonical repo path.
+6. The closure label rules.
+7. The adversarial QA requirement.
+8. Hook/validator exception rules.
+9. Branch-authority preclaim gates.
+10. `[SCP-POLL]`, `[SCP-DELEGATE]`, `[SCP-CMUX-DELIVERY]`, `[SCP-COORDINATION]`, `[SCP-IDLE]`, `[SCP-FREEZE]`, and `[SCP-FINISH]` receipt requirements.
+11. The control-plane non-implementation rule.
+12. The self-bootstrap team lifecycle and `SCP-TEAM-MANIFEST` requirement when one `EXEC PM` pane is asked to create teams.
+13. A pointer to the branch-visible SCP package once adoption is active.
+
+Interchangeability means any harness can occupy any role when given the same role contract and proof gates. It does not mean an agent may self-accept, self-close, or ignore separation of duties.