@opengsd/gsd-path 1.0.0

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@opengsd/gsd-path",
+  "version": "1.0.0",
+  "description": "Disk-backed AI agent pipeline. Docs: DOCS.md (start here), QUICK.md, FULL.md, UPDATE.md",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "gsd-path": "scripts/install.mjs"
+  },
+  "files": [
+    "plugin.json",
+    "scripts/install.mjs",
+    "scripts/install.py",
+    "scripts/migrate_core.py",
+    "scripts/core_hook_gate.py",
+    "scripts/core_hook_settings.py",
+    "scripts/sync_skill_resources.py",
+    "scripts/wizard.mjs",
+    "scripts/skill-resources.json",
+    "scripts/_common.py",
+    "scripts/state_checkpoint.py",
+    "scripts/state_promote.py",
+    "scripts/discussion_validate.py",
+    "scripts/integration.py",
+    "scripts/archive_milestone.py",
+    "scripts/bootstrap_repository.py",
+    "scripts/detect_project.py",
+    "scripts/promote_lookahead.py",
+    "scripts/discussion_records.py",
+    "scripts/check_handoffs.py",
+    "scripts/check_docs_audit.py",
+    "scripts/check_task_briefs.py",
+    "scripts/review_panel.py",
+    "scripts/review_findings.py",
+    "scripts/check_update.py",
+    "scripts/guard_hook.py",
+    "scripts/git_guard.py",
+    "scripts/isolation.py",
+    "scripts/pipeline_git.py",
+    "scripts/pipeline_state.py",
+    "scripts/status_runtime.py",
+    "scripts/build_state.py",
+    "scripts/loop_run.py",
+    "scripts/workflow_run.py",
+    "scripts/dispatch_driver.py",
+    "scripts/lean_verification.py",
+    "scripts/token_budget.py",
+    "scripts/pipeline_undo.py",
+    "scripts/pipeline_diagnose.py",
+    "README.md",
+    "MIGRATE.md",
+    "RUNTIME.md",
+    "DOCS.md",
+    "HOOKS.md",
+    "QUICK.md",
+    "FULL.md",
+    "UPDATE.md",
+    "GUIDE.md",
+    "skills/",
+    "platforms/",
+    "AGENTS.md",
+    "WORKFLOW.md"
+  ],
+  "engines": {
+    "node": ">=18.17"
+  },
+  "scripts": {
+    "install:ci": "npm ci",
+    "check:prereqs": "bash scripts/check-test-prereqs.sh",
+    "test": "node --test tests/*.test.mjs",
+    "test:smoke": "npm test",
+    "test:integration": "npm run test:python",
+    "test:python": "python3 -m unittest discover -s tests",
+    "test:sync": "python3 scripts/sync_skill_resources.py --check",
+    "test:daemon": "PYTHONPATH=daemon python3 -m unittest discover -s tests -p 'test_daemon_*.py'",
+    "verify": "npm test && npm run test:python && python3 scripts/sync_skill_resources.py --check",
+    "verify:release": "npm run verify && python3 scripts/check_trust_evidence.py --repo .",
+    "prepublishOnly": "npm run verify:release"
+  }
+}

package/platforms/claude/dispatch.md

