markhazleton · markhazleton · May 1, 2026
diff --git a/.devspark/VERSION b/.devspark/VERSION
@@ -1,4 +1,4 @@
-version: 2.1.0
-installed: 2026-04-30
+version: 2.2.0
+installed: 2026-05-01
 method: claude-quickstart
 migrated-from: legacy-specify
diff --git a/.devspark/defaults/commands/devspark.address-pr-review.md b/.devspark/defaults/commands/devspark.address-pr-review.md
@@ -4,6 +4,9 @@ handoffs:
   - label: Re-Review Updated PR
     agent: devspark.pr-review
     prompt: Run /devspark.pr-review UPDATE for this PR after fixes are committed
+scripts:
+  sh: pwsh -File .devspark/scripts/powershell/address-pr-review.ps1 -PrId $ARGUMENTS -Json
+  ps: .devspark/scripts/powershell/address-pr-review.ps1 -PrId $ARGUMENTS -Json
 ---
 
 ## User Input
@@ -33,9 +36,9 @@ This command is the **author-side companion** to `/devspark.pr-review`. It helps
 
 ### Phase 0 — Load context
 
-> **Script Resolution**: Before running `.devspark/scripts/powershell/address-pr-review.ps1 -PrId $ARGUMENTS -Json`, apply the 2-tier override check for PowerShell only — if `.documentation/scripts/powershell/address-pr-review.ps1` exists on disk, run that file instead, preserving all arguments. Team override in `.documentation/scripts/powershell/` takes priority over `.devspark/scripts/powershell/`.
+> **Script Resolution**: Before running `{SCRIPT}`, apply the 2-tier override check for PowerShell only — if `.documentation/scripts/powershell/address-pr-review.ps1` exists on disk, run that file instead, preserving all arguments. Team override in `.documentation/scripts/powershell/` takes priority over `.devspark/scripts/powershell/`.
 
-1. Run `.devspark/scripts/powershell/address-pr-review.ps1 -PrId $ARGUMENTS -Json` with `-PrId {PR_ID} -Json`.
+1. Run `{SCRIPT}` with `-PrId {PR_ID} -Json`.
 2. Fail fast if `/.documentation/specs/pr-review/pr-{PR_ID}.md` is missing.
 3. Parse open findings from checklist lines matching:
    - `- [ ] **C-##**`

diff --git a/.devspark/defaults/commands/devspark.analyze.md b/.devspark/defaults/commands/devspark.analyze.md
@@ -7,6 +7,9 @@ handoffs:
   - label: Revise Plan
     agent: devspark.plan
     prompt: Revise plan to address analysis findings
+scripts:
+  sh: .devspark/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks
+  ps: .devspark/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks
 ---
 
 ## User Input
@@ -35,9 +38,9 @@ Read the YAML frontmatter in `spec.md` before analyzing. Treat `classification`,
 
 ### 1. Initialize Analysis Context
 
-> **Script Resolution**: Before running `.devspark/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
+> **Script Resolution**: Before running `{SCRIPT}`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
 
-Run `.devspark/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks` once from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS. Derive absolute paths:
+Run `{SCRIPT}` once from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS. Derive absolute paths:
 
 - SPEC = FEATURE_DIR/spec.md
 - PLAN = FEATURE_DIR/plan.md
@@ -211,7 +214,7 @@ After producing the report:
 
 ## Context
 
-$ARGUMENTS
+{ARGS}
 
 ## Shared Review Resolution Contract Output
 

diff --git a/.devspark/defaults/commands/devspark.archive.md b/.devspark/defaults/commands/devspark.archive.md
@@ -7,6 +7,9 @@ handoffs:
   - label: Run Documentation Audit
     agent: devspark.site-audit
     prompt: Audit documentation quality and stale references before harvest
+scripts:
+  sh: .devspark/scripts/bash/harvest.sh $ARGUMENTS --json
+  ps: .devspark/scripts/powershell/harvest.ps1 $ARGUMENTS -Json
 ---
 
 ## User Input
@@ -36,9 +39,9 @@ Treat every invocation of `/devspark.archive` as an invocation of `/devspark.har
 
 ### 1. Gather Context
 
-> **Script Resolution**: Before running `.devspark/scripts/powershell/harvest.ps1 $ARGUMENTS -Json`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
+> **Script Resolution**: Before running `{SCRIPT}`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
 
