feat: promote parallel autonomous governance preset v0.2.0 - #73
Merged
Conversation
There was a problem hiding this comment.
Pull request overview
Adds an experimental parallel-autonomous-run-governance Spec Kit preset to coordinate multiple isolated autonomous runs with bounded concurrency, DAG handoffs, cooperative stop/resume, and explicit consolidation, including field-evidence and scaffolding for the standalone preset repo.
Changes:
- Introduces campaign/runner/state/result JSON templates plus runbook/evidence/retrospective Markdown templates.
- Adds orchestration entrypoint(s) and Spec Kit command surfaces for validate/start/status/stop/resume/consolidate workflows.
- Includes preset metadata, license, manpage, field-evidence, and mirrored “preset repo” scaffold under
specs/spec-kit-preset-repos/.
Reviewed changes
Copilot reviewed 50 out of 50 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
| specs/spec-kit-presets/parallel-autonomous-run-governance/templates/parallel-worker-result-template.json | Worker result contract template (campaign ID, head SHA, evidence, handoffs). |
| specs/spec-kit-presets/parallel-autonomous-run-governance/templates/parallel-runner-profiles-template.json | Runner/merge profile template using executable + argv arrays. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/templates/parallel-campaign-template.json | Campaign manifest template (topology, concurrency, workers, consolidation). |
| specs/spec-kit-presets/parallel-autonomous-run-governance/templates/parallel-campaign-state-template.json | Aggregate resumable campaign state template. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/templates/parallel-autonomous-runbook-template.md | Runbook template documenting authority/isolation/scheduling/consolidation. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/templates/parallel-autonomous-retrospective-template.md | Retrospective template for evidence-based findings and promotion decisions. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/templates/parallel-autonomous-evidence-template.md | Evidence ledger template for campaign/workers/handoffs/consolidation. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/templates/agent-file-addendum.md | Agent guidance addendum for parallel campaign governance boundaries. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/scripts/orchestrate-parallel-autonomous-runs.sh | Bash entrypoint delegating to the PowerShell orchestrator. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/preset.yml | Preset definition (id/version/templates/commands/tags). |
| specs/spec-kit-presets/parallel-autonomous-run-governance/LICENSE | Preset MIT license. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1 | Manpage for orchestration CLI. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/docs/field-evidence/native-macos-smoke-2026-07-18.md | Field evidence for native macOS 13-worker smoke run. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/commands/speckit.parallel-autonomous.md | Command spec for validate/execute campaign workflow. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/commands/speckit.parallel-autonomous-stop.md | Command spec for cooperative stop request. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/commands/speckit.parallel-autonomous-status.md | Command spec for read-only campaign inspection. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/commands/speckit.parallel-autonomous-resume.md | Command spec for resume with revalidation. |
| specs/spec-kit-presets/parallel-autonomous-run-governance/commands/speckit.parallel-autonomous-consolidate.md | Command spec for consolidation with explicit authority/selection. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/templates/parallel-worker-result-template.json | Mirrored worker result contract template for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/templates/parallel-runner-profiles-template.json | Mirrored runner/merge profile template for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/templates/parallel-campaign-template.json | Mirrored campaign manifest template for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/templates/parallel-campaign-state-template.json | Mirrored campaign state template for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/templates/parallel-autonomous-runbook-template.md | Mirrored runbook template for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/templates/parallel-autonomous-retrospective-template.md | Mirrored retrospective template for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/templates/parallel-autonomous-evidence-template.md | Mirrored evidence ledger template for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/templates/agent-file-addendum.md | Mirrored agent addendum template for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/scripts/orchestrate-parallel-autonomous-runs.sh | Mirrored Bash entrypoint for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/LICENSE | Mirrored MIT license for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1 | Mirrored manpage for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/docs/field-evidence/native-macos-smoke-2026-07-18.md | Mirrored field evidence for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/commands/speckit.parallel-autonomous.md | Mirrored command spec for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/commands/speckit.parallel-autonomous-stop.md | Mirrored stop command spec for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/commands/speckit.parallel-autonomous-status.md | Mirrored status command spec for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/commands/speckit.parallel-autonomous-resume.md | Mirrored resume command spec for standalone repo scaffold. |
| specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/commands/speckit.parallel-autonomous-consolidate.md | Mirrored consolidate command spec for standalone repo scaffold. |
| specs/007-parallel-autonomous-run-governance/tasks.md | Feature task tracking for the preset build-out and field validation. |
| specs/007-parallel-autonomous-run-governance/spec.md | Feature spec defining requirements, scenarios, and boundaries. |
| specs/007-parallel-autonomous-run-governance/plan.md | Implementation plan describing architecture/contracts/delivery and override. |
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 52 out of 52 changed files in this pull request and generated 5 comments.
Comments suppressed due to low confidence (4)
specs/spec-kit-presets/parallel-autonomous-run-governance/tests/fixture-worker.ps1:46
- In the handoff loop, git add/commit exit codes are not checked. If either command fails, the fixture continues and records a HEAD SHA that doesn't include the handoff commit, which can make tests flaky and hide underlying git issues.
specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/tests/fixture-worker.ps1:46 - Same issue as the preset-source copy: git add/commit failures inside the handoff loop are not checked, so the fixture may report a HEAD SHA that doesn't contain the handoff commit.
& git -C $Worktree add -- ([string] $handoff.path)
& git -C $Worktree commit -m "test: handoff $WorkerId to $($handoff.consumerWorkerId)" | Out-Null
$head = (& git -C $Worktree rev-parse HEAD).Trim()
specs/spec-kit-presets/parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1:1
- The manpage header declares
v0.1.0, but the preset version in this PR is0.1.2(see preset.yml / README). This should match the actual version being documented.
specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1:1 - Same manpage header version mismatch as the preset-source copy: it declares
v0.1.0while the preset version in this PR is0.1.2.
.TH ORCHESTRATE-PARALLEL-AUTONOMOUS-RUNS 1 "2026-07-18" "v0.1.0"
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 52 out of 52 changed files in this pull request and generated 1 comment.
Comments suppressed due to low confidence (2)
specs/spec-kit-presets/parallel-autonomous-run-governance/preset.yml:6
- Die Preset-Version ist im PR-Kontext inkonsistent: In PR-Beschreibung / Evidence / Manpage wird v0.1.0 genannt, hier steht aber 0.1.2. Bitte die Version ueber alle Preset-Artefakte konsistent halten (entweder alles auf 0.1.0 oder alle Referenzen auf 0.1.2 anheben).
specs/spec-kit-presets/parallel-autonomous-run-governance/tests/fixture-worker.ps1:46 - Im Handoff-Loop werden die Exit-Codes von
git addundgit commitnicht geprueft. Wenn z.B. ein Hook/GPG-Signing/Config das Commit blockiert, laeuft das Fixture weiter und schreibt ein Worker-Result mit inkonsistentem Git-Head/Handoff-Hash. Bitte wie oben beim ersten Commit strikt auf Fehler abbrechen.
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 68 out of 68 changed files in this pull request and generated 6 comments.
Comments suppressed due to low confidence (2)
specs/spec-kit-presets/parallel-autonomous-run-governance/preset.yml:6
- The preset metadata version is set to 0.1.2, but the PR description/spec artifacts/manpage/evidence refer to v0.1.0. This mismatch makes it unclear what version is being introduced by this PR and what the smoke evidence applies to. Align the preset version (and any repeated version strings) to a single value.
specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/preset.yml:6 - The preset metadata version is set to 0.1.2, but the PR description/spec artifacts/manpage/evidence refer to v0.1.0. This mismatch makes it unclear what version is being introduced by this PR and what the smoke evidence applies to. Align the preset version (and any repeated version strings) to a single value.
version: "0.1.2"
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 68 out of 68 changed files in this pull request and generated 4 comments.
Comments suppressed due to low confidence (2)
specs/spec-kit-presets/parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1:1
- The man page header advertises
v0.1.0, but the preset itself is versioned as0.1.2(seepreset.yml/ README). This makes the generated documentation inconsistent with the shipped preset version and differs from the header style used by existing preset man pages (which include the preset id + version and the manual section).
specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1:1 - Same version/header consistency issue in the repo-shaped scaffold: the man page advertises
v0.1.0even though the preset is0.1.2, and it omits the trailing manual title used by the other preset man pages in this repo.
.TH ORCHESTRATE-PARALLEL-AUTONOMOUS-RUNS 1 "2026-07-18" "v0.1.0"
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 68 out of 68 changed files in this pull request and generated no new comments.
Comments suppressed due to low confidence (2)
specs/spec-kit-presets/parallel-autonomous-run-governance/scripts/orchestrate-parallel-autonomous-runs.sh:12
- This new Bash entry point doesn’t implement
-h/--help, but other shipped Bash tools in the preset set do (e.g.validate-autonomous-run-state.sh). Since this is user-facing and has a man page, it should provide a basic help switch (at minimum printing usage and pointing todocs/man/orchestrate-parallel-autonomous-runs.1) before delegating to PowerShell.
specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/scripts/orchestrate-parallel-autonomous-runs.sh:12 - This new Bash entry point doesn’t implement
-h/--help, but other shipped Bash tools in the preset set do. Since this is user-facing and has a man page, it should provide a basic help switch (at minimum printing usage and pointing todocs/man/orchestrate-parallel-autonomous-runs.1) before delegating to PowerShell.
#!/usr/bin/env bash
set -euo pipefail
script_dir="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
if ! command -v pwsh >/dev/null 2>&1; then
printf 'Fehler: PowerShell 7 (pwsh) ist fuer den strukturierten Campaign-Kern erforderlich.\n' >&2
exit 2
fi
exec pwsh -NoLogo -NoProfile -File \
"$script_dir/orchestrate-parallel-autonomous-runs.ps1" "$@"
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 68 out of 68 changed files in this pull request and generated 1 comment.
Comments suppressed due to low confidence (5)
specs/spec-kit-presets/parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1:1
- The man page header still reports version
v0.1.0, but the preset scaffold declares version0.1.2(README + preset.yml). This should be kept in sync so consumers don’t misidentify the installed preset version.
specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1:1 - The repo-scaffold man page header still reports version
v0.1.0, but the preset scaffold declares version0.1.2(README + preset.yml). Keep these aligned so the repo-shaped release candidate is self-consistent.
.TH ORCHESTRATE-PARALLEL-AUTONOMOUS-RUNS 1 "2026-07-18" "v0.1.0"
specs/007-parallel-autonomous-run-governance/plan.md:28
- This plan says the preset was published as
v0.1.0, but the preset scaffold in this PR is versioned as0.1.2(and the main presets README points to thev0.1.2.zip). Aligning the plan with the implemented/published version avoids confusion when tracking field-campaign progression.
Implement and validate in Level 0, publish v0.1.0 in a protected standalone
repository, then opt in the Secure CaseTracker coordinator and six language
repositories. Promote to v0.2.0 and the standard eight-preset matrix only after
the Units 00-03 field campaign succeeds.
specs/007-parallel-autonomous-run-governance/tasks.md:13
- Task T010 references publishing
v0.1.0, but the preset scaffold in this PR is0.1.2. Update the task log so it matches the version actually being referenced/installed elsewhere in the PR.
- [x] T010 Publish protected experimental repository and v0.1.0.
specs/spec-kit-presets/parallel-autonomous-run-governance/README.md:4
- The PR metadata describes adding
parallel-autonomous-run-governanceasv0.1.0, but the preset scaffold declaresVersion: 0.1.2. Either the PR description/title should be updated tov0.1.2, or the preset versioning should be adjusted so the PR accurately reflects what is being introduced.
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 68 out of 68 changed files in this pull request and generated no new comments.
Comments suppressed due to low confidence (6)
specs/spec-kit-presets/README.md:17
- The wording "standard eight-preset profile" contradicts the earlier framing of an "eight standard and optional" set. This reads as if the optional preset is part of the standard baseline.
specs/spec-kit-presets/parallel-autonomous-run-governance/README.md:32 - This sentence implies the linked smoke evidence validates version 0.1.2, but the evidence document states "Preset version: 0.1.0". Either update the evidence to match, or clarify here which version the smoke covered.
specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/README.md:32 - This sentence implies the linked smoke evidence validates version 0.1.2, but the evidence document states "Preset version: 0.1.0". Either update the evidence to match, or clarify here which version the smoke covered.
The 13-worker native macOS smoke passed all four topologies. See
[`docs/field-evidence/native-macos-smoke-2026-07-18.md`](docs/field-evidence/native-macos-smoke-2026-07-18.md).
specs/spec-kit-presets/parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1:1
- The manpage header still reports v0.1.0, but the preset itself is versioned as 0.1.2 (preset.yml/README). This should be kept consistent so packaging and documentation match.
specs/spec-kit-preset-repos/spec-kit-preset-parallel-autonomous-run-governance/docs/man/orchestrate-parallel-autonomous-runs.1:1 - The manpage header still reports v0.1.0, but the preset itself is versioned as 0.1.2 (preset.yml/README). This should be kept consistent so packaging and documentation match.
.TH ORCHESTRATE-PARALLEL-AUTONOMOUS-RUNS 1 "2026-07-18" "v0.1.0"
specs/007-parallel-autonomous-run-governance/tasks.md:13
- This task list records publishing v0.1.0, but the preset sources in this PR are already at v0.1.2. Updating the task entry avoids ambiguity about what was actually published.
- [x] T010 Publish protected experimental repository and v0.1.0.
hindermath
changed the title
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 192 out of 192 changed files in this pull request and generated no new comments.
Comments suppressed due to low confidence (6)
docs/learning-units/presentations/Praesentation-Secure-ServiceHarvester-Lernreihe.md:214
- The slide headline says there are eight governance presets, but the table below lists only six. This is confusing for learners and contradicts the updated text. Add the missing
autonomous-run-governanceandparallel-autonomous-run-governancerows to make the table match the “acht” claim.
docs/learning-units/presentations/Praesentation-Secure-CaseTracker-Lernreihe.md:201 - The slide headline says there are eight governance presets, but the table lists only six entries. Add the missing
autonomous-run-governanceandparallel-autonomous-run-governancerows so the content matches the updated “acht” wording.
docs/learning-units/presentations/Praesentation-Secure-OrderDesk-Lernreihe.md:235 - The slide headline says there are eight governance presets, but the table only lists six. Add
autonomous-run-governanceandparallel-autonomous-run-governanceso the table matches the updated “acht” claim.
docs/learning-units/presentations/Praesentation-Secure-ServiceHarvester-Lernreihe.en.md:213 - The heading states there are eight governance presets, but the table lists only six. Add
autonomous-run-governanceandparallel-autonomous-run-governanceso the table matches the “Eight” wording.
docs/learning-units/presentations/Praesentation-Secure-CaseTracker-Lernreihe.en.md:201 - The heading says “The Eight Governance Presets”, but the table lists only six. Add
autonomous-run-governanceandparallel-autonomous-run-governanceto align the table with the updated wording.
docs/learning-units/presentations/Praesentation-Secure-OrderDesk-Lernreihe.en.md:235 - The heading says “The Eight Governance Presets”, but the table lists only six entries. Add
autonomous-run-governanceandparallel-autonomous-run-governanceso the table matches the updated wording.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
parallel-autonomous-run-governancefrom the historical v0.1.x development line to the validated v0.2.0 releaseField evidence
91c2c1a0-1526-479a-b8a3-e36a7d15d2b1mainPublication and rollout
77859364fe33f35633373b86bd95fcab4ed3263d3a97b8e9d948803b146abcefcc65worktree was not overwrittenValidation
git diff --check: pass