create-harness-vibe-coding 0.8.6 → 0.8.8

package/templates/common/Harness/context-loading.md

@@ -1,142 +1,142 @@
-# Context Loading Protocol
-
-Use when context is growing, subagents are needed, or an agent is unsure which harness doc applies.
-
-## Routing Authority
-
-`Harness/README.md` is the primary router. This file is a secondary context-splitting protocol for subagents and long tasks.
-
-If this file and `Harness/README.md` disagree, follow `Harness/README.md`, record the assumption in `Harness/tasks/<task-id>/PROGRESS.md`, and update this file later.
-
-project files are the only durable communication channel; chat/subagent transcript state is non-authoritative. Important assumptions, decisions, blockers, evidence, and handoffs must be written to `Harness/tasks/<task-id>/PROGRESS.md` and `Harness/tasks/<task-id>/PLAN.md`, the current feature doc, `Harness/MEMORY.md`, or `Harness/memory/*` as appropriate.
-
-## Main Context
-
-Always keep:
-
-- `CLAUDE.md`
-- `Harness/MEMORY.md`
-- `Harness/README.md`
-- `Harness/PROGRESS.md` when active
-- `Harness/tasks/<task-id>/PROGRESS.md` when active
-- `Harness/tasks/<task-id>/PLAN.md` when active
-- current feature doc when active
-
-Load other docs only by trigger.
-
-## Trigger Matrix
-
-| Trigger | Load |
-| --- | --- |
+# Context Loading Protocol
+
+Use when context is growing, subagents are needed, or an agent is unsure which harness doc applies.
+
+## Routing Authority
+
+`Harness/README.md` is the primary router. This file is a secondary context-splitting protocol for subagents and long tasks.
+
+If this file and `Harness/README.md` disagree, follow `Harness/README.md`, record the assumption in `Harness/tasks/<task-id>/PROGRESS.md`, and update this file later.
+
+project files are the only durable communication channel; chat/subagent transcript state is non-authoritative. Important assumptions, decisions, blockers, evidence, and handoffs must be written to `Harness/tasks/<task-id>/PROGRESS.md` and `Harness/tasks/<task-id>/PLAN.md`, the current feature doc, `Harness/MEMORY.md`, or `Harness/memory/*` as appropriate.
+
+## Main Context
+
+Always keep:
+
+- `CLAUDE.md`
+- `Harness/MEMORY.md`
+- `Harness/README.md`
+- `Harness/PROGRESS.md` when active
+- `Harness/tasks/<task-id>/PROGRESS.md` when active
+- `Harness/tasks/<task-id>/PLAN.md` when active
+- current feature doc when active
+
+Load other docs only by trigger.
+
+## Trigger Matrix
+
+| Trigger | Load |
+| --- | --- |
 | idea, scope, MVP | `Harness/lifecycle.md`, `Harness/research/PRD.md`, `Harness/ACCEPTANCE_PROTOCOL.md` |
 | acceptance, AC, criteria, contract, validation matrix | `Harness/ACCEPTANCE_PROTOCOL.md`, `Harness/AGENT_ISOLATION.md`, `Harness/HARNESS_BRIDGE.md` as needed |
 | research, competitors, stack choice | `Harness/research/README.md`, `Harness/research/research-results.md` |