-Run `.devspark/scripts/powershell/harvest.ps1 $ARGUMENTS -Json` from the repo root. Parse the JSON output:
+Run `{SCRIPT}` from the repo root. Parse the JSON output:
 
 - `REPO_ROOT` — absolute path to the repository root
 - `ARCHIVE_DIR` — target folder for today's archive (e.g., `.archive/2026-03-07`)

diff --git a/.devspark/defaults/commands/devspark.checklist.md b/.devspark/defaults/commands/devspark.checklist.md
@@ -7,6 +7,9 @@ handoffs:
   - label: Run Analysis
     agent: devspark.analyze
     prompt: Analyze spec consistency after checklist review
+scripts:
+  sh: .devspark/scripts/bash/check-prerequisites.sh --json
+  ps: .devspark/scripts/powershell/check-prerequisites.ps1 -Json
 ---
 
 ## Overview: "Unit Tests for English"
@@ -42,9 +45,9 @@ You **MUST** consider the user input before proceeding (if not empty).
 
 **Multi-app support**: If this repository uses multi-app mode (`.documentation/devspark.json` exists with `mode: "multi-app"`), check for `--app <id>` in the user input to scope this workflow to a specific application. When app context is provided, resolve artifacts from `{app.path}/.documentation/` instead of the repository root `.documentation/`. Print the resolved scope (app name, doc root) at the start of output.
 
-> **Script Resolution**: Before running `.devspark/scripts/powershell/check-prerequisites.ps1 -Json`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
+> **Script Resolution**: Before running `{SCRIPT}`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
 
-1. **Setup**: Run `.devspark/scripts/powershell/check-prerequisites.ps1 -Json` from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS list.
+1. **Setup**: Run `{SCRIPT}` from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS list.
    - All file paths must be absolute.
    - For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'\''m Groot' (or double-quote if possible: "I'm Groot").
    - If `/.documentation/memory/constitution.md` exists, load it. Use constitution principles to inform checklist categories (e.g., if the constitution mandates accessibility, include accessibility items).

diff --git a/.devspark/defaults/commands/devspark.clarify.md b/.devspark/defaults/commands/devspark.clarify.md
@@ -4,6 +4,9 @@ handoffs:
   - label: Build Technical Plan
     agent: devspark.plan
     prompt: Create a plan for the spec. I am building with...
+scripts:
+   sh: .devspark/scripts/bash/check-prerequisites.sh --json --paths-only
+   ps: .devspark/scripts/powershell/check-prerequisites.ps1 -Json -PathsOnly
 ---
 
 ## User Input
@@ -24,9 +27,9 @@ Note: This clarification workflow is expected to run (and be completed) BEFORE i
 
 Execution steps:
 
-> **Script Resolution**: Before running `.devspark/scripts/powershell/check-prerequisites.ps1 -Json -PathsOnly`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
+> **Script Resolution**: Before running `{SCRIPT}`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
 
-1. Run `.devspark/scripts/powershell/check-prerequisites.ps1 -Json -PathsOnly` from repo root **once** (combined `--json --paths-only` mode / `-Json -PathsOnly`). Parse minimal JSON payload fields:
+1. Run `{SCRIPT}` from repo root **once** (combined `--json --paths-only` mode / `-Json -PathsOnly`). Parse minimal JSON payload fields:
    - `FEATURE_DIR`
    - `FEATURE_SPEC`
    - (Optionally capture `IMPL_PLAN`, `TASKS` for future chained flows.)
@@ -189,7 +192,7 @@ Behavior rules:
 - If no questions asked due to full coverage, output a compact coverage summary (all categories Clear) then suggest advancing.
 - If quota reached with unresolved high-impact categories remaining, explicitly flag them under Deferred with rationale.
 
-Context for prioritization: $ARGUMENTS
+Context for prioritization: {ARGS}
 
 ## Shared Review Resolution Contract Output
 

diff --git a/.devspark/defaults/commands/devspark.commit-audit.md b/.devspark/defaults/commands/devspark.commit-audit.md
@@ -7,6 +7,9 @@ handoffs:
   - label: View Harvest Report
     agent: devspark.harvest
     prompt: Review completed specs and stale documentation before archiving
+scripts:
+  sh: .devspark/scripts/bash/commit-audit.sh $ARGUMENTS --json
+  ps: .devspark/scripts/powershell/commit-audit.ps1 $ARGUMENTS -Json
 ---
 
 ## User Input
