create-harness-vibe-coding 0.8.17 → 0.8.19

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

@@ -0,0 +1,229 @@
+{
+  "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
+      }
+    },
+    {
+      "id": "wf-ui",
+      "classification": "direct",
+      "aliases": ["/wf-ui", "$wf-ui", "/skills wf-ui"],
+      "entersWf": false,
+      "taskCapsulePolicy": "none",
+      "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-AUTO-SPARK.md

@@ -28,7 +28,7 @@ For task-state writes, CEO provides concise bullets and decisions; task-scribe f
 
 ## Startup: Roadmap Declaration
 
-Before first spark cycle, CEO MUST declare a roadmap. This is written to `Harness/tasks/auto/SPARK-ROADMAP.md`.
+Before first spark cycle, CEO MUST declare a roadmap. This is written to `Harness/tasks/continuous/SPARK-ROADMAP.md`.
 
 ### Roadmap Format
 
@@ -239,15 +239,15 @@ Re-Anchor Gate (every preset interval)
 
 ## Task Capsule & Recording
 
-WF-AUTO-SPARK uses a dedicated task capsule at `Harness/tasks/auto/`. Shared with `/wf-auto` — same capsule, different operational mode.
+WF-AUTO-SPARK uses a dedicated task capsule at `Harness/tasks/continuous/`. Shared with `/wf-auto` — same capsule, different operational mode.
 
 ### Capsule Structure
 
 | File | Purpose | Updated |
 |------|---------|---------|
-| `Harness/tasks/auto/SPARK-ROADMAP.md` | North Star + milestones + deviation log | At startup + every milestone change |
-| `Harness/tasks/auto/PLAN.md` | Current cycle's change spec (write set, acceptance criteria) | Before each implementation |
-| `Harness/tasks/auto/PROGRESS.md` | Cycle log, value reflections, cumulative stats, evidence | After each cycle |
+| `Harness/tasks/continuous/SPARK-ROADMAP.md` | North Star + milestones + deviation log | At startup + every milestone change |
+| `Harness/tasks/continuous/PLAN.md` | Current cycle's change spec (write set, acceptance criteria) | Before each implementation |
+| `Harness/tasks/continuous/PROGRESS.md` | Cycle log, value reflections, cumulative stats, evidence | After each cycle |
 | `Harness/PROGRESS.md` | Global task index — active spark session status | At session start, milestone, and stop |
 
 ### Heartbeat Protocol (per cycle, in `PROGRESS.md`)
@@ -314,9 +314,9 @@ This replaces the broken `/wf-auto` auto-continue. No silent drift across sessio
 | File | Purpose |
 |------|---------|
 | `Harness/specs/workflows/WF-AUTO-SPARK.md` | This spec |
-| `Harness/tasks/auto/SPARK-ROADMAP.md` | Active roadmap (created at startup) |
-| `Harness/tasks/auto/PLAN.md` | Per-cycle change spec |
-| `Harness/tasks/auto/PROGRESS.md` | Cycle log, heartbeat, evidence ledger |
+| `Harness/tasks/continuous/SPARK-ROADMAP.md` | Active roadmap (created at startup) |
+| `Harness/tasks/continuous/PLAN.md` | Per-cycle change spec |
+| `Harness/tasks/continuous/PROGRESS.md` | Cycle log, heartbeat, evidence ledger |
 | `Harness/PROGRESS.md` | Global task index linkage |
 | `.claude/skills/wf-auto-spark/SKILL.md` | Claude Code skill loader |
 | `.agents/skills/wf-auto-spark/SKILL.md` | Codex skill loader (mirror) |

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

@@ -113,7 +113,7 @@ WF-AUTO operates in explicit states. Without a state machine, "auto-degrade", "s
 | `auto.exhausted` | A-GATE passed permanently | Two different confirmation strategies return no actionable finding |
 | `paused` | User interrupted, waiting for direction | User says "stop" or interrupts at any point |
 
-**State transitions are CEO-owned.** The CEO decides which state to enter based on W0 results and checkpoint responses. The state machine is recorded in `Harness/tasks/auto/PROGRESS.md` at each transition.
+**State transitions are CEO-owned.** The CEO decides which state to enter based on W0 results and checkpoint responses. The state machine is recorded in `Harness/tasks/continuous/PROGRESS.md` at each transition.
 
 ## Adaptive coverage instead of a magic angle count
 
@@ -271,7 +271,7 @@ CEO NEVER writes production code (per WF-KERNEL State Ownership). Implementer wr
 
 ### RECORD
 
-Every cycle writes one entry to `Harness/tasks/auto/PROGRESS.md`:
+Every cycle writes one entry to `Harness/tasks/continuous/PROGRESS.md`:
 
 ```text
 ## Cycle N (timestamp) — State: auto.internal | auto.spark | auto.checkpoint
@@ -304,18 +304,18 @@ enabled `/wf-auto` tick hook may drive long-running auto-optimization.
 
 Manual or benchmark-driven single-cycle `/wf-auto` runs use the same bounded
 tick contract: they may stop because the caller explicitly requested one tick,
-but they still MUST create or update `Harness/tasks/auto/PLAN.md` and
-`Harness/tasks/auto/PROGRESS.md` before returning.
+but they still MUST create or update `Harness/tasks/continuous/PLAN.md` and
+`Harness/tasks/continuous/PROGRESS.md` before returning.
 
 The hook is not a role-enforcement mechanism, not a memory injection mechanism,
 and not WF-MAX state. It is only a bounded tick trigger:
 
 ```text
 wf-auto hook event
--> confirm /wf-auto is active in Harness/tasks/auto/
+-> confirm /wf-auto is active in Harness/tasks/continuous/
 -> check STOP/paused/user-interrupt state
 -> request exactly one W0-W5 tick or one Intent Checkpoint
--> append heartbeat/evidence to Harness/tasks/auto/PROGRESS.md
+-> append heartbeat/evidence to Harness/tasks/continuous/PROGRESS.md
 -> exit
 ```
 
@@ -324,7 +324,7 @@ Hard boundaries:
 - no execution-control hook is installed or registered by default
 - only `/wf-auto` may use a runtime hook to drive auto-optimization
 - the hook must run one bounded tick, not an unbounded process
-- the hook must respect `Harness/tasks/auto/STOP`, `state=paused`, user stop,
+- the hook must respect `Harness/tasks/continuous/STOP`, `state=paused`, user stop,
   and the Adaptive Coverage Exhaustion Gate
 - the hook must not enforce WF-MAX roles, writeSet, or agent identity
 - the hook must not inject memory directly; use `MEMORY_PROTOCOL.md` scenario
@@ -449,7 +449,7 @@ If a spark cycle's measured result is NEGLIGIBLE or REVERTED, increment `weakSpa
 
 ## CEO Constraints
 
-CEO tool boundaries follow [WF-KERNEL.md](WF-KERNEL.md) State Ownership: CEO plans, dispatches, synthesizes, and writes ONLY the auto task capsule (`Harness/tasks/auto/PROGRESS.md`, `Harness/tasks/auto/PLAN.md`). CEO never writes production source code — all implementation is delegated to Workers.
+CEO tool boundaries follow [WF-KERNEL.md](WF-KERNEL.md) State Ownership: CEO plans, dispatches, synthesizes, and writes ONLY the auto task capsule (`Harness/tasks/continuous/PROGRESS.md`, `Harness/tasks/continuous/PLAN.md`). CEO never writes production source code — all implementation is delegated to Workers.
 
 ## Anti-Pattern Catalog
 
@@ -509,10 +509,10 @@ Mini PRD-derived AC IDs in `/wf-auto`.
 
 ## Task Capsule
 
-WF-AUTO uses a dedicated task capsule at `Harness/tasks/auto/`:
+WF-AUTO uses a dedicated task capsule at `Harness/tasks/continuous/`:
 
-- `Harness/tasks/auto/PROGRESS.md` — cycle log, exhaustion evidence, cumulative stats
-- `Harness/tasks/auto/PLAN.md` — current cycle's change spec
+- `Harness/tasks/continuous/PROGRESS.md` — cycle log, exhaustion evidence, cumulative stats
+- `Harness/tasks/continuous/PLAN.md` — current cycle's change spec
 
 Unlike normal task capsules, this one is never archived — it's the permanent home of the auto-optimization state.
 
@@ -522,6 +522,6 @@ Closeout happens exactly once, when A-GATE passes permanently:
 
 1. CEO records final exhaustion evidence: dynamic obligations, selected and skipped probes, coverage, confidence, and two different confirmation strategies
 2. CEO writes summary: total cycles, files changed, findings addressed, findings rejected, residual risk
-3. CEO marks `Harness/tasks/auto/PROGRESS.md` as "WF-AUTO EXHAUSTED" with timestamp
+3. CEO marks `Harness/tasks/continuous/PROGRESS.md` as "WF-AUTO EXHAUSTED" with timestamp
 4. `Harness/PROGRESS.md` is updated with the auto session outcome
 5. No further automatic action is taken

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/NAMING.md

@@ -3,20 +3,20 @@
 ## Format
 
 ```
-task-<verb>-<noun>[-detail]
+task-<verb>-<noun>[-detail]-<MMDD>
 ```
 
-All task directories MUST have the `task-` prefix. This distinguishes tasks from system directories at a glance.
+All task directories MUST have the `task-` prefix and end with a 4-digit month-day suffix (MMDD, e.g. `0729` for July 29). This distinguishes tasks from system directories and provides chronological ordering.
 
 ## Rules
 
 | Rule | Example ✓ | Example ✗ |
 |------|-----------|-----------|
-| `task-` prefix required | `task-fix-ceo-inheritance` | `fix-ceo-inheritance` |
-| kebab-case (lowercase, hyphens) | `task-fix-ceo-inheritance` | `task-fix_ceo_inheritance` |
-| Verb-first after prefix | `task-add-goal-persistence` | `task-goal-persistence-add` |
-| 2-5 words after prefix, <=46 total chars | `task-refactor-role-contract` | `task-refactor-the-entire-role-contract-model` |
-| No abbreviations unless domain-standard | `task-fix-auth-middleware` | `task-fx-ath-mdw` |
+| `task-` prefix + MMDD suffix required | `task-fix-ceo-inheritance-0730` | `fix-ceo-inheritance-0730` |
+| kebab-case (lowercase, hyphens) | `task-fix-ceo-inheritance-0730` | `task-fix_ceo_inheritance-0730` |
+| Verb-first after prefix | `task-add-goal-persistence-0730` | `task-goal-persistence-add-0730` |
+| 2-5 words after prefix + MMDD date, <=46 total chars | `task-refactor-role-contract-0729` | `task-refactor-the-entire-role-contract-model-0729` |
+| No abbreviations unless domain-standard | `task-fix-auth-middleware-0730` | `task-fx-ath-mdw-0730` |
 
 ## Reserved Names
 
@@ -27,7 +27,7 @@ All task directories MUST have the `task-` prefix. This distinguishes tasks from
 
 ## Task ID Lifecycle
 
-1. Created by copying `_template/` → `task-<verb>-<noun>/`
+1. Created by copying `_template/` → `task-<verb>-<noun>-<MMDD>/`
 2. Directory name IS the task ID - used in `Harness/PROGRESS.md` and dispatch packets
 3. Directory archived (not renamed) when task completes
 4. Task ID is immutable after creation (changing it breaks cross-references)
@@ -36,12 +36,12 @@ All task directories MUST have the `task-` prefix. This distinguishes tasks from
 ## Examples
 
 ```
-task-add-dark-mode-support
-task-fix-auth-token-expiry
-task-update-harness-lifecycle-docs
-task-remove-legacy-config-files
-task-refactor-agent-dispatch-model
-task-migrate-to-esm-imports
-task-audit-security-headers
-task-benchmark-wf-max-throughput
+task-add-dark-mode-support-0729
+task-fix-auth-token-expiry-0730
+task-update-harness-lifecycle-docs-0728
+task-remove-legacy-config-files-0731
+task-refactor-agent-dispatch-model-0801
+task-migrate-to-esm-imports-0802
+task-audit-security-headers-0803
+task-benchmark-wf-max-throughput-0804
 ```

package/templates/common/Harness/tasks/_template/PLAN.md

@@ -1,80 +1,37 @@
 # {{TASK_ID}} - PLAN
 
-Compact task record. Keep only facts needed to resume, review, and verify.
-Link files or command names instead of pasting logs or subagent transcripts.
-
-> Task ID: kebab-case, under 60 chars. Directory name = task ID.
+Compact task record. Default: keep 1-3 concise ACs unless the task explicitly needs a broader acceptance matrix.
 
 ## Goal
 
 - Outcome:
 - Non-goals:
 
-## Decisions
-
--
-
-## Acceptance
-
-Default: keep 1-3 concise ACs. Expand only for UI/API/security/data-loss,
-cross-module, or other high-risk behavior.
-
-- AC-001:
-
-Expanded evidence required when triggered:
-- UI/browser-visible: add selector contract and real browser evidence.
-- API/integration: add endpoint/payload/response contract.
-- High-risk behavior: add AC-by-AC validation matrix.
-
 ## Scope
 
-Allowed write set:
--
-
-Forbidden:
--
-- Truth files (PRD, ACs, UI/API contracts, test plan, validation report) unless a Change Request is recorded.
-
-## Memory Preflight
-
-- Memory preflight: done | exempt | blocked
-- Memory hints: none | <file/path + reason>
+- Write set:
+- Forbidden:
 
-## Context
-
-- Loaded:
-- Assumptions:
-
-## Agents
-
-Only record agents or bounded passes that materially changed the decision.
-
-| Role | Read / Write Set | Result |
-|------|------------------|--------|
+## Decisions
 
-## Verification
+| # | Decision | Reason | Date |
+|---|----------|--------|------|
+|   |          |        |      |
 
-- [ ]
+## Acceptance
 
-## Risks
+| ID | Criterion | Evidence | Status |
+|----|-----------|----------|--------|
+| AC-001 |           |          | pending |
 
--
+Expanded evidence required when triggered by high-risk changes, broad cross-file edits, release work, or user request.
 
 ## Expanded Contracts
 
-Use this section only when the Acceptance triggers above apply.
-
-### UI Contract
-
-| Element | Selector / Role | States | AC IDs |
-|---------|-----------------|--------|--------|
+- Add Given/When/Then, selector contracts, migration notes, or release evidence only when the task risk requires it.
 
-### API Contract
-
-| Endpoint | Method | Payload / Response | AC IDs |
-|----------|--------|--------------------|--------|
-
-### Validation Matrix
+## Risks
 
-| AC ID | Result | Evidence | Notes |
-|-------|--------|----------|-------|
+| Risk | Mitigation | Status |
+|------|------------|--------|
+|      |            |        |

package/templates/common/Harness/tasks/_template/PROBLEM.md

@@ -0,0 +1,18 @@
+# {{TASK_ID}} - PROBLEM
+
+Record problems, root causes, and fixes. One entry per distinct problem.
+Delete files that prove nothing.
+
+## Active
+
+| ID | Problem | Root cause | Fix | Status |
+|----|---------|------------|-----|--------|
+|   |         |            |     |        |
+
+## Resolved
+
+| ID | Problem | Root cause | Fix | Resolved |
+|----|---------|------------|-----|----------|
+|   |         |            |     |          |
+
+Status: open | investigating | blocked | fixed

package/templates/common/Harness/tasks/_template/PROGRESS.md

@@ -1,26 +1,21 @@
 # {{TASK_ID}} - PROGRESS
 
-Compact heartbeat. Update on phase changes, blockers, failures, and closeout.
-Do not paste logs; record the command/file that proves the state.
+Compact heartbeat.
 
-## Status
+Phase heartbeat. Update on transitions, blockers, verification. Keep under 20 lines.
+
+## Current
 
 - Phase: Intake
 - Next:
 - Blocker: none
 
-## Tasks
-
-- [ ] Define goal and scope
-
-## Changes
-
--
-
 ## Verification
 
--
+- [ ] verification command
 
-## Notes
+## Log
 
--
+| Date | Phase | Note |
+|------|-------|------|
+|      |       |      |