Skip to content

Latest commit

 

History

History
351 lines (263 loc) · 16 KB

README.md

File metadata and controls

351 lines (263 loc) · 16 KB

Autonomous Run Governance

Git-Dateiinventar / Git path inventory

Model-Routing-Ausfuehrung / Model-routing execution

Paketkennung: v0.4.12. Vorbereitung und Veröffentlichungsgrenze. Die Release-Seite und der externe Archivnachweis belegen die Veröffentlichung, nicht dieser Vorbereitungsstand. Frühere Versionsnachweise unten bleiben historisch.

Package identity: v0.4.12. The release page and external archive evidence prove publication, not this preparation snapshot. Earlier version records below remain historical.

Release-Abschluss und Verbesserungsprofil / Publication closeout and improvement profile.

Der unten verlinkte Basispaket-Nachweis bleibt historisch; dieses Paket nimmt die Quellenkorrekturen als neue Version auf.

The linked base-package evidence remains historical; this package includes the source corrections as a new version.

Leserpfad / Reader path: Deutsch: Einstieg, Begriffe und Fehlerhilfe · English: start, terms and troubleshooting.

Historisches Basispaket v0.4.6. Der Release-Stand wird getrennt geprüft; ein Commit auf main ist noch keine Veröffentlichung oder Installation.

Historical base package v0.4.6. The release page records actual publication separately; a main-branch commit is not publication or installation.

Patch 0.4.6 liefert die verbesserte zweisprachige Einstiegs- und Kompositionsdokumentation. Verhalten und Berechtigungsgrenzen bleiben erhalten. Release-Nachweis / Release record.

Patch 0.4.6 packages the improved bilingual getting-started and composition guide. Behavior and authority boundaries remain unchanged.

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

Version 0.4.10 | Priority 70 | Spec Kit >=0.8.3

Version 0.4.10 prueft Git-Dateiinventare NUL-sicher. Dadurch bleiben auch versionierte Pfade mit Zeilenumbruechen oder anderen ungewoehnlichen Zeichen Teil der Evidence-Pruefung, statt unbemerkt aus dem Inventar zu fallen.

Version 0.4.10 parses Git path inventories with NUL delimiters. Tracked paths containing newlines or other unusual characters therefore remain part of the evidence check instead of silently disappearing from the inventory.

Version 0.4.9 bindet den normalen Phasenrunner an die rollenbezogene Ausfuehrungspolicy aus Model Routing Governance v0.2.4. Lesende Fast-Profile behalten ihre Schreibsperre; native agy-Ergebnisse speichert der Host nach strikter JSON-Pruefung.

Version 0.4.9 binds the normal phase runner to the role-aware execution policy from Model Routing Governance v0.2.4. Read-only fast profiles retain their write boundary; the host persists native agy results after strict JSON validation.

Version 0.4.8 erhaelt historische Leerzeilen am Dateiende nur mit derselben ausdruecklichen Pfad-/Rohhashbindung wie historische Leerzeichen. Im Staged- Modus gelten weiterhin die exakten Indexbytes und nur neu hinzugefuegte Dateien. Andere EOF-Befunde, Hashdrift, Konfliktmarker und unnoetige Ausnahmen bleiben blockierend. Keine Archivdatei wird umgeschrieben.

Version 0.4.8 preserves historical blank-at-EOF only under the same explicit path/raw-hash approval as trailing spaces. Staged mode still requires exact index bytes and newly added files. Other EOF errors, hash drift, conflict markers and unnecessary exemptions remain blocking. No archive file is rewritten.

Version 0.4.4 prueft im Staged-Modus Pfade, regulaere Dateitypen und Bytes direkt im Git-Index. Umbenennungen werden als geloeschter Quellpfad plus hinzugefuegter Zielpfad geprueft; Symlinks, Gitlinks und andere nicht regulaere Indexeintraege bleiben blockierend. Die Begrenzung historischer Whitespace-Ausnahmen aus v0.4.3 bleibt erhalten.

Version 0.4.4 validates staged paths, regular-file types, and bytes directly in the Git index. Renames are checked as a deleted source plus an added target; symlinks, gitlinks, and other non-regular index entries remain blocking. The v0.4.3 restriction on historical whitespace allowances remains in force.

Version 0.4.2 ergaenzt eine fail-closed Ausnahme fuer unveraenderliche historische Textdateien: Sie muss als exakter repositoryrelativer Pfad plus Roh-SHA-256 ausdruecklich genehmigt und zugleich Teil der beabsichtigten Liefermenge sein. Pfad-, Hash- oder Inhaltsdrift sowie eine unnoetige Ausnahme bleiben blockierend.

Version 0.4.2 adds a fail-closed exception for immutable historical text files. It requires an explicitly approved exact repository-relative path plus raw SHA-256, and the file must also be part of the intended delivery set. Path, hash, or content drift and unnecessary exceptions remain blocking.

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

Vorlagen und Komposition / Templates and Composition

Das Manifest liefert eigene autonome Commands, Run-State- und Readiness-Vorlagen und ergänzt Constitution/Spec/Plan/Tasks per append. Installation füllt keinen Run-State aus und startet keinen Lauf. Nenne Feature, Scope, aktuelle Autorität und genau einen Delivery-Modus; Vorlagen sind Hilfsmittel, keine abgeschlossenen Gates.

The manifest provides autonomous commands, state/readiness templates and append contributions to constitution/spec/plan/tasks. Installation fills no state and starts no run. Name feature, scope, current authority and one delivery mode. Templates are aids, not passed gates.

Feature-Nummern und Aufrufe unten sind Beispiele. Verwende das tatsächlich freigegebene Feature und die Syntax deiner Integration. Bei fehlendem Profil, veralteter Evidence oder unklarer Autorität zuerst den Blocker behandeln. Status/Readiness ist der sichere Einstieg, nicht ein ungeprüfter Start.

Feature numbers/invocations below are examples. Use the authorized feature and your integration's syntax. Resolve missing profiles, stale evidence or unclear authority first. Start with status/readiness, not an unchecked run.

Kleinere Prioritätszahlen haben höhere Auflösungspriorität. append ergänzt, wrap verschachtelt; replace oder Overrides können gleichnamige Beiträge verdrängen. Eigene Reihenfolgen separat prüfen. Priorität ersetzt keine Phasen-Gates, stärkste deklarierte Routing-Rolle oder Remote-Autorität. Prüfe specify preset resolve plan-template und erzeugte Agentenflächen.

Lower numbers mean higher precedence. Append adds, wrap nests; replace or overrides can hide same-name contributions. Check custom orderings separately. Priority replaces neither phase gates, strongest-role routing nor remote authority. Inspect plan-template resolution and generated agent surfaces.

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.12.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.12.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