@@ -0,0 +1,63 @@
+# Claude Code agent dispatch
+
+Apply this contract whenever a GSD Path skill delegates work:
+
+- Use Claude Code's `Agent` tool with `subagent_type: general-purpose`. Every
+  GSD Path child must be able to write its declared artifact, so do not use the
+  one-shot `Explore` or `Plan` agents. The linked role brief supplies the
+  read-only boundary for auditors and reviewers.
+- Supply the deterministic logical task name as the Agent `description`:
+  `inspect_codebase`, `inspect_docs`, `docs_audit`,
+  `research_<dimension>`, `decide`, `roadmap`, `plan`, `plan_patch`,
+  `build_<task_id>`, `review_wave_<wave>_cycle_<cycle>` (a `deep` wave review
+  appends the lens suffix `_contract` or `_adversarial`; an optional review
+  panel uses `review_wave_<wave>_cycle_<cycle>_panel_<family>`; an
+  optional finding skeptic uses
+  `review_wave_<wave>_cycle_<cycle>_skeptic_<criterion_locator>`),
+  `review_plan_panel_<family>`,
+  `review_final`, or
+  `review_gap_<number>`. Normalize variable parts to lowercase ASCII and
+  replace non-alphanumeric runs with one underscore. Never add a random
+  suffix.
+- Keep the returned agent ID when the host advertises a resume facility. For a
+  correction, retry, post-patch review, repeated audit, or later milestone,
+  resume that child when supported; otherwise start a fresh `general-purpose`
+  child. Always send the entire new self-contained brief. If a child with the
+  same logical task name is still running, wait for it rather than dispatching
+  a colliding target.
+- Resolve the phase's linked role brief to an absolute path. Include that path
+  in the prompt and require the agent to read it before acting.
+- Tier hints: when the host advertises model or reasoning-effort selection,
+  request `heavy` for `plan`, `plan_patch`, `decide`, and `roadmap`, and
+  `light` for `inspect_docs` and `docs_audit`; when it offers no such
+  selection, do not override the model except on a review-panel child, which receives the exact slug from `scripts/review_panel.py resolve`. Do not ask Claude Code to create
+  another worktree: GSD Path supplies the exact repository or
+  linked-worktree root in the brief, and the child must work only there.
+  Host isolation: none.
+- Give every child a self-contained prompt with absolute input, template, and
+  output paths plus its bounded responsibility. A coder prompt also names its
+  isolated linked-worktree root; no child may infer the primary worktree.
+- Launch independent Agent calls concurrently up to the available limit, using
+  background execution when exposed by the host. Batch any remainder and
+  collect every result before applying the phase gate.
+- When the host exposes a blocking ask/reply channel, route a coder's
+  `NEEDS-ORCHESTRATOR` question through it as a live question with the worker
+  held alive for the reply, instead of block-and-redispatch. Append the
+  answer to the task Log as `Orchestrator answer:` so the portable on-disk
+  record stays complete; a timed-out or unavailable channel falls back to
+  the portable block path.
+- A child that receives a disposable worktree stages its assigned artifact
+  under that root. The parent validates it and atomically transfers it to
+  the canonical project path before removing the exact disposable root. A
+  child never writes a disposable-review output directly into the primary
+  worktree.
+- If the `Agent` tool or full-capability `general-purpose` agent is unavailable,
+  stop and report the missing capability. Do not silently collapse an
+  independence boundary into the main context.
+
+## Parent lifecycle
+
+The parent owns lifecycle: wait for terminal completion, enforce timeout and
+cancellation, transfer staged outputs from disposable roots, clean up every
+child and temporary root before the phase gate, and never let a child delegate
+another GSD Path child. A timeout or cancellation is a blocked result.

package/platforms/copilot/dispatch.md

