This is the top-level workspace bootstrap for ~/.
It tracks only safe infrastructure files via a whitelist .gitignore and distributes reusable scripts to child workspaces.
home-baseline manages workspace initialisation: it provides scripts that turn a plain directory into a private GitHub or GitLab repo with .gitignore, standard scripts, and a pre-push secret-scanning hook installed. It does not contain application source code.
IMPORTANT: Always work in ~/home-baseline-source — this is the git clone with the GitHub remote. ~/ is a local copy only (no remote) and changes there cannot be pushed.
cd ~/home-baseline-source # ← start Copilot CLI here
copilot
# → make changes, commit, push
# After runtime-distribution changes: sync to ~/
bash ~/scripts/sync-home.sh --no-pull # macOS/Linux
pwsh ~/scripts/sync-home.ps1 -NoPull # Windows| Directory | Git-Remote | Purpose |
|---|---|---|
~/home-baseline-source |
✅ origin → GitHub |
Development, commits, push |
~/ |
❌ no remote | Local copy for scripts & hooks |
Der persönliche Fork unter ~/home-baseline-source bleibt dauerhaft als
versionierte Level-0-Quelle erhalten. sync-home.* verteilt nur
homeRuntime: Skripte, gemeinsame Agent-Guidance und ausgewaehlte
Spec-Kit-Oberflaechen. Dokumentation, Specs, Preset-Quellen und Evidence werden
direkt im Klon gelesen; STATS.md und private Agentenzustaende bleiben lokal.
Nach reinen Source-only-Aenderungen ist kein Home-Sync erforderlich. Vor echten
Laeufen --check-only / -CheckOnly verwenden; --force / -Force nur nach
Pruefung der Konflikte. In der ABS-DD-Sandbox die eingebundene Referenz direkt
verwenden; der allgemeine schreibende Home-Sync bleibt gesperrt. Nur ein
ausdruecklich angeforderter --runtime-only-/-RuntimeOnly-Lauf darf
manifestgebundene homeRuntime in die Container-Betriebskopie verteilen, ohne
Pull, Commit, Git-Konfigurations- oder Identitaetsaenderung.
Keep the personal fork at ~/home-baseline-source permanently as the versioned
Level 0 source. sync-home.* distributes only homeRuntime: scripts, shared
agent guidance, and selected Spec Kit surfaces. Read documentation, specs,
preset sources, and evidence directly from the clone; STATS.md and private
agent state remain local. Source-only changes do not require Home sync. Use
--check-only / -CheckOnly before a real run and review conflicts before
using force. General writing Home sync remains host-only; only an explicitly
requested runtime-only run may distribute manifest-bound homeRuntime inside
the container without pull, commit, Git configuration, or identity changes.
Für GitHub-Repositories zuerst die authentifizierte gh CLI für mögliche Schreibaktionen und Live-Repository-Operationen verwenden, einschließlich PR-/Issue-Kommentaren, PR-Statusprüfungen, Review-Follow-up, Workflow-Prüfung und Merge-/Statusabfragen. GitHub-Connector-Tools hauptsächlich für strukturierte Read-only-Inspektion oder Fälle nutzen, in denen die CLI nicht geeignet ist.
Für GitLab-Repositories die authentifizierte glab CLI zuerst für gleichwertige Aktionen verwenden. Bekanntermaßen fehlschlagende Connector-Schreibwege nicht wiederholt versuchen, wenn gh/glab die Aufgabe direkt erledigen kann.
For GitHub repositories, use the authenticated gh CLI first for feasible write actions and live repository operations, including PR/issue comments, PR status checks, review follow-up, workflow inspection, and merge/status queries. Use GitHub connector tools mainly for structured read-only inspection or when the CLI is not suitable.
For GitLab repositories, use the authenticated glab CLI first for equivalent actions. Do not repeatedly try connector write paths that are known to fail when gh/glab can perform the task directly.
- Die vollstaendige Skriptinventur steht unter
docs/scripts/; neue Skripte muessen genau einer Kategorie inscripts/config/script-catalog.jsonzugeordnet sein. - Vor einem schreibenden Skriptlauf Hilfe und vorhandenen Check-, Dry-Run- oder WhatIf-Modus verwenden.
- Die Level-0-Quelle wird ueber den gemeinsamen Resolver ermittelt; neue Automationen duerfen den absoluten Pfad nicht fest eincodieren.
The complete script inventory lives under docs/scripts/. New scripts must
match exactly one catalog category. Read help and use a check or preview mode
before writing. Resolve Level 0 through the shared contract rather than a
hard-coded absolute path.
Jede technische oder fachliche Änderung erhält genau eine Entscheidung:
UpdateRequired, NoUpdateRequired, GeneratedUpdate oder FollowUp.
Quelle, Owner, betroffene Dokumente und Evidence richten sich nach
docs/documentation-governance.md. GeneratedUpdate ändert die kanonische
Quelle und führt den Renderer aus. FollowUp benötigt Owner, Risiko, Frist,
Wiedervorlage, Evidence und Scope-Grund; Sicherheits-, Bedienungs- oder
Breaking-Change-Dokumentation zusätzlich akzeptierte Risikoevidence.
Erfasse außerdem Zielgruppen und Leserpfade, kanonische Quelle und Owner,
Navigation, Dokumentklasse, Sprachpartner, Plattform-/Beispielnachweis,
Distributionsklasse, Home-Sync-Bedarf und Re-Evaluation. Große Einstiegsseiten
verwenden Progressive Disclosure und bei Bedarf synchron gepflegte .en.md-
Sprachpartner.
Every technical or professional change records exactly one Documentation
Impact decision. Follow the source, ownership, generated-output, and evidence
contract in docs/documentation-governance.md; deterministic validation does
not replace semantic review. Also record reader paths, navigation, language
partners, distribution class, Home-sync need, and reevaluation.
Lernenden-Dokumentation darf kein GitHub-Konto pauschal voraussetzen. origin
ist der persoenliche Fork beziehungsweise das persoenliche Lernenden-Repository,
upstream die institutionell gepflegte Referenz. GitHub ist ein Profil neben
GitLab, Codeberg, Forgejo und anderen Git-faehigen Systemen. Ein GitHub-Konto
darf nur fuer den direkten GitHub-Pfad oder die optionale Copilot-Anmeldung
verlangt werden. Maintainer-Remotes und Produktnamen bleiben unberuehrt.
Learner documentation must not assume a GitHub account universally. origin
is the personal fork or learner repository and upstream is the
institution-maintained reference. GitHub is one profile alongside GitLab,
Codeberg, Forgejo, and other Git-capable systems. A GitHub account may only be
required for the direct GitHub route or optional Copilot sign-in. Maintainer
remotes and product names remain unaffected.
Neue Lernreihen fuer Fachinformatiker*innen und weitere IT-Ausbildungsberufe werden zuerst in docs/learning-units/ als Level-0-Quelle vorbereitet. Der Lernreihen-Blueprint, das Lernreihen-Register, das IT-Berufe-Mapping und die Vorlagen unter docs/learning-units/templates/ sind verbindlich, bevor eine konkrete Level-1-/Level-2-Struktur gespiegelt wird. KI-Agenten duerfen Lernreihen, Lastenhefte, Berufsbild-Mappings, Reihenfolgen und ZIP-Paketierung vorbereiten, starten aber keine Spec-Kit-Laeufe fuer Lernende ohne ausdruecklichen Auftrag. Spec-Kit-Laeufe sind begleitende SDD-Aufgaben und ersetzen nicht Berufsschule, betriebliche Ausbildung, Rahmenlehrplan, Ausbilderentscheidung oder Pruefungsvorbereitung.
New learning series for IT specialist apprentices and additional IT training occupations are prepared first in docs/learning-units/ as the level-0 source. The Learning Series Blueprint, Learning Series Register, IT occupation mapping, and templates under docs/learning-units/templates/ are binding before a concrete level-1/level-2 structure is mirrored. AI agents may prepare learning series, intake files, occupation mappings, ordering, and ZIP packaging, but must not start learner Spec Kit runs without an explicit instruction. Spec Kit runs are companion SDD tasks and do not replace vocational school, workplace training, the curriculum, instructor decisions, or exam preparation.
Jeder KI-Agenten-Aufruf fuer Arbeit an einem Secure-Trader-System (Secure OrderDesk, Secure ServiceHarvester, Secure CaseTracker) erfolgt in einer freigegebenen Sandbox bzw. einem Container (Referenz: absdd-image-sandbox), nie direkt auf dem Arbeitsplatz-Rechner der Auszubildenden, auf gemeinsam genutzten Servern oder in produktionsnahen Umgebungen. In den Lernreihen ist diese Regel ein Gate ab dem 1. Lehrjahr (Unit 00) und gilt, bevor der erste Agent gestartet wird. Nur agentenlose Taetigkeit (Lesen, Review, allgemeine Entwicklung) darf ausserhalb der Sandbox erfolgen. In ISO/IEC-27001-zertifizierten (oder gleichwertigen) Organisationen ist dies ein pruefbarer Kontrollpunkt (u. a. A.5.23, A.8.25, A.8.28, A.8.31). Verbindliche Grundlagen: docs/learning-units/Secure-Trader-Sandbox-Preflight.md, docs/secure-development/mitgeltende-dokumente/Leitlinie_Sichere-Entwicklungs-Sandbox.md und docs/secure-development/checklisten/CL_12_Agentische-KI-Sandbox.md.
Every AI-agent invocation for work on a Secure Trader system (Secure OrderDesk, Secure ServiceHarvester, Secure CaseTracker) runs in an approved sandbox/container (reference: absdd-image-sandbox), never directly on the apprentice's workstation, on shared servers, or in production-near environments. In the learning series this rule is a gate from year 1 (unit 00) and applies before the first agent is started. Only agent-free work (reading, review, general development) may happen outside the sandbox. In ISO/IEC 27001-certified (or equivalent) organizations this is an auditable control point (e.g. A.5.23, A.8.25, A.8.28, A.8.31). Authoritative basis: docs/learning-units/Secure-Trader-Sandbox-Preflight.md, docs/secure-development/mitgeltende-dokumente/Leitlinie_Sichere-Entwicklungs-Sandbox.md, and docs/secure-development/checklisten/CL_12_Agentische-KI-Sandbox.md.
There is no build step. Validate changes by running scripts directly.
# Bash (macOS / Linux)
bash scripts/bootstrap-workspace.sh --dry-run FlutterProjects # preview, no writes
bash scripts/install-hooks.sh
bash scripts/setup-git-identity.sh --check-only # check for placeholder identity
bash scripts/setup-git-identity.sh # set git identity interactively
bash scripts/scan-agent-secrets.sh --fail-on-high .
bash scripts/audit-agent-changes.sh snapshot
bash scripts/audit-agent-changes.sh report
bash scripts/update-spec-kit.sh --dry-run
# PowerShell 7+ (Windows)
pwsh scripts/bootstrap-workspace.ps1 -WorkspaceName FlutterProjects -WhatIf
pwsh scripts/install-hooks.ps1 -Verbose
pwsh -NoProfile scripts/setup-git-identity.ps1 -CheckOnly # check for placeholder identity
pwsh -NoProfile scripts/setup-git-identity.ps1 # set git identity interactively
pwsh scripts/scan-agent-secrets.ps1 -FailOnHigh
pwsh -NoProfile scripts/audit-agent-changes.ps1 -Action snapshot
pwsh -NoProfile scripts/audit-agent-changes.ps1 -Action report
pwsh -NoProfile scripts/update-spec-kit.ps1 -WhatIfAlways use --dry-run / -WhatIf before changing bootstrap logic. Reinstall hooks after editing anything under scripts/hooks/.
Plattformübergreifende Testausgabe (macOS / Linux / Windows) / Cross-Platform Test Output (macOS / Linux / Windows)
When terminal output cannot be copy-pasted between machines, use the matching platform test script:
# On the Mac — collects info, commits and pushes results automatically:
bash ~/home-baseline-source/scripts/mac-test.sh
# On Linux / WSL:
bash ~/home-baseline-source/scripts/linux-test.sh# On Windows:
pwsh ~/home-baseline-source/scripts/windows-test.ps1Results land in mac-test-output.txt, linux-test-output.txt, or windows-test-output.txt in the repo. Read from Windows:
git -C "$HOME\home-baseline-source" pull
Get-Content "$HOME\home-baseline-source\windows-test-output.txt" # oder mac-test-output.txt, linux-test-output.txtAt the start of each session, detect the OS and call the matching script variant:
| OS | Shell | Extension | Detection |
|---|---|---|---|
| Windows | pwsh (PowerShell 7+) |
.ps1 |
$IsWindows / $env:OS -eq 'Windows_NT' |
| macOS | bash |
.sh |
$IsMacOS / uname -s → Darwin |
| Linux | bash |
.sh |
$IsLinux / uname -s → Linux |
Rule: On Windows always call pwsh scripts/xyz.ps1. On macOS/Linux always call bash scripts/xyz.sh. Both variants are functionally equivalent — never mix them. Validate changes by running the variant that matches the current OS.
Skriptsprachenwahl / Script language choice: Nach der OS-Erkennung vorhandene PowerShell-7-Skripte oder Cmdlets bevorzugen, wenn sie die Aufgabe loesen und pwsh verfuegbar ist. Fuer strukturierte lokale Automationen ist C# ueber .NET oder mono ein zulaessiger zweiter Weg, wenn Typisierung, Dateiformate oder Wiederverwendbarkeit davon profitieren. Erst wenn PowerShell oder C# nicht sinnvoll passen, die OS-nahe vorhandene Repo-Variante nutzen, auf macOS/Linux typischerweise Bash. Keine neue Sprache nur aus Bequemlichkeit einfuehren, wenn ein bestehendes Repo-Skript denselben Zweck erfuellt.
- Maintain
docs/project-statistics.mdas the living statistics ledger for this repository. - Update it after each completed feature/Lastenheft, each completed Spec-Kit phase, or when explicitly requested.
- Keep
## Fortschreibungsprotokollchronological: oldest entry first, newest entry last. - Keep
## Gesamtstatistikas the final top-level section. - Treat
docs/project-statistics.config.jsonand the marked Profile 2 block as the binding contract; update it withrender-project-statistics.*. - Profile 2 includes KPIs, artifact mix, 52-week daily activity, weekly and cumulative volume, phase or monthly volume, speedup gauges, and the experienced/Thorsten-Solo/AI-visible comparison.
- Use ASCII only: heatmap digits
0..4,-for days not elapsed, and#/.gauges. Do not use Unicode blocks, color-only signals, or\ | /as intensity levels. - Keep phase slots stable and split series into blocks of 16. Without reliable phase data, show monthly volume and do not invent phases.
- Keep charts at 100 characters or fewer and provide exact values plus a CEFR-B2 text alternative in German first and English second.
- Methodology v2 uses Git-tracked text and gross changes from non-merge commits while excluding the ledger,
STATS.md, and binaries. - Manual references for this repository are
80lines/workday (conservative) and100lines/workday (Thorsten-Solo, scripting infrastructure). - Default C#/.NET Thorsten-Solo baseline is
125lines/workday unless the repository documents a justified deviation. - Shared guidance and statistics-method changes must update all five shared agent surfaces, including
.github/agents/copilot-instructions.md, together in the same change.
Programmierung #include<everyone>is binding shared guidance across the workspace family.- All user-facing artefacts must be reviewed for inclusive use: CLI output, documentation, HTML, UI, and generated templates.
- Treat WCAG 2.2 Level AA as the default accessibility baseline wherever the criteria apply.
- Keep text-first usability visible for keyboard-only use, screen readers, Braille displays, and text browsers.
- Review new or changed non-trivial logic for didactic inline-comment need: comments explain why, trade-off, boundary condition, historical deviation, or proof limit, not obvious code behavior.
- Shared guidance and learner-facing documentation follow DE first, EN second; for large normative documents, a synchronised
.EN.mdcompanion file is acceptable. - Do not update only this file when a shared rule changes; keep
AGENTS.md,CLAUDE.md,GEMINI.md, and.github/copilot-instructions.mdaligned and document any intentional deviation in the same change.
Bei Sync- oder Bootstrap-Skripten, die ihr eigenes Verzeichnis kopieren oder ersetzen, vor echten Läufen immer Syntaxcheck und Vorschau verwenden: bash -n, --dry-run und -WhatIf. Echte Läufe aus einer stabilen Repo-Kopie wie ~/home-baseline-source/scripts/ starten oder sicherstellen, dass das Skript dorthin delegiert.
For sync or bootstrap scripts that copy or replace their own directory, always use syntax checks and previews before real runs: bash -n, --dry-run, and -WhatIf. Start real runs from a stable repository copy such as ~/home-baseline-source/scripts/, or ensure the script delegates there.
Bei erzeugten oder schnell angepassten PowerShell-Skripten Variablen in Strings vor angrenzender Interpunktion immer mit ${Name} abgrenzen, z. B. ${Path}:. So entstehen keine fehlerhaften Bereichsvariablen wie $Path:.
In generated or quickly adapted PowerShell scripts, always delimit variables before adjacent punctuation with ${Name}, for example ${Path}:. This avoids invalid scoped-variable parsing such as $Path:.
Bei Workspace-/Repo-Migrationen eine vorhandene oder remote neuere README.md nicht stillschweigend überschreiben. Wenn die Remote-README kanonisch ist oder ausdrücklich erhalten bleiben soll, vor dem Push fetch/Rebase ausführen und README.md aus origin/main bewahren oder wiederherstellen.
During workspace/repository migrations, do not silently overwrite an existing or newer remote README.md. If the remote README is canonical or must be preserved, fetch/rebase before pushing and preserve or restore README.md from origin/main.
- Die zentrale
constitution.mdenthält das verbindliche Level-2 Project Environment Registry. - Spec-Kit-Pläne und Copilot-Arbeit in Level-2-Projekten müssen die passende Registry-Zeile als verbindlichen Kontext für Runtime, Build/Test, A11Y, Statistik und Agentenflächen verwenden.
- Änderungen an einer Level-2-Runtime, Toolchain oder Statistik-Basis müssen
constitution.md,.specify/memory/constitution.mdund betroffene KI-Agenten-Dateien gemeinsam prüfen.
The central constitution.md contains the binding Level-2 Project Environment Registry. Spec-Kit plans and Copilot work in Level-2 projects must use the matching registry row as binding context for runtime, build/test, A11Y, statistics, and agent surfaces. Changes to Level-2 runtime, toolchain, or statistics baselines require a joint review of constitution.md, .specify/memory/constitution.md, and affected AI-agent files.
- Level-2-Projekte SOLLEN eine speichersichere Sprache (Memory-Safe Language, MSL) als primäre Laufzeit verwenden, wenn die Zielplattform es erlaubt.
- Verbindliche MSL-Erlaubnisliste, Regeln und Begründungspflicht: siehe
constitution.md, Prinzip XI. - MSL-Kurzliste: Rust, Swift, C#, F#, Java, Kotlin, Scala, Go, Dart, Python, Ruby, JavaScript, TypeScript, Haskell, OCaml, Erlang, Elixir, Ada, SPARK.
- Nicht MSL (Begründung im Level-2-
constitution.mderforderlich): C, C++, klassisches Objective-C, Assembly,cc65-C89, Zig (pre-1.0), Nim (manual), D ohne GC. - In Nicht-MSL-Repositories (z. B.
C64Projects/cc65) die im Level-2-constitution.mdhinterlegte Begründung im Plan- und Task-Kontext erwähnen. speckit.constitutionundspeckit.specifySOLLEN bei Nicht-MSL-Primärsprache einen nicht blockierenden Hinweis ausgeben (Tooling-Aufgabe, separate Umsetzung).- Änderungen an dieser Empfehlung erfordern ein gemeinsames Update in
constitution.md,.specify/memory/constitution.md,AGENTS.md,CLAUDE.md,GEMINI.mdund.github/copilot-instructions.md.
Level-2 projects SHOULD use a memory-safe language (MSL) as their primary runtime when the target platform allows. Authoritative rules: constitution.md, Principle XI. MSL short list: Rust, Swift, C#/F#, Java/Kotlin/Scala, Go, Dart, Python, Ruby, JavaScript/TypeScript, Haskell, OCaml, Erlang/Elixir, Ada/SPARK. Non-MSL languages (C, C++, Assembly, cc65, Zig pre-1.0, …) require a documented justification in the Level-2 constitution.md. In non-MSL repositories (e.g. C64Projects/cc65), surface the documented justification in plans and tasks. speckit.constitution and speckit.specify SHOULD emit a non-blocking advisory warning when the primary language is not an MSL — tracked as a separate tooling task. Changes to this recommendation require a joint update across constitution.md, .specify/memory/constitution.md, and all four agent guidance files.
- KI-generierter und menschlich geschriebener Code MUSS den etablierten Secure-Coding-Best-Practices der Zielsprache und des Frameworks folgen. LLMs erzeugen nicht zuverlässig sicheren Code; explizite Durchsetzung ist erforderlich.
- Verbindliche Regeln und sprachspezifische Anforderungen: siehe
constitution.md, Prinzip XII. - Sprachspezifische Kurzregeln (Detailprofil:
.specify/templates/secure-coding-language-rules-template.md):- C / C89: Bounds-Checking, kein
gets(), kein ungeprueftessprintf()/strcpy(), CERT C. - C# / .NET: parametrisierte Queries, Output-Encoding gegen XSS, Anti-Forgery-Tokens, sichere Deserialisierung, Microsoft Secure Coding Guidelines.
- Rust:
unsafeisolieren und begruenden, keine Panic-Pfade aus nicht vertrauenswuerdigem Input, Deserialisierung validieren,cargo auditoder gleichwertig verwenden. - Go: HTTP-/Client-Timeouts setzen,
contextpropagieren, SSRF pruefen,crypto/randnutzen,govulncheckoder gleichwertig verwenden. - Swift: keine Force-Unwraps auf nicht vertrauenswuerdigen Daten, dekodierte Eingaben validieren, Keychain/CryptoKit/TLS-Defaults nutzen, Datei-URLs einschraenken.
- Java / Kotlin: DTOs validieren, Persistence-Zugriffe parametrisieren, Deserialisierung beschraenken, Auth/CSRF/CORS/Session-Defaults pruefen.
- Python: Boundary-Input validieren, keine unsichere Deserialisierung oder dynamische Ausfuehrung,
subprocess/Dateipfade einschraenken, Dependency-Audit nutzen. - TypeScript / JavaScript: Runtime-Input validieren, XSS/Prototype-Pollution/SSRF pruefen, keine dynamische Code-Ausfuehrung, Lockfiles auditieren.
- SQL: nur parametrisierte Statements, kein dynamisches SQL aus nicht vertrauenswuerdigem Input.
- Bash: Variable in Anfuehrungszeichen (
"$var"), keinevalauf nicht vertrauenswuerdigem Input,--End-of-Options. - PowerShell:
Set-StrictMode -Version Latest, validierte Parameter, keinInvoke-Expressionauf nicht vertrauenswuerdigem Input.
- C / C89: Bounds-Checking, kein
- Kryptografie: aktuelle Algorithmen (AES-256, RSA >= 3072, SHA-256+, Ed25519); veraltete (MD5, SHA-1 für Signaturen, DES, RC4) nur mit expliziter Risikobegründung.
- Fehlerbehandlung darf keine internen Zustände, Stack-Traces oder Verbindungszeichenketten an Endbenutzer preisgeben.
- Hinzugefügte Abhängigkeiten müssen aktiv gepflegt sein und dürfen keine bekannten kritischen CVEs aufweisen.
- Code-Reviews MÜSSEN eine Sicherheitsperspektive für Eingabeverarbeitung, Authentifizierung, Autorisierung, Kryptografie und Datei-/Netzwerk-I/O enthalten.
- Änderungen an dieser Regel erfordern ein gemeinsames Update in
constitution.md,.specify/memory/constitution.md,AGENTS.md,CLAUDE.md,GEMINI.mdund.github/copilot-instructions.md.
AI-generated and human-written code MUST follow the secure-coding best practices of the target language and framework. Authoritative rules: constitution.md, Principle XII, and .specify/templates/secure-coding-language-rules-template.md. Language-specific short rules cover C/C89, C#/.NET, Rust, Go, Swift, Java/Kotlin, Python, TypeScript/JavaScript, SQL, Bash, and PowerShell. MSL status does not replace secure API, I/O, auth, SQL, crypto, logging, or dependency review. Cryptography: use current algorithms (AES-256, SHA-256+, Ed25519); deprecated (MD5, SHA-1 for signatures, DES, RC4) only with explicit risk acknowledgement. Error handling must not expose internals. Dependencies must have no known critical CVEs. Code reviews must include a security perspective for input handling, auth, crypto, and I/O. Changes require a joint update across constitution.md, .specify/memory/constitution.md, and all four agent guidance files.
- KI-generierte und menschlich geschriebene Software-Architektur MUSS etablierten sicheren Architekturprinzipien folgen. Sicherer Code (Prinzip XII) ohne sichere Architektur reicht nicht aus — beide Ebenen müssen zusammenwirken.
- Verbindliche Regeln und sprachspezifische Architekturvorgaben: siehe
constitution.md, Prinzip XIII. - Verbindliche Architekturprinzipien:
- Trust Boundaries: Explizite Vertrauensgrenzen definieren; alle Eingaben an Vertrauensgrenzen validieren und bereinigen.
- Defense in Depth: Mindestens zwei unabhängige Sicherheitsschichten für kritische Assets.
- Least Privilege: Jede Komponente, jeder Dienst und Prozess arbeitet mit minimalen Berechtigungen.
- Fail-Safe Defaults: Zugriff standardmäßig verweigern, explizit gewähren; Fehlerpfade fallen in sicheren Zustand zurück.
- Angriffsfläche reduzieren: Ungenutzte Endpunkte, Dienste und Debug-Funktionen deaktivieren oder entfernen.
- Separation of Concerns: Authentifizierung, Autorisierung, Logging und Eingabevalidierung als Cross-Cutting Concerns implementieren, nicht ad-hoc verstreuen.
- Sichere Konfiguration: Secrets in plattformgeeigneten Secret-Stores (z. B. Azure Key Vault, macOS Keychain), nie im Quellcode oder in Git-tracked Config-Dateien.
- Supply-Chain-Sicherheit: Abhängigkeiten aus verifizierten Registries; Lock-Files committen; verwundbare Abhängigkeiten vor Release ersetzen.
- Änderungen an dieser Regel erfordern ein gemeinsames Update in
constitution.md,.specify/memory/constitution.md,AGENTS.md,CLAUDE.md,GEMINI.mdund.github/copilot-instructions.md.
AI-generated and human-written software architecture MUST follow secure-architecture principles. Authoritative rules: constitution.md, Principle XIII. Core principles: trust boundaries (validate all input at system boundaries), defense in depth (at least two independent security layers), least privilege (minimum required permissions), fail-safe defaults (deny by default), attack surface reduction (disable unused features), separation of concerns (auth/logging/validation as cross-cutting concerns), secure configuration (secrets in secret stores, never in code or Git), supply-chain security (verified registries, lock files, no known-vulnerable dependencies). Principles XII + XIII together form the complete secure-development approach: XII = tactical code-level security, XIII = strategic architecture-level security. Changes require a joint update across constitution.md, .specify/memory/constitution.md, and all four agent guidance files.
- Jedes Level-2-Projekt MUSS die folgenden Sicherheitsdokumente pflegen, basierend auf den Templates in
.specify/templates/:- Bedrohungsmodell / Threat Model (
threat-model-template.md) — STRIDE-Methodik, Trust Boundaries, Risikobewertung, CAPEC-Referenzen (Prinzip XIII + XVII) - Security Architecture Decision Records (S-ADR) (
adr-template.md) — architektonische Sicherheitsentscheidungen mit Compliance-Nachweis (Prinzip XIII) - arc42 Section 8 Sicherheits-Querschnittskonzepte (
arc42-security-template.md) — Authentifizierung, Autorisierung, Verschlüsselung, Eingabevalidierung, Fehlerbehandlung, Logging, Abhängigkeiten, Deployment (Prinzip XIII) - Sicherheits-Checkliste / Security Checklist (
security-checklist-template.md) — sprachspezifische Code-Review-Checkliste (Prinzip XII) - Abhängigkeits-Audit / Dependency Audit (
dependency-audit-template.md) — CVE-Tracking, Lizenz-Compliance, Supply-Chain-Sicherheit (Prinzip XII) - Sicherheits-Qualitätsszenarien / Security Quality Scenarios (
security-quality-scenarios-template.md) — iSAQB CPSA-F Qualitätsszenario-Methodik (Prinzip XII + XIII, SHOULD) - ASVS-Verifikation / ASVS Verification (
asvs-verification-template.md) — OWASP ASVS Level, Scope und Evidenz (Prinzip XV, Web-/API-Projekte MUST) - Supply-Chain-Evidenz / Supply Chain Evidence (
supply-chain-evidence-template.md) — SBOM, AI-SBOM, VEX, SLSA, OpenSSF Scorecard (Prinzip XVI, releasefähige Projekte MUST; AI-SBOM nur bei KI-Runtime-/Produktkomponenten) - Zero-Trust-Anwendbarkeit / Zero Trust Applicability (
zero-trust-applicability-template.md) — NIST SP 800-207-Bewertung (Prinzip XVIII, verteilte Systeme SHOULD) - SAMM-Bewertung / SAMM Assessment (
samm-assessment-template.md) — OWASP SAMM Reifegrad und Verbesserungsplan (Prinzip XVIII, langlebige Projekte SHOULD) - Cloud-Autonomie / Cloud Autonomy (
cloud-autonomy-applicability-template.md) — BSI C3A-Anwendbarkeit für Cloud-Service-Auswahl, Provider-Abhängigkeiten, Audit-/Nachweisstand und Autonomie-Risiken (Prinzip XVIII, cloudnahe Projekte MUST) - Cloud-Compliance-Assurance (
cloud-compliance-assurance-template.md) — BSI C5-Anwendbarkeit für Cloud-Testate, Assurance-Scope, Shared Responsibility, Provider-/Subprocessor-Abhängigkeiten, Datenstandort, Logging, Backup und Incident-Evidence (Prinzip XVIII, cloudnahe Projekte SHOULD) - Regulatorische Anwendbarkeit / Regulatory Applicability (
regulatory-applicability-template.md) — DS-GVO, NIS2, CRA, EU AI Act und DORA als Scope-/N/A-Prüfung mit ausdrücklicher Begründung für private Ausbildungsprojekte (Prinzip XIX, projektartabhängig)
- Bedrohungsmodell / Threat Model (
- Projektspezifische Instanzen werden in
docs/security/gepflegt; S-ADRs als einzelne Dateien indocs/security/adr/.
Every Level-2 project MUST maintain security documents based on templates in .specify/templates/: threat model (STRIDE+CAPEC), S-ADRs, arc42 Section 8 security concepts, security checklist, dependency audit, security quality scenarios (SHOULD), ASVS verification (web/API MUST), supply-chain evidence (release-capable MUST; AI-SBOM when AI runtime/product components apply), Zero Trust applicability note (distributed systems SHOULD), SAMM assessment (long-lived projects SHOULD), cloud autonomy applicability record (cloud-dependent projects MUST), cloud compliance assurance record (cloud-dependent projects SHOULD), and regulatory applicability record (project-type-dependent). Project-specific instances live in docs/security/; S-ADRs in docs/security/adr/. See constitution.md, Principles XII–XIX for authoritative requirements.
- Vor jeder Level-2-Aufgabe die anwendbaren Sicherheitsstandards aus
constitution.md, Prinzipien XIV-XVIII bestimmen und explizit benennen. NIST SSDFundCWE Top 25gelten immer für Level-2-Arbeit.OWASP ASVSgilt für Web-, API-, HTTP- und authentifizierte Dienste; der gewählte ASVS-Level muss benannt werden.SBOMgilt für releasefähige oder verteilbare Artefakte;VEX, wenn bekannte Schwachstellen in ausgelieferten oder geprüften Komponenten bewertet werden müssen.AI-SBOMgilt projektartabhängig bei KI-Modellen, KI-Diensten, Trainings-/Embedding-Daten, Inferenz-Infrastruktur oder KI-Runtime-Komponenten im ausgelieferten oder betriebenen System; reine Entwicklungswerkzeug-Nutzung wird alsN/Amit Toolchain-Begründung dokumentiert.SLSAgilt als Soll-Vorgabe für CI/CD- oder veröffentlichte Artefakte;Zero Trustist für verteilte, servicebasierte, cloudnahe oder remote-verwaltete Systeme explizit zu prüfen.BSI C3Agilt projektartabhängig bei Cloud-Service-Auswahl, Cloud-Betrieb, SaaS/PaaS/IaaS, Managed Services, Container-/Artefakt-Hosting oder providerabhängigen Deployments; reine Entwicklungsinfrastruktur wird alsN/Amit Toolchain-Begründung dokumentiert.BSI C5gilt projektartabhängig bei Cloud-Service-Auswahl, Cloud-Betrieb, SaaS/PaaS/IaaS, Managed Services, Container-/Artefakt-Hosting, providerabhängigen Deployments oder Cloud-Assurance-Prüfungen; reine Entwicklungsinfrastruktur wird alsN/Amit Toolchain-Begründung dokumentiert.NIS2,CRA,EU AI ActundDORAwerden als regulatorische Anwendbarkeitsmatrix geprüft; Beispielprodukt, Entwicklungswerkzeuge und Organisation getrennt pruefen; Ausbildung und AI-SBOMN/Asind keine allgemeine Ausnahme; unbekannter Scope bleibtOpen.CAPECsoll in Bedrohungsmodellen für die risikoreichsten Angriffswege verwendet werden;OWASP SAMMsoll für langlebige Projekte/Workspaces in Verbesserungspläne einfließen.OWASP Cheat Sheet Series,OWASP Proactive Controlsund bei öffentlichen OSS-Repositories oder kritischen AbhängigkeitenOpenSSF Scorecardsind als ergänzende Referenzen zu berücksichtigen.- Nichtanwendbarkeit immer als
N/Amit kurzer Begründung dokumentieren; keine stillschweigende Auslassung.
At the start of every Level-2 task, determine and name the applicable security standards from constitution.md, Principles XIV-XIX. NIST SSDF and CWE Top 25 always apply. OWASP ASVS applies to web/API/HTTP/auth-bearing services; SBOM applies to releasable or distributable artefacts; AI-SBOM applies when AI models, AI services, datasets, inference infrastructure, or AI runtime components are part of the released or operated system; VEX applies when known vulnerabilities in shipped/evaluated components need a disposition statement. SLSA is the target model for CI/CD and published artefacts; Zero Trust must be explicitly evaluated for distributed, service-based, cloud, or remotely managed systems. BSI C3A applies when cloud services, SaaS/PaaS/IaaS, managed services, artifact hosting, or provider-dependent deployments are part of the released or operated system; development infrastructure alone is N/A with a toolchain rationale. BSI C5 applies when cloud-service selection, cloud operation, managed services, artifact hosting, provider-dependent deployments, or cloud assurance reviews are in scope; development infrastructure alone is N/A with the same toolchain rationale. NIS2, CRA, EU AI Act, and DORA are screened through a regulatory applicability matrix; assess sample product, development tools and operating organisation separately; education and AI-SBOM N/A are not blanket regulatory exemptions; unknown scope remains Open. CAPEC, OWASP SAMM, OWASP Cheat Sheet Series, OWASP Proactive Controls, and OpenSSF Scorecard are supporting references where relevant. Record non-applicability as N/A with justification rather than omitting it silently.
- In
spec.md,plan.mdundtasks.mddie anwendbaren Standards samt Evidenzpfad festhalten. - Bei Bedrohungsmodellen
STRIDEals Basis und bei risikoreichen Flows zusätzlich relevanteCAPEC-Patterns verwenden. - Bei Web/API-Features den
ASVS-Level und den Verifikationsumfang indocs/security/oder gleichwertiger Projektdokumentation ablegen. - KI-Nutzung explizit klassifizieren: Entwicklungswerkzeug, keine KI im ausgelieferten/betriebenen System, oder KI-Runtime-/Produktkomponente;
AI-SBOMentsprechend alsN/Abegründen oder in der Supply-Chain-Evidenz dokumentieren. - Bei Release-/Artefakt-Arbeit
SBOM,AI-SBOM,VEX, Provenance/SLSA-Nachweise und gegebenenfallsOpenSSF Scorecardin Release- oder Sicherheitsdokumentation einplanen. - Bei Architekturänderungen
Zero Trust-Anwendbarkeit und bei langlebigen ProjektenSAMM-Folgeaktionen prüfen. - Bei Cloud-Service-Auswahl oder providerabhängigen Deployments
BSI C3A-Anwendbarkeit prüfen und den Evidenzpfad dokumentieren. - Bei Cloud-Service-Auswahl, providerabhängigen Deployments oder Cloud-Assurance-Prüfungen
BSI C5-Anwendbarkeit prüfen und den Evidenzpfad dokumentieren. - Bei Release, Marktbereitstellung, Kundenübergabe, Cloud-Betrieb, KI-Runtime-/Produktkomponenten, Finanzsektor-ICT-Abhängigkeiten oder regulierten Kunden/Lieferketten
NIS2,CRA,EU AI ActundDORAals Anwendbarkeitsmatrix prüfen. - Default-Evidenzpfad:
docs/security/asvs-verification.md,docs/security/supply-chain-evidence.md,docs/security/zero-trust-applicability.md,docs/security/samm-assessment.md,docs/security/cloud-autonomy-applicability.md,docs/security/cloud-compliance-assurance.md,docs/security/regulatory-applicability.md; Abweichungen nur mit lokal dokumentierter Begründung.
Capture the applicable standards and the evidence path in spec.md, plan.md, and tasks.md. Use STRIDE as the base for threat modeling and add relevant CAPEC patterns for the highest-risk flows. For web/API work, record the chosen ASVS level and verification scope in docs/security/ or equivalent project documentation. Classify AI usage as development tooling, absent from the released/operated system, or AI runtime/product component; document AI-SBOM as N/A or as supply-chain evidence accordingly. For release and artefact work, plan SBOM, AI-SBOM, VEX, provenance/SLSA evidence, and OpenSSF Scorecard review where applicable. For architectural changes, evaluate Zero Trust; for long-lived projects, consider OWASP SAMM follow-up actions. The default evidence path is docs/security/asvs-verification.md, docs/security/supply-chain-evidence.md, docs/security/zero-trust-applicability.md, docs/security/samm-assessment.md, docs/security/cloud-autonomy-applicability.md, docs/security/cloud-compliance-assurance.md, and docs/security/regulatory-applicability.md, unless the repository documents a justified equivalent location.
- Detect existing sub-repos (
.git/directories) inside the target directory → add them to.gitignore - Copy
scripts/(secret scanner, hook installer,pre-pushhook) into workspace git init+ initial commit + apply local git settings (git config --local)gh repo createorglab repo create(private) + pushbash scripts/install-hooks.sh— copiesscripts/hooks/pre-push→.git/hooks/pre-push- If
~/.gitconfig.d/exists: append[includeIf "gitdir:~/WorkspaceName/"]block to~/.gitconfigpointing to~/.gitconfig.d/<workspacename>.inc(idempotent — no duplicate if already present) - Append a row to
~/README.mdworkspace table and commit/pushhome-baseline
bootstrap-project vs. bootstrap-workspace git config scope: bootstrap-project applies settings only via git config --local inside the new project repo — it MUST NOT and does not touch ~/.gitconfig or ~/.gitconfig.d/. Only bootstrap-workspace writes includeIf blocks.
Reverses the bootstrap in a safe, ordered sequence:
- Create backup archive (if
--backup/-Backup) - Safety checks — abort on uncommitted changes or unpushed commits (unless
--force) - Delete remote repo via
gh repo deleteorglab repo delete(auto-detected from remote URL); skip if--keep-remote - Delete local workspace directory
- Clean up artifacts: remove row from
~/README.md, entry from~/.gitignore,[includeIf]block from~/.gitconfig, and~/.gitconfig.d/<name>.inc - Atomic commit of all artifact changes in
~/
Alias: bootstrap-workspace.sh --teardown <WorkspaceName> delegates to teardown-workspace.sh.
The workspace name home-baseline is explicitly protected (exit 2).
scripts/hooks/pre-push— runs on everygit push; usesgitleaksfor the commit ranges being pushed when available, then scans changed git-tracked files from those ranges (.gitignorerespected) with the regex fallback; blocks push with exit 2 on HIGH findings.scripts/scan-agent-secrets.sh/.ps1— manual scanner; usesgitleaks git --pre-commitfor the current git diff when available, then runs the existing regex checks; accepts--fail-on-high/-FailOnHighfor CI use; requiresrg(ripgrep), whilegitleaksis preferred but optional.scripts/audit-agent-changes.sh/.ps1— local baseline/report workflow for agent-managed files. It stores local audit state under~/.home-baseline/agent-audit/, lists later file drift, and searches recent Codex, Claude, Copilot, and Continue logs for path-based hints. This is heuristic correlation, not proof of authorship.
The root .gitignore denies everything (/* and /.*) then explicitly allows safe entries only:
!.gitignore
!.gitconfig
!scripts/
!README.md
Credential directories (.aws/, .ssh/, .kube/, .docker/, .gnupg/) and agent state (.claude/, .codex/, .gemini/, .junie/) are never tracked.
Each bootstrapped workspace (e.g. ~/MyProjects/, ~/WorkProjects/) is an independent Git repo. It inherits a copy of scripts/ and the pre-push hook but has its own AGENTS.md, CLAUDE.md, GEMINI.md, and .github/copilot-instructions.md. Changes to home-baseline do not auto-propagate; workspaces must manually sync.
- Bash:
#!/usr/bin/env bash+set -euo pipefail - PowerShell:
#Requires -Version 7+Set-StrictMode -Version Latest+$ErrorActionPreference = 'Stop' - Indentation: 2 spaces (Bash), 4 spaces (PowerShell)
- Filenames: kebab-case (
bootstrap-workspace.sh) - PowerShell parameters: PascalCase (
-WorkspaceName,-WhatIf) - PowerShell naming: Functions and Cmdlets MUST use the
Verb-Nounpattern (e.g.New-HBWorkspace). - Bash variables: lowercase_underscore
- Documentation mandatory: Every new script MUST have a Unix man-page (for
.sh) indocs/man/and complete bilingual comment-based help (for.ps1). Help switches (-h,--help) MUST point to the documentation.
German primary (Fehler:, Verzeichnis nicht gefunden), English acceptable in code comments. Box-drawing characters (╔, ║, ╚, ✓, →) used for visual output blocks.
Follow Conventional Commits: chore:, docs:, feat:, fix:. Subjects are short and imperative (example from history: feat: bootstrap-workspace aktualisiert ~/README.md automatisch). Always include the trailer:
Co-authored-by: Copilot <[email protected]>
Include: affected scripts/docs, manual verification commands run (--dry-run output), and sample console output when user-visible output changes. For any change touching secret-scan or hook logic, explicitly state the risk and include scanner output.
- Never commit tokens,
.envfiles, or local agent state (.claude/,.codex/,.gemini/). - Run
bash scripts/scan-agent-secrets.sh --fail-on-high .before pushing any change that touches hook or scanner logic; this usesgitleaksfor the current diff when available. - The pre-push hook runs
gitleakson pushed commit ranges when available and then applies the regex fallback to changed tracked files for patterns likeghp_*,sk-*,AKIA*,AIza*, PEM private key headers, and secret-named files (.env*,*secret*,*.key,*.pem).
- Visibility: public template repository (GitHub "Use this template" enabled)
- License: MIT
- Branch protection:
mainrequires PR review;enforce_admins: false(owner can push directly) - CI runners:
ubuntu-22.04,macos-15,windows-2022via.github/workflows/homogeneity-check.yml - Compliance score: 100 % (25/25 checks) as of last verified installation
Windows: $env:HOME ist ein leerer String, nicht $null / Windows: $env:HOME Is an Empty String, Not $null
PowerShell 7's ?? null-coalescing operator does not catch an empty string.
Always use: $(if ($env:HOME) { $env:HOME } else { $env:USERPROFILE })
When the destination already exists, Copy-Item src dst -Recurse copies src into dst (creates dst/src/).
Use Copy-Item src/* dst/ -Recurse -Force to copy contents, not the container.
Bash equivalent: cp -r src/. dst/ instead of cp -r src dst.
CI: Scanner muss aus dem Parent von $GITHUB_WORKSPACE laufen / CI: Scanner Must Run from the Parent of $GITHUB_WORKSPACE
check-homogeneity.sh/ps1 expects TARGET_DIR to be a relative or absolute path it can enter.
If called with just $(basename "$GITHUB_WORKSPACE") while CWD is the repo root, all files appear missing.
Correct approach:
PARENT="$(dirname "$GITHUB_WORKSPACE")"; REPO="$(basename "$GITHUB_WORKSPACE")"
cd "$PARENT" && bash "${REPO}/scripts/check-homogeneity.sh" "${REPO}"PowerShell equivalent: Set-Location (Split-Path $env:GITHUB_WORKSPACE -Parent) then & "${repo}/scripts/check-homogeneity.ps1" -TargetDir $repo.
Do not run several migrate-workspace.* commands in parallel. Each migration invokes init-stats.*,
which updates the shared level 0/1/2 statistics across the whole environment. Parallel migration runs
can block each other and time out. First run -WhatIf/--dry-run, then execute real migrations one
workspace at a time with a longer timeout.
Bash-Array ${#array[@]+...} auf Ubuntu 22.04 nicht unterstützt / Bash Array ${#array[@]+...} Not Supported on Ubuntu 22.04
${#FAILURES[@]+"${#FAILURES[@]}"} causes a bad substitution error on older bash.
Use the Bash-3-safe for-loop: count=0; for _ in "${arr[@]+"${arr[@]}"}"; do count=$((count+1)); done
# comment lines inside ``` blocks were parsed as h1 headings → false heading-gap-h1-to-h3.
Fix: track an $inFencedBlock toggle on lines matching ```.
[hier](...) and [here](...) inside backtick spans (documentation examples) triggered the link check.
Fix: strip inline code spans ('[^]+'`) from each line before pattern-matching links.
The whitelist .gitignore (/* blocks everything) silently ignores git add LICENSE.
Always add !LICENSE to the allowlist; use git add -f LICENSE if needed retroactively.
Both scripts previously had hindermath hardcoded. Fixed to detect current user:
- Bash:
GH_USER=$(gh api user --jq '.login') - PowerShell:
$ghUser = (gh api user --jq '.login')
The restrictions field (who can push directly) requires a paid plan.
On a free personal account only required_pull_request_reviews is effective.
Set enforce_admins: false to allow the owner to bypass the PR requirement.
The scanner itself contains \033[ literals in comments → self-triggers the ANSI check.
Exclude via: --glob '!check-homogeneity.*' (rg) / Where-Object { $_.Name -notmatch '^check-homogeneity\.(ps1|sh)$' } (PS).
<!-- workspace-table-end -->-Anker darf nicht entfernt werden / <!-- workspace-table-end --> Anchor Must Not Be Removed
bootstrap-workspace.sh/ps1 and bootstrap-project.sh/ps1 use this comment as an insertion anchor in README.md. Removing it breaks automated workspace-table updates.
When the same heading text appears more than once, GitHub appends -1, -2 etc. to the anchor.
TOC links for second/third occurrences must include this suffix (e.g. #macos--linux-1).
Avoid duplicates by making heading text unique where possible.
All headings must follow the DE / EN pattern. German-only headings break bilingual consistency and violate WCAG 2.4.6.
Exception: tool names / proper nouns (e.g. ### Homogeneity Guardian, ### Compliance-Check).
Every code block must have a language specifier. Use text for ASCII art, dialog examples, and directory trees.
Bare ``` without a language violates WCAG 4.1.1 (Parsing).
The README follows WCAG 2.2 Level AA. See ## Barrierefreiheit / Accessibility (A11Y) for the full criteria table.
Only known gap: WCAG 3.1.2 (lang attributes) — GitHub strips HTML attributes, cannot be implemented.
The TOC is 2-level: ## headings as top-level items, ### headings as nested items (2-space indent).
#### headings are excluded from the TOC (too granular, too many platform-specific duplicates).
CHANGELOG.md documents versions v0.1.0–v0.4.0 following Keep a Changelog format.
Must be listed in .gitignore whitelist as !CHANGELOG.md.
All rows in a text code block table must have identical character width. A single trailing space before the closing │ makes a row 1 char too long and breaks the visual frame.
Verify with: $line.Length (PowerShell) — all frame characters count as 1 char regardless of UTF-8 byte width.
Never copy from ~/home-baseline-source/ manually. The correct command is:
Run specify init --here --force --integration {agent} once per agent for agy, opencode, claude, copilot, and codex.
Do not refresh Level 0, Level 1, and Level 2 repositories by hand. Run
bash scripts/update-spec-kit.sh --dry-run or
pwsh scripts/update-spec-kit.ps1 -WhatIf first, then use --commit --push /
-Commit -Push when the preview is correct.
The script dynamically discovers new repositories via .git plus .specify/,
backs up and restores .specify/memory/constitution.md, reapplies the local
governance templates, and includes RiderProjects/TuiVision in normal update
runs. OpenCode support is tracked only through .opencode/command/*.md;
.opencode caches, sessions, logs, credentials, and local dependencies remain
excluded.
The default template source is the public home-baseline repository that runs
the script. Private repositories such as RiderProjects/TuiVision may only be
used deliberately with --template-source / -TemplateSource.
Bash option parsing interprets -h as a flag, causing scripts to show help or hang waiting for stdin.
Use the -- end-of-options sentinel: teardown-workspace.sh -- -h. Applies to all scripts accepting positional workspace/project names (bootstrap-project.sh, bootstrap-workspace.sh, init-stats.sh, migrate-workspace.sh, teardown-workspace.sh).
When a feature's implementation is fully merged, rename the corresponding Lastenheft_*.md using:
bash scripts/rename-lastenheft.sh <LH-file> <branch-name> # macOS/Linux
pwsh scripts/rename-lastenheft.ps1 -File <LH-file> -BranchName <branch-name> # WindowsThis stamps the branch name onto the filename (e.g. Lastenheft_Foo.003-feature.md) to mark it as archived.
The rename task is now included as the last step of every feature's Polish phase in tasks.md (constitution v1.1.1).
Missing this step was the root cause of 003, 005, and 006 Lastenhefte remaining unrenamed.
GitHub-Housekeeping: Archivierung, Sichtbarkeit, Forks und Stars / GitHub Housekeeping: Archiving, Visibility, Forks, and Stars
archived on GitHub means read-only, not hidden. Public archived repositories remain visible to signed-out visitors.
Archived repositories are read-only through the API; changing visibility requires:
archived=false → private=true → archived=true.
Public forks cannot simply be changed to private. Options are: keep them public archived, delete them, or recreate them as private mirror repositories. Keep deletion target lists explicit and narrow; gh repo delete may require gh auth refresh -h github.com -s delete_repo.
For activity-based housekeeping, use pushedAt instead of updatedAt, because metadata updates change updatedAt. Stars are account metadata and can be removed via DELETE /user/starred/{owner}/{repo}; verify afterwards with user/starred.
Windows: gh auth login in Hintergrund-/Async-Prozessen / Windows: gh auth login in Background/Async Processes
gh auth login --web does NOT detect browser confirmation when run in a background or async process (e.g. Copilot CLI async shell). The browser callback never arrives.
Always run gh auth login in an interactive terminal window directly.
macOS / Linux / Windows: glab auth login in Hintergrund-/Async-Prozessen / macOS / Linux / Windows: glab auth login in Background/Async Processes
glab auth login --web does NOT detect browser confirmation when run in a background or async process. The browser callback never arrives.
Always run glab auth login in an interactive terminal window directly.
Symptom: Failed to log in to github.com account (keyring) from gh auth status.
Fix: gh auth logout -h github.com -u hindermath then gh auth login --web -p ssh in a real terminal.
Windows: ssh-agent-Dienst standardmäßig deaktiviert / Windows: ssh-agent Service Disabled by Default
The Windows OpenSSH Agent service is Disabled and requires admin rights to enable.
Use HTTPS + gh auth setup-git for git push instead of SSH on Windows.
After gh auth login, run gh auth setup-git once to configure git credential helper.
On Linux, git pull without config fails with "Need to specify how to reconcile divergent branches".
Fix once: git config --global pull.rebase true
Or per-call: git pull --rebase
gh auth setup-git may not work if credential cache has stale entries.
Reliable fix: generate SSH key, add to GitHub, set remote to SSH:
ssh-keygen -t ed25519 -C "linux-home-baseline" -f ~/.ssh/id_ed25519 -N ""
gh ssh-key add ~/.ssh/id_ed25519.pub --title "linux-home-baseline"
git remote set-url origin [email protected]:hindermath/home-baseline.git
ssh -T [email protected] # testTestskripte: git pull --rebase --autostash vor dem Push / Test Scripts: git pull --rebase --autostash Before Push
The *-test.sh/ps1 scripts write the output file before pushing. Without --autostash, git pull --rebase fails with "unstaged changes".
All test scripts use: git pull --rebase --autostash origin main
When calling pwsh -File script.ps1 as a subprocess, PowerShell loads the user profile.
If the profile contains Oh-My-Posh or cursor-positioning code, it throws:
Exception setting "CursorPosition": "Das Handle ist ungültig."
Fix: always add -NoProfile to subprocess calls in windows-test.ps1.
- Wiederkehrende Toolchain-Wartungsrunden sind im README unter
Wiederkehrende agentische Toolchain-Wartung / Recurring Agentic Toolchain Maintenancedokumentiert. - Wenn ein bekannter KI-Agent in
~oder~/home-baseline-sourcestartet und keine strengere Read-only-Aufgabe im Vordergrund steht, fragt er einmal nach: nur pruefen, pruefen und fehlende Required-Tools installieren, vollstaendig inklusive GSDB-Preflight vorbereiten oder ueberspringen. - macOS/Linux nutzen
scripts/maintain-agentic-brew-apps.shundscripts/config/brew-apps-registry.json; Windows nutztscripts/maintain-agentic-winget-apps.ps1undscripts/config/winget-apps-registry.json; VS-Code-Extensions werden ueberscripts/config/vscode-extensions-registry.json, Required-CLI-Pruefungen ueberscripts/config/required-cli-tools-registry.json, npm-Agenten-CLIs ueberscripts/config/npm-agent-cli-registry.jsongepflegt. - PSScriptAnalyzer
1.25.0ist ein Required-PowerShell-Modul ausscripts/config/powershell-modules-registry.json; alle getrackten repo-eigenen.ps1,.psm1und.psd1muessen den gemeinsamen Analyselauf bestehen. Nur die dort begruendet dokumentierten, von GitHub Spec Kit erzeugten Upstream-Pfade sind ausgenommen. / PSScriptAnalyzer1.25.0is a required module; every tracked, repository-owned PowerShell file must pass the shared analysis run. Only generated GitHub Spec Kit upstream paths documented there with a rationale are excluded. - Level-0 unter
~/home-baseline-sourceist die kanonische Quelle fuer diese Wartungsdateien. Bestehende Level-1-/Level-2-Kopien mitpropagate-agentic-toolchain-maintenance.*zuerst als Vorschau, danach schreibend und abschliessend mit--check-only/-CheckOnlysynchronisieren; das Werkzeug commitet oder pusht nicht. - Fuer komplette Wartungslaeufe
maintain-agentic-workspace.shauf macOS/Linux beziehungsweisemaintain-agentic-workspace.ps1auf Windows verwenden. Ohne Optionen aktualisieren sie Level-0/1/2 und die Required-Toolchain;--check-only/-CheckOnlyprueft, Vorschau zeigt Schreibschritte, und Drift-Reparatur bleibt mit--repair-drift/-RepairDriftausdruecklich zustimmungspflichtig. Die Orchestratoren wechseln keine Branches und committen oder pushen keine Ziel-Repositories. - Vollwartung verwendet Storage-Profil
Safe: sieben Tage Aufbewahrung, Pressure Mode unter 15 Prozent freiem Speicher und ausschließlich Git-ignorierte, nicht getrackte, repo-interne Buildausgaben.Deepbenötigt im echten Lauf eine eigene Bestätigung;scripts-onlyerzwingtNone. Container-Volumes,--allundsystem prunesind ausgeschlossen. Non-MSL-Repositories wiecc65undtvisiondürfen nur über kuratierte Adapter mit dokumentierter Begründung und geschützter Build-Evidence bereinigt werden.
Full maintenance uses the Safe storage profile: seven-day retention, pressure mode below 15 percent free space, and only Git-ignored, untracked, repository-contained build outputs. An update Deep run requires separate confirmation; scripts-only enforces None. Container volumes, --all, and system prune are excluded. Non-MSL repositories such as cc65 and tvision may be cleaned only by curated adapters that preserve their documented justification and build evidence.
- VS Code ist der grafische Required-Editor fuer Auszubildende; Helix (
hx) ist der Required-A11Y-/CLI-Editor. Fuer die sechs MSL-Pfade C#, Go, Java, Python, Rust und Swift sind die offiziellen minimalen VS-Code-Extensions required; Microsoft Container Tools ist zusaetzlich required fuer Podman-Workflows. - Die offizielle PowerShell-Erweiterung
ms-vscode.powershellist fuer das Schreiben und Debuggen von PowerShell-Skripten und Cmdlets in VS Code ebenfalls required. - Pandoc und Typst CLI sind plattformuebergreifende Pflichtwerkzeuge fuer Dokumentkonvertierung und lokalen PDF-Satz. Die Community-Erweiterung Tinymist Typst (
myriad-dreamin.tinymist) ist in VS Code required und verwaltet ihren Language Server selbst. Das separate Systempakettinymistbleibt optional. Linux ohne Homebrew verwendet bei fehlendem Typst den offiziellen Cargo-Build mit--locked; dafuer ist eine kompatible Rust-Toolchain erforderlich. - Podman CLI und Compose-Unterstuetzung sowie die sechs MSL-CLI-Toolchains
.NET, Go, Java/Javac, Python, Rust/Cargo und Swift sind Required;syftfuer SBOM-Nachweise und GitHub Spec Kit (specify) fuer SDD sind ebenfalls Required.specifywird bei Bedarf ueberuv tool install specify-cli --from git+https://github.com/github/spec-kit.git@464d57fe30c72e9a88d279cc49834539ec989c03installiert. - Die Agenten-CLI-Oberflaechen
codex,claudeundcopilotsind plattformuebergreifend Required und nutzen bei Bedarf die npm-Registry als Fallback. Google Antigravity ersetzt Gemini CLI;agyist plattformuebergreifend Required: macOS nutzt Homebrew, WindowsGoogle.AntigravityCLIper WinGet und Linux den pruefsummengeprueften offiziellen Installer. - Standardlaeufe installieren nur
required;optionaldient als dokumentierter Komfort-/Projektkontext.xquartzbleibt bewusst aus der Brew-Registry ausgeschlossen. - Fehlende Required-Programme aus
--compare-only/-CompareOnlywerden bei freigegebener Wartung installiert; optionale Tools nur nach ausdruecklicher Zustimmung. gitleaks,syft,specify, die MSL-CLI-Toolchains und die Required-Agenten-CLIs muessen nach Paketmanager-Wartung pruefbar sein.- Zweitgeraete ueber
mac-test.sh,linux-test.shundwindows-test.ps1vergleichen; bewusst installierte Top-Level-Tools danach in die passende Registry uebernehmen.
Recurring toolchain maintenance rounds are documented in the README section Wiederkehrende agentische Toolchain-Wartung / Recurring Agentic Toolchain Maintenance. macOS/Linux use scripts/maintain-agentic-brew-apps.sh with scripts/config/brew-apps-registry.json; Windows uses scripts/maintain-agentic-winget-apps.ps1 with scripts/config/winget-apps-registry.json; VS Code extensions are maintained through scripts/config/vscode-extensions-registry.json, required CLI checks through scripts/config/required-cli-tools-registry.json, and npm agent CLIs through scripts/config/npm-agent-cli-registry.json. VS Code is the required graphical editor for apprentices; Helix (hx) is the required A11Y/CLI editor. The official minimal VS Code extensions are required for the six MSL paths C#, Go, Java, Python, Rust, and Swift; Microsoft Container Tools is also required for Podman workflows. Podman CLI and Compose support plus the six MSL CLI toolchains .NET, Go, Java/Javac, Python, Rust/Cargo, and Swift are required; syft for SBOM evidence and GitHub Spec Kit (specify) for SDD are required as well. The codex, claude, and copilot agent CLI surfaces are required across platforms and use the npm registry as a fallback when needed. Google Antigravity replaces Gemini CLI; agy is required cross-platform: macOS uses Homebrew, Windows uses Google.AntigravityCLI through WinGet, and Linux uses the checksum-verified official installer. specify is installed through uv tool install specify-cli --from git+https://github.com/github/spec-kit.git@464d57fe30c72e9a88d279cc49834539ec989c03 when missing. Default runs install only required; optional records convenience/project context. xquartz stays intentionally excluded from the Brew registry. gitleaks, syft, specify, the MSL CLI toolchains, and the required agent CLIs must be verifiable after package-manager maintenance; compare second machines through the platform test scripts and then update the matching registry for intentional top-level tools.
The official PowerShell extension ms-vscode.powershell is also required for authoring and debugging PowerShell scripts and cmdlets in VS Code.
Pandoc and Typst CLI are required cross-platform tools for document conversion and local PDF typesetting. The community-maintained Tinymist Typst extension (myriad-dreamin.tinymist) is required in VS Code and manages its own language server. The standalone tinymist system package remains optional. Linux without Homebrew uses the official locked Cargo build when Typst is missing, requiring a compatible Rust toolchain.
Level-0 under ~/home-baseline-source is the canonical source for these maintenance files. Synchronize existing Level-1/Level-2 copies with propagate-agentic-toolchain-maintenance.*: preview first, apply second, and finish with --check-only / -CheckOnly. The tool performs no commits or pushes.
Use maintain-agentic-workspace.sh on macOS/Linux or maintain-agentic-workspace.ps1 on Windows for complete maintenance. With no options they update Level-0/1/2 and the required toolchain; check-only reports state, preview shows mutating steps, and drift repair requires explicit --repair-drift / -RepairDrift. The orchestrators never switch branches or commit/push target repositories.
At startup in ~ or ~/home-baseline-source, known AI agents ask once whether to check only, check and install missing required tools, prepare full maintenance including GSDB preflight, or skip. Missing required tools from compare mode may be installed after approval; optional tools require explicit approval.
- Level-2-Repositories SOLLEN die zentrale sichere-Entwicklung-Basis aus
docs/secure-development/enthalten; MSL-Status ist ein Pruefpunkt, aber keine Voraussetzung fuer die RL-SE-/Checklist-Selbstpruefung. - Dazu gehoeren Richtlinie, Checklisten, Sammelband,
docs/secure-development/mitgeltende-dokumente/und die zentrale Verzahnungsdateidocs/secure-development/mitgeltende-dokumente/Verzahnung_Richtlinie_Checklisten_Spec-Kit-Presets.md. docs/secure-development/baseline-manifest.jsonist die kanonische Dateiliste fuer die dort versionierte Basis; die Einzelchecklisten sind Quelle und der Sammelband wird mitbuild-secure-development-docs.*erzeugt und geprueft.- Projektnachweise liegen getrennt unter
docs/security/secure-development/<datum>-<scope>/; Sicherheit beginnt ab dem ersten Ausbildungs- und Entwicklungsauftrag gemaess dem Lernpfad Lehrjahr 1 bis 3. - Die mitgeltende
Leitlinie_Sichere-Entwicklungs-Sandbox.mdbeschreibt das Sandbox-Referenzprofil fuer KI-Agenten, Spec Kit, MSL-basierte Level-2-Projekte und die oeffentlichkeitsfaehigeabsdd-image-sandbox. - Neue Level-2-Projekte koennen diese Basis beim Bootstrap ueber
bootstrap-project.* --primary-language <Sprache>/-PrimaryLanguage <Sprache>erhalten. Level-2-Repos werden standardmaessig unabhaengig vom MSL-Status als GSDB-pflichtig mit dem Acht-Preset-Profil in der lokalen Registry~/.home-baseline/level2-repository-registry.jsonregistriert; begruendete Ausnahmen muessen explizit gesetzt werden. Bei Lern-Sprachrepos gilt die vorgesehene Sprache aus dem eindeutigen Repo-Suffix oder einem expliziten Sprachparameter bereits vor dem Runtime-Scaffold. - Fuer GSDB-Zielmengen zuerst diese lokale Registry lesen; manuelle Repo-Listen sind nur ein bewusster Override. Bestehende Repos koennen mit
register-level2-repository.*nachgetragen werden. - Wiederkehrende Wartung prueft GSDB-Registry-Drift mit
register-level2-repository.* --scan-root/-ScanRootzuerst im Trockenlauf. Wartungsscans duerfen bekannte Sprach-, MSL-, GSDB- oder Preset-Metadaten nicht aufunknown,falseodernoneherabstufen; neu erkannte Level-2-Repositories werden nach Bestaetigung in der lokalen Registry gemerkt. - Wiederkehrende Level-2-Wartungsrunden sind im README unter
Wiederkehrende Level-2-Wartungsrunde / Recurring Level-2 Maintenance Rounddokumentiert; dort die Reihenfolge fuer Toolchain-Pruefung, Klonen/Pullen, Registry, Spec-Kit/Governance, GSDB und Statistikabschluss verwenden. - Bestehende Level-2-Projekte werden registry-basiert mit
prepare-rl-se-checklist-selbstpruefung.*vor der Haertung und mitprepare-secure-development-hardening.*fuer den spaeteren Haertungs-Intake vorbereitet; zuerst--dry-run/-WhatIfnutzen. - Die Vorbereitung erzeugt nur Intake- und Ordnungsartefakte:
docs/secure-development/,Lastenheft_RL-SE-Checklist-Selbstpruefung.md,Lastenheft_Secure-Development-Hardening.mdundLastenheft_Abarbeitungsreihenfolge.md. Lastenheft_RL-SE-Checklist-Selbstpruefung.mdverlangt getrennt Anwendbarkeit (Applicable,N/A,Open) und Umsetzung (Fulfilled,Partly Fulfilled,Not Fulfilled,Not Assessed) sowie Begruendung, Evidenzpfad, Owner, Follow-up, Re-Evaluation-Trigger und Restrisiko.- Das Suchmuster fuer die automatische Reihenfolge ist strikt
Lastenheft*.md;Lastenheft_Abarbeitungsreihenfolge.mdwird selbst nicht als Arbeitspaket einsortiert. - Vorhandene Reihenfolge-Dateien werden geschuetzt: nur der markierte generierte Abschnitt wird aktualisiert; manuelle Begruendungen bleiben erhalten.
check-gsdb-self-assessment.*prueft die GSDB ohne Spec-Kit-Lauf als Self-Assessment/Preflight.--check-only/-CheckOnlybleibt rein lesend. Ein normaler Lauf schreibtdocs/security/gsdb-self-assessment.md, erzeugt oder aktualisiertLastenheft_GSDB-Spec-Kit-Intensivpruefung.mdund nimmt dieses Lastenheft inLastenheft_Abarbeitungsreihenfolge.mdauf.- Diese Vorbereitung startet keinen Spec-Kit-Lauf, erzeugt keinen Feature-Branch und befuellt ausser dem GSDB-Preflight-Bericht keine weiteren
docs/security/-Nachweise. Die eigentlichen Haertungs- und Intensivpruefungslaeufe werden separat gestartet. - Aktive Lastenhefte fuer spaetere Spec-Kit-Laeufe SOLLEN als Intake-Dateien eine klare Mindeststruktur enthalten: Zweck, Ausgangslage, Zielbild, Scope, Nicht-Ziele, Anforderungen, erwartete Artefakte, Akzeptanzkriterien und einen kopierbaren
/speckit-specify-Prompt. Lastenhefte mit Feature-Branch-Suffix gelten als historisch und werden nicht erneut gestartet.
Level-2 repositories SHOULD contain the central secure-development baseline from docs/secure-development/, including guideline, checklists, compendium, docs/secure-development/mitgeltende-dokumente/, and the related-documents alignment file docs/secure-development/mitgeltende-dokumente/Verzahnung_Richtlinie_Checklisten_Spec-Kit-Presets.md. MSL status is a checkpoint, not a prerequisite for GSDB scope. Level-2 repositories default to GSDB-required with the eight-preset profile; justified exceptions must be explicit. A learning-language repository's intended language is valid from its unambiguous suffix or an explicit parameter before a runtime scaffold exists. Maintenance scans must not downgrade known language, MSL, GSDB, or preset metadata to unknown, false, or none. Existing projects are prepared with prepare-rl-se-checklist-selbstpruefung.* before hardening and with prepare-secure-development-hardening.* for the later hardening intake; use --dry-run / -WhatIf first. Read the local registry before using manual target lists. Recurring level-2 maintenance rounds are documented in the README section Wiederkehrende Level-2-Wartungsrunde / Recurring Level-2 Maintenance Round; use that order for toolchain checks, clone/pull, registry, Spec Kit/governance, GSDB, and statistics closeout. check-gsdb-self-assessment.* performs a GSDB preflight without starting Spec Kit, can run read-only with --check-only / -CheckOnly, and in normal mode writes docs/security/gsdb-self-assessment.md, creates or updates Lastenheft_GSDB-Spec-Kit-Intensivpruefung.md, and updates Lastenheft_Abarbeitungsreihenfolge.md. The generated intake is for a later manually started Spec Kit run; the preflight itself does not create a feature branch or claim formal hardening.
The current secure-development baseline version is controlled by docs/secure-development/baseline-manifest.json; individual checklists are canonical and the compendium is generated. Project evidence stays under docs/security/secure-development/<date>-<scope>/. Every item uses separate applicability and implementation axes. Security learning starts with the first training and development task. Registry-based baseline-only propagation does not modify Lastenhefte or start Spec Kit.
Recurring maintenance checks GSDB registry drift with register-level2-repository.* --scan-root / -ScanRoot first as a dry run. Newly detected level-2 repositories are remembered after confirmation without downgrading stronger existing metadata.
- Modellwahl ist operative Agenten-Routing-Guidance, keine Feature-Anforderung. Modellnamen nicht in
spec.md,plan.md,tasks.mdoder einzelne Feature-Specs schreiben; diese Artefakte muessen reproduzierbar bleiben, auch wenn Modellnamen wechseln oder ein anderer KI-Agent verwendet wird. - Der jeweilige Agent soll diese Empfehlungen auf seine aktuell verfuegbaren Modelle abbilden; keine feste Anbieter- oder Modellbindung ableiten.
- Fuer Spec-Kit-Spezifikation, Klaerung, Planung, Tasks und Analyse (
/speckit-specify,/speckit-clarify,/speckit-plan,/speckit-tasks,/speckit-analyze; je nach Agent auch/speckit.specifyusw.) das staerkste verfuegbare Frontier-Reasoning-/Coding-Modell bevorzugen. - Fuer vollstaendige, lang laufende
/speckit-implement-Laeufe das staerkste verfuegbare Long-Running-Agent-Modell bevorzugen; das Frontier-Modell nutzen, wenn maximale Urteilsguete wichtiger ist als Laufzeitstabilitaet. - Fuer fokussierte Reviews oder CI-Fixes ein coding-optimiertes Modell bevorzugen.
- Fuer triviale Bereinigung, Formatierung oder risikoarme mechanische Edits ist ein schnelles kleines Coding-Modell akzeptabel.
- Die stabilen operativen Rollen heissen
frontier-reasoning,long-running-implementation,coding-review,fast-mechanicalundscript-only. Installierte Presets deklarieren ihre Kommandos inmodel-routing.json; bei mehreren Wrappern gewinnt die staerkste Rolle. - Intake-Create/Update/Delete, Intake-Review/Repair, Sequencing-Create/Update/Delete sowie Specify/Clarify/Plan/Tasks/Analyze verwenden
frontier-reasoning. Read/Status/Next duerfenfast-mechanicalverwenden; Stop und deterministische Validatoren bleibenscript-only. - Ein nicht-paralleler autonomer Lauf darf Modelle nur an einer validierten Phasengrenze wechseln. Jede Phase startet einen neuen Prozess, bindet ihr Handoff per SHA-256 und schreibt Profil, Modell und Reasoning-Aufwand in den Run-State.
- Lokale Runner-Profile muessen
fail-closedarbeiten. Fehlendes Profil, Modell, Reasoning oder erfolgreicher Preflight fuehrt zuBlocked; kein stiller Fallback.
Model choice is operational agent-routing guidance, not a feature requirement. Do not pin model names in spec.md, plan.md, tasks.md, or individual feature specs. Stable roles are frontier-reasoning, long-running-implementation, coding-review, fast-mechanical, and script-only. Installed presets declare command roles in model-routing.json; the strongest applicable wrapper role wins. Semantic intake and Spec-Kit decisions use frontier reasoning, read/status/next may use fast mechanical routing, and stop plus deterministic validators remain script-only. A non-parallel autonomous run changes models only at a validated phase boundary through a new process and SHA-256-bound handoff. Local profiles fail closed: missing profile, model, effort, or successful preflight results in Blocked, never a silent fallback.
DE: Die Versionsangaben beschreiben den zentralen Release-Sollstand. Diese Quellenpflege aktualisiert keine installierten Presets oder Home Runtime. Rollout und Community-Einreichung brauchen getrennte Auftraege. EN: Version references describe the central release target, not installation state. Source binding updates install no presets and sync no Home Runtime. Rollout and community submission require separate requests.
DE: Architecture v0.6.5 trennt C5 Typ 1 (Zeitpunkt), Typ 2 (Zeitraum und Wirksamkeit) und Unknown. C3A v1.0 verlangt sichtbare 30 Kriteriengruppen mit konkreten C-/AC-Kennungen; SI ist Erlaeuterung. Fehlende Evidence bleibt Open. Authoring 0.3.10, Review 0.2.7 und Sequencing 0.2.13 teilen denselben Konfigurationsvertrag fuer Active ohne Folge-Kandidat, leeres Idle und verschachtelte Git-Repositories. Installation ist keine Laufberechtigung.
EN: Architecture v0.6.5 separates C5 Type 1/as-of-date, Type 2/period effectiveness and Unknown. C3A v1.0 retains all 30 criterion groups and exact C/AC identifiers; SI informs interpretation. Missing evidence stays Open. The coordinated Intake versions share Active/no-next-candidate, empty Idle and nested-Git-index rules. Installation grants no execution authority.
- Standard-Preset-Set:
security-governancev0.7.5 prio 10,architecture-governancev0.6.6 prio 20,isaqb-architecture-governancev0.2.6 prio 30,a11y-governancev0.4.7 prio 40,cross-platform-governancev0.2.6 prio 50,agent-parity-governancev0.4.6 prio 60,autonomous-run-governancev0.4.12 prio 70,parallel-autonomous-run-governancev0.2.13 prio 80. - Optionale Presets:
model-routing-governancev0.2.9 prio 61 sowie Intake Authoring v0.3.14 prio 64, Intake Review v0.2.9 prio 65 und Intake Sequencing v0.2.14 prio 66 bleiben ausserhalb der Standard-Achtermatrix. Thorstens verwaltete Flotte installiert alle vier uebermodel-routing-twelve-governance-presets; bestehende Neun-, Zehn- und Elf-Preset-Profile bleiben kompatibel, ersetzen aber nicht das Zwölfer-Flottenprofil. Konkrete Modelle werden pro Rechner erkannt und nie aus einem Remote-Repository uebernommen. Optional Model Routing v0.2.9 and the three Intake Governance presets remain outside the standard eight. Thorsten's managed fleet installs all four throughmodel-routing-twelve-governance-presets; compatible nine-, ten-, and eleven-preset profiles do not replace that fleet profile. Concrete models are discovered per machine and never copied from a remote repository. - Intake Authoring trennt Create, Read, Update und Delete. Create schreibt nur neue Ziele; Update benoetigt aktuelle ausdrueckliche Autoritaet und archiviert den Vorgaenger; Delete verschiebt Ziel und Receipt in ein hashgebundenes Archiv und hinterlaesst einen Tombstone; Read bleibt standardmaessig eine read-only Summary. Oeffentliche Quellen sind auf statisches HTTPS mit begrenzten Antworten und SSRF-Schutz beschraenkt. Mehrere Intakes benoetigen einen vollstaendigen Series-Vorschlag und ausdrueckliche Freigabe; partielle Publikation ist unzulaessig. Materielle Fragen werden einzeln und hoechstens fuenfmal gestellt.
ReadyForReviewstartet Review, Specify oder autonome Laeufe nie automatisch. Intake Authoring separates Create, Read, Update, and Delete; protects updates and logical deletion with archived hash evidence; limits URL input to bounded public HTTPS; and requires explicit approval before publishing a complete intake series. It never infers overwrite, remote authority, or downstream execution. - Intake Review akzeptiert bei aktiver Projekt- oder Kampagnenpolicy nur aktuelle
Ready- oder menschlich akzeptierteReadyWithAcceptedRisks-Ergebnisse; Critical/High, offene materielle Fragen, Hash-Drift oder fehlende Worker-Coverage blockieren. Review und Status sind read-only, Repair benoetigt ausdrueckliche Aenderungsautoritaet. Series-Reviews verwenden Schema 1.1, binden den normalisierten Request-Hash und pruefen exakte Zielreihenfolge, explizite Roots sowie einen azyklischen Graphen; nicht belegbare Vorgaengerbeziehungen fuehren zuNeedsClarification. Series reviews use schema 1.1, bind the normalized request hash, and verify exact target order, explicit roots, and an acyclic graph; unprovable predecessor relations result inNeedsClarification. - Intake Sequencing verwaltet nur Reihenfolge und Lifecycle bereits vorhandener Intakes. Create/Update/Delete benoetigen ausdrueckliche aktuelle Autoritaet; Read/Status/Next bleiben read-only.
nextmeldet startfaehige Ziele oder konkrete Blocker, startet aber weder Review noch Specify noch autonome Laeufe. Bindende Kanten werden von reiner Liefer- oder Shared-Writer-Serialisierung unterschieden; unklare Graph- oder Abschlussfakten bleibenNeedsClarification. Intake Sequencing manages only the order and lifecycle of existing intakes. It separates binding dependencies from delivery-only serialization, requires explicit write authority, and never starts downstream work. autonomous-run-governancev0.4.12 prio 70 ist Teil der Standard-Achtermatrix. Ein vollständiger autonomer Lauf bleibt ausdrücklich delegationspflichtig; die Installation allein erteilt weder Ausführungsberechtigung noch Remote-, Merge-, Bypass- oder Provider-Rechte undLocalImplementationbleibt Default. Dokumentations-, Status-, Schema- oder Evidence-Änderungen gelten erst dann als testfrei, wenn keine ausführbaren Validatoren die geänderten Pfade, Marker, Schemas oder Zustandswerte konsumieren. Vor autorisierten Commits wird der exakt beabsichtigte Kandidat mit dem Delivery-Set-Validator im Staged-Modus einschließlich exakter Pfad- und Index-Hash-Bindung geprüft; fremde Änderungen bleiben unberührt. Vor einem Merge wird jeder Acceptance-Gate dem tatsächlich ausgeführten Workflow, Job, Runner beziehungsweise der Plattform und dem Befehl zugeordnet; grüne Namen oder ein Bypass ersetzen keinen technischen Nachweis. Bewusst pausierte Läufe werden alsPausedByUsergespeichert und nur überspeckit.autonomous-resumefortgesetzt;speckit.autonomous-stopwirkt kooperativ am nächsten sicheren Grenzpunkt, und ein gespeicherter Delivery-Modus ist keine aktuelle Berechtigung. Nach Preset- oder Governance-Drift werden neue zwingende Korrektheits-, Sicherheits-, Berechtigungs- und Evidenzregeln minimal mit akzeptierten Plan-, Task- und Checklist-Artefakten abgeglichen; reine Effizienzpräferenzen lösen keine rückwirkende Neugenerierung aus. Die lesbare Skill-ÜberschriftDeliverist kein Run-State-Wert; für Remote-Closeout gelten ausschließlichPublish,ReviewoderMergeAndSync.parallel-autonomous-run-governancev0.2.13 prio 80 ist Teil der Standard-Achtermatrix. Die Installation startet keine Kampagne und erteilt keine zusaetzlichen Remote-, Merge-, Bypass-, Abbruch-, Secret- oder Provider-Rechte. Kampagnen bleiben ausdruecklich delegationspflichtig, verwenden getrennte Worktrees und maximal drei gleichzeitig aktive Worker. Schema 1.1 erlaubt einrunnerProfileje Worker mit Kampagnen-Fallback; Modell und Reasoning-Stufe sind optionale, nicht geheime Metadaten und werden ohne Deklaration nicht erraten. Konsolidierung verlangt exakten Head, aktuelle Review- und Check-Evidenz, ist nach Teilmerges fortsetzbar und setztCompletederst nach Synchronisation, manifestdeklarierten idempotenten Post-Merge-Aktionen und Abschlussvalidierung.- Reale Preset-8-Kampagnen setzen in jedem Worker-Repository ein installiertes und aktiviertes
autonomous-run-governance >=0.2.2voraus. Preset 7 mit Prioritaet70liefert Lebenszyklus, Evidenz und Berechtigungsgrenzen; Preset 8 mit Prioritaet80koordiniert die Kampagne. Fehlt Preset 7, ist es deaktiviert oder zu alt, endet der Preflight vor dem Worker-Start.requireAutonomousPreset: falsebleibt auf isolierte interne Fixtures begrenzt und ist kein Produktionsmodus. Real Preset 8 campaigns require installed and enabledautonomous-run-governance >=0.2.2in every worker repository. Preset 7 at priority70supplies lifecycle, evidence, and authority boundaries; Preset 8 at priority80coordinates the campaign. Missing, disabled, or outdated Preset 7 fails preflight before worker start.requireAutonomousPreset: falseremains limited to isolated internal fixtures and is not a production mode. a11y-governancev0.4.7 ergänzt didaktische Inline-Code-Kommentar-Governance für neue oder geaenderte nicht-triviale Logik.security-governancev0.7.5 fuehrtAI-SBOMweiter als bedingt anwendbare Supply-Chain-Evidenz, ergänzt sprachspezifische Secure-Coding-Profile und ergänzt regulatorische Anwendbarkeit für DS-GVO, NIS2, CRA, EU AI Act und DORA. Reine Entwicklungswerkzeug-Nutzung bleibtN/A; KI-Runtime-/Produktkomponenten benoetigen Evidenz nach G7/BSI AI-SBOM-Clustern; Beispielprodukt, Entwicklungswerkzeuge und Organisation brauchen getrennte Anwendbarkeitsnachweise; Ausbildung ist keine pauschale Ausnahme.architecture-governancev0.6.6 ergänztBSI C3Aals bedingte Cloud-Autonomie-Evidenz undBSI C5als bedingte Cloud-Compliance-Assurance-Evidenz für Cloud-Service-Auswahl, Provider-Abhängigkeiten, Audit-/Nachweisstand, Shared Responsibility und Betriebsnachweise.- Alle acht Presets enthalten ab diesem Release-Block audit-ready Spec-Kit-Run-Evidenz:
Applicable/N/A/Open, Begründung, Evidenzpfad, Reviewer, Restrisiko und Follow-up muessen im aktuellen Spec-Kit-Lauf dokumentiert werden. - Die ursprünglichen sechs Presets sind seit 2026-05-04 und
autonomous-run-governancev0.2.2 ist seit 2026-07-17 imgithub/spec-kitCommunity-Katalog enthalten und liegen zusätzlich als veröffentlichte Repos unterhttps://github.com/hindermath/spec-kit-preset-*. parallel-autonomous-run-governancev0.2.13 ist eigenstaendig veroeffentlicht; v0.2.2 wurde mitgithub/spec-kit#3591fuer den Community-Katalog eingereicht.- Registrierte Level-0-, Level-1- und Level-2-Repositories installieren bei vorhandener Spec-Kit-Integration standardmäßig alle acht Presets aus
scripts/config/spec-kit-governance-presets.json, sofern keine begründete Ausnahme dokumentiert ist. - Referenz-Rollout für alle acht Presets:
RiderProjects/TinyPl0,RiderProjects/TinyCalc,RiderProjects/TuiVision,RiderProjects/InventarWorkerService. - Installation erfolgt bevorzugt mit
install-spec-kit-governance-presets.*aus der zentralen Matrix; die Skriptlogik enthaelt keine fest eingebauten Versionen. Bei neuen Preset-Releases zuerst die Matrix aktualisieren, dann bestehende Repos bewusst mit--force/-Forcenachziehen. - Flotten-Rollouts erfassen Level-0, Level-1 und Level-2 explizit. Eine reine Level-2-Registry beweist keine vollstaendige Abdeckung; jeder Zielstatus wird bis Installation, exakter Matrixvalidierung, Commit, Push und Remote-Synchronisation verfolgt.
- Vor dem Staging werden generierte Preset-/Agentenpfade mit dem gesamten Arbeitsbaum abgeglichen. Fremde Aenderungen bleiben unberuehrt; bei Konflikten wird ein sauberer Worktree statt eines erzwungenen Misch-Commits verwendet.
- Aktuelle normative Sechs-/Siebenerangaben werden auf die Achtermatrix migriert. Historische Statistik-, Changelog-, Feldnachweis- und Kompatibilitaetsangaben bleiben erhalten und werden durch einen dokumentierten Allowlist-Scan unterschieden.
- Provider-/Billing-Ablehnung, technischer Gate-Fehler und bestandener Gate sind getrennte Ergebnisse. Bypass oder gruene Sammelnamen ersetzen keinen exakten technischen Nachweis.
.specify/presets/und generierte Agenten-/Command-Dateien committen, wenn Presets Projekt-Policy sind;.specify/presets/.cache/nie committen.- Nach Installation oder Update prüfen:
specify preset list, mindestens einspecify preset info <id>, bei Template-Fragen zusätzlichspecify preset resolve <template>. - Die veroeffentlichten
hindermath/spec-kit-preset-*-Repositories sind die alleinigen Produktquellen; ihre Git-Arbeitskopien liegen unter~/SpecKitPresetProjects/. Home Baseline verwaltet Profile, gepinnte Release-Bezuege und Projektintegrationen, keine parallelen Produkt-Scaffolds. - Preset-Verbesserungen direkt im jeweiligen eigenstaendigen Git-Repository entwickeln, pruefen und veroeffentlichen. Bestehende Installationen der zwoelf ausgerollten Presets und vorhandene Assurance-Installationen bleiben bei einer Quellenbereinigung unveraendert. Ueber jede weitere Verteilung des 13. Presets entscheidet Thorsten separat; Katalogaufnahme oder Quellenpflege erteilt keine Rollout-Autoritaet.
- Bei Änderungen an Preset-Regeln immer prüfen, ob
constitution.md,.specify/memory/constitution.md,AGENTS.md,CLAUDE.md,GEMINI.md,.github/copilot-instructions.mdundscripts/templates/*ebenfalls aktualisiert werden müssen. - Bei jeder Preset-Version oder Prioritätsänderung zuerst
scripts/config/spec-kit-governance-presets.jsonaktualisieren und danach README-Tabellen, Constitution, Agenten-Dateien,scripts/templates/speckit-workflow-section.mdund Agenten-Templates gemeinsam prüfen. - Community-Katalog-Einreichungen an
github/spec-kitstrikt einzeln erstellen und aktivieren: erst den erzeugten PR prüfen und mergen lassen sowie das Issue abschließen, dann das nächste Issue einreichen. Bei einer bereits vorhandenen Warteschlange nur den nächsten Kandidaten fürpreset-submissionbenennen; keine neuen Batch-Issues oder parallelen Label-Anfragen. Grundlage ist der Maintainer-Hinweis ingithub/spec-kit#3679; der Betriebsvertrag steht indocs/maintenance/Preset-and-Fleet-Operations-Lessons-Learned.md. Submit and activategithub/spec-kitcommunity catalog updates strictly one at a time. Complete the generated PR and issue before filing the next issue; for an existing queue, name only the next label candidate. Do not create new batch issues or parallel label requests.
Fleet rollouts explicitly cover level 0, level 1, and level 2 and track each target through installation, exact matrix validation, commit, push, and remote synchronization. Separate generated paths from unrelated work before staging. Migrate current normative six/seven references while preserving allowlisted history and compatibility aliases. Provider refusal, technical gate failure, and passing evidence are distinct; bypass is not technical proof.
- Community-/Katalog-Abstimmung läuft über
github/spec-kit#2362.
Standard preset set: security-governance v0.7.5 prio 10, architecture-governance v0.6.6 prio 20, isaqb-architecture-governance v0.2.6 prio 30, a11y-governance v0.4.7 prio 40, cross-platform-governance v0.2.6 prio 50, agent-parity-governance v0.4.6 prio 60, autonomous-run-governance v0.4.12 prio 70, and parallel-autonomous-run-governance v0.2.13 prio 80. a11y-governance v0.4.7 adds didactic inline-code-comment governance for new or changed non-trivial logic. architecture-governance v0.6.6 adds conditional BSI C3A cloud-autonomy evidence and BSI C5 cloud-compliance assurance evidence for cloud-service selection, provider dependencies, audit/assurance status, shared responsibility, and operational evidence. security-governance v0.7.5 keeps conditional AI-SBOM evidence, language-specific secure-coding profiles, and regulatory applicability screening for GDPR, NIS2, CRA, EU AI Act, and DORA: development-tool-only AI usage is N/A, AI runtime/product components require G7/BSI AI-SBOM cluster evidence, and record scoped legal applicability independently of educational purpose and AI-SBOM; unknown roles remain Open. All eight presets now include audit-ready Spec-Kit run evidence: Applicable / N/A / Open, rationale, evidence path, reviewer, residual risk, and follow-up must be documented for the current Spec-Kit run. The original six presets have been in the github/spec-kit community catalog since 2026-05-04, and autonomous-run-governance v0.2.2 was verified there on 2026-07-17. All eight are also published under https://github.com/hindermath/spec-kit-preset-*. parallel-autonomous-run-governance v0.2.13 was submitted to the community catalog as github/spec-kit#3591. Registered level-0, level-1, and level-2 repositories with Spec Kit default to all eight presets from scripts/config/spec-kit-governance-presets.json unless a justified exception is documented. Use install-spec-kit-governance-presets.* so preset versions stay centralized in the matrix. Commit .specify/presets/ and generated agent command updates when presets are project policy, but never commit .specify/presets/.cache/. Verify installs with specify preset list, specify preset info, and where relevant specify preset resolve. The published hindermath preset repositories are the sole product sources; develop and release changes in their own Git working clones. Home Baseline maintains profiles, pinned release references, and integrations. Source cleanup preserves the twelve deployed presets and existing assurance installations. Thorsten decides any further distribution of the thirteenth preset separately; catalog acceptance never grants rollout authority. Preset-rule changes and preset version/priority changes require reviewing the central matrix, constitution, README tables/install snippets, all agent guidance files, and relevant templates together. Community/catalog coordination happens in github/spec-kit#2362.
- Bash 3.x+ (macOS/Linux), PowerShell 7+ (Windows) + git ≥ 2.13 (required for
includeIf), gh CLI (existing dependency) (003-git-config-scope) - File system —
~/.gitconfig(INI),~/.gitconfig.d/*.inc(INI fragments) (003-git-config-scope) - Bash 3.x+ (macOS/Linux), PowerShell 7+ (Windows) +
ghCLI,glabCLI (optional),tar(built-in),git≥ 2.13 (005-workspace-teardown) - File system —
~/WorkspaceName/, remote repo,~/README.md,~/.gitignore,~/.gitconfig,~/.gitconfig.d/(005-workspace-teardown) - Bash 3.x+ (macOS/Linux) · PowerShell 7+ (Windows) +
glab≥ 1.40 (new),gh≥ 2.30,git≥ 2.30 (006-gitlab-support) - Existing script files plus
~/README.mdrow updates for GitHub/GitLab bootstrap flows (006-gitlab-support) - Bash 3.x+ (macOS/Linux), PowerShell 7+ (Windows) +
specifyCLI ≥ 0.8.3,git≥ 2.30 (008-spec-kit-update-automation)
- 003-git-config-scope: Git-Konfiguration Scope-Isolierung —
includeIf,~/.gitconfig.d/, bootstrap-workspace, sync-home, check-homogeneity, pre-push hook erweitert - 005-workspace-teardown:
teardown-workspace.sh/.ps1— Backup, Remote-Löschung (GitHub/GitLab auto-detected), lokale Löschung, Artefakt-Bereinigung;--teardown-Alias inbootstrap-workspace.*;--end-of-options für Workspace-Namen mit--Präfix - 006-gitlab-support: GitLab-CLI-Support für
bootstrap-workspace.*undbootstrap-project.*,--platform gitlab, Self-hosted--gitlab-url, bilinguale Fehlerpfade - 007-gitlab-release-automation:
setup-gitlab-release.*, GitLab-Release-Templates und non-blocking manuellerrelease-Job ergänzt; mit echten Releases insysinfotool(v0.1.0) undinventarworkerservice2(v0.0.1) validiert; Detached-HEAD- und CHANGELOG-Refresh-Fixes eingearbeitet - 008-spec-kit-update-automation: Added
update-spec-kit.*for dynamic Level-0/1/2 Spec-Kit refreshes, governance-template preservation, TuiVision inclusion, and.opencode/commandtracking
- Verbindliche Zielgruppen ab dem ersten Ausbildungsjahr sind Fachinformatikerinnen, IT-System-Elektronikerinnen, Kaufleute für IT-System-Management und Kaufleute für Digitalisierungsmanagement.
- Lern-, Bedien-, Governance- und Spec-Kit-Inhalte stehen auf Deutsch zuerst und Englisch danach, verwenden ungefähr CEFR B2 und erklären Fachbegriffe beim ersten Auftreten.
- Spec-Kit-Erfahrung wird nicht vorausgesetzt. Befehle, Artefakte, Zustände und Übergänge werden beim ersten Gebrauch verständlich eingeführt.
- Abhängigkeiten, Zustände und Entscheidungen erhalten eine vollständige textorientierte Erklärung; eine ausschließlich visuelle Darstellung genügt nicht.
Programmierung #include<everyone>und WCAG 2.2 Level AA gelten als verbindliche Prüfbasis, soweit die Kriterien auf das Artefakt anwendbar sind.
The binding audience starts in the first training year and includes IT
specialist apprentices, IT systems electronics technician apprentices, and
both IT management occupations. Learner, usage, governance, and Spec Kit
content is German-first/English-second at about CEFR B2, explains technical
terms at first use, assumes no prior Spec Kit experience, and never relies on
visual-only dependency, state, or decision information. Programmierung #include<everyone> and WCAG 2.2 Level AA are the review baseline wherever
applicable.
- Auf einem macOS-Entwicklungsrechner zuerst die passende lokale Safe-Mode-
Prüfung (
--check-only,--dry-run,-CheckOnlyoder-WhatIf) ausführen. - Fehlt ein nativer Linux-Host, Linux in einem isolierten nativen Container mit schreibgeschütztem Repository und ohne unnötiges Netzwerk oder in einem eng begrenzten nativen Linux-CI-Job prüfen.
- Fehlt ein nativer Windows-Host, einen eng begrenzten nativen Windows-CI-Job verwenden.
- Übertragbare Evidence bindet exakten Commit, Befehl, nativen Runner/die Plattform, Exitcode, Payload-SHA-256, Entscheidungs-SHA-256 und Nullschreibwerte. Fehlt eine Bindung, bleibt das Gate offen.
- Ein grüner Teilnachweis beweist nur den gebundenen Befehl. Er ist kein vollständiger Regressions-, Security-, A11Y-, Review- oder Delivery-Pass.
On a macOS development host, run the matching local safe mode first. If no native Linux host is available, use an isolated native container with a read-only repository and no unnecessary network, or a narrowly scoped native Linux CI job. If no native Windows host is available, use a narrowly scoped native Windows CI job. Portable evidence binds the exact commit, command, native runner/platform, exit code, payload SHA-256, decision SHA-256, and zero-write values; otherwise the gate remains open. A green partial proof establishes only its bound command and is not a full regression, security, accessibility, review, or delivery pass.
For additional context about technologies to be used, project structure, shell commands, and other important information, read the current plan
Neue Lastenhefte enthalten bei hilfreichen Abläufen, Zuständen oder Abhängigkeiten
lesbaren Mermaid-Quelltext im Markdown und eine gleichwertige Textalternative.
Bei einfachen Inhalten die Nichtanwendung kurz begründen. Diagramme bilden die
verbindlichen Text-/Manifestquellen ab; Farbe allein trägt keine Bedeutung.
Nach jedem vollständig abgeschlossenen Spec-Kit-Feature-Lauf den vollständigen
Ergebnisbericht im Chat anzeigen und im Feature-Verzeichnis als
completion-report.md versionieren. Einzelne Planungs-/Status-/Review-Kommandos
lösen keinen solchen Bericht aus; blockierte oder pausierte Läufe als
Zwischenbericht kennzeichnen. Vorlage: .specify/templates/completion-report-template.md;
Regel: docs/spec-kit-diagrams-and-completion-reports.md.
Ergebnis, Tests, Dokumentation, Git-gebundene Umfangszahlen, Verlauf und Restpunkte
belegen. Programmlogik von generierter Evidence, Git-Wandzeit von aktiver
Arbeitszeit und bestandene von ausgefallenen Prüfungen unterscheiden. Finale
Merge-/Sync-Evidence im Chat und bestehenden Closeout-Nachweis ergänzen; keine
zusätzlichen Commits allein für selbstreferenzielle Berichts-/Statistikwerte.
Diese Projektregel und lokale Vorlagen bei Spec-Kit-Updates erhalten.
New intakes use readable Mermaid Markdown and equivalent text alternatives for useful workflows, states or dependencies; justify omission for simple content. Diagrams reflect authoritative text/manifests and never rely on color alone. After each completed feature run, show the full outcome report in chat and version completion-report.md in the feature directory using the shared template and rule above. Individual planning/status/review commands do not trigger it; paused/blocked runs receive interim reports. Evidence outcomes, tests, docs, Git-bound counts, delivery history and remaining work. Distinguish code from volume generated as evidence, elapsed from active time, and passed from failed checks. Add final merge/sync proof in chat and existing closeout evidence, without commits solely for self-referential counts or IDs. Preserve local rules/templates across Spec Kit updates.
Dieses Projekt verwendet im ausdruecklich freigegebenen Profil das Profil
project-statistics-fourteen-governance-presets: unveraenderte 13er-Basis plus
project-statistics-governance v0.1.4, aktiviert mit Prioritaet 90.
Das Preset dient reproduzierbarer Projekttransparenz, nicht der Bewertung von
Lernenden, Qualitaet oder KI-Zeitersparnis. Die bestehende Statistik bleibt
kanonisch. Der kuenftige getrennte Kontext ist docs/project-statistics-pilot/;
Referenz-Modellrechnungen bleiben ausgeschaltet. Installation startet weder
Messung noch Spec-Kit-Feature und erteilt keine Commit-/Push-/Mergefreigabe.
Integrationsnachweis: docs/maintenance/project-statistics-installation-v010.md
relativ zur Repository-Wurzel. Kein impliziter Home-Runtime-Sync und keine globale
Default-Aenderung. Operative Profilzuordnung erst nach gepruefter Lieferung.
This project's explicitly authorized profile opts into fourteen presets: the unchanged thirteen-preset base plus Project Statistics Governance v0.1.2 at priority 90. It provides reproducible project transparency, not learner ratings, quality scores or AI time-savings measurements. Existing statistics remain canonical; the future pilot context is separate and reference estimates remain off. Installation starts no measurement or Spec Kit feature and grants no delivery authority. See the integration record relative to the repository root. No implicit Home Runtime sync or global default change; operational assignment follows reviewed delivery.
DE: Die urspruenglichen sechs Governance-Presets plus Secure Development Assurance werden am 3. Oktober jaehrlich geprueft; naechster Termin 2027-10-03, 10:00 Europe/Berlin. Anlasspruefungen verschieben den Termin nicht. Die Automation liest und berichtet nur; Aenderungen brauchen einen Auftrag. Lieferung: A Home Baseline/betroffene Home Runtime, B zwei je Vorhaben benannte public Level-2-Piloten, C restliche betroffene public Level-2-Verbraucher erst nach separatem Auftrag, D restliche betroffene Flotte nach erneutem Auftrag. Aktuelle Piloten: Show-CommandTui400 und TinyCalc. Keine implizite Flotten-, Werkzeuginstallations-, Produktlauf- oder Community-Autoritaet. Admin-Bypass nur nach erfolgreich abgeschlossenen technischen Checks des exakten Heads. EN: Review the original six governance presets plus Secure Development Assurance annually on 3 October; next due 2027-10-03 at 10:00 Europe/Berlin. Event reviews do not reset the date. Automation only reads and reports. Deliver central/runtime first, then two named public Level-2 pilots. Remaining public Level-2 consumers require a separate request; the remaining affected fleet requires another request. No implicit tool, product or community authority. See docs/maintenance/governance-review-and-rollout.md in the Level-0 source.
Show-CommandTui400 verwendet nach LH-01-Machbarkeit managed C#14 (eigener Code
MSL ohne unsafe), Host-.NET10/net10.0, Terminal.Gui2.5.0 mit explizitem dotnet-Treiber
und Mindest-PowerShell7.6.4. Runtime/OS/PInvoke/native Pakete bleiben getrennte
Vertrauensgrenzen. Die operative Registry führt C# und msl; Statistikreferenz
Thorsten-Solo125, konservativ80. Das explizite14er-Profil bleibt unverändert.
Die Auswahl ist keine Produkt-/Plattform-/A11Y-Abnahme oder Rolloutbefugnis.
LH-01 evidence selects managed C#14 for own memory-safe code, host .NET10, Terminal.Gui2.5.0 with explicit dotnet driver and minimum PowerShell7.6.4. Native and runtime trust boundaries remain separate. Use C#/msl metadata and80/125 statistics references, unchanged fourteen presets. Selection grants no product, platform, accessibility or fleet authority.
Bisherige macOS-14-Jobs verwenden explizit macos-15. Die bestehende
Repository-Auswahl fuer Linux-only-Wartungsjobs bleibt erhalten. Ein gruener
CI-Lauf beweist nur die ausgefuehrten Checks, keine Produkt-Plattformabnahme.
Bei Runnerwechseln auch verpflichtende Checknamen und Migrationsvorlagen
pruefen. Betrieb und Pruefgrenzen: docs/maintenance/macos-runner-migration.md.
Existing macOS 14 jobs explicitly use macos-15. Keep the existing repository
selection for Linux-only maintenance jobs. Successful CI proves the executed
checks, not product platform acceptance. Review required check names and
migration templates whenever runner labels change. See the linked guide.
DE: Die sechs Host-Toolchains C#/.NET, Go, Java/Javac, Python, Rust/Cargo und
Swift folgen den neuesten stabilen Hersteller-Releases einschliesslich neuer
Hauptversionen. CLI-Registry und Paketregister bestimmen Quellen und Zuordnung.
Paketstand, gestartete CLI und Herstellerstand werden getrennt geprueft.
--msl-only / -MslOnly begrenzt Wartung auf diese Toolchains und ihre
Abhaengigkeiten; zuerst Vergleich und Vorschau lesen. Paketquellen-Rueckstand,
PATH-Drift und unbekannte Aktualitaet bleiben Pflichtbefunde. Kein automatischer
Installer-Fallback. Swiftly verwaltet Swift-CLI auf macOS/Linux; Windows nutzt
WinGet. Apples Werkzeuge und Projekt-Pins bleiben eigenstaendige Vertraege.
Eine zentrale Skriptaenderung autorisiert keinen Lauf auf anderen Rechnern.
Details im Level-0-Klon: docs/maintenance/msl-toolchains.md.
EN: The six host toolchains follow the latest stable upstream releases,
including new major versions. CLI and package registries define sources and
mapping. Package, active CLI and upstream versions are checked separately.
Use --msl-only / -MslOnly for bounded maintenance after comparison and
preview. Package source lag, PATH drift and unknown currency remain required
findings; no automatic installer fallback. Swiftly manages Swift CLI on
macOS/Linux; Windows uses WinGet. Apple tools and project pins retain their
own contracts. Central script changes do not authorize runs on other hosts.
Read docs/maintenance/msl-toolchains.md in the Level-0 source clone.