Skip to content

Commit f6df40c

Browse files
committed
docs: propagate spec-kit preset governance
1 parent ec007ed commit f6df40c

12 files changed

Lines changed: 217 additions & 2 deletions

.github/copilot-instructions.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -270,6 +270,22 @@ Diese Regeln gelten für alle Repositories in diesem Workspace. Projektspezifisc
270270

271271
*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. For release and artefact work, plan `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`, and `docs/security/samm-assessment.md`, unless the repository documents a justified equivalent location.*
272272

273+
## Spec-Kit-Preset-Pflege / Spec Kit Preset Maintenance
274+
275+
- Standard-Preset-Set: `security-governance` v0.2.0 prio 10, `architecture-governance` v0.2.0 prio 20, `isaqb-architecture-governance` v0.1.0 prio 30, `a11y-governance` v0.2.0 prio 40, `cross-platform-governance` v0.1.0 prio 50, `agent-parity-governance` v0.1.0 prio 60.
276+
- Alle sechs Presets sind seit 2026-05-04 im `github/spec-kit` Community-Katalog enthalten und liegen zusätzlich als veröffentlichte Repos unter `https://github.com/hindermath/spec-kit-preset-*`.
277+
- Neue Level-2-Projekte SOLLEN bei der Spec-Kit-Initialisierung die passende Preset-Teilmenge installieren; C#/.NET-Level-2-Projekte verwenden standardmäßig alle sechs Presets, sofern keine begründete Ausnahme dokumentiert ist.
278+
- Referenz-Rollout für alle sechs Presets: `RiderProjects/TinyPl0`, `RiderProjects/TinyCalc`, `RiderProjects/TuiVision`, `RiderProjects/InventarWorkerService`.
279+
- Installation bevorzugt über den Community-Katalog, wenn `specify` das unterstützt; für reproduzierbare Pins die versionierten GitHub-ZIP-URLs aus `constitution.md`/`README.md` verwenden.
280+
- `.specify/presets/` und generierte Agenten-/Command-Dateien committen, wenn Presets Projekt-Policy sind; `.specify/presets/.cache/` nie committen.
281+
- Nach Installation oder Update prüfen: `specify preset list`, mindestens ein `specify preset info <id>`, bei Template-Fragen zusätzlich `specify preset resolve <template>`.
282+
- Die lokale Arbeitskopie der veröffentlichten Preset-Repos liegt unter `~/SpecKitPresetProjects/`; kanonische Scaffolds liegen im Level-0-Repo unter `specs/spec-kit-presets/` und `specs/spec-kit-preset-repos/`.
283+
- Verbesserungen an Presets zuerst im Level-0-Scaffold einarbeiten, dann in die passenden Repos unter `~/SpecKitPresetProjects/` übertragen, committen, pushen und mit GitHub-ZIP-URL smoke-testen.
284+
- Bei Änderungen an Preset-Regeln immer prüfen, ob `constitution.md`, `.specify/memory/constitution.md`, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md` und relevante Templates ebenfalls aktualisiert werden müssen.
285+
- Community-/Katalog-Abstimmung läuft über `github/spec-kit#2362`.
286+
287+
*Standard preset set: `security-governance` v0.2.0 prio 10, `architecture-governance` v0.2.0 prio 20, `isaqb-architecture-governance` v0.1.0 prio 30, `a11y-governance` v0.2.0 prio 40, `cross-platform-governance` v0.1.0 prio 50, and `agent-parity-governance` v0.1.0 prio 60. All six presets are in the `github/spec-kit` community catalog as of 2026-05-04 and are also published under `https://github.com/hindermath/spec-kit-preset-*`. New Level-2 projects should install the applicable subset; C#/.NET Level-2 projects default to all six unless a justified exception is documented. 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`. Preset-rule changes require reviewing constitution, all agent guidance files, and relevant templates. Community/catalog coordination happens in `github/spec-kit#2362`.*
288+
273289
<!-- SPECKIT START -->
274290
For additional context about technologies to be used, project structure,
275291
shell commands, and other important information, read the current plan