@@ -0,0 +1,61 @@
+# GitHub Copilot CLI agent dispatch
+
+Apply this contract whenever a GSD Path skill delegates work:
+
+- Use Copilot CLI's `task` tool with the built-in `general-purpose` agent.
+  Every GSD Path child must be able to write its declared artifact; the linked
+  role brief supplies the read-only boundary for auditors and reviewers.
+- Supply the deterministic logical task name as the task description:
+  `inspect_codebase`, `inspect_docs`, `docs_audit`,
+  `research_<dimension>`, `decide`, `roadmap`, `plan`, `plan_patch`,
+  `build_<task_id>`, `review_wave_<wave>_cycle_<cycle>` (a `deep` wave review
+  appends the lens suffix `_contract` or `_adversarial`; an optional review
+  panel uses `review_wave_<wave>_cycle_<cycle>_panel_<family>`; an
+  optional finding skeptic uses
+  `review_wave_<wave>_cycle_<cycle>_skeptic_<criterion_locator>`),
+  `review_plan_panel_<family>`,
+  `review_final`, or
+  `review_gap_<number>`. Normalize variable parts to lowercase ASCII and
+  replace non-alphanumeric runs with one underscore. Never add a random
+  suffix.
+- Keep the returned agent ID for each logical task name. For a correction,
+  retry, post-patch review, repeated audit, or later milestone, use
+  `write_agent` when that child remains available for follow-up and send the
+  entire new self-contained brief. Otherwise start a fresh `general-purpose`
+  task with that brief. If the child is still running a different brief, wait;
+  never create a colliding logical target.
+- Resolve the phase's linked role brief to an absolute path. Include that path
+  in the prompt and require the child to read it before acting.
+- Tier hints: when the host advertises model or reasoning-effort selection,
+  request `heavy` for `plan`, `plan_patch`, `decide`, and `roadmap`, and
+  `light` for `inspect_docs` and `docs_audit`; when it offers no such
+  selection, do not override the model except on a review-panel child, which receives the exact slug from `scripts/review_panel.py resolve`. Do not ask Copilot to create another
+  worktree: GSD Path supplies the exact repository or linked-worktree root,
+  and the child must work only there. Host isolation: none.
+- Give every child a self-contained prompt with absolute input, template, and
+  output paths plus its bounded responsibility. A coder prompt also names its
+  isolated linked-worktree root; no child may infer the primary worktree.
+- Launch one `task` call per independent brief in parallel up to the available
+  concurrency limit. Batch any remainder and collect every result before
+  applying the phase gate.
+- When the host exposes a blocking ask/reply channel, route a coder's
+  `NEEDS-ORCHESTRATOR` question through it as a live question with the worker
+  held alive for the reply, instead of block-and-redispatch. Append the
+  answer to the task Log as `Orchestrator answer:` so the portable on-disk
+  record stays complete; a timed-out or unavailable channel falls back to
+  the portable block path.
+- A child that receives a disposable worktree stages its assigned artifact
+  under that root. The parent validates it and atomically transfers it to
+  the canonical project path before removing the exact disposable root. A
+  child never writes a disposable-review output directly into the primary
+  worktree.
+- If `task` or the full-capability `general-purpose` agent is unavailable, stop
+  and report the missing capability. Do not silently collapse an independence
+  boundary into the main context.
+
+## Parent lifecycle
+
+The parent owns lifecycle: wait for terminal completion, enforce timeout and
+cancellation, transfer staged outputs from disposable roots, clean up every
+child and temporary root before the phase gate, and never let a child delegate
+another GSD Path child. A timeout or cancellation is a blocked result.

package/platforms/cursor/agent.md

@@ -0,0 +1,17 @@
+---
+name: gsd-path
+description: Full-capability child for bounded work delegated by an explicitly invoked GSD Path skill.
+model: inherit
+readonly: false
+---
+
+Execute only the complete, self-contained GSD Path brief supplied by the
+parent agent.
+
+- Read the absolute role-brief path before acting and obey its boundary.
+- Work only in the exact repository or linked-worktree root from the prompt.
+- Read only the named inputs and write only the declared outputs or coder
+  scope. Never infer missing paths or expand the assignment.
+- Do not create another worktree, override the model, or delegate the task.
+- Report the output paths, status, verdict, and reproduced evidence requested
+  by the brief. Surface partial or failed results plainly.

package/platforms/cursor/dispatch.md

