Autonomous Run Governance

Permission-bounded, evidence-first governance for one explicitly delegated autonomous Spec Kit run.

Version 0.4.1 | Priority 70 | Spec Kit >=0.8.3

Version 0.4.1 prueft die ausdrueckliche Liefermenge einschliesslich benannter unversionierter Dateien, verlangt ein strukturiertes semantisches Ergebnis fuer jede geroutete Phase und trennt PreMerge- von PostMerge-Gate-Evidence. Exitcode 0 allein bedeutet nicht mehr Completed. Der unabhaengige G2B-Feldnachweis und die versionierte ZIP-Pruefung sind abgeschlossen.

Version 0.4.1 validates the explicit delivery set, including named untracked files, requires a structured semantic result for every routed phase, and separates PreMerge from PostMerge gate evidence. Exit zero alone no longer means Completed. The independent G2B field proof and versioned ZIP validation are complete.

Version 0.3.6 classifies a missing or outdated PowerShell runtime as a bilingual blocked prerequisite in the model-routing test wrapper. Runtime and authority semantics are unchanged.

Exit code 3 is limited to this test prerequisite and means Blocked. The autonomous execution scripts retain their existing invocation and runtime exit contracts.

Version 0.3.4 accepts machine-local runner-profile schema 2.0 and composes with the published model-routing.json catalogs. Unknown or ambiguous bindings remain blocked.

Version 0.3.3 recognizes optional intake-review-governance. Preset 9 remains N/A unless repository policy explicitly activates the gate.

Version 0.3.3 additionally carries the accepted project-specific learner and accessibility contract through Specify, Plan, Tasks, implementation evidence, documentation, and retrospective. It does not invent a target audience or silently assume Spec Kit experience.

Deutsch

Wofuer ist dieses Preset gedacht?

Dieses Preset fuehrt einen Spec-Kit-Feature-Lauf kontrolliert von der Vorbereitung bis zum belegbaren Abschluss. Es verbindet:

• ausdrueckliche Berechtigungen statt stiller Annahmen,
• reproduzierbare Specify-, Clarify-, Plan-, Tasks- und Analyze-Phasen,
• ausgewogenes, providerneutrales Modell-Routing an sicheren Phasengrenzen,
• einen maschinenlesbaren Run-State,
• kooperatives Stoppen und idempotentes Fortsetzen,
• pruefbare Acceptance-Gates fuer den exakten aktuellen Head,
• einen kontrollierten lokalen oder remote Closeout,
• retrospektives Lernen ohne automatische Scope-Erweiterung.

Die Installation startet keinen Lauf und erteilt keine Commit-, Push-, Merge-, Bypass-, Secret- oder Provider-Administrationsrechte.

Ablauf im Ueberblick

flowchart LR
    A["Expliziter Auftrag"] --> B["Preflight und Berechtigung"]
    B --> C["Spec Kit: Specify bis Analyze"]
    C --> R["SHA-256-gebundene Phasenuebergabe"]
    R --> D["Implementieren und validieren"]
    D --> E{"Delivery-Modus"}
    E -->|LocalImplementation| F["Lokaler Abschluss"]
    E -->|PublishPR| G["Commit, Push und PR"]
    E -->|MergeAndSync| H["Review, Merge und Sync"]
    F --> I["Completed"]
    G --> I
    H --> I

Loading

Textalternative DE: Ein ausdruecklicher Auftrag fuehrt zuerst durch Preflight und Berechtigungspruefung. Danach folgen die Spec-Kit-Phasen, Implementierung und Validierung. Der aktuelle Auftrag bestimmt genau einen Delivery-Modus. Erst wenn dessen Abschlussbedingungen und die finale Validierung erfuellt sind, ist der Lauf Completed.

Eine einzelne autonome Ausfuehrung darf unterschiedliche Modellprofile nutzen. Der Wechsel erfolgt ausschliesslich zwischen abgeschlossenen Phasen durch einen neuen Prozess. Rolle, Profil, Modell, Reasoning-Aufwand, Preflight und Ergebnis-Hash werden im Run-State belegt. Fehlt ein erforderliches lokales Profil, wird der Lauf Blocked; es gibt keinen stillen Fallback.

Text alternative EN: An explicit instruction first passes repository and authority preflight. The Spec Kit phases, implementation, and validation follow. Current authority selects exactly one delivery mode. The run becomes Completed only after that mode's closeout conditions and final validation have succeeded.

In fuenf Minuten starten

