docs: amend constitution to v1.13.0 for preset governance#24
Merged
hindermath merged 1 commit intomainfrom May 5, 2026
Merged
Conversation
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
This PR updates the repository’s governance baseline by amending the constitution to v1.13.0 and synchronizing the corresponding Spec-Kit templates, command templates, agent guidance surfaces, and the project statistics ledger so the new preset governance requirements are consistently captured across the repo.
Changes:
- Bump constitution/mirror to v1.13.0, adding cross-platform scripting discipline, stronger A11Y evidence expectations, CRA awareness, and general iSAQB/arc42 architecture governance.
- Expand Spec-Kit templates/command templates with new evidence prompts for A11Y, architecture, MSL, secure-coding language rules, and CRA applicability.
- Update agent guidance surfaces and
docs/project-statistics.mdto reflect the new governance/evidence paths.
Reviewed changes
Copilot reviewed 33 out of 33 changed files in this pull request and generated 14 comments.
Show a summary per file
| File | Description |
|---|---|
constitution.md |
Updates governance to v1.13.0 incl. A11Y evidence routing, scripting discipline, CRA awareness, and general architecture governance. |
.specify/memory/constitution.md |
Mirrors constitution.md v1.13.0 to keep Spec-Kit memory in sync. |
AGENTS.md |
Syncs agent guidance with new architecture governance + expanded security documentation list. |
CLAUDE.md |
Syncs agent guidance with new architecture governance + expanded security documentation list. |
GEMINI.md |
Syncs agent guidance with new architecture governance + expanded security documentation list. |
.github/copilot-instructions.md |
Syncs Copilot guidance with new architecture governance + expanded security documentation list. |
docs/project-statistics.md |
Advances the ledger date and records the governance/template sync as a new entry. |
.specify/templates/plan-template.md |
Adds planning prompts for general architecture evidence, CRA/MSL, and A11Y evidence/code-block tagging. |
.specify/templates/spec-template.md |
Adds constitution requirements for iSAQB/arc42 evidence, code-block language tags, and CRA evidence path. |
.specify/templates/tasks-template.md |
Adds foundational tasks for A11Y evidence, code-block tagging checks, CRA/MSL evidence, architecture evidence, and script parity evidence. |
.specify/templates/commands/constitution.md |
Ensures constitution updates include preset-provided evidence templates and applicability markings. |
.specify/templates/commands/spec.md |
Expands spec command guidance to include A11Y evidence, architecture evidence, and CRA/MSL/supply-chain impacts. |
.specify/templates/commands/plan.md |
Expands plan command guidance to include A11Y/code-block tagging, architecture evidence, and CRA/MSL/supply-chain scope. |
.specify/templates/commands/tasks.md |
Expands tasks command guidance to include A11Y, security, and architecture evidence tasks. |
.specify/templates/a11y-checklist-template.md |
Introduces a WCAG 2.2 AA checklist template. |
.specify/templates/a11y-evidence-template.md |
Introduces an accessibility evidence record template. |
.specify/templates/cli-a11y-review-template.md |
Introduces a CLI-specific accessibility review template. |
.specify/templates/bilingual-content-check-template.md |
Introduces a bilingual content/orthography equivalence checklist template. |
.specify/templates/agent-parity-checklist-template.md |
Introduces an agent-surface parity checklist template. |
.specify/templates/man-page-template.md |
Introduces a Unix man-page template for script-shaped tools. |
.specify/templates/powershell-help-template.md |
Introduces a PowerShell comment-based help template (bilingual). |
.specify/templates/script-parity-checklist-template.md |
Introduces a script parity checklist template (Bash/PowerShell equivalence + docs). |
.specify/templates/architecture-vision-template.md |
Introduces an architecture vision template. |
.specify/templates/context-view-template.md |
Introduces an arc42-style context view template. |
.specify/templates/building-block-view-template.md |
Introduces an arc42-style building-block view template. |
.specify/templates/runtime-view-template.md |
Introduces a runtime view template. |
.specify/templates/deployment-view-template.md |
Introduces a deployment view template. |
.specify/templates/architecture-decision-template.md |
Introduces a general architecture ADR template. |
.specify/templates/architecture-risks-template.md |
Introduces an architecture risks/technical debt template. |
.specify/templates/quality-scenarios-template.md |
Introduces a quality scenarios template to capture measurable quality attributes. |
.specify/templates/msl-applicability-template.md |
Introduces an MSL applicability record template aligned with Principle XI. |
.specify/templates/secure-coding-language-rules-template.md |
Introduces a language-specific secure-coding evidence template. |
.specify/templates/cra-applicability-template.md |
Introduces a CRA applicability record template aligned with Principle XIX. |
| ## Allgemeine Architektur-Governance / General Architecture Governance | ||
|
|
||
| - Struktur-, Schnittstellen-, Qualitätsattribut-, Laufzeit-, Deployment- oder Wartbarkeitsänderungen müssen iSAQB/arc42-Architekturevidenz prüfen. | ||
| - Standardpfad: `docs/architecture/`; ADRs fuer allgemeine Architekturentscheidungen liegen unter `docs/architecture/adr/`. |
| - Verfügbare Templates: `architecture-vision-template.md`, `context-view-template.md`, `building-block-view-template.md`, `runtime-view-template.md`, `deployment-view-template.md`, `architecture-decision-template.md`, `architecture-risks-template.md`, `quality-scenarios-template.md`. | ||
|
|
||
| *Structural, interface, quality-attribute, runtime, deployment, or maintainability changes must evaluate iSAQB/arc42 architecture evidence. Default path: `docs/architecture/`; general architecture ADRs live under `docs/architecture/adr/`. Use the matching templates when the artefact applies.* | ||
| ## Sicherheitsdokumentation / Security Documentation (XII–XVIII Extensions) |
| - Bei Release-/Artefakt-Arbeit `SBOM`, `VEX`, Provenance/SLSA-Nachweise und gegebenenfalls `OpenSSF Scorecard` in Release- oder Sicherheitsdokumentation einplanen. | ||
| - Bei Architekturänderungen `Zero Trust`-Anwendbarkeit und bei langlebigen Projekten `SAMM`-Folgeaktionen prüfen. | ||
| - Bei allgemeinen Architekturänderungen iSAQB/arc42-Evidenz unter `docs/architecture/` prüfen. | ||
| - Bei A11Y-relevanten Artefakten `docs/accessibility/`-Evidenz und Sprach-Tags fuer Markdown-Codebloecke pruefen. |
| ## Allgemeine Architektur-Governance / General Architecture Governance | ||
|
|
||
| - Struktur-, Schnittstellen-, Qualitätsattribut-, Laufzeit-, Deployment- oder Wartbarkeitsänderungen müssen iSAQB/arc42-Architekturevidenz prüfen. | ||
| - Standardpfad: `docs/architecture/`; ADRs fuer allgemeine Architekturentscheidungen liegen unter `docs/architecture/adr/`. |
| - Verfügbare Templates: `architecture-vision-template.md`, `context-view-template.md`, `building-block-view-template.md`, `runtime-view-template.md`, `deployment-view-template.md`, `architecture-decision-template.md`, `architecture-risks-template.md`, `quality-scenarios-template.md`. | ||
|
|
||
| *Structural, interface, quality-attribute, runtime, deployment, or maintainability changes must evaluate iSAQB/arc42 architecture evidence. Default path: `docs/architecture/`; general architecture ADRs live under `docs/architecture/adr/`. Use the matching templates when the artefact applies.* | ||
| ## Sicherheitsdokumentation / Security Documentation (XII–XVIII Extensions) |
| ## Allgemeine Architektur-Governance / General Architecture Governance | ||
|
|
||
| - Struktur-, Schnittstellen-, Qualitätsattribut-, Laufzeit-, Deployment- oder Wartbarkeitsänderungen müssen iSAQB/arc42-Architekturevidenz prüfen. | ||
| - Standardpfad: `docs/architecture/`; ADRs fuer allgemeine Architekturentscheidungen liegen unter `docs/architecture/adr/`. |
| - Verfügbare Templates: `architecture-vision-template.md`, `context-view-template.md`, `building-block-view-template.md`, `runtime-view-template.md`, `deployment-view-template.md`, `architecture-decision-template.md`, `architecture-risks-template.md`, `quality-scenarios-template.md`. | ||
|
|
||
| *Structural, interface, quality-attribute, runtime, deployment, or maintainability changes must evaluate iSAQB/arc42 architecture evidence. Default path: `docs/architecture/`; general architecture ADRs live under `docs/architecture/adr/`. Use the matching templates when the artefact applies.* | ||
| ## Sicherheitsdokumentation / Security Documentation (XII–XVIII Extensions) |
| - Bei Release-/Artefakt-Arbeit `SBOM`, `VEX`, Provenance/SLSA-Nachweise und gegebenenfalls `OpenSSF Scorecard` in Release- oder Sicherheitsdokumentation einplanen. | ||
| - Bei Architekturänderungen `Zero Trust`-Anwendbarkeit und bei langlebigen Projekten `SAMM`-Folgeaktionen prüfen. | ||
| - Bei allgemeinen Architekturänderungen iSAQB/arc42-Evidenz unter `docs/architecture/` prüfen. | ||
| - Bei A11Y-relevanten Artefakten `docs/accessibility/`-Evidenz und Sprach-Tags fuer Markdown-Codebloecke pruefen. |
| | 2026-04-19 | Dritter Docs-Hotfix fuer DocFX-Theme-A11Y | Der Pages-Workflow bekam einen gezielten Nachbearbeitungsschritt fuer generierte DocFX-Ausgabe: `.github/scripts/postprocess-docfx-site.sh` setzt ein `lang="de"` auf allen HTML-Seiten, markiert das Navbar-Logo als dekorativ statt mit redundantem Alternativtext und entfernt das unzulaessige `aria-expanded` sowohl aus statischem HTML als auch aus dem generierten `public/docfx.min.js`, das den Theme-Dropdown zur Laufzeit rendert. Direkt danach prueft der Workflow mit `rg`, dass weder in `_site` noch im ausgelieferten DocFX-JavaScript ungepatchte Muster verbleiben, bevor `lynx` und Playwright/Axe laufen. Sichtbares Zusatzvolumen dieser Runde: ca. `+20` Workflow-/Skriptzeilen sowie `+1` Statistikzeile netto. Konservative Manualreferenz: grob `21 / 80 = 0.3` Arbeitstage bzw. `2.0` Stunden; Thorsten-Solo-Referenz: `21 / 100 = 0.2` Arbeitstage bzw. `1.6` Stunden; sichtbares Arbeitsfenster: fortgesetzte agentische Sitzung am 2026-04-19. | | ||
| | 2026-04-19 | Pages-Hotfix und Auto-Merge aktiviert | Nach dem Merge von PR `#19` schlug der neue Docs-Workflow im Schritt `Axe smoke check` fehl, weil das temporaer unter `/tmp` abgelegte Node-Skript die lokal installierten Pakete `@playwright/test` und `@axe-core/playwright` nicht aufloesen konnte. Der Workflow wurde deshalb so nachgebessert, dass das Smoke-Skript im Repository-Workspace erzeugt und nach dem Lauf wieder entfernt wird. Parallel wurde die globale Repository-Einstellung `allow_auto_merge` per GitHub-API auf `true` gesetzt, damit kuenftige PRs bei passenden Schutzregeln automatisch gemerged werden koennen. Sichtbares Zusatzvolumen dieser Runde: ca. `+5` Produktions-/Konfigurationszeilen netto im Workflow plus `+1` Dokumentationszeile netto in diesem Ledger. Konservative Manualreferenz: grob `6 / 80 = 0.1` Arbeitstage bzw. `0.6` Stunden; Thorsten-Solo-Referenz: `6 / 100 = 0.1` Arbeitstage bzw. `0.5` Stunden; sichtbares Arbeitsfenster: fortgesetzte agentische Sitzung am 2026-04-19. | | ||
| | 2026-04-19 | Zweiter Docs-Hotfix fuer Axe/Playwright-Kontext | Der erste Workflow-Hotfix beseitigte zwar das Paketauflösungsproblem, der folgende Lauf scheiterte aber erneut daran, dass `@axe-core/playwright` nicht mit `browser.newPage()` betrieben werden darf. Der Smoke-Test verwendet jetzt explizit `browser.newContext()` und erzeugt die Seite daraus, bevor `AxeBuilder` ausgeführt wird. Sichtbares Zusatzvolumen dieser Runde: ca. `+3` Produktions-/Konfigurationszeilen netto im Workflow plus `+1` Dokumentationszeile netto in diesem Ledger. Konservative Manualreferenz: grob `4 / 80 = 0.1` Arbeitstage bzw. `0.4` Stunden; Thorsten-Solo-Referenz: `4 / 100 = 0.0` Arbeitstage bzw. `0.3` Stunden; sichtbares Arbeitsfenster: fortgesetzte agentische Sitzung am 2026-04-19. | | ||
| | 2026-05-05 | Spec-Kit-Preset-Governance auf Constitution v1.13.0 synchronisiert | Nach der Integration der sechs Spec-Kit-Presets (`a11y-governance`, `agent-parity-governance`, `architecture-governance`, `cross-platform-governance`, `isaqb-architecture-governance`, `security-governance`) wurden `constitution.md`, `.specify/memory/constitution.md`, die Spec-Kit-Plan-/Spec-/Tasks-/Command-Templates sowie die vier Agentenflaechen synchronisiert. Neu erfasst sind iSAQB/arc42-Architekturevidenz unter `docs/architecture/`, A11Y-Evidenz unter `docs/accessibility/`, sprachgetaggte Markdown-Codebloecke, CRA-/MSL-/Secure-Coding-Evidenz und Cross-Platform-/Agent-Parity-Templates. Sichtbares Zusatzvolumen vor dieser Ledger-Zeile: ca. `+1269` Dokumentations-/Template-Zeilen netto, `0` Produktionscode-Zeilen und `0` Testcode-Zeilen. Konservative Manualreferenz: `1269 / 80 = 15.9` Arbeitstage bzw. `123.8` Stunden; Thorsten-Solo-Referenz: `1269 / 100 = 12.7` Arbeitstage bzw. `99.0` Stunden; sichtbares Arbeitsfenster: 1 agentische Governance-Sitzung am 2026-05-05. | |
Comment on lines
+17
to
+19
| checklist. It is referenced from `tasks-template` for any change that | ||
| touches input handling, authentication, authorisation, cryptography, | ||
| file I/O, or network I/O. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Purpose
Synchronize the project constitution and Spec-Kit templates after integrating the six governance presets.
Touched projects / areas
constitution.md,.specify/memory/constitution.mdAGENTS.md,CLAUDE.md,GEMINI.md,.github/copilot-instructions.mddocs/project-statistics.mdTest evidence
git diff --checkconstitution.mdand.specify/memory/constitution.mdare identicalConfig/API impact
Documentation and governance templates only; no runtime config or API behavior change.