.gitignore

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -862,3 +862,9 @@ modules.xml
862862
.junie/memory/
863863
.junie/.onboarding_migrated
864864
.opencode/node_modules/
865+
866+
# Spec-Kit Presets (Policy-Dateien tracken, lokalen Cache ignorieren)
867+
!.specify/presets/
868+
!.specify/presets/**
869+
.specify/presets/.cache/
870+
.specify/presets/.cache/**

.specify/memory/constitution.md

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -903,11 +903,51 @@ Any expansion of the surgical subdirectory exception (Principle I) MUST include
903903
a security justification confirming no credentials are present in the newly
904904
allowed path.
905905

906+
**Spec Kit preset governance**: The standard governance preset set for this
907+
workspace family consists of:
908+
909+
| Preset | Version | Priority | Scope |
910+
|---|---:|---:|---|
911+
| `security-governance` | `v0.2.0` | `10` | secure development, MSL, SSDF, ASVS, SBOM/VEX/SLSA, CRA awareness |
912+
| `architecture-governance` | `v0.2.0` | `20` | secure architecture, STRIDE/CAPEC, Zero Trust, SAMM, S-ADR |
913+
| `isaqb-architecture-governance` | `v0.1.0` | `30` | general iSAQB/arc42 architecture governance |
914+
| `a11y-governance` | `v0.2.0` | `40` | WCAG 2.2 AA, bilingual DE/EN, CEFR B2, inclusive artefacts |
915+
| `cross-platform-governance` | `v0.1.0` | `50` | Bash/PowerShell parity, macOS/Linux/Windows script governance |
916+
| `agent-parity-governance` | `v0.1.0` | `60` | synchronized agent guidance across declared AI-agent files |
917+
918+
All six presets are published as standalone repositories under
919+
`https://github.com/hindermath/spec-kit-preset-*` and are included in the
920+
`github/spec-kit` community preset catalog as of 2026-05-04. New Level-2
921+
projects SHOULD install the applicable subset during Spec-Kit initialization.
922+
For C#/.NET Level-2 projects, the default subset is all six presets unless the
923+
project documents a narrow reason to omit one. Existing C# Level-2 projects
924+
`RiderProjects/TinyPl0`, `RiderProjects/TinyCalc`, `RiderProjects/TuiVision`,
925+
and `RiderProjects/InventarWorkerService` are the reference rollout set for
926+
all-six installation.
927+
928+
Use the community catalog when supported by the local `specify` CLI. Use
929+
versioned GitHub ZIP URLs when a reproducible release pin is required. Commit
930+
`.specify/presets/` and all generated agent-command updates when presets are
931+
project policy. Do not commit `.specify/presets/.cache/`. Preset updates MUST
932+
be verified with `specify preset list`, at least one `specify preset info`, and
933+
where relevant `specify preset resolve`.
934+
935+
Local working clones of the published preset repositories live under
936+
`~/SpecKitPresetProjects/`. Canonical scaffolds in this repository live under
937+
`specs/spec-kit-presets/` and `specs/spec-kit-preset-repos/`. Preset
938+
improvements SHOULD be made in the home-baseline scaffold first, propagated to
939+
the affected standalone preset repositories, committed, pushed, and smoke-tested
940+
via the GitHub ZIP URL before use in dependent projects. Preset-rule changes
941+
MUST review whether `constitution.md`, `.specify/memory/constitution.md`,
942+
`AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, and
943+
the relevant templates under `scripts/templates/` need matching updates.
944+
Community/catalog coordination is tracked in `github/spec-kit#2362`.
945+
906946
**Runtime guidance**: Use `AGENTS.md` / `CLAUDE.md` / `GEMINI.md` /
907947
`.github/copilot-instructions.md` for per-agent operational guidance. This
908948
constitution is the authoritative policy layer above all agent-specific files.
909949

910-
**Version**: 1.13.0 | **Ratified**: 2026-03-31 | **Last Amended**: 2026-05-05
950+
**Version**: 1.13.0 | **Ratified**: 2026-03-31 | **Last Amended**: 2026-05-06
911951

912952
<!-- EN: constitution.md placeholder
913953
[DE-Zusammenfassung: constitution.md beschreibt die Prinzipien und Standards für alle home-baseline Workspaces.]

.specify/templates/agent-file-template.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,5 +24,14 @@ Auto-generated from all feature plans. Last updated: [DATE]
2424

2525
[LAST 3 FEATURES AND WHAT THEY ADDED]
2626

27+
## Spec-Kit Governance Presets
28+
29+
If this project installs governance presets, keep this section synchronized
30+
with `.specify/presets/` and generated agent command files. C#/.NET Level-2
31+
projects default to all six home-baseline presets unless a justified exception
32+
is documented: `security-governance`, `architecture-governance`,
33+
`isaqb-architecture-governance`, `a11y-governance`,
34+
`cross-platform-governance`, and `agent-parity-governance`.
35+
2736
<!-- MANUAL ADDITIONS START -->
2837
<!-- MANUAL ADDITIONS END -->

.specify/templates/constitution-template.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,19 @@
4040
[SECTION_3_CONTENT]
4141
<!-- Example: Code review requirements, testing gates, deployment approval process, etc. -->
4242

43+
## Spec-Kit Presets
44+
45+
<!--
46+
If this project uses Spec-Kit governance presets, list the installed presets,
47+
versions, priorities, and evidence paths here. The home-baseline default set is:
48+
security-governance v0.2.0 prio 10, architecture-governance v0.2.0 prio 20,
49+
isaqb-architecture-governance v0.1.0 prio 30, a11y-governance v0.2.0 prio 40,
50+
cross-platform-governance v0.1.0 prio 50, agent-parity-governance v0.1.0 prio 60.
51+
C#/.NET Level-2 projects default to all six unless a justified exception is documented.
52+
-->
53+
54+
[SPEC_KIT_PRESET_POLICY]
55+
4356
## Governance
4457
<!-- Example: Constitution supersedes all other practices; Amendments require documentation, approval, migration plan -->
4558

.specify/templates/plan-template.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,12 @@
7777
`docs/security/zero-trust-applicability.md`, and
7878
`docs/security/samm-assessment.md`. If the repository uses an equivalent
7979
governance location, state that path explicitly and justify the deviation.
80+
- **Spec-Kit presets**: List installed governance presets and confirm their
81+
applicability. For C#/.NET Level-2 projects, default to all six
82+
home-baseline presets (`security-governance`, `architecture-governance`,
83+
`isaqb-architecture-governance`, `a11y-governance`,
84+
`cross-platform-governance`, `agent-parity-governance`) unless a justified
85+
exception is documented.
8086
- **Security-first**: Confirm no credential files, agent state, logs, history,
8187
or SQLite state are planned for tracking.
8288
- **Inclusion/A11Y**: Identify affected user-facing artefacts and the WCAG 2.2

.specify/templates/tasks-template.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -152,6 +152,7 @@ Examples of foundational tasks (adjust based on your project):
152152

153153
- [ ] TXXX [P] Documentation updates in docs/
154154
- [ ] TXXX [P] Verify the implementation against the matching Level-2 Project Environment Registry row in `constitution.md`
155+
- [ ] TXXX [P] Verify installed Spec-Kit governance presets with `specify preset list`; for C#/.NET Level-2 projects confirm the all-six default or document the justified exception
155156
- [ ] TXXX [P] Verify primary implementation language against the MSL allow-list in `constitution.md`, Principle XI; cite the Level-2 non-MSL justification if applicable
156157
- [ ] TXXX [P] Run the required A11Y/text-first review path for affected user-facing artefacts
157158
- [ ] TXXX [P] If user-facing CLI, documentation, HTML, UI, generated templates, error messages, or changelogs changed, update accessibility evidence in `docs/accessibility/` using the installed A11Y templates or justify an equivalent path

AGENTS.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -203,6 +203,23 @@ For contributions:
203203
- Default-Evidenzpfad: `docs/security/asvs-verification.md`, `docs/security/supply-chain-evidence.md`, `docs/security/zero-trust-applicability.md`, `docs/security/samm-assessment.md`; Abweichungen nur mit lokal dokumentierter Begründung.
204204

205205
*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. For release and artefact work, plan `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`, and `docs/security/samm-assessment.md`, unless the repository documents a justified equivalent location.*
206+
207+
## Spec-Kit-Preset-Pflege / Spec Kit Preset Maintenance
208+
209+
- Standard-Preset-Set: `security-governance` v0.2.0 prio 10, `architecture-governance` v0.2.0 prio 20, `isaqb-architecture-governance` v0.1.0 prio 30, `a11y-governance` v0.2.0 prio 40, `cross-platform-governance` v0.1.0 prio 50, `agent-parity-governance` v0.1.0 prio 60.
210+
- Alle sechs Presets sind seit 2026-05-04 im `github/spec-kit` Community-Katalog enthalten und liegen zusätzlich als veröffentlichte Repos unter `https://github.com/hindermath/spec-kit-preset-*`.
211+
- Neue Level-2-Projekte SOLLEN bei der Spec-Kit-Initialisierung die passende Preset-Teilmenge installieren; C#/.NET-Level-2-Projekte verwenden standardmäßig alle sechs Presets, sofern keine begründete Ausnahme dokumentiert ist.
212+
- Referenz-Rollout für alle sechs Presets: `RiderProjects/TinyPl0`, `RiderProjects/TinyCalc`, `RiderProjects/TuiVision`, `RiderProjects/InventarWorkerService`.
213+
- Installation bevorzugt über den Community-Katalog, wenn `specify` das unterstützt; für reproduzierbare Pins die versionierten GitHub-ZIP-URLs aus `constitution.md`/`README.md` verwenden.
214+
- `.specify/presets/` und generierte Agenten-/Command-Dateien committen, wenn Presets Projekt-Policy sind; `.specify/presets/.cache/` nie committen.
215+
- Nach Installation oder Update prüfen: `specify preset list`, mindestens ein `specify preset info <id>`, bei Template-Fragen zusätzlich `specify preset resolve <template>`.
216+
- Die lokale Arbeitskopie der veröffentlichten Preset-Repos liegt unter `~/SpecKitPresetProjects/`; kanonische Scaffolds liegen im Level-0-Repo unter `specs/spec-kit-presets/` und `specs/spec-kit-preset-repos/`.
217+
- Verbesserungen an Presets zuerst im Level-0-Scaffold einarbeiten, dann in die passenden Repos unter `~/SpecKitPresetProjects/` übertragen, committen, pushen und mit GitHub-ZIP-URL smoke-testen.
218+
- Bei Änderungen an Preset-Regeln immer prüfen, ob `constitution.md`, `.specify/memory/constitution.md`, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md` und relevante Templates ebenfalls aktualisiert werden müssen.
219+
- Community-/Katalog-Abstimmung läuft über `github/spec-kit#2362`.
220+
221+
*Standard preset set: `security-governance` v0.2.0 prio 10, `architecture-governance` v0.2.0 prio 20, `isaqb-architecture-governance` v0.1.0 prio 30, `a11y-governance` v0.2.0 prio 40, `cross-platform-governance` v0.1.0 prio 50, and `agent-parity-governance` v0.1.0 prio 60. All six presets are in the `github/spec-kit` community catalog as of 2026-05-04 and are also published under `https://github.com/hindermath/spec-kit-preset-*`. New Level-2 projects should install the applicable subset; C#/.NET Level-2 projects default to all six unless a justified exception is documented. 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`. Preset-rule changes require reviewing constitution, all agent guidance files, and relevant templates. Community/catalog coordination happens in `github/spec-kit#2362`.*
222+
206223
## Hinweise / Notes
207224

208225
- Diese Datei bleibt bewusst kompakt und ergänzt die projektspezifische Dokumentation.

CLAUDE.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -256,6 +256,23 @@ Governed by `.editorconfig`:
256256
- Default-Evidenzpfad: `docs/security/asvs-verification.md`, `docs/security/supply-chain-evidence.md`, `docs/security/zero-trust-applicability.md`, `docs/security/samm-assessment.md`; Abweichungen nur mit lokal dokumentierter Begründung.
257257

258258
*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. For release and artefact work, plan `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`, and `docs/security/samm-assessment.md`, unless the repository documents a justified equivalent location.*
259+
260+
## Spec-Kit-Preset-Pflege / Spec Kit Preset Maintenance
261+
262+
- Standard-Preset-Set: `security-governance` v0.2.0 prio 10, `architecture-governance` v0.2.0 prio 20, `isaqb-architecture-governance` v0.1.0 prio 30, `a11y-governance` v0.2.0 prio 40, `cross-platform-governance` v0.1.0 prio 50, `agent-parity-governance` v0.1.0 prio 60.
263+
- Alle sechs Presets sind seit 2026-05-04 im `github/spec-kit` Community-Katalog enthalten und liegen zusätzlich als veröffentlichte Repos unter `https://github.com/hindermath/spec-kit-preset-*`.
264+
- Neue Level-2-Projekte SOLLEN bei der Spec-Kit-Initialisierung die passende Preset-Teilmenge installieren; C#/.NET-Level-2-Projekte verwenden standardmäßig alle sechs Presets, sofern keine begründete Ausnahme dokumentiert ist.
265+
- Referenz-Rollout für alle sechs Presets: `RiderProjects/TinyPl0`, `RiderProjects/TinyCalc`, `RiderProjects/TuiVision`, `RiderProjects/InventarWorkerService`.
266+
- Installation bevorzugt über den Community-Katalog, wenn `specify` das unterstützt; für reproduzierbare Pins die versionierten GitHub-ZIP-URLs aus `constitution.md`/`README.md` verwenden.
267+
- `.specify/presets/` und generierte Agenten-/Command-Dateien committen, wenn Presets Projekt-Policy sind; `.specify/presets/.cache/` nie committen.
268+
- Nach Installation oder Update prüfen: `specify preset list`, mindestens ein `specify preset info <id>`, bei Template-Fragen zusätzlich `specify preset resolve <template>`.
269+
- Die lokale Arbeitskopie der veröffentlichten Preset-Repos liegt unter `~/SpecKitPresetProjects/`; kanonische Scaffolds liegen im Level-0-Repo unter `specs/spec-kit-presets/` und `specs/spec-kit-preset-repos/`.
270+
- Verbesserungen an Presets zuerst im Level-0-Scaffold einarbeiten, dann in die passenden Repos unter `~/SpecKitPresetProjects/` übertragen, committen, pushen und mit GitHub-ZIP-URL smoke-testen.
271+
- Bei Änderungen an Preset-Regeln immer prüfen, ob `constitution.md`, `.specify/memory/constitution.md`, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md` und relevante Templates ebenfalls aktualisiert werden müssen.
272+
- Community-/Katalog-Abstimmung läuft über `github/spec-kit#2362`.
273+
274+
*Standard preset set: `security-governance` v0.2.0 prio 10, `architecture-governance` v0.2.0 prio 20, `isaqb-architecture-governance` v0.1.0 prio 30, `a11y-governance` v0.2.0 prio 40, `cross-platform-governance` v0.1.0 prio 50, and `agent-parity-governance` v0.1.0 prio 60. All six presets are in the `github/spec-kit` community catalog as of 2026-05-04 and are also published under `https://github.com/hindermath/spec-kit-preset-*`. New Level-2 projects should install the applicable subset; C#/.NET Level-2 projects default to all six unless a justified exception is documented. 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`. Preset-rule changes require reviewing constitution, all agent guidance files, and relevant templates. Community/catalog coordination happens in `github/spec-kit#2362`.*
275+
259276
## Hinweise / Notes
260277

261278
- Diese Datei ergaenzt die projektspezifische Dokumentation mit agentischen Arbeitsregeln.

0 commit comments

Comments
 (0)