-| task split, owner, write set | `Harness/tasks/<task-id>/PROGRESS.md`, `Harness/tasks/<task-id>/PLAN.md`, `Harness/agent-workflow.md` |
-| parallel agents, dispatch, worktree decision | `Harness/subagents.md`, `Harness/dispatch.md`, `Harness/tasks/<task-id>/PLAN.md` |
-| `/wf` mode, long task, multi-file, multi-agent | `Harness/WF.md`, `Harness/subagents.md`, `Harness/dispatch.md`, `Harness/tasks/<task-id>/PLAN.md` |
-| `/wf max`, 5+ disjoint files, maximum parallelism | `Harness/WF-MAX.md`, `Harness/subagents.md`, `Harness/dispatch.md`, `Harness/tasks/<task-id>/PLAN.md` |
+| task split, owner, write set | `Harness/tasks/<task-id>/PROGRESS.md`, `Harness/tasks/<task-id>/PLAN.md`, `Harness/agent-workflow.md` |
+| parallel agents, dispatch, worktree decision | `Harness/subagents.md`, `Harness/dispatch.md`, `Harness/tasks/<task-id>/PLAN.md` |
+| `/wf` mode, long task, multi-file, multi-agent | `Harness/WF.md`, `Harness/subagents.md`, `Harness/dispatch.md`, `Harness/tasks/<task-id>/PLAN.md` |
+| `/wf max`, 5+ disjoint files, maximum parallelism | `Harness/WF-MAX.md`, `Harness/subagents.md`, `Harness/dispatch.md`, `Harness/tasks/<task-id>/PLAN.md` |
 | memory, scenario memory, repeated tool failure, repeated user correction, reusable lesson | `Harness/MEMORY.md`, `Harness/MEMORY_PROTOCOL.md`, the relevant `Harness/memory/*.md` file |
 | subagent spawn | `Harness/subagents.md`, `Harness/AGENT_ISOLATION.md`, this file plus the role pack below |
-
-## ECC Rules Per Role
-
-Each subagent role loads a specific ECC rule subset. The dispatcher MUST include
-`ecc` in the dispatch packet so the subagent knows which rules to read first.
-
-| Role | Frontend Task | Backend Task | Full-Stack Task |
-|------|--------------|-------------|-----------------|
-| **Explorer** | `web/patterns.md`, `web/design-quality.md` | `common/patterns.md`, stack patterns | All |
-| **Planner** | `common/patterns.md`, `web/patterns.md` | `common/patterns.md`, stack patterns | All |
-| **Architect** | `web/patterns.md`, `web/performance.md` | `common/patterns.md`, `python/fastapi.md` or `golang/patterns.md` | All + API contract |
-| **Implementer (FE)** | `web/design-quality.md`, `web/patterns.md`, `web/performance.md`, `typescript/patterns.md` | N/A | Frontend subset |
-| **Implementer (BE)** | N/A | `common/patterns.md`, `python/fastapi.md` or `golang/patterns.md` | Backend subset |
-| **Test Writer** | `web/testing.md`, `typescript/testing.md` | Stack testing rules | Both |
-| **Reviewer** | `web/design-quality.md`, `web/security.md`, `web/performance.md` | Stack security + testing rules | All |
+
+## ECC Rules Per Role
+
+Each subagent role loads a specific ECC rule subset. The dispatcher MUST include
+`ecc` in the dispatch packet so the subagent knows which rules to read first.
+
+| Role | Frontend Task | Backend Task | Full-Stack Task |
+|------|--------------|-------------|-----------------|
+| **Explorer** | `web/patterns.md`, `web/design-quality.md` | `common/patterns.md`, stack patterns | All |
+| **Planner** | `common/patterns.md`, `web/patterns.md` | `common/patterns.md`, stack patterns | All |
+| **Architect** | `web/patterns.md`, `web/performance.md` | `common/patterns.md`, `python/fastapi.md` or `golang/patterns.md` | All + API contract |
+| **Implementer (FE)** | `web/design-quality.md`, `web/patterns.md`, `web/performance.md`, `typescript/patterns.md` | N/A | Frontend subset |
+| **Implementer (BE)** | N/A | `common/patterns.md`, `python/fastapi.md` or `golang/patterns.md` | Backend subset |
+| **Test Writer** | `web/testing.md`, `typescript/testing.md` | Stack testing rules | Both |
+| **Reviewer** | `web/design-quality.md`, `web/security.md`, `web/performance.md` | Stack security + testing rules | All |
 | **Debugger** | Stack-specific coding-style + patterns | Stack-specific coding-style + patterns | Context-dependent |