@@ -0,0 +1,63 @@
+# Cursor agent dispatch
+
+Apply this contract whenever a GSD Path skill delegates work:
+
+- Use Cursor's `Task` tool with the installed custom `gsd-path` subagent. Its
+  model is `inherit` and it has full tool access; the linked role brief supplies
+  the read-only boundary for auditors and reviewers.
+- Supply the deterministic logical task name as the task description:
+  `inspect_codebase`, `inspect_docs`, `docs_audit`,
+  `research_<dimension>`, `decide`, `roadmap`, `plan`, `plan_patch`,
+  `build_<task_id>`, `review_wave_<wave>_cycle_<cycle>` (a `deep` wave review
+  appends the lens suffix `_contract` or `_adversarial`; an optional review
+  panel uses `review_wave_<wave>_cycle_<cycle>_panel_<family>`; an
+  optional finding skeptic uses
+  `review_wave_<wave>_cycle_<cycle>_skeptic_<criterion_locator>`),
+  `review_plan_panel_<family>`,
+  `review_final`, or
+  `review_gap_<number>`. Normalize variable parts to lowercase ASCII and
+  replace non-alphanumeric runs with one underscore. Never add a random
+  suffix.
+- Keep the returned agent ID for each logical task name. When Cursor exposes
+  resume, continue that agent for a correction, retry, post-patch review,
+  repeated audit, or later milestone and send the entire new self-contained
+  brief. Otherwise start a fresh full-capability child with that complete
+  brief. If the prior child is still running, wait; never collide targets.
+- Resolve the phase's linked role brief to an absolute path. Include that path
+  in the prompt and require the child to read it before acting.
+- Tier hints: when the host advertises model or reasoning-effort selection,
+  request `heavy` for `plan`, `plan_patch`, `decide`, and `roadmap`, and
+  `light` for `inspect_docs` and `docs_audit`; when it offers no such
+  selection, do not override the model. The only exception is a review-panel
+  child: pass the exact slug returned by `scripts/review_panel.py resolve`
+  for that family. Never override the model on the canonical reviewer,
+  planner, or coder. Set the task working directory to the
+  exact repository or linked-worktree root supplied by GSD Path; do not ask
+  Cursor or the child to create another worktree. Host isolation: none.
+- Give every child a self-contained prompt with absolute input, template, and
+  output paths plus its bounded responsibility. A coder prompt also names its
+  isolated linked-worktree root; no child may infer the primary worktree.
+- Launch independent tasks concurrently up to the available limit, using
+  background execution when exposed. Batch any remainder and collect every
+  result before applying the phase gate.
+- When the host exposes a blocking ask/reply channel, route a coder's
+  `NEEDS-ORCHESTRATOR` question through it as a live question with the worker
+  held alive for the reply, instead of block-and-redispatch. Append the
+  answer to the task Log as `Orchestrator answer:` so the portable on-disk
+  record stays complete; a timed-out or unavailable channel falls back to
+  the portable block path.
+- A child that receives a disposable worktree stages its assigned artifact
+  under that root. The parent validates it and atomically transfers it to
+  the canonical project path before removing the exact disposable root. A
+  child never writes a disposable-review output directly into the primary
+  worktree.
+- If `Task` or the custom `gsd-path` subagent is unavailable, stop and report
+  the missing capability. Do not silently collapse an independence boundary
+  into the main context.
+
+## Parent lifecycle
+
+The parent owns lifecycle: wait for terminal completion, enforce timeout and
+cancellation, transfer staged outputs from disposable roots, clean up every
+child and temporary root before the phase gate, and never let a child delegate
+another GSD Path child. A timeout or cancellation is a blocked result.

package/platforms/grok/dispatch.md