@@ -48,9 +51,9 @@ Multiple scope flags may be combined: `--scope=velocity,hygiene`
 
 ### 1. Initialize Audit Context
 
-> **Script Resolution**: Before running `.devspark/scripts/powershell/commit-audit.ps1 $ARGUMENTS -Json`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
+> **Script Resolution**: Before running `{SCRIPT}`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
 
-Run `.devspark/scripts/powershell/commit-audit.ps1 $ARGUMENTS -Json` and parse its JSON output.
+Run `{SCRIPT}` and parse its JSON output.
 
 Expected fields include:
 

diff --git a/.devspark/defaults/commands/devspark.create-pr.md b/.devspark/defaults/commands/devspark.create-pr.md
@@ -4,6 +4,9 @@ handoffs:
   - label: Review Pull Request
     agent: devspark.pr-review
     prompt: Review the pull request for constitution compliance
+scripts:
+  sh: .devspark/scripts/bash/create-pr.sh --mode preflight --json $ARGUMENTS
+  ps: .devspark/scripts/powershell/create-pr.ps1 -Mode Preflight -Json $ARGUMENTS
 ---
 
 ## User Input
@@ -34,9 +37,9 @@ This command is advisory. Dirty trees, missing specs, incomplete tasks, unresolv
 
 ### 1. Run Preflight Context
 
-> **Script Resolution**: Before running `.devspark/scripts/powershell/create-pr.ps1 -Mode Preflight -Json $ARGUMENTS`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
+> **Script Resolution**: Before running `{SCRIPT}`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
 
-Run `.devspark/scripts/powershell/create-pr.ps1 -Mode Preflight -Json $ARGUMENTS` once from the repository root and parse the returned JSON.
+Run `{SCRIPT}` once from the repository root and parse the returned JSON.
 
 Use the script output as the source of truth for:
 

diff --git a/.devspark/defaults/commands/devspark.critic.md b/.devspark/defaults/commands/devspark.critic.md
@@ -9,6 +9,9 @@ handoffs:
     agent: devspark.tasks
     prompt: Regenerate tasks with missing operational items
     send: true
+scripts:
+  sh: .devspark/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks
+  ps: .devspark/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks
 ---
 
 ## User Input
@@ -44,9 +47,9 @@ Read the YAML frontmatter in `spec.md` before evaluating risk. Treat `classifica
 
 ### 1. Initialize Analysis Context
 
-> **Script Resolution**: Before running `.devspark/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
+> **Script Resolution**: Before running `{SCRIPT}`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
 
-Run `.devspark/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks` once from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS. Derive absolute paths:
+Run `{SCRIPT}` once from repo root and parse JSON for FEATURE_DIR and AVAILABLE_DOCS. Derive absolute paths:
 
 - SPEC = FEATURE_DIR/spec.md
 - PLAN = FEATURE_DIR/plan.md
@@ -491,7 +494,7 @@ This command produces a **"pre-mortem"** analysis - imagining the project has fa
 
 ## Context
 
-$ARGUMENTS
+{ARGS}
 
 ## Shared Review Resolution Contract Output
 

diff --git a/.devspark/defaults/commands/devspark.discover-constitution.md b/.devspark/defaults/commands/devspark.discover-constitution.md
@@ -379,4 +379,4 @@ If user says "done" before any questions:
 
 ## Context
 
-$ARGUMENTS
+{ARGS}
diff --git a/.devspark/defaults/commands/devspark.evolve-constitution.md b/.devspark/defaults/commands/devspark.evolve-constitution.md
@@ -7,6 +7,9 @@ handoffs:
   - label: Review PRs
     agent: devspark.pr-review
     prompt: Review recent PRs to gather more data
+scripts:
+  sh: .devspark/scripts/bash/evolution-context.sh $ARGUMENTS --json
+  ps: .devspark/scripts/powershell/evolution-context.ps1 $ARGUMENTS -Json
 ---
 
 ## User Input
@@ -50,9 +53,9 @@ Parse `$ARGUMENTS` for action type:
 
 ### 1. Initialize Evolution Context
 
-> **Script Resolution**: Before running `.devspark/scripts/powershell/evolution-context.ps1 $ARGUMENTS -Json`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
+> **Script Resolution**: Before running `{SCRIPT}`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
 
