@bradheitmann/odin-sentinel 0.4.5 → 0.4.7

package/templates/pm-role-template.md

@@ -0,0 +1,61 @@
+# PM Role Template
+
+Use this as a public starter template for an ODIN Sentinel PM role.
+
+## Team Objective
+
+- Outcome: `<desired result>`
+- Deadline or session boundary: `<timebox>`
+- Human operator: `<name or role>`
+
+## Roles
+
+- EXEC PM: owns launch/activation, readiness waivers or substitutions, CMUX
+  topology, staffing, final claim framing, and escalation.
+- TEAM PM: owns routing and worker activation inside an assigned team after EXEC
+  PM launch. TEAM PM cannot staff new occupants, waive launch readiness, mutate
+  CMUX topology, or close lifecycle unless EXEC PM explicitly delegates it.
+- ODIN: monitors health, scope, delivery, and drift; intervenes or escalates.
+- DEV: implements assigned write scope only.
+- QA: verifies independently and reports PASS/FAIL.
+
+## Readiness Gates
+
+- Node.js version satisfies package metadata: `<status>`
+- ODIN MCP server configured and smoke-tested: `<status>`
+- Native skill or prompt fallback available: `<status>`
+- CMUX workspace and role slots ready: `<status>`
+- Harness auth/account readiness checked: `<status>`
+- Local inference smoke-tested if used: `<status>`
+- Role compatibility smoke test passed: `<status>`
+- Launch/waiver authority holder: `A/EXEC-PM`
+
+## Operator-Friendly Status
+
+- Plain-language summary: `<what is happening in one sentence>`
+- Current blocker, if any: `<sign-in | permission prompt | API/account setup | local model smoke test | none>`
+- Safe next choice for the human operator: `<approve | sign in | choose fallback harness | keep slot vacant | ask for help>`
+- Secret-handling reminder: `Do not paste API keys or tokens into chat.`
+
+## Assignments
+
+- `<role slot>` -> `<agent/harness>` -> `<scope>`
+
+## Blockers And Escalation
+
+- Blocker: `<description>`
+- Owner: `<role>`
+- Escalate to human when: `<condition>`
+
+## User-Defined Criteria
+
+- `<project-specific criterion>`
+
+## Minimal Filled Example
+
+- Outcome: `Clarify install documentation for first-time users`
+- Human operator: `project maintainer`
+- Readiness summary: `MCP smoke test passes; Claude Code sign-in still needed`
+- Safe next choice: `sign in to Claude Code, choose another harness, or keep that slot vacant`
+- Assignment: `B/DEV-1 -> Codex -> README.md only`
+- User-defined criterion: `Do not ask the operator to paste API keys`

package/templates/qa-slice-template.md

@@ -0,0 +1,46 @@
+# QA Slice Template
+
+Use this as a public starter template. Replace every placeholder before launch.
+
+## Parent DEV Reference
+
+- DEV task: `<task id or title>`
+- DEV changed files: `<list supplied by DEV>`
+- Expected verification: `<commands or checks>`
+
+## Fresh-Context Review
+
+QA starts from the task contract and changed files, not from DEV's confidence.
+
+## Checks
+
+- Acceptance criteria:
+  - `<criterion>` -> PASS/FAIL
+- Scope compliance:
+  - Only declared write-allowed files changed: PASS/FAIL
+- Security/privacy:
+  - No secrets printed or committed: PASS/FAIL
+  - No unsafe permission or auth behavior: PASS/FAIL
+- Regression risk:
+  - Relevant tests or manual checks reproduced: PASS/FAIL
+- User-defined criteria:
+  - `<project-specific criterion>` -> PASS/FAIL
+
+## QA Verdict
+
+Return one verdict:
+
+- PASS: all required checks passed.
+- FAIL: one or more required checks failed.
+- BLOCKED: QA could not verify because required evidence, access, or commands are missing.
+
+QA reports issues. QA does not fix code during the QA pass.
+
+## Minimal Filled Example
+
+- DEV task: `Update one README paragraph to clarify install steps`
+- DEV changed files: `README.md`
+- Expected verification: `pnpm test`
+- Acceptance criterion: `README explains global and zero-install paths`
+- Scope compliance: `Only README.md changed`
+- Verdict: `PASS`, `FAIL`, or `BLOCKED` with one-sentence evidence

package/templates/team-manifest-template.yaml