@@ -0,0 +1,61 @@
+# Grok agent dispatch
+
+Apply this contract whenever a GSD Path skill delegates work:
+
+- Use Grok's `spawn_subagent` tool with `subagent_type: general-purpose` and
+  `capability_mode: all`. Every GSD Path child must be able to write its
+  declared artifact; the linked role brief supplies the read-only boundary for
+  auditors and reviewers.
+- Supply the deterministic logical task name as the subagent `description`:
+  `inspect_codebase`, `inspect_docs`, `docs_audit`,
+  `research_<dimension>`, `decide`, `roadmap`, `plan`, `plan_patch`,
+  `build_<task_id>`, `review_wave_<wave>_cycle_<cycle>` (a `deep` wave review
+  appends the lens suffix `_contract` or `_adversarial`; an optional review
+  panel uses `review_wave_<wave>_cycle_<cycle>_panel_<family>`; an
+  optional finding skeptic uses
+  `review_wave_<wave>_cycle_<cycle>_skeptic_<criterion_locator>`),
+  `review_plan_panel_<family>`,
+  `review_final`, or
+  `review_gap_<number>`. Normalize variable parts to lowercase ASCII and
+  replace non-alphanumeric runs with one underscore. Never add a random
+  suffix.
+- Keep the returned subagent ID for each logical task name. For a correction,
+  retry, post-patch review, repeated audit, or later milestone in the same
+  conversation, call `spawn_subagent` with `resume_from` and the entire new
+  self-contained prompt. If it is still running a different brief, wait for
+  it; never create a colliding logical target.
+- Resolve the phase's linked role brief to an absolute path. Include that path
+  in the prompt and require the subagent to read it before acting.
+- Tier hints: when the host advertises model or reasoning-effort selection,
+  request `heavy` for `plan`, `plan_patch`, `decide`, and `roadmap`, and
+  `light` for `inspect_docs` and `docs_audit`; when it offers no such
+  selection, do not override the model except on a review-panel child, which receives the exact slug from `scripts/review_panel.py resolve`. Set `cwd` to the exact root supplied
+  by GSD Path and use `isolation: none`; the pipeline already owns any
+  required linked worktree. Host isolation: none.
+- Give every subagent a self-contained prompt with absolute input, template,
+  and output paths plus its bounded responsibility. A coder prompt also names
+  its isolated linked-worktree root; no child may infer the primary worktree.
+- Launch independent subagents with `background: true` up to the available
+  limit. Batch any remainder, wait with `wait_commands_or_subagents`, and
+  collect every result before applying the phase gate.
+- When the host exposes a blocking ask/reply channel, route a coder's
+  `NEEDS-ORCHESTRATOR` question through it as a live question with the worker
+  held alive for the reply, instead of block-and-redispatch. Append the
+  answer to the task Log as `Orchestrator answer:` so the portable on-disk
+  record stays complete; a timed-out or unavailable channel falls back to
+  the portable block path.
+- A child that receives a disposable worktree stages its assigned artifact
+  under that root. The parent validates it and atomically transfers it to
+  the canonical project path before removing the exact disposable root. A
+  child never writes a disposable-review output directly into the primary
+  worktree.
+- If `spawn_subagent` or the `general-purpose` type is unavailable, stop and
+  report the missing capability. Do not silently collapse an independence
+  boundary into the main context.
+
+## Parent lifecycle
+
+The parent owns lifecycle: wait for terminal completion, enforce timeout and
+cancellation, transfer staged outputs from disposable roots, clean up every
+child and temporary root before the phase gate, and never let a child delegate
+another GSD Path child. A timeout or cancellation is a blocked result.

package/platforms/kimi/dispatch.md

@@ -0,0 +1,64 @@
+# Kimi agent dispatch
+
+Apply this contract whenever a GSD Path skill delegates work:
+
+- Use Kimi's `Agent` tool with `subagent_type: coder` for every child. Every
+  GSD Path child must write its declared artifact, and `coder` is the only
+  type with file-editing tools; never use `explore` or `plan` children for
+  artifact-producing work. The linked role brief supplies the read-only
+  boundary for auditors and reviewers.
+- Supply the deterministic logical task name as the Agent `description`:
+  `inspect_codebase`, `inspect_docs`, `docs_audit`,
+  `research_<dimension>`, `decide`, `roadmap`, `plan`, `plan_patch`,
+  `build_<task_id>`, `review_wave_<wave>_cycle_<cycle>` (a `deep` wave review
+  appends the lens suffix `_contract` or `_adversarial`; an optional review
+  panel uses `review_wave_<wave>_cycle_<cycle>_panel_<family>`; an
+  optional finding skeptic uses
+  `review_wave_<wave>_cycle_<cycle>_skeptic_<criterion_locator>`),
+  `review_plan_panel_<family>`,
+  `review_final`, or
+  `review_gap_<number>`. Normalize variable parts to lowercase ASCII and
+  replace non-alphanumeric runs with one underscore. Never add a random
+  suffix.
+- Keep the returned agent ID for each logical task name. For a correction,
+  retry, post-patch review, repeated audit, or later milestone in the same
+  conversation, resume that agent through the `resume` parameter and send
+  the entire new self-contained brief. If it is still running a different
+  brief, wait for it; never create a colliding logical target.
+- Resolve the phase's linked role brief to an absolute path. Include that
+  path in the prompt and require the child to read it before acting.
+- Tier hints: when the host advertises model or reasoning-effort selection,
+  request `heavy` for `plan`, `plan_patch`, `decide`, and `roadmap`, and
+  `light` for `inspect_docs` and `docs_audit`; when it offers no such
+  selection, do not override the model except on a review-panel child, which receives the exact slug from `scripts/review_panel.py resolve`. Do not ask Kimi to create a worktree:
+  GSD Path supplies the exact repository or linked-worktree root in the
+  brief, and the child must work only there. Host isolation: none.
+- Give every child a self-contained prompt with absolute input, template,
+  and output paths plus its bounded responsibility. A coder prompt also
+  names its isolated linked-worktree root; no child may infer the primary
+  worktree.
+- Launch independent `Agent` calls concurrently in one block, up to the
+  available limit. Batch any remainder without combining briefs, and collect
+  every result before applying the phase gate. Do not leave children running
+  after collection.
+- When the host exposes a blocking ask/reply channel, route a coder's
+  `NEEDS-ORCHESTRATOR` question through it as a live question with the worker
+  held alive for the reply, instead of block-and-redispatch. Append the
+  answer to the task Log as `Orchestrator answer:` so the portable on-disk
+  record stays complete; a timed-out or unavailable channel falls back to
+  the portable block path.
+- A child that receives a disposable worktree stages its assigned artifact
+  under that root. The parent validates it and atomically transfers it to
+  the canonical project path before removing the exact disposable root. A
+  child never writes a disposable-review output directly into the primary
+  worktree.
+- If the `Agent` tool or the `coder` child type is unavailable, stop and
+  report the missing capability. Do not silently collapse an independence
+  boundary into the main context.
+
+## Parent lifecycle
+
+The parent owns lifecycle: wait for terminal completion, enforce timeout and
+cancellation, transfer staged outputs from disposable roots, clean up every
+child and temporary root before the phase gate, and never let a child delegate
+another GSD Path child. A timeout or cancellation is a blocked result.

