docs: expand preset README guidance

Author: hindermath

specs/spec-kit-preset-repos/spec-kit-preset-a11y-governance/README.md

@@ -4,31 +4,122 @@ Version: `0.4.0`
 Status: published, standard governance preset
 Priority: `40`
 Requires: Spec-Kit `>=0.8.0` (uses the `wrap` and `append` composition
-strategies introduced in 0.8.x).
+strategies introduced in `0.8.x`).
 
 ## Zweck / Purpose
 
-- inject accessibility, bilingual-delivery, and CEFR-B2 readability
-  expectations into Spec-Kit
-- make didactic inline-code-comment review explicit for new or changed
-  non-trivial logic
-- preserve the `Programmierung #include<everyone>` principle as a
-  reusable preset instead of a local-only policy
+Dieses Standard-Preset bringt Barrierefreiheit, DE-first/EN-second
+Auslieferung, CEFR-B2-Lesbarkeit und didaktische Inline-Kommentarprüfung in
+Spec-Kit-Workflows. Es macht `Programmierung #include<everyone>` als
+wiederverwendbare Governance sichtbar, statt diese Regel nur lokal in einem
+Repository zu halten.
+
+*This standard preset injects accessibility, DE-first/EN-second delivery,
+CEFR-B2 readability, and didactic inline-comment review into Spec-Kit
+workflows. It preserves `Programmierung #include<everyone>` as reusable
+governance instead of keeping it as a local-only policy.*
+
+Das Qualitätsziel ist, dass nutzerseitige Artefakte auch mit Tastatur,
+Screenreader, Braille-Zeile, Textbrowser und klarer Sprache nutzbar bleiben.
+Das gilt für CLI-Ausgaben, Dokumentation, HTML, UI und generierte Templates.
+
+*The quality goal is that user-facing artifacts remain usable with keyboard,
+screen readers, Braille displays, text browsers, and clear language. This
+applies to CLI output, documentation, HTML, UI, and generated templates.*
+
+## Zielgruppen / Audience
+
+Dieses Preset eignet sich, wenn:
+
+- ein Projekt nutzerseitige CLI-, Dokumentations-, HTML-, UI- oder
+  Template-Artefakte erzeugt;
+- Lernende, Fachinformatiker*innen, KDM oder KITSM mit verständlichen
+  DE-first/EN-second Materialien arbeiten sollen;
+- WCAG 2.2 Level AA und CEFR B2 früh in Spec, Plan und Tasks sichtbar sein
+  sollen;
+- nicht-triviale Logik didaktische Kommentare braucht, damit Wartung und
+  Ausbildung nicht am Codeverständnis scheitern.
+
+*Use this preset for user-facing CLI, documentation, HTML, UI, or template
+artifacts; for DE-first/EN-second learning material; when WCAG 2.2 Level AA
+and CEFR B2 should be visible early in specs, plans, and tasks; and when
+non-trivial logic needs didactic comments for maintainability and learning.*
+
+## Lieferumfang / What It Provides
+
+- Addenda für Constitution, Spec, Plan, Tasks und Agent-Guidance
+- Wrapper für `speckit.specify`, `speckit.plan` und `speckit.tasks`
+- Templates für A11Y-Review, bilinguale Inhaltsprüfung, CLI-A11Y,
+  A11Y-Evidence und didaktische Code-Kommentarprüfung
+- auditfähige Spec-Kit-Run-Evidence-Felder für Anwendbarkeit, N/A-Begründung,
+  Reviewer, Evidence-Pfad, Restrisiko und Follow-up
+
+*The preset provides addenda for the main Spec-Kit artifacts and agent
+guidance, wraps the normal Specify/Plan/Tasks flow, and supplies templates for
+accessibility review, bilingual content checks, CLI accessibility, evidence,
+and didactic code-comment review.*
+
+## Nicht enthalten / What It Does Not Provide
+
+Das Preset führt keine Accessibility-Scanner, Screenreader-Tests,
+Übersetzungsprüfung oder UI-Automation selbst aus. Es ersetzt keine Prüfung
+durch betroffene Nutzergruppen und erteilt keine Repository-, Merge-,
+Deployment- oder Provider-Administrationsrechte.
+
+*The preset does not run accessibility scanners, screen-reader tests,
+translation review, or UI automation by itself. It does not replace review
+with affected user groups and grants no repository, merge, deployment, or
+provider-administration authority.*
+
+## Voraussetzungen / Prerequisites
+
+1. kompatible GitHub Spec Kit CLI;
+2. gültige Spec-Kit-Integration im Ziel-Repository;
+3. versionierte Constitution und Agent-Guidance;
+4. geklärter Evidence-Ort, standardmäßig `docs/accessibility/`;
+5. bekannte Zielgruppen, Artefakttypen und Sprachebene.
+
+*Before installation, use a compatible GitHub Spec Kit CLI, a valid Spec-Kit
+integration, versioned constitution and agent guidance, a clear evidence
+location, and known target audiences, artifact types, and language level.*
 
 ## Installation / Install
 