-| **Verifier** | `web/testing.md` | Stack testing rules | Both |
-
-## Subagent Packs
-
-Each pack now includes `ecc` — the ECC rule files this role MUST load first.
-
-Explorer Pass:
-- ecc: `common/patterns.md` + stack-specific patterns (see ECC Rules Per Role)
-- inject: question, read boundary, relevant docs
-- forbid: writes
-- return: files found, facts, risks, suggested tests
-
+| **Verifier** | `web/testing.md` | Stack testing rules | Both |
+
+## Subagent Packs
+
+Each pack now includes `ecc` — the ECC rule files this role MUST load first.
+
+Explorer Pass:
+- ecc: `common/patterns.md` + stack-specific patterns (see ECC Rules Per Role)
+- inject: question, read boundary, relevant docs
+- forbid: writes
+- return: files found, facts, risks, suggested tests
+
 Planner:
 - ecc: `common/patterns.md` + `common/development-workflow.md`
 - inject: user goal, lifecycle phase, PRD or PLAN section, acceptance gate status, dispatch constraints
 - forbid: production code
 - return: tasks, dependencies, read/write sets, dispatch table, gates, open questions
-
-Researcher:
-- ecc: none (uses WebSearch/WebFetch, not code rules)
-- inject: question, decision needed, source boundaries, tool options
-- forbid: production code
-- return: sources, adopted/rejected/watch decisions, risks, research-results.md patch
-
-Docs Researcher:
-- ecc: none (uses official docs, not code rules)
-- inject: library/API/config, implementation question, version/date constraints
-- forbid: production code
-- return: official links, constraints, errors, examples, affected docs
-
-Architect:
-- ecc: `common/patterns.md` + stack-specific (web/patterns.md for FE, python/fastapi.md for BE)
-- inject: PRD, current architecture, ports
-- forbid: implementation
-- return: boundary decision, affected docs, risks
-
+
+Researcher:
+- ecc: none (uses WebSearch/WebFetch, not code rules)
+- inject: question, decision needed, source boundaries, tool options
+- forbid: production code
+- return: sources, adopted/rejected/watch decisions, risks, research-results.md patch
+
+Docs Researcher:
+- ecc: none (uses official docs, not code rules)
+- inject: library/API/config, implementation question, version/date constraints
+- forbid: production code
+- return: official links, constraints, errors, examples, affected docs
+
+Architect:
+- ecc: `common/patterns.md` + stack-specific (web/patterns.md for FE, python/fastapi.md for BE)
+- inject: PRD, current architecture, ports
+- forbid: implementation
+- return: boundary decision, affected docs, risks
+
 Test Writer:
 - ecc: `common/testing.md` + stack-specific testing rules
 - inject: acceptance criteria, UI/API contracts, feature doc, test write set
 - forbid: production code
 - return: failing tests, AC ID mapping, and test intent
-
-Implementer (Frontend):
-- ecc: `web/design-quality.md`, `web/patterns.md`, `web/performance.md`, `typescript/patterns.md`
-- inject: task, tests, allowed write set, forbidden scope
-- forbid: unrelated refactor and test loosening
-- return: changed files and implementation notes
-
-Implementer (Backend):
-- ecc: `common/patterns.md`, stack-specific patterns (`python/fastapi.md` or `golang/patterns.md`)
-- inject: task, tests, allowed write set, forbidden scope
-- forbid: unrelated refactor and test loosening
-- return: changed files and implementation notes
-
+
+Implementer (Frontend):
+- ecc: `web/design-quality.md`, `web/patterns.md`, `web/performance.md`, `typescript/patterns.md`
+- inject: task, tests, allowed write set, forbidden scope
+- forbid: unrelated refactor and test loosening
+- return: changed files and implementation notes
+
+Implementer (Backend):
+- ecc: `common/patterns.md`, stack-specific patterns (`python/fastapi.md` or `golang/patterns.md`)
+- inject: task, tests, allowed write set, forbidden scope
+- forbid: unrelated refactor and test loosening
+- return: changed files and implementation notes
+
 Reviewer:
 - ecc: `web/design-quality.md` (FE), `web/security.md` (FE), `common/security.md`, stack security
 - inject: PRD, acceptance criteria, UI/API contracts, diff, test/validation evidence, architecture docs
 - forbid: writes
 - return: findings by severity, AC traceability, missing tests, boundary issues
