home-baseline

English version

home-baseline ist die versionierte Level-0-Quelle für einen sicheren, plattformübergreifenden und agentisch unterstützten Entwicklungsarbeitsplatz. Sie verwaltet gemeinsame Skripte, Governance, Spec-Kit-Presets, Dokumentationsregeln und Lernmaterialien. Du brauchst keine Spec-Kit-Erfahrung, um hier zu beginnen.

Aktueller vorbereiteter Governance-Zielstand: Security v0.7.1, Architecture v0.6.2 sowie Intake Authoring v0.3.7, Review v0.2.4 und Sequencing v0.2.8. Aktueller Authoring-Patch: begrenzte v0.3.7-Lieferung.

Aktueller begrenzter Rollout: Security 0.7.1, Architecture 0.6.2 und Sequencing 0.2.8. Paketbindung, Piloten und verbleibende Schritte. Die Installation startet keine Produktimplementierung.

Jahresprüfung und gestufte Lieferung: zentrale Baseline/Home Runtime, zwei benannte Piloten, übrige öffentliche Level-2-Repos erst nach separatem Auftrag, übrige Flotte nach erneutem Auftrag.

Spec-Kit-Läufe in öffentlichen Repositories

Datenstand öffentlich: 2026-10-06T09:33:20Z; privat: 2026-10-04T16:37:47Z · Methodik und Beleggrenzen

Level	Öffentliches GitHub-Repository / Gruppe	Gestartet	Ausgeführt	Abschluss belegt	Manuell	Autonom seriell	Autonom parallel	Gemischt	Nicht eindeutig belegt	Beschleunigungsfaktor (Repo-Schätzung)
0	home-baseline	29	29	28	0	22	0	0	7	72,1×
2	cc65	0	0	0	0	0	0	0	0	72,7×
2	tvision	0	0	0	0	0	0	0	0	90,2×
2	agent-operations-cockpit	3	3	3	0	3	0	0	0	225,2×
2	InventarWorkerService	2	2	2	0	1	0	0	1	18,9×
2	TinyCalc	5	5	5	0	1	0	0	4	31,2×
2	TinyPl0	6	6	6	0	4	0	0	2	37,1×
2	TuiVision	46	46	46	0	19	0	0	27	94,0×
2	absdd-image-sandbox	3	3	3	0	2	0	0	1	39,1×
2	Show-CommandTui400	0	0	0	0	0	0	0	0	168,3×
	Öffentliche Level-2-Repositories gesamt	65	65	65	0	30	0	0	35	58,0×
	Öffentliche Level-0-/2-Repositories gesamt	94	94	93	0	52	0	0	42	60,1×
	Private GitHub-Repositories gesamt	24	24	0	0	0	24	0	0	59,7× (35/112 Repos)
	Alle erfassten Repositories gesamt	118	118	93	0	52	24	0	42	59,9× (45/122 Repos)

Ausführungsarten teilen ausschließlich Ausgeführt auf. Private ungeprüfte Kandidaten: 0; nicht mitgezählt.

Repo-Schätzung gegenüber 80 Textzeilen/Arbeitstag; × bedeutet Faktor. Gesamter Textbestand und Git-Aktivtage, einschließlich importierter Inhalte und Repos ohne Spec-Kit-Läufe; keine gemessene KI-Zeitersparnis. Summen sind nach Repo-Aktivtagen gewichtet; bei Lücken zeigt N/M die Abdeckung. Statistik-Quellstände öffentlich: 2026-09-26 bis 2026-10-06; privat: 2026-09-26 bis 2026-10-04. Vorhandene Werte behalten ihren Quellstand; Berechnungsbelege und Lücken.

Sicher starten

Arbeite für Änderungen, Commits, Pull Requests und Pushes immer im dauerhaften Checkout ~/home-baseline-source. Das Home-Verzeichnis ~/ enthält nur die ausgewählte Home Runtime, also betriebliche Kopien und maschinenlokalen Zustand. Es ist keine zweite Level-0-Quelle.

Vor einem schreibenden Wartungslauf zuerst die Vorschau verwenden:

# macOS oder Linux: prüft und zeigt geplante Änderungen
bash scripts/maintain-agentic-workspace.sh --dry-run

# Windows mit PowerShell 7: prüft und zeigt geplante Änderungen
pwsh -NoProfile -File scripts/maintain-agentic-workspace.ps1 -WhatIf

Die Vorschau kann sichere Remote-Abfragen ausführen, verändert aber keine Arbeitsdateien. Prüfe das textorientierte Ergebnis und die genannte nächste Aktion, bevor du einen echten Lauf autorisierst.

Copilot-Review-Governance sicher voranzeigen