+### Veröffentlichter Tag / Published Tag
+
 ```bash
 specify preset add \
   --from https://github.com/hindermath/spec-kit-preset-a11y-governance/archive/refs/tags/v0.4.0.zip \
   --priority 40
 specify preset info a11y-governance
 ```
 
+### Entwicklungs-Checkout / Development Checkout
+
 ```bash
 specify preset add --dev /path/to/a11y-governance --priority 40
 specify preset info a11y-governance
 ```
 
+### Empfohlene Kombination / Recommended Composition
+
+| Priority | Preset |
+|---:|---|
+| 10 | `security-governance` |
+| 20 | `architecture-governance` |
+| 30 | `isaqb-architecture-governance` |
+| 40 | `a11y-governance` |
+| 50 | `cross-platform-governance` |
+| 60 | `agent-parity-governance` |
+
+Dieses Preset liegt nach Security und Architektur, damit nutzerseitige
+Artefakte, Dokumentation, Templates und Lernmaterialien in der gleichen
+Spec-Kit-Komposition geprüft werden.
+
+*This preset runs after security and architecture so user-facing artifacts,
+documentation, templates, and learning material are checked in the same
+Spec-Kit composition.*
+
 ## Quellkapitel / Source Chapters
 
 - `VII. Programmierung #include<everyone> — Inclusion & Accessibility By
@@ -76,6 +167,21 @@ specify preset info a11y-governance
 
 Default evidence location: `docs/accessibility/`.
 
+## Prüfung / Verification
+
+```bash
+specify preset list
+specify preset info a11y-governance
+specify preset resolve
+specify check
+```
+
+Prüfe zusätzlich, ob nutzerseitige Artefakte im Plan benannt sind und ob N/A
+für WCAG, Bilingualität oder CEFR B2 begründet wurde.
+
+*Also verify that user-facing artifacts are named in the plan and that N/A
+decisions for WCAG, bilingual delivery, or CEFR B2 are justified.*
+
 ## Einsatz / When to Use
 
 - any project that produces user-facing `CLI`, `documentation`, `HTML`,
@@ -90,6 +196,24 @@ Default evidence location: `docs/accessibility/`.
 - purely internal artefacts with no user-facing surface at all
 - teams that do not want DE-first / EN-second guidance
 
+## Fehlersuche / Troubleshooting
+
+### Kein UI vorhanden / No UI Exists
+
+Prüfe CLI-Ausgaben, Dokumentation und Templates trotzdem. Diese Artefakte sind
+nutzerseitig, wenn Menschen sie lesen, bedienen oder bearbeiten.
+
+### N/A ist zu pauschal / N/A Is Too Broad
+
+Trenne Artefakttypen. Ein Projekt ohne HTML-UI kann trotzdem CLI- und
+Dokumentations-A11Y brauchen.
+
+### Kommentare fehlen / Comments Are Missing
+
+Bewerte nicht jede öffentliche Funktion mechanisch gleich. Kommentare sind
+erforderlich, wenn nicht-triviale Logik, Lernkontext, Randbedingungen oder
+Trade-offs sonst schwer verständlich bleiben.
+
 ## Sicherheit und Grenzen / Safety and Boundaries
 
 - Installation adds governance prompts, templates, and wrapped Spec-Kit
@@ -112,3 +236,16 @@ Default evidence location: `docs/accessibility/`.
   documents and checklists can record applicability, N/A rationale, reviewer,
   evidence path, residual risk, and follow-up per standards-relevant Spec-Kit
   run.
+
+## Kompatibilitäts- und Sicherheitsübersicht / Compatibility and Safety Summary
+
+- kompatibel mit Spec-Kit `>=0.8.0`
+- priorisiert als Stufe `40`
+- deckt CLI, Dokumentation, HTML, UI und generierte Templates ab
+- keine automatischen Scanner-, Remote-, Merge- oder Provider-Aktionen
+- WCAG-, CEFR-, Bilingualitäts- und Kommentarentscheidungen bleiben
+  projektbezogene Evidence
+
+## License
+
+MIT. See `LICENSE`.