-
+
 Debugger:
 - ecc: stack-specific coding-style + patterns
 - inject: failed AC ID, failing command, error output, trace/screenshot/network evidence, related files
 - forbid: broad rewrites
 - return: failure layer, root cause, fix, proof
-
+
 Verifier:
 - ecc: stack-specific testing rules
 - inject: verification commands, acceptance criteria, UI/API contracts, running app/API endpoint
 - forbid: code changes
 - return: commands run, AC-by-AC validation matrix, evidence paths, residual risk
-
-Memory Master:
-- inject: trigger reason, current failure/user-correction/closeout context, task PROGRESS.md section
-- forbid: source code, unrelated Harness docs
-- return: memory action summary, files written, cross-project flag
-
-Context Master:
-- inject: trigger reason (threshold % or closeout), current task PROGRESS.md, task phase
-- forbid: source code, memory files, MEMORY.md writes
-- return: context usage %, stale blocks, compressible blocks, durable knowledge candidates, compression suggestion
-
-## Handoff Rule
-
-Only the subagent summary enters main context. If details are needed, load the named files directly instead of replaying the subagent conversation.
-
-Use the handoff format in [dispatch.md](dispatch.md) for every dispatched agent.
+
+Memory Master:
+- inject: trigger reason, current failure/user-correction/closeout context, task PROGRESS.md section
+- forbid: source code, unrelated Harness docs
+- return: memory action summary, files written, cross-project flag
+
+Context Master:
+- inject: trigger reason (threshold % or closeout), current task PROGRESS.md, task phase
+- forbid: source code, memory files, MEMORY.md writes
+- return: context usage %, stale blocks, compressible blocks, durable knowledge candidates, compression suggestion
+
+## Handoff Rule
+
+Only the subagent summary enters main context. If details are needed, load the named files directly instead of replaying the subagent conversation.
+
+Use the handoff format in [dispatch.md](dispatch.md) for every dispatched agent.

package/templates/common/Harness/dispatch.md

@@ -1,105 +1,106 @@
-# Dispatch Protocol
-
-Purpose: coordinate a small set of subagents without building a scheduler.
-
-Use [subagents.md](subagents.md) for orchestration strategy. Use this file for the dispatch table, handoff format, and status protocol.
-
-Use when work needs parallel reading, independent review, cross-layer analysis, or more than one bounded implementation pass.
-
-## Principles
-
-- Main agent owns the final decision, integration, and verification.
-- project files are the only durable communication channel; chat/subagent transcript state is non-authoritative.
+# Dispatch Protocol
+
+Purpose: coordinate a small set of subagents without building a scheduler.
+
+Use [subagents.md](subagents.md) for orchestration strategy. Use this file for the dispatch table, handoff format, and status protocol.
+
+Use when work needs parallel reading, independent review, cross-layer analysis, or more than one bounded implementation pass.
+
+## Principles
+
+- Main agent owns the final decision, integration, and verification.
+- project files are the only durable communication channel; chat/subagent transcript state is non-authoritative.
 - Important assumptions, decisions, blockers, evidence, and handoffs must be written to `Harness/tasks/<task-id>/PROGRESS.md` and `Harness/tasks/<task-id>/PLAN.md`, the current feature doc, `Harness/MEMORY.md`, or `Harness/memory/*` as appropriate.
 - PRD-derived Acceptance Criteria are the source of truth. Dispatch packets must carry the relevant AC IDs and contracts.