Der geschlossene Acht-Ziel-Vertrag kann lokal mit Fixture-Evidence geprüft werden. Dieser Einstieg schreibt weder zum Provider noch zu Git oder Home:

bash scripts/manage-copilot-review-governance.sh --action preview --dry-run \
  --desired-state scripts/config/copilot-review-governance-desired-state.json \
  --inventory scripts/tests/copilot-review-governance/fixtures/vertical-slice/home-baseline-green.json \
  --output .specify/runtime/copilot-review-governance-preview.json

Details: Quickstart, Manpage und Betriebsführung.

Wähle deinen Leserpfad

Du möchtest ...	Einstieg	Nächste Aktion
lernen oder neu beginnen	Lernpfad	Beruf, Lehrjahr und erste Unit auswählen
den Workspace täglich pflegen	Wartung	Plattform wählen und Vorschau ausführen
als Maintainer oder KI-Agent arbeiten	Source und Home Runtime	kanonischen Änderungsort und Sync-Bedarf bestimmen
prüfen oder Fehler analysieren	Prüfung und Fehleranalyse	Head, Evidence und Proof-Grenze feststellen

Der ausführliche Effizienzleitfaden verbindet diese vier Leserpfade mit sicheren Befehlen, Evidence und klaren Stop-Grenzen.

Lokales Modell-Routing für KI-Agenten

Modell-Routing bedeutet: Eine stabile Arbeitsrolle wie frontier-reasoning oder fast-mechanical wird auf ein Modell abgebildet, das das lokal installierte Agentenprogramm tatsächlich anbietet. Fachliche Spec-Kit-Artefakte nennen deshalb Rollen, keine vergänglichen Modellnamen.

Das optionale Preset model-routing-governance auf Priorität 61 erkennt lokale Harness-Fähigkeiten, zum Beispiel über Codex oder Antigravity. Es veröffentlicht keine Modellliste und übernimmt keine Zugangsdaten. Die konkrete Auswahl bleibt als machineLocal-Konfiguration auf dem jeweiligen Rechner. Unbekannte oder mehrdeutige Zuordnungen werden blockiert und niemals geraten.

# Nur lesen: installierte Harness-Fähigkeiten und lokale Bindung prüfen
bash scripts/resolve-model-routing.sh -Action Status -Harness Codex \
  -RoutingRoot .specify/presets