@@ -0,0 +1,163 @@
+session_id: "<session-id>"
+topology:
+  mode: "governed-team"
+  cmux_required: true
+  cmux_workspace: "<workspace-ref>"
+  layout: "human-readable spatial/pod organization"
+executive_office:
+  - "A/EXEC-PM"
+  - "A/EXEC-ODIN"
+  - "A/EXEC-ASST"
+development_pods:
+  - "B"
+odin_mesh:
+  cadence_seconds: 30
+  executive_odin: "A/EXEC-ODIN"
+  team_odins:
+    - "B/ODIN"
+model_profile:
+  minimum_compatible_child_mcp_version: "0.4.5"
+  inference_provider_inventory: []
+handoff_sources:
+  - "<handoff path or none>"
+startup_objectives:
+  - "<plain-language objective>"
+role_slots:
+  - role_slot: "A/EXEC-PM"
+    harness: "<harness>"
+    readiness_status: "PASS"
+    layout_locator:
+      workspace: "<workspace-ref>"
+      pane: "<pane-ref>"
+      surface: "<surface-ref>"
+    scp_context_source: "native sentinel-coordination-protocol skill"
+    mcp_available: true
+    mcp_version: "0.4.5"
+    scp_skill_available: true
+    full_protocol_text_injected: false
+    watcher: "A/EXEC-ODIN"
+  - role_slot: "A/EXEC-ODIN"
+    harness: "<harness>"
+    readiness_status: "PASS"
+    layout_locator:
+      workspace: "<workspace-ref>"
+      pane: "<pane-ref>"
+      surface: "<surface-ref>"
+    scp_context_source: "native sentinel-coordination-protocol skill"
+    mcp_available: true
+    mcp_version: "0.4.5"
+    scp_skill_available: true
+    full_protocol_text_injected: false
+    watches:
+      - "A/EXEC-PM"
+      - "B/ODIN"
+  - role_slot: "B/ODIN"
+    harness: "<harness>"
+    readiness_status: "PASS"
+    layout_locator:
+      workspace: "<workspace-ref>"
+      pane: "<pane-ref>"
+      surface: "<surface-ref>"
+    scp_context_source: "native sentinel-coordination-protocol skill"
+    mcp_available: true
+    mcp_version: "0.4.5"
+    scp_skill_available: true
+    full_protocol_text_injected: false
+    watches:
+      - "B/TEAM-PM"
+      - "B/DEV-1"
+  - role_slot: "B/DEV-1"
+    harness: "<harness>"
+    readiness_status: "PASS"
+    layout_locator:
+      workspace: "<workspace-ref>"
+      pane: "<pane-ref>"
+      surface: "<surface-ref>"
+    scp_context_source: "native sentinel-coordination-protocol skill"
+    mcp_available: true
+    mcp_version: "0.4.5"
+    scp_skill_available: true
+    full_protocol_text_injected: false
+    watcher: "B/ODIN"
+fallback_policy:
+  non_governed_one_shot_only: "Allowed only for bounded, non-persistent help when MCP/skill/protocol proof is absent. Not suitable for a persistent governed role."
+operator_friendly_status:
+  summary: "<what is happening in one sentence>"
+  current_blocker: "<sign-in | permission prompt | API/account setup | local model smoke test | none>"
+  safe_next_choice: "<approve | sign in | choose fallback harness | keep slot vacant | ask for help>"
+user_defined_criteria:
+  - "<project-specific criterion>"
+
+# Minimal filled example
+#
+# session_id: "example-session"
+# topology:
+#   mode: "governed-team"
+#   cmux_required: true
+#   cmux_workspace: "workspace:1"
+#   layout: "A executive office plus B development pod"
+# executive_office:
+#   - "A/EXEC-PM"
+#   - "A/EXEC-ODIN"
+# development_pods:
+#   - "B"
+# odin_mesh:
+#   cadence_seconds: 30
+#   executive_odin: "A/EXEC-ODIN"
+#   team_odins:
+#     - "B/ODIN"
+# model_profile:
+#   minimum_compatible_child_mcp_version: "0.4.5"
+#   inference_provider_inventory: []
+# handoff_sources:
+#   - "none"
+# startup_objectives:
+#   - "Clarify install documentation for first-time users"
+# role_slots:
+#   - role_slot: "A/EXEC-PM"
+#     harness: "Codex"
+#     readiness_status: "PASS"
+#     layout_locator:
+#       workspace: "workspace:1"
+#       pane: "pane:1"
+#       surface: "surface:1"
+#     scp_context_source: "native sentinel-coordination-protocol skill"
+#     mcp_available: true
+#     mcp_version: "0.4.5"
+#     scp_skill_available: true
+#     full_protocol_text_injected: false
+#     watcher: "A/EXEC-ODIN"
+#   - role_slot: "B/ODIN"
+#     harness: "Codex"
+#     readiness_status: "PASS"
+#     layout_locator:
+#       workspace: "workspace:1"
+#       pane: "pane:2"
+#       surface: "surface:2"
+#     scp_context_source: "native sentinel-coordination-protocol skill"
+#     mcp_available: true
+#     mcp_version: "0.4.5"
+#     scp_skill_available: true
+#     full_protocol_text_injected: false
+#     watches:
+#       - "B/TEAM-PM"
+#       - "B/DEV-1"
+#   - role_slot: "B/DEV-1"
+#     harness: "Codex"
+#     readiness_status: "PASS"
+#     layout_locator:
+#       workspace: "workspace:1"
+#       pane: "pane:2"
+#       surface: "surface:3"
+#     scp_context_source: "odin-sentinel MCP at or above minimum version"
+#     mcp_available: true
+#     mcp_version: "0.4.5"
+#     scp_skill_available: false
+#     full_protocol_text_injected: false
+#     watcher: "B/ODIN"
+# operator_friendly_status:
+#   summary: "Docs update is ready to dispatch."
+#   current_blocker: "none"
+#   safe_next_choice: "launch B/DEV-1"
+# user_defined_criteria:
+#   - "Do not ask the operator to paste API keys."