-- Agent count: default (non-WF) ≤3 active agents; `/wf` requires ≥3 distinct subagents from `.claude/agents/` before second plan; `/wf max` removes the cap entirely (governed by span formula in WF-MAX.md). See [WF.md](WF.md) and [WF-MAX.md](WF-MAX.md) for the authoritative rules.
-- Read-only agents may run in parallel.
-- Writing agents run serially unless write sets are disjoint.
-- Use a worktree when two agents may touch overlapping files or long-running branches.
-- Only summaries enter main context. Load named files directly when details are needed.
-- Subagents read task files, return findings and PLAN patch suggestions. Only the main agent commits changes to PROGRESS.md and PLAN.md.
-
-## Scope
-
-`agent-workflow.md` owns the build/review loop. `subagents.md` owns orchestration strategy and agent roster. This file owns the dispatch input and subagent handoff formats.
-
-## Agent Roster
-
-| Agent | Mode | Purpose |
-| --- | --- | --- |
-| `planner` | Read | split goal into tasks, dependencies, write sets |
-| `researcher` | Read | product, market, ecosystem, dependency research |
-| `docs-researcher` | Read | official docs, API, SDK, version, limits |
-| `architect` | Read | layer boundaries, ports, data flow, state impact |
-| `test-writer` | Write | failing test or manual verification plan |
-| `implementer` | Write | minimal change inside declared write set |
-| `debugger` | Write | smallest fix for a reproduced failure |
-| `reviewer` | Read | diff review, risks, missing tests |
-| `verifier` | Read | run checks and record evidence |
-| `memory-master` | Write | write/consolidate memory entries |
-| `context-master` | Read | analyze context, recommend compression |
-| `explore-manager` | Read | WF-MAX W0: spawn researchers, synthesize |
-| `architect-manager` | Read | WF-MAX W1: spawn architects, synthesize |
-| `implement-manager` | Write | WF-MAX W2: spawn implementers |
-| `review-manager` | Read | WF-MAX W2R: spawn reviewers, deduplicate |
-
-## Dispatch Rules
-
-- Every dispatch row needs task, agent, mode, read set, write set, dependency, output, and status.
-- A write set of `none` means read-only.
-- If two write sets overlap, do not run those agents in parallel.
-- If an agent returns uncertainty, mark the row `Blocked` or add a follow-up row.
-- If docs, tests, and code disagree, stop implementation and record the conflict in `Harness/tasks/<task-id>/PROGRESS.md`.
-- In /wf max, file claims must respect WF-MAX.md leaf condition: no split below 50 avgLines, no split when files ≤ span×2.
-
-## Dispatch Input (Controller → Subagent)
-
-The controller MUST include these fields in the subagent's dispatch packet.
-Without them, the subagent has no way to know which rules or contracts to load.
-
-```text
-Role:               <installed agent name or bounded role, e.g. planner, implementer-fe, reviewer, memory-master>
-Task:               <one-sentence goal>
-ECC:                <which ECC rules to load, e.g. web/design-quality.md, python/fastapi.md. See context-loading.md#ecc-rules-per-role>
+- Agent count: default (non-WF) <=3 active agents; `/wf` requires the complete role chain by default; `/wf max` inherits that chain and removes the Harness default cap through the span formula. Real concurrency is still bounded by runtime thread budget, config, billing, and local resources. Use current runtime subagents first, close completed agents, then cross-CLI overflow. Generated Codex config defaults to `agents.max_threads = 12` and `agents.max_depth = 1`; ask the user before raising `agents.max_threads` above that default. See [WF.md](WF.md) and [WF-MAX.md](WF-MAX.md).
+- Read-only agents may run in parallel.
+- Writing agents run serially unless write sets are disjoint.
+- Use a worktree when two agents may touch overlapping files or long-running branches.
+- Only summaries enter main context. Load named files directly when details are needed.
+- Subagents read task files, return findings and PLAN patch suggestions. Only the main agent commits changes to PROGRESS.md and PLAN.md.
+
+## Scope
+
+`agent-workflow.md` owns the build/review loop. `subagents.md` owns orchestration strategy and agent roster. This file owns the dispatch input and subagent handoff formats.
+
+## Agent Roster
+
+| Agent | Mode | Purpose |
+| --- | --- | --- |
+| `planner` | Read | split goal into tasks, dependencies, write sets |
+| `researcher` | Read | product, market, ecosystem, dependency research |
+| `docs-researcher` | Read | official docs, API, SDK, version, limits |
+| `architect` | Read | layer boundaries, ports, data flow, state impact |
+| `test-writer` | Write | failing test or manual verification plan |
+| `implementer` | Write | minimal change inside declared write set |
+| `debugger` | Write | smallest fix for a reproduced failure |
+| `reviewer` | Read | diff review, risks, missing tests |
+| `verifier` | Read | run checks and record evidence |
+| `reflector` | Read | synthesize review/evidence and decide acceptance readiness |
+| `memory-master` | Write | write/consolidate memory entries |
+| `context-master` | Read | analyze context, recommend compression |
+| `explore-manager` | Read | WF-MAX W0: spawn researchers, synthesize |
+| `architect-manager` | Read | WF-MAX W1: spawn architects, synthesize |
+| `implement-manager` | Write | WF-MAX W2: spawn implementers |
+| `review-manager` | Read | WF-MAX W2R: spawn reviewers, deduplicate |
+
+## Dispatch Rules
+
+- Every dispatch row needs task, agent, mode, read set, write set, dependency, output, and status.
+- A write set of `none` means read-only.
+- If two write sets overlap, do not run those agents in parallel.
+- If an agent returns uncertainty, mark the row `Blocked` or add a follow-up row.
+- If docs, tests, and code disagree, stop implementation and record the conflict in `Harness/tasks/<task-id>/PROGRESS.md`.
+- In /wf max, file claims must respect WF-MAX.md leaf condition: no split below 50 avgLines, no split when files <= span*2.
+
+## Dispatch Input (Controller -> Subagent)
+
+The controller MUST include these fields in the subagent's dispatch packet.
+Without them, the subagent has no way to know which rules or contracts to load.
+
+```text
+Role:               <installed agent name or bounded role, e.g. planner, implementer-fe, reviewer, memory-master>
+Task:               <one-sentence goal>
+ECC:                <which ECC rules to load, e.g. web/design-quality.md, python/fastapi.md. See context-loading.md#ecc-rules-per-role>
 Skills:             <which skills to activate, e.g. react-review, tdd-guide>
 PRD:                <path or task PLAN section containing Mini PRD>
 Acceptance IDs:     <AC-001, AC-002, or "none" for non-behavioral work>
 UI contract:        <path to UI_CONTRACT.md or task PLAN section, if UI task>