# Ausdrücklich lokal aktualisieren; keine Repository-Datei wird geändert
pwsh -NoProfile -File scripts/resolve-model-routing.ps1 `
  -Action Refresh -Harness Codex -RoutingRoot .specify/presets

Der Ein-Kommando-Wartungslauf führt nach der Toolchain-Prüfung nur den read-only Status aus. Ein Refresh braucht eine aktuelle lokale Autorisierung. Autonome Presets dürfen Modelle ausschließlich an validierten Phasengrenzen in einem neuen Prozess wechseln. Delivery- und Provider-Rechte entstehen dadurch nicht.

Danach folgt die neue Storage-Stufe: Safe inventarisiert und bereinigt verifizierte Level-2-Buildausgaben und ausgewählte Caches; bei weniger als 15 Prozent freiem Speicher greift Pressure Mode. Deep benötigt für einen echten Lauf eine eigene Bestätigung, scripts-only verwendet None. Kuratierte Non-MSL-Adapter schützen die Begründungen und Build-Evidence von cc65 und tvision; Container-Volumes bleiben immer unberührt. Details stehen im Wartungsportal.

Das vollständige Dokumentationsportal ordnet alle Themen und kanonischen Quellen ein. Die Skriptreferenz listet die verfügbaren Befehle, Plattformen und sicheren Prüfmodi.

CI-Budget-Governance sicher voranzeigen

Der lokale CI-Gate (eine profilgebundene Prüfentscheidung) zeigt Profil, ausgewählte Prüfungen, Blocker, Gate-Set-Hash und das spätere Evidence-Ziel an, ohne eine Evidence-Datei oder ein Repository zu ändern:

bash scripts/maintain-agentic-workspace.sh --ci-gate --dry-run

pwsh -NoProfile -File scripts/maintain-agentic-workspace.ps1 -CiGate -WhatIf

Fehler enden fail-closed mit einer nächsten Aktion. Aktionen-Minuten und Copilot-Review-Verbrauch bleiben getrennte Kostenkategorien. Die vollständige Bedienung, Evidence-Prüfung, Exitcodes und Stufe-A-Grenze stehen in der Skriptreferenz.

Preview is read-only. A real local gate may write only machine-local success evidence after stable HEAD and hash checks; it never means remote convergence.

Stage-B-Flottenrollout sicher voranzeigen

Stage B verteilt die akzeptierte CI-Budget-Governance seriell über die autorisierte Flotte. Die erste Aktion bleibt schreibfrei:

bash scripts/maintain-agentic-workspace.sh --stage-b-action preflight --dry-run

pwsh -NoProfile -File scripts/maintain-agentic-workspace.ps1 -StageBAction Preflight -WhatIf

Ein realer Deliver- oder Resume-Lauf benötigt aktuelle MergeAndSync- Autorität und stoppt vor dem nächsten Repository, sobald ein nicht behebbarer Fehler auftritt. Quickstart und Manpage erklären Evidence, Exitcodes, Review/Bypass-Grenze und die getrennte G4-Folge.

Stage B rolls out the accepted governance serially. Preview is read-only; real delivery or resume requires current MergeAndSync authority and stops before the next repository on a non-recoverable failure.

Voraussetzungen

• Git und ein persönliches oder institutionelles Git-Repository;
• auf Windows PowerShell 7, auf macOS/Linux Bash;
• gh für GitHub oder glab für GitLab nur dann, wenn du diese Plattform nutzt;
• Python 3 und pwsh für die vollständigen Governance-Prüfungen;
• für agentische Arbeit an Secure-Trader-Systemen eine freigegebene Sandbox.

Die ausführliche Installation steht unter Erste Schritte. GitHub ist ein mögliches Profil, aber keine allgemeine Voraussetzung für Lernende.

Sicherheits- und Zugänglichkeitsgrenzen

• Programmierung #include<everyone> gilt für Dokumentation, CLI und UI.
• Nutzerseitige Inhalte folgen Deutsch zuerst, Englisch danach, CEFR B2 und anwendbaren Kriterien der WCAG 2.2 AA.
• Geheimnisse, produktive Daten und persönliche absolute Pfade gehören nicht in Commits oder veröffentlichbare Evidence.
• Agentische Arbeit an Secure-Trader-Systemen läuft container-first in einer freigegebenen Sandbox.
• Wartungsskripte committen, pushen oder mergen nicht selbst in Ziel-Repositories.
• Remote- oder Adminrechte entstehen nur durch eine aktuelle ausdrückliche Autorisierung.

Siehe Sicherheitsdokumentation, A11Y für die Wartungs-TUI und Dokumentations-Governance.

Source, Runtime und lokaler Zustand

Die drei Distributionsklassen verhindern, dass Quelle, betriebliche Kopie und private Maschinendaten verwechselt werden:

• homeRuntime: wird kanonisch in Level 0 geändert und anschließend manifestgesteuert nach ~/ synchronisiert;
• sourceOnly: wird direkt aus ~/home-baseline-source gelesen und benötigt keinen Home-Sync;
• machineLocal: bleibt ausschließlich auf der Maschine und erhält keine implizite Remote-Autorität.

Die vollständige Erklärung mit Ownern, Sync-Triggern und Container-Grenze steht unter Source und Home Runtime. Konkrete Runtime-Mitglieder werden aus scripts/config/home-sync-manifest.json abgeleitet.

In der ABS-DD-Sandbox bleibt der allgemeine schreibende Home-Sync gesperrt. Der explizite Runtime-only-Modus verteilt nur homeRuntime nach /home/adedev und überspringt Pull, Commit, Git-Konfiguration und Git-Identität:

bash ~/home-baseline-source/scripts/sync-home.sh --runtime-only

Inside the ABS-DD sandbox, general writing Home sync remains blocked. The explicit runtime-only mode distributes only homeRuntime into /home/adedev and skips pull, commit, Git configuration, and Git identity.

Änderungen beitragen

1. AGENTS.md und die Constitution lesen.
2. Auf einem aktuellen codex/- oder nummerierten Feature-Branch arbeiten.
3. Vor Änderungen den sicheren Prüfmodus des betroffenen Skripts verwenden.
4. Genau eine Documentation-Impact-Entscheidung dokumentieren.
5. Betroffene Tests, Links, Sprachpartner, A11Y- und Sicherheitsprüfungen ausführen.
6. Pull Request gegen den kanonischen Default-Branch erstellen.

Weitere Einzelheiten stehen im Maintainer- und Agentenpfad und in den Repository Guidelines.

Diagramme und Ergebnisberichte / Diagrams and outcome reports

Mermaid- und Abschlussbericht-Regeln führen vom neuen Lastenheft zum belegten Feature-Ergebnisbericht. / The linked rules explain accessible intake diagrams and evidence-based feature reports.

Statistik-Pilot / Statistics pilot: Installationsstand und Grenzen. Statistik-Rollout / Statistics rollout: Abschluss der sechs Level-2-Repositories.