package/platforms/kiro/dispatch.md

@@ -0,0 +1,58 @@
+# Kiro agent dispatch
+
+Apply this contract whenever a GSD Path skill delegates work:
+
+- Use Kiro's subagent facility with the default general-purpose subagent.
+  Every GSD Path child must be able to write its declared artifact; the linked
+  role brief supplies the read-only boundary for auditors and reviewers.
+- Supply the deterministic logical task name as the task description:
+  `inspect_codebase`, `inspect_docs`, `docs_audit`,
+  `research_<dimension>`, `decide`, `roadmap`, `plan`, `plan_patch`,
+  `build_<task_id>`, `review_wave_<wave>_cycle_<cycle>` (a `deep` wave review
+  appends the lens suffix `_contract` or `_adversarial`; an optional review
+  panel uses `review_wave_<wave>_cycle_<cycle>_panel_<family>`; an
+  optional finding skeptic uses
+  `review_wave_<wave>_cycle_<cycle>_skeptic_<criterion_locator>`),
+  `review_plan_panel_<family>`,
+  `review_final`, or
+  `review_gap_<number>`. Normalize variable parts to lowercase ASCII and
+  replace non-alphanumeric runs with one underscore. Never add a random
+  suffix.
+- Start a fresh general-purpose child for a correction, retry, post-patch
+  review, repeated audit, or later milestone and send the entire new
+  self-contained brief. Disk artifacts remain the source of truth.
+- Resolve the phase's linked role brief to an absolute path. Include that path
+  in the prompt and require the subagent to read it before acting.
+- Tier hints: when the host advertises model or reasoning-effort selection,
+  request `heavy` for `plan`, `plan_patch`, `decide`, and `roadmap`, and
+  `light` for `inspect_docs` and `docs_audit`; when it offers no such
+  selection, do not override the model except on a review-panel child, which receives the exact slug from `scripts/review_panel.py resolve`. Set the child working directory to the
+  exact repository or linked-worktree root supplied by GSD Path; do not ask
+  Kiro or the child to create another worktree. Host isolation: none.
+- Give every child a self-contained prompt with absolute input, template, and
+  output paths plus its bounded responsibility. A coder prompt also names its
+  isolated linked-worktree root; no child may infer the primary worktree.
+- Encode task dependencies explicitly. Launch independent ready tasks in
+  parallel up to the host's advertised concurrent-subagent capacity; batch
+  any remainder and collect every result before applying the phase gate.
+- When the host exposes a blocking ask/reply channel, route a coder's
+  `NEEDS-ORCHESTRATOR` question through it as a live question with the worker
+  held alive for the reply, instead of block-and-redispatch. Append the
+  answer to the task Log as `Orchestrator answer:` so the portable on-disk
+  record stays complete; a timed-out or unavailable channel falls back to
+  the portable block path.
+- A child that receives a disposable worktree stages its assigned artifact
+  under that root. The parent validates it and atomically transfers it to
+  the canonical project path before removing the exact disposable root. A
+  child never writes a disposable-review output directly into the primary
+  worktree.
+- If the subagent facility or the default general-purpose subagent is
+  unavailable, stop and report the missing capability. Do not silently
+  collapse an independence boundary into the main context.
+
+## Parent lifecycle
+
+The parent owns lifecycle: wait for terminal completion, enforce timeout and
+cancellation, transfer staged outputs from disposable roots, clean up every
+child and temporary root before the phase gate, and never let a child delegate
+another GSD Path child. A timeout or cancellation is a blocked result.

