create-harness-vibe-coding 0.8.17 → 0.8.18

package/templates/common/Harness/specs/protocols/MEMORY_PROTOCOL.md

@@ -10,6 +10,21 @@ Memory is downstream of evidence. It records reusable patterns, not raw transcri
 - **L2 = Startup Digest**: `Harness/memory/startup-hints.md`. Lightweight hints loaded at session start. Not a replacement for full router.
 - **L3 = Detailed Durable Memory**: `Harness/memory/*.md` files. Loaded only when scenario matches via `routes.md`.
 
+## Project/Global Memory Boundary
+
+- `Harness/tasks/` and `Harness/PROGRESS.md` are always project-local, even when the Harness runtime is installed globally.
+- Project memory lives in `Harness/memory/` and records repo-specific lessons, preferences, and tool patterns.
+- Global memory may live under the selected global Harness directory for cross-project lessons and preferences.
+- Global memory must never store project task state, secrets, raw transcripts, or private project facts.
+
+## Project/Global Settings Boundary
+
+- Project settings live in `Harness/settings.json` and override global settings.
+- Global settings defaults live in the selected global Harness runtime under `Harness/settings.json`.
+- Host-global settings are copied, not symlinked, into Claude Code, Codex, and OpenCode user config directories.
+- Settings and memory must never store secrets; use external secret stores or environment variables.
+- Existing user-authored config, command, skill, or agent files are user-owned unless they carry a Harness ownership marker.
+
 ## When To Write Memory
 
 Write memory when any condition applies:

package/templates/common/Harness/specs/protocols/TASK_ARCHIVE.md

@@ -46,15 +46,21 @@ machine state.
 - Do NOT delete historical evidence.
 - `Harness/PROGRESS.md` keeps the last 5 non-archived task entries in the Task
   Index.
-- When outer task capsules exceed 5 completed/abandoned/obsolete tasks, archive
-  the oldest safe tasks.
+- When outer task capsules exceed 5 completed/abandoned/obsolete tasks, remind
+  the user to run the task archive command. Do not auto-archive during unrelated
+  validation or closeout unless the user explicitly invokes archive apply mode.
 - The validator (`Harness/scripts/validate-harness.mjs`) warns when
   `Harness/tasks/` holds more than 5 outer task capsules (excluding `_archive`,
   `_template`, `auto`) and fails in `--strict` mode.
 
 ## Script
 
-Use `Harness/scripts/task-state.mjs archive`:
+User-facing command:
+
+- Codex: `$wf-task-archive` or `/skills wf-task-archive`.
+- Claude Code/OpenCode: `/wf-task-archive`.
+
+Underlying implementation: `Harness/scripts/task-state.mjs archive`.
 
 - Default: dry-run.
 - `--apply` to execute.

package/templates/common/Harness/specs/runtime/command-surface.json