-API contract:       <path to api/openapi.yaml, if frontend↔backend task. Omit if N/A>
-Read set:           <files and directories the subagent may read>
-Write set:          <files the subagent may modify. "none" = read-only>
-Forbidden:          <commands, paths, or patterns the subagent must not touch>
-Verification:       <commands to run after implementation, e.g. npm test>
-```
-
-## Handoff Format (Subagent → Controller)
-
-Subagents return summaries in this shape:
-
-```text
-Agent:
-Task:
-Mode:
-ECC loaded:         <which ECC rule files were actually loaded. Should match dispatch ECC field.>
-Skills active:      <which skills were active. Should match dispatch Skills field.>
-API contract:       <path to contract file used, if applicable>
+API contract:       <path to api/openapi.yaml, if frontend<->backend task. Omit if N/A>
+Read set:           <files and directories the subagent may read>
+Write set:          <files the subagent may modify. "none" = read-only>
+Forbidden:          <commands, paths, or patterns the subagent must not touch>
+Verification:       <commands to run after implementation, e.g. npm test>
+```
+
+## Handoff Format (Subagent -> Controller)
+
+Subagents return summaries in this shape:
+
+```text
+Agent:
+Task:
+Mode:
+ECC loaded:         <which ECC rule files were actually loaded. Should match dispatch ECC field.>
+Skills active:      <which skills were active. Should match dispatch Skills field.>
+API contract:       <path to api/openapi.yaml, if frontend<->backend task. Omit if N/A>
 Acceptance IDs:     <AC IDs handled or validated>
 Files read:
-Files changed:
-Findings:
-Evidence:
-Risks:
-Next:
+Files changed:
+Findings:
+Evidence:
+Risks:
+Next:
 PLAN patch:
 Validation matrix:  <AC-by-AC pass/fail/block evidence, for validators>
-Concurrency group:  <wave number — 0=exploration, 1,2,3,...=implementation waves. Optional; only used in /wf max.>
-File claim:         <list of exact file paths this agent exclusively owns. Optional; only used in /wf max.>
-Granularity floor:  <50 avgLines → do NOT spawn. Apply leaf condition from WF-MAX.md.>
-```
-
-Use `Files changed: none` for read-only agents. Use `PLAN patch: none` when no state update is needed.
-If a handoff matters after context loss, write it to `Harness/tasks/<task-id>/PROGRESS.md`, `Harness/tasks/<task-id>/PLAN.md`, the current feature doc, or `Harness/memory/*`; do not rely on chat transcript state.
-
-## Statuses
-
-Allowed dispatch statuses: Pending / In Progress / Returned / Integrated / Blocked / Verified.
+Concurrency group:  <wave number - 0=exploration, 1,2,3,...=implementation waves. Optional; only used in /wf max.>
+File claim:         <list of exact file paths this agent exclusively owns. Optional; only used in /wf max.>
+Granularity floor:  <50 avgLines -> do NOT spawn. Apply leaf condition from WF-MAX.md.>
+```
+
+Use `Files changed: none` for read-only agents. Use `PLAN patch: none` when no state update is needed.
+If a handoff matters after context loss, write it to `Harness/tasks/<task-id>/PROGRESS.md`, `Harness/tasks/<task-id>/PLAN.md`, the current feature doc, or `Harness/memory/*`; do not rely on chat transcript state.
+
+## Statuses
+
+Allowed dispatch statuses: Pending / In Progress / Returned / Integrated / Blocked / Verified.

package/templates/common/Harness/extension.md

@@ -1,70 +1,70 @@
-# Extension Contract
-
+# Extension Contract
+
 Purpose: keep stack-specific agents, skills, and rules compatible with this harness.
-
-Use during setup whenever adding assets from ECC, SuperClaude, toolboxes, or local project conventions.
-
-## Non-Invasive Extension Rules
-
-Extensions must preserve project and harness ownership boundaries.
-
+
+Use during setup whenever adding assets from ECC, SuperClaude, toolboxes, or local project conventions.
+
+## Non-Invasive Extension Rules
+
+Extensions must preserve project and harness ownership boundaries.
+
 - Preserve existing `.claude/`, `CLAUDE.md`, `AGENTS.md`, `.gitignore`, `Harness/README.md`, `Harness/workflows/*.md`, settings, and local rules unless the user explicitly requests an overwrite.
-- Treat existing project config as project fact. Read it before adding assets, then adapt new assets to the project instead of replacing the project.
+- Treat existing project config as project fact. Read it before adding assets, then adapt new assets to the project instead of replacing the project.
 - Register added agents, skills, workflows, and rules in `Harness/MEMORY.md` and this docs router where applicable.
-- Added assets may extend `.claude/skills/`, `.claude/agents/`, `.claude/rules/`, or `Harness/workflows/`, but they must not replace core harness docs.
-- Core harness docs are `Harness/README.md`, `Harness/PROGRESS.md`, `Harness/subagents.md`, `Harness/context-loading.md`, `Harness/dispatch.md`, `Harness/agent-workflow.md`, and this file.
-- If an optional workflow needs a new command or tool, document the command and fallback in `Harness/workflows/<name>.md` instead of changing core harness behavior.
-
-## Agent Contract
-
-Every added agent must have frontmatter:
-
-```yaml
----
-name: stack-agent-name
-description: Use when ...
-tools: Read, Grep, Glob
-model: sonnet
----
-```
-
-Agent body must state:
-
-- load first
-- inputs required
-- allowed write set or read-only
-- forbidden scope
-- verification or evidence
-- return format from [subagents.md](subagents.md) and [dispatch.md](dispatch.md)
-
-## Skill Contract
-
-Every added skill must state:
-
-- when to use
-- docs to load
-- required inputs
-- allowed writes
-- output format
-- whether to update `Harness/PROGRESS.md` and task files
-- whether to use [subagents.md](subagents.md) and [dispatch.md](dispatch.md)
-
-Skills should extend the harness. They should not replace `Harness/README.md`, `Harness/PROGRESS.md`, `subagents.md`, `context-loading.md`, `dispatch.md`, or `agent-workflow.md`.
-
-## Rules
-
-- Do not add broad agents that can write anywhere.
-- Do not add agents whose role overlaps an existing common agent without naming the difference.
-- Do not add tools that bypass project permissions or user approval.
-- Do not run stack-specific writing agents in parallel unless write sets are disjoint.
-- If an added asset conflicts with this harness, adapt the asset instead of changing the core contract.
-
-## Registration
-
-After adding assets:
-
-- list agents in `Harness/MEMORY.md#Agents`
-- list skills in `Harness/MEMORY.md#Skills`
-- list workflows by path in `Harness/MEMORY.md` or `Harness/README.md`
-- update `Harness/PROGRESS.md` and `Harness/tasks/<task-id>/PROGRESS.md` when the asset affects current work
-- run `node Harness/scripts/validate-harness.mjs`
+- Added assets may extend `.claude/skills/`, `.claude/agents/`, `.claude/rules/`, or `Harness/workflows/`, but they must not replace core harness docs.
+- Core harness docs are `Harness/README.md`, `Harness/PROGRESS.md`, `Harness/subagents.md`, `Harness/context-loading.md`, `Harness/dispatch.md`, `Harness/agent-workflow.md`, and this file.
+- If an optional workflow needs a new command or tool, document the command and fallback in `Harness/workflows/<name>.md` instead of changing core harness behavior.
+
+## Agent Contract
+
+Every added agent must have frontmatter:
+
+```yaml
+---
+name: stack-agent-name
+description: Use when ...
+tools: Read, Grep, Glob
+model: sonnet
+---
+```
+
+Agent body must state:
+
+- load first
+- inputs required
+- allowed write set or read-only
+- forbidden scope
+- verification or evidence
+- return format from [subagents.md](subagents.md) and [dispatch.md](dispatch.md)
+
+## Skill Contract
+
+Every added skill must state:
+
+- when to use
+- docs to load
+- required inputs
+- allowed writes
+- output format
+- whether to update `Harness/PROGRESS.md` and task files
+- whether to use [subagents.md](subagents.md) and [dispatch.md](dispatch.md)
+
+Skills should extend the harness. They should not replace `Harness/README.md`, `Harness/PROGRESS.md`, `subagents.md`, `context-loading.md`, `dispatch.md`, or `agent-workflow.md`.
+
+## Rules
+
+- Do not add broad agents that can write anywhere.
+- Do not add agents whose role overlaps an existing common agent without naming the difference.
+- Do not add tools that bypass project permissions or user approval.
+- Do not run stack-specific writing agents in parallel unless write sets are disjoint.
+- If an added asset conflicts with this harness, adapt the asset instead of changing the core contract.
+
+## Registration
+
+After adding assets:
+
+- list agents in `Harness/MEMORY.md#Agents`
+- list skills in `Harness/MEMORY.md#Skills`
+- list workflows by path in `Harness/MEMORY.md` or `Harness/README.md`
+- update `Harness/PROGRESS.md` and `Harness/tasks/<task-id>/PROGRESS.md` when the asset affects current work
+- run `node Harness/scripts/validate-harness.mjs`