package/platforms/opencode/dispatch.md

@@ -0,0 +1,62 @@
+# OpenCode agent dispatch
+
+Apply this contract whenever a GSD Path skill delegates work:
+
+- On current OpenCode, use the `Task` tool with the built-in `general`
+  subagent. If the installed OpenCode v2 host exposes the renamed `subagent`
+  tool instead, use that tool with the built-in `general` agent and its
+  advertised schema. Every GSD Path child must be able to write its declared
+  artifact; the linked role brief supplies the read-only boundary for auditors
+  and reviewers.
+- Supply the deterministic logical task name as the child description:
+  `inspect_codebase`, `inspect_docs`, `docs_audit`,
+  `research_<dimension>`, `decide`, `roadmap`, `plan`, `plan_patch`,
+  `build_<task_id>`, `review_wave_<wave>_cycle_<cycle>` (a `deep` wave review
+  appends the lens suffix `_contract` or `_adversarial`; an optional review
+  panel uses `review_wave_<wave>_cycle_<cycle>_panel_<family>`; an
+  optional finding skeptic uses
+  `review_wave_<wave>_cycle_<cycle>_skeptic_<criterion_locator>`),
+  `review_plan_panel_<family>`,
+  `review_final`, or
+  `review_gap_<number>`. Normalize variable parts to lowercase ASCII and
+  replace non-alphanumeric runs with one underscore. Never add a random
+  suffix.
+- Reuse a returned child-session ID when the host exposes a resume parameter.
+  Otherwise start a fresh `general` child for a correction, retry, post-patch
+  review, repeated audit, or later milestone and send the entire new
+  self-contained prompt. Disk artifacts, not child chat history, remain the
+  source of truth.
+- Resolve the phase's linked role brief to an absolute path. Include that path
+  in the prompt and require the child to read it before acting.
+- Tier hints: when the host advertises model or reasoning-effort selection,
+  request `heavy` for `plan`, `plan_patch`, `decide`, and `roadmap`, and
+  `light` for `inspect_docs` and `docs_audit`; when it offers no such
+  selection, do not override the model except on a review-panel child, which receives the exact slug from `scripts/review_panel.py resolve`. Host isolation: none. The child's working directory is the exact absolute root GSD Path supplied; a host SHA checkout or extra worktree is a contract failure.
+- Give every child a self-contained prompt with
+  absolute repository, input, template, and output paths plus its bounded
+  responsibility. A coder prompt also names its isolated linked-worktree root;
+  no child may infer the primary worktree.
+- Launch one child call per independent brief in the same turn up to the
+  available limit. Batch any remainder and collect every result before
+  applying the phase gate.
+- When the host exposes a blocking ask/reply channel, route a coder's
+  `NEEDS-ORCHESTRATOR` question through it as a live question with the worker
+  held alive for the reply, instead of block-and-redispatch. Append the
+  answer to the task Log as `Orchestrator answer:` so the portable on-disk
+  record stays complete; a timed-out or unavailable channel falls back to
+  the portable block path.
+- A child that receives a disposable worktree stages its assigned artifact
+  under that root. The parent validates it and atomically transfers it to
+  the canonical project path before removing the exact disposable root. A
+  child never writes a disposable-review output directly into the primary
+  worktree.
+- If neither supported child tool nor the full-capability `general` subagent is
+  available, stop and report the missing capability. Do not silently collapse
+  an independence boundary into the main context.
+
+## Parent lifecycle
+
+The parent owns lifecycle: wait for terminal completion, enforce timeout and
+cancellation, transfer staged outputs from disposable roots, clean up every
+child and temporary root before the phase gate, and never let a child delegate
+another GSD Path child. A timeout or cancellation is a blocked result.