@@ -0,0 +1,215 @@
+{
+  "schemaVersion": 1,
+  "commands": [
+    {
+      "id": "wf-help",
+      "classification": "direct",
+      "aliases": ["/wf-help", "$wf-help", "/skills wf-help"],
+      "entersWf": false,
+      "taskCapsulePolicy": "none",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf",
+      "classification": "workflow",
+      "aliases": ["/wf", "$wf", "/skills wf"],
+      "entersWf": true,
+      "taskCapsulePolicy": "required",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-max",
+      "classification": "workflow",
+      "aliases": ["/wf-max", "$wf-max", "/skills wf-max"],
+      "entersWf": true,
+      "taskCapsulePolicy": "required",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-auto",
+      "classification": "workflow",
+      "aliases": ["/wf-auto", "$wf-auto", "/skills wf-auto"],
+      "entersWf": true,
+      "taskCapsulePolicy": "auto-capsule-required",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-auto-spark",
+      "classification": "workflow",
+      "aliases": ["/wf-auto-spark", "$wf-auto-spark", "/skills wf-auto-spark"],
+      "entersWf": true,
+      "taskCapsulePolicy": "auto-capsule-required",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-review",
+      "classification": "workflow",
+      "aliases": ["/wf-review", "$wf-review", "/skills wf-review"],
+      "entersWf": true,
+      "taskCapsulePolicy": "use-current-or-create-when-needed",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-learn",
+      "classification": "workflow",
+      "aliases": ["/wf-learn", "$wf-learn", "/skills wf-learn"],
+      "entersWf": true,
+      "taskCapsulePolicy": "use-current-or-create-when-needed",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-browser",
+      "classification": "workflow",
+      "aliases": ["/wf-browser", "$wf-browser", "/skills wf-browser"],
+      "entersWf": true,
+      "taskCapsulePolicy": "required",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-readme",
+      "classification": "workflow",
+      "aliases": ["/wf-readme", "$wf-readme", "/skills wf-readme"],
+      "entersWf": true,
+      "taskCapsulePolicy": "required",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-update",
+      "classification": "direct",
+      "aliases": ["/wf-update", "$wf-update", "/skills wf-update"],
+      "entersWf": false,
+      "taskCapsulePolicy": "none",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-remove",
+      "classification": "workflow",
+      "aliases": ["/wf-remove", "$wf-remove", "/skills wf-remove"],
+      "entersWf": true,
+      "taskCapsulePolicy": "required",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-task-record",
+      "classification": "direct",
+      "aliases": ["/wf-task-record", "$wf-task-record", "/skills wf-task-record"],
+      "entersWf": false,
+      "taskCapsulePolicy": "creates-or-updates",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-task-list",
+      "classification": "direct",
+      "aliases": ["/wf-task-list", "$wf-task-list", "/skills wf-task-list"],
+      "entersWf": false,
+      "taskCapsulePolicy": "none",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-task-archive",
+      "classification": "direct",
+      "aliases": ["/wf-task-archive", "$wf-task-archive", "/skills wf-task-archive"],
+      "entersWf": false,
+      "taskCapsulePolicy": "none",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    },
+    {
+      "id": "wf-command-create",
+      "classification": "direct",
+      "aliases": ["/wf-command-create", "$wf-command-create", "/skills wf-command-create"],
+      "entersWf": false,
+      "taskCapsulePolicy": "required",
+      "surfaces": {
+        "claudeCommand": true,
+        "opencodeCommand": true,
+        "claudeSkill": true,
+        "codexSkill": true,
+        "helpRow": true
+      }
+    }
+  ]
+}

package/templates/common/Harness/specs/runtime/subagents.md

@@ -208,6 +208,12 @@ independent same-runtime subagent context; for broad WF-MAX review, dispatch
 agents report suggestions only. The controller accepts, rejects, or escalates
 each finding and owns the final decision.
 
+### OpenCode Reviewer Caveat
+
+`opencode run --agent reviewer`: current installed `.opencode/agents/reviewer.md`
+is `mode: subagent`; OpenCode falls back to the default agent. Probe before
+claiming primary-runner review. Prefer same-runtime reviewer subagent fallback.
+
 ## Subagent Status Handling
 
 | Status | Controller Action |

package/templates/common/Harness/specs/workflows/WF-MAX.md

@@ -86,6 +86,11 @@ Every Worker dispatch or peer-CLI call must be bounded by the controller's comma
 
 Record the channel actually used, command/tool form, timeout, exit status, and a <=250 token Evidence-Packet in the task capsule. Do not create ad hoc probe scripts or write peer-CLI output to `%TEMP%`; persistent evidence belongs only under the current task's `evidence/` directory when it is intentionally part of the task record.
 
+### Peer CLI Output Contract
+
+- `opencode run --agent reviewer`: installed agent is `mode: subagent` per `.opencode/agents/reviewer.md`. Do NOT claim primary-runner role use without a live probe.
+- Parse JSON/JSONL peer CLI output: fail on empty/non-JSON, error events, budget errors, fallback warnings, or missing final model text.
+
 ## Parallelism Priority
 
 1. Read-only exploration — max parallel, all readSets

package/templates/common/Harness/specs/workflows/WF-STATE.md