1. Preset installieren:

   specify preset add \
     --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.4.1.zip \
     --priority 70

2. Installation pruefen:

   specify preset info autonomous-run-governance
   specify preset resolve autonomous-run-readiness-checklist-template
   bash .specify/scripts/bash/invoke-autonomous-model-phase.sh --help

3. Einen eindeutig begrenzten lokalen Lauf delegieren:

   /speckit.autonomous Implementiere Feature 042 vollstaendig.
   Delivery-Modus: LocalImplementation.
   Keine Commits, Pushes, PRs, Merges oder Bypasses.
   

4. Zustand jederzeit read-only abfragen:

   /speckit.autonomous-status
   

Fuer einen absichtlichen Halt wird /speckit.autonomous-stop verwendet. Ein bewusst pausierter Lauf wird ausschliesslich mit /speckit.autonomous-resume fortgesetzt.

Wann Preset 7 und wann Preset 8?

Preset 7 ist fuer genau einen autonomen Feature-Lauf zustaendig. Mehrere isolierte Worker, Kampagnen-DAGs, gemischte Runner-Profile oder eine geordnete Mehr-PR-Konsolidierung benoetigen zusaetzlich parallel-autonomous-run-governance. Preset 8 baut auf diesem Preset auf und ersetzt seine Worker-Governance nicht.

Handbuch

Kapitel	Inhalt
Dokumentationsstart	Rollenbasierter Wegweiser
Erster Lauf	Installation, Readiness und erster sicherer Lauf
Berechtigung und Delivery	Delivery-Modi und Autorisierungsgrenzen
Lebenszyklus und Operationen	Status, Stop, Resume und Retrospektive
Evidence und Closeout	Gates, Exact Head, Review und Abschluss
Recovery und Fehlersuche	Unterbrechung, Drift und Blocker
Kompatibilitaet	Versionen, Schemas und Upgrade-Regeln

English

What is this preset for?

This preset governs one Spec Kit feature run from preparation to a verifiable closeout. It combines:

• explicit authority instead of silent assumptions,
• reproducible Specify, Clarify, Plan, Tasks, and Analyze phases,
• balanced provider-neutral model routing at safe phase boundaries,
• machine-readable run state,
• cooperative stop and idempotent resume,
• acceptance gates bound to the exact current head,
• controlled local or remote closeout,
• retrospective learning without automatic scope expansion.

Installing the preset does not start a run or grant commit, push, merge, bypass, secret, or provider-administration authority.

Five-minute start

1. Install the preset:

   specify preset add \
     --from https://github.com/hindermath/spec-kit-preset-autonomous-run-governance/archive/refs/tags/v0.4.1.zip \
     --priority 70

2. Verify the installation:

   specify preset info autonomous-run-governance
   specify preset resolve autonomous-run-readiness-checklist-template

3. Delegate one bounded local run:

   /speckit.autonomous Implement feature 042 completely.
   Delivery mode: LocalImplementation.
   Do not commit, push, open a PR, merge, or bypass policy.
   

4. Inspect state at any time without changing it:

   /speckit.autonomous-status
   

Use /speckit.autonomous-stop for a deliberate pause. Resume a deliberately paused run only through /speckit.autonomous-resume.

One autonomous run may use different local model profiles. A switch is allowed only between completed phases by starting a new process. The run state records the role, profile, model, reasoning effort, preflight, and result hash. A missing required profile blocks the run; no silent fallback is permitted.

Preset 7 or Preset 8?

Preset 7 governs one autonomous feature run. Multiple isolated workers, campaign DAGs, mixed runner profiles, or ordered multi-PR consolidation also require parallel-autonomous-run-governance. Preset 8 builds on this preset and does not replace worker governance.

Manual

Chapter	Subject
Documentation home	Role-based documentation map
First run	Installation, readiness, and first safe run
Authority and delivery	Delivery modes and authority boundaries
Lifecycle and operations	Status, stop, resume, and retrospective
Evidence and closeout	Gates, exact head, review, and completion
Recovery and troubleshooting	Interruption, drift, and blockers
Compatibility	Versions, schemas, and upgrade rules

Safety summary

• Ambiguous remote authority always falls back to LocalImplementation.
• Status is read-only and grants no authority.
• Stop is cooperative and never an implicit process kill.
• A stored delivery mode records history; it is not current permission.
• Missing, stale, or contradictory evidence blocks remote closeout.
• Missing model profiles, failed preflights, or unbound phase handoffs block the next routed phase.
• Completed requires every applicable closeout field and final validation.

License

MIT