-Run `.devspark/scripts/powershell/evolution-context.ps1 $ARGUMENTS -Json` to gather context and parse JSON output for:
+Run `{SCRIPT}` to gather context and parse JSON output for:
 
 - `CONSTITUTION_PATH`: Path to current constitution
 - `CONSTITUTION_EXISTS`: Whether constitution exists

diff --git a/.devspark/defaults/commands/devspark.harvest.md b/.devspark/defaults/commands/devspark.harvest.md
@@ -7,6 +7,9 @@ handoffs:
   - label: Run Documentation Audit
     agent: devspark.site-audit
     prompt: Audit documentation quality and stale references before harvest
+scripts:
+  sh: .devspark/scripts/bash/harvest.sh $ARGUMENTS --json
+  ps: .devspark/scripts/powershell/harvest.ps1 $ARGUMENTS -Json
 ---
 
 ## User Input
@@ -60,9 +63,9 @@ Multiple scopes may be combined: `--scope=specs,comments`
 
 ### 1. Initialize Harvest Context
 
-> **Script Resolution**: Before running `.devspark/scripts/powershell/harvest.ps1 $ARGUMENTS -Json`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
+> **Script Resolution**: Before running `{SCRIPT}`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
 
-Run `.devspark/scripts/powershell/harvest.ps1 $ARGUMENTS -Json` and parse its JSON output.
+Run `{SCRIPT}` and parse its JSON output.
 
 Expected fields include:
 

diff --git a/.devspark/defaults/commands/devspark.implement.md b/.devspark/defaults/commands/devspark.implement.md
@@ -8,6 +8,9 @@ handoffs:
   - label: Run Analysis
     agent: devspark.analyze
     prompt: Analyze spec consistency after implementation
+scripts:
+  sh: .devspark/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks
+  ps: .devspark/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks
 ---
 
 ## User Input
@@ -22,9 +25,9 @@ You **MUST** consider the user input before proceeding (if not empty).
 
 **Multi-app support**: If this repository uses multi-app mode (`.documentation/devspark.json` exists with `mode: "multi-app"`), check for `--app <id>` in the user input to scope this workflow to a specific application. When app context is provided, resolve artifacts from `{app.path}/.documentation/` instead of the repository root `.documentation/`. Print the resolved scope (app name, doc root) at the start of output.
 
-> **Script Resolution**: Before running `.devspark/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
+> **Script Resolution**: Before running `{SCRIPT}`, apply the 2-tier override check — if `.documentation/scripts/powershell/<filename>` (PowerShell) or `.documentation/scripts/bash/<filename>` (Bash) exists on disk, run that file instead, preserving all arguments. Team overrides in `.documentation/scripts/` always take priority over `.devspark/scripts/`.
 
-1. Run `.devspark/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks` from repo root and parse FEATURE_DIR and AVAILABLE_DOCS list. All paths must be absolute. For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'\''m Groot' (or double-quote if possible: "I'm Groot").
+1. Run `{SCRIPT}` from repo root and parse FEATURE_DIR and AVAILABLE_DOCS list. All paths must be absolute. For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'\''m Groot' (or double-quote if possible: "I'm Groot").
 
 2. **Check checklists status** (if FEATURE_DIR/checklists/ exists):
    - Scan all checklist files in the checklists/ directory
@@ -146,6 +149,11 @@ You **MUST** consider the user input before proceeding (if not empty).
    - Suggest next steps if implementation cannot proceed
    - **IMPORTANT** For completed tasks, make sure to mark the task off as [X] in the tasks file.
 
+   Additional governance expectations for create-pr/pr-review transitions:
+
+   - Delivery status must be met (`create_pr_ready=true` in latest harness result)
+   - Branch sync must pass (`HEAD` not behind `origin/main`)
+
 10. Completion validation:
     - Verify all required tasks are completed
     - Check that implemented features match the original specification

diff --git a/.devspark/defaults/commands/devspark.personalize.md b/.devspark/defaults/commands/devspark.personalize.md
@@ -1,5 +1,8 @@
 ---
 description: Create a personalized copy of any DevSpark command prompt for the current git user.
+scripts:
+  sh: .devspark/scripts/bash/check-prerequisites.sh --json
+  ps: .devspark/scripts/powershell/check-prerequisites.ps1 -Json
 ---
 
 ## User Input
Original file line number	Diff line number	Diff line change
Expand Up		@@ -379,4 +379,4 @@ If user says "done" before any questions:

		## Context

		$ARGUMENTS
		{ARGS}