@@ -82,6 +82,67 @@ Use `Harness/scripts/task-state.mjs` as the deterministic state writer:
 Do not rely on prompt instructions alone to keep active task, task `STATE.json`,
 task `PROGRESS.md`, and root `Harness/PROGRESS.md` synchronized.
 
+## Links (Cross-Task Dependencies)
+
+STATE.json `links` enables cross-task dependency resolution without reading
+every task capsule:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `links.dependsOn` | `string[]` | Task IDs this task depends on (blockers) |
+| `links.blocks` | `string[]` | Task IDs this task blocks |
+| `links.related` | `string[]` | Related task IDs (no dependency direction) |
+
+When resolving `links.dependsOn`, the controller reads only the listed tasks'
+STATE.json, not all task capsules. A task with unresolved dependsOn entries
+should stay in the blocked queue until its dependencies resolve.
+
+## Work Items (Parallel Dispatch)
+
+STATE.json `workItems[]` enables fine-grained parallel dispatch tracking with
+per-item dependencies:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `id` | `string` | Unique item identifier |
+| `status` | `string` | `pending`, `ready`, `running`, `done`, `blocked`, `skipped`, `failed` |
+| `phase` | `string` | Phase this item belongs to |
+| `dependsOn` | `string[]` | Item IDs this item depends on |
+| `parallelGroup` | `string` | Group name for concurrent dispatch (optional) |
+| `readSet` | `string[]` | Files/patterns the item may read |
+| `writeSet` | `string[]` | Files/patterns the item may write |
+| `agent` | `string` | Agent role assigned (optional) |
+| `evidence` | `string` | Evidence path or summary (optional) |
+| `next` | `string` | Next action after this item completes (optional) |
+
+`workItems` is an additive array — it supplements the dispatchLedger and queues
+for finer-grained tracking. The dispatchLedger remains the canonical record of
+subagent dispatches.
+
+## Open Tasks
+
+"Open tasks" are non-archived task capsules with status one of:
+`active`, `in_progress`, `running`, `pending`, `blocked`,
+`needs-user-decision`.
+
+The active pointer (`Harness/PROGRESS.md`) marks the single task the agent
+should resume. Other open tasks remain visible in the Task Index but are not
+automatically loaded.
+
+## Queue Entry Normalization
+
+Queues (`ready`, `running`, `blocked`, `done`) accept both plain string entries
+and object entries. The normalization rules are backward-compatible:
+
+- A plain string entry is treated as a task or dispatch item ID.
+- An object entry may contain the same fields as a work item (`id`, `status`,
+  `dependsOn`, etc.) for richer inline tracking.
+- `task-state.mjs` preserves both forms during reconcile — it does not coerce
+  objects to strings or vice versa.
+
+This enables incremental adoption: existing STATE.json files with string-only
+queues continue to work without changes.
+
 ## Resume Protocol
 
 New window / session start:
@@ -99,6 +160,11 @@ New window / session start:
    - Queues: ready (can dispatch immediately), running (awaiting results),
      blocked (needs resolution), done.
    - nextAction (what to do next).
+   - **links.dependsOn**: if non-empty, check whether any dependency tasks are
+     still open (their STATE.json has a non-archived status). Report blocked
+     dependencies to the user.
+   - **workItems[]**: if non-empty, inspect items with status `running` or
+     `ready` for parallel dispatch candidates.
 4. Do NOT bulk-read `Harness/tasks/` to find context. Use the active pointer.
 5. Direct simple tasks may skip STATE/PLAN/PROGRESS unless the user says
    "continue"/"resume".

package/templates/common/Harness/tasks/_template/STATE.json

@@ -10,12 +10,18 @@
   "activeQuestion": null,
   "nextAction": "Define goal and acceptance criteria",
   "acceptance": [],
+  "links": {
+    "dependsOn": [],
+    "blocks": [],
+    "related": []
+  },
   "queues": {
     "ready": [],
     "running": [],
     "blocked": [],
     "done": []
   },
+  "workItems": [],
   "dispatchLedger": [],
   "decisions": [],
   "risks": [],