package/platforms/qwen/dispatch.md

@@ -0,0 +1,60 @@
+# Qwen Code agent dispatch
+
+Apply this contract whenever a GSD Path skill delegates work:
+
+- Use Qwen Code's `agent` tool with `subagent_type: general-purpose`; do not
+  use the context-inheriting `fork` child. Every GSD Path child must be able to
+  write its declared artifact; the linked role brief supplies the read-only
+  boundary for auditors and reviewers.
+- Supply the deterministic logical task name as the task description:
+  `inspect_codebase`, `inspect_docs`, `docs_audit`,
+  `research_<dimension>`, `decide`, `roadmap`, `plan`, `plan_patch`,
+  `build_<task_id>`, `review_wave_<wave>_cycle_<cycle>` (a `deep` wave review
+  appends the lens suffix `_contract` or `_adversarial`; an optional review
+  panel uses `review_wave_<wave>_cycle_<cycle>_panel_<family>`; an
+  optional finding skeptic uses
+  `review_wave_<wave>_cycle_<cycle>_skeptic_<criterion_locator>`),
+  `review_plan_panel_<family>`,
+  `review_final`, or
+  `review_gap_<number>`. Normalize variable parts to lowercase ASCII and
+  replace non-alphanumeric runs with one underscore. Never add a random
+  suffix.
+- General-purpose children start with fresh context and are not resumable. For
+  every correction, retry, post-patch review, repeated audit, or later
+  milestone, launch a fresh child with the entire new self-contained brief.
+  Disk artifacts, not child chat history, remain the source of truth.
+- Resolve the phase's linked role brief to an absolute path. Include that path
+  in the prompt and require the child to read it before acting.
+- Tier hints: when the host advertises model or reasoning-effort selection,
+  request `heavy` for `plan`, `plan_patch`, `decide`, and `roadmap`, and
+  `light` for `inspect_docs` and `docs_audit`; when it offers no such
+  selection, do not override the model except on a review-panel child, which receives the exact slug from `scripts/review_panel.py resolve`. Do not ask Qwen Code to create another
+  worktree: GSD Path supplies the exact repository or linked-worktree root,
+  and the child must work only there. Host isolation: none.
+- Give every child a self-contained prompt with absolute input, template, and
+  output paths plus its bounded responsibility. A coder prompt also names its
+  isolated linked-worktree root; no child may infer the primary worktree.
+- Launch one `agent` call per independent brief in the same turn up to the
+  available limit. Batch any remainder and collect every result before
+  applying the phase gate.
+- When the host exposes a blocking ask/reply channel, route a coder's
+  `NEEDS-ORCHESTRATOR` question through it as a live question with the worker
+  held alive for the reply, instead of block-and-redispatch. Append the
+  answer to the task Log as `Orchestrator answer:` so the portable on-disk
+  record stays complete; a timed-out or unavailable channel falls back to
+  the portable block path.
+- A child that receives a disposable worktree stages its assigned artifact
+  under that root. The parent validates it and atomically transfers it to
+  the canonical project path before removing the exact disposable root. A
+  child never writes a disposable-review output directly into the primary
+  worktree.
+- If the `agent` tool or its full-capability general-purpose child is
+  unavailable, stop and report the missing capability. Do not silently
+  collapse an independence boundary into the main context.
+
+## Parent lifecycle
+
+The parent owns lifecycle: wait for terminal completion, enforce timeout and
+cancellation, transfer staged outputs from disposable roots, clean up every
+child and temporary root before the phase gate, and never let a child delegate
+another GSD Path child. A timeout or cancellation is a blocked result.