Skip to content

Commit 011f6b3

Browse files
committed
chore: update agent parity governance to v0.2.0
1 parent 4f35729 commit 011f6b3

17 files changed

Lines changed: 82 additions & 18 deletions

.github/copilot-instructions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -297,7 +297,7 @@ For GitLab repositories, use the authenticated `glab` CLI first for equivalent a
297297
298298
## Spec-Kit-Preset-Pflege / Spec Kit Preset Maintenance
299299
300-
- Standard-Preset-Set: `security-governance` v0.4.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.
300+
- Standard-Preset-Set: `security-governance` v0.4.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.2.0 prio 60.
301301
- `security-governance` v0.4.0 fuehrt `AI-SBOM` weiter als bedingt anwendbare Supply-Chain-Evidenz und ergaenzt sprachspezifische Secure-Coding-Profile fuer Rust, Go, Swift, Java/Kotlin, Python und TypeScript/JavaScript. Reine Entwicklungswerkzeug-Nutzung bleibt `N/A`; KI-Runtime-/Produktkomponenten benoetigen Evidenz nach G7/BSI AI-SBOM-Clustern.
302302
- 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-*`.
303303
- 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.
@@ -310,7 +310,7 @@ For GitLab repositories, use the authenticated `glab` CLI first for equivalent a
310310
- 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.
311311
- Community-/Katalog-Abstimmung läuft über `github/spec-kit#2362`.
312312
313-
*Standard preset set: `security-governance` v0.4.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. `security-governance` v0.4.0 keeps conditional `AI-SBOM` evidence and adds language-specific secure-coding profiles for Rust, Go, Swift, Java/Kotlin, Python, and TypeScript/JavaScript: development-tool-only AI usage is `N/A`, while AI runtime/product components require G7/BSI AI-SBOM cluster evidence. 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/skill 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`.*
313+
*Standard preset set: `security-governance` v0.4.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.2.0 prio 60. `security-governance` v0.4.0 keeps conditional `AI-SBOM` evidence and adds language-specific secure-coding profiles for Rust, Go, Swift, Java/Kotlin, Python, and TypeScript/JavaScript: development-tool-only AI usage is `N/A`, while AI runtime/product components require G7/BSI AI-SBOM cluster evidence. 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/skill 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`.*
314314
315315
<!-- SPECKIT START -->
316316
For additional context about technologies to be used, project structure,

.specify/memory/constitution.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -816,7 +816,7 @@ workspace family consists of:
816816
| `isaqb-architecture-governance` | `v0.1.0` | `30` | general iSAQB/arc42 architecture governance |
817817
| `a11y-governance` | `v0.2.0` | `40` | WCAG 2.2 AA, bilingual DE/EN, CEFR B2, inclusive artefacts |
818818
| `cross-platform-governance` | `v0.1.0` | `50` | Bash/PowerShell parity, macOS/Linux/Windows script governance |
819-
| `agent-parity-governance` | `v0.1.0` | `60` | synchronized agent guidance across declared AI-agent files |
819+
| `agent-parity-governance` | `v0.2.0` | `60` | synchronized agent guidance and agent-neutral Spec-Kit model routing across declared AI-agent files |
820820

821821
`security-governance` v0.4.0 keeps conditional `AI-SBOM` evidence and adds language-specific secure-coding profiles for Rust, Go, Swift, Java/Kotlin, Python, and TypeScript/JavaScript: development-tool-only AI usage is `N/A`, while AI runtime/product components require G7/BSI AI-SBOM cluster evidence.
822822

.specify/presets/.registry

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -227,9 +227,9 @@
227227
"installed_at": "2026-05-28T20:10:02.071942+00:00"
228228
},
229229
"agent-parity-governance": {
230-
"version": "0.1.0",
230+
"version": "0.2.0",
231231
"source": "local",
232-
"manifest_hash": "sha256:043c8875f717174f0fdf27f61c7e8fcdc8e658f5fddca9142d10e90ce52c060a",
232+
"manifest_hash": "sha256:5e0a6d59cb5291092173e9acee873e808f3ec176bcb81a7a913ac300b420796d",
233233
"enabled": true,
234234
"priority": 60,
235235
"registered_commands": {

.specify/presets/agent-parity-governance/README.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Agent Parity Governance Preset
22

3-
Version: `0.1.0`
3+
Version: `0.2.0`
44
Requires: `spec-kit >= 0.8.0` (uses the `wrap` and `append` composition
55
strategies introduced in 0.8.x).
66

@@ -9,6 +9,8 @@ Purpose:
99
- prevent silent process drift between AI-agent guidance files
1010
- enforce that shared rules land atomically across the project's
1111
declared AI-agent guidance surfaces
12+
- keep Spec-Kit model-routing guidance agent-neutral and out of
13+
reproducible feature artifacts
1214

1315
Primary source chapter from `home-baseline` constitution:
1416

@@ -20,6 +22,7 @@ What it covers:
2022
- atomic-change discipline (one change → all surfaces)
2123
- propagation into project templates and `.specify/memory/constitution.md`
2224
- explicit documentation of intentional deviations
25+
- agent-neutral Spec-Kit model routing by work type
2326
- parity-verification artefact (`agent-parity-checklist-template`)
2427

2528
Preset strategy:
@@ -39,6 +42,8 @@ When to use:
3942
instructions
4043
- any project where AI-agent surfaces are part of the contributor
4144
contract
45+
- any project that wants model routing guidance without pinning a
46+
provider-specific model in specs, plans, or tasks
4247

4348
Common surfaces include `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`,
4449
`.github/copilot-instructions.md`, `.cursorrules`, `.windsurfrules`,
@@ -52,4 +57,4 @@ When not to use:
5257

5358
Recommended standalone install priority:
5459

55-
- `40`
60+
- `60`

.specify/presets/agent-parity-governance/preset.yml

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ schema_version: "1.0"
33
preset:
44
id: "agent-parity-governance"
55
name: "Agent Parity Governance"
6-
version: "0.1.0"
7-
description: "Adds shared-guidance parity across a project's declared AI-agent instruction surfaces so agent guidance does not drift."
6+
version: "0.2.0"
7+
description: "Adds shared-guidance parity and agent-neutral Spec-Kit model-routing guidance across a project's declared AI-agent instruction surfaces so agent guidance does not drift."
88
author: "Thorsten Hindermann"
99
repository: "https://github.com/hindermath/spec-kit-preset-agent-parity-governance"
1010
license: "MIT"
@@ -72,4 +72,5 @@ tags:
7272
- "parity"
7373
- "agent-md"
7474
- "agent-guidance"
75+
- "model-routing"
7576
- "multi-agent"

.specify/presets/agent-parity-governance/templates/agent-file-addendum.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,3 +17,24 @@
1717
- Document every `N/A` decision with rationale; never silently omit.
1818
- Use `agent-parity-checklist-template` as the standard verification
1919
artefact for shared-guidance changes.
20+
21+
## Spec-Kit Model Routing
22+
23+
- Treat model choice as operational agent-routing guidance, not as a
24+
feature requirement.
25+
- Do not pin model names in `spec.md`, `plan.md`, `tasks.md`, or
26+
individual feature specs. Those artifacts must remain reproducible even
27+
when model names change or a different AI agent is used.
28+
- Each agent maps these recommendations to its currently available
29+
models. Do not derive a fixed vendor or model requirement from this
30+
preset.
31+
- For Spec-Kit specification, clarification, planning, task generation,
32+
and analysis, prefer the strongest available frontier reasoning/coding
33+
model.
34+
- For complete long-running `speckit.implement` or `/speckit-implement`
35+
runs, prefer the strongest available long-running agent model; use a
36+
frontier model when maximum judgment quality is more important than
37+
runtime stability.
38+
- For focused review or CI fixes, prefer a coding-optimized model.
39+
- For trivial cleanup, formatting, or low-risk mechanical edits, a fast
40+
small coding model is acceptable.

.specify/presets/agent-parity-governance/templates/agent-parity-checklist-template.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,15 @@ confirm whether the shared rule landed.
3232
| Agent guidance addendum template (if maintained) | | |
3333
| Other template (name): | | |
3434

35+
## Model Routing
36+
37+
| Check | Done? | Notes |
38+
|-------|-------|-------|
39+
| Model-routing guidance, if changed, is present in all maintained agent surfaces | | |
40+
| Guidance is agent-neutral and does not require a specific provider or model | | |
41+
| `spec.md`, `plan.md`, `tasks.md`, and feature specs contain no model-name requirements | | |
42+
| Routing distinguishes planning/analyze, long-running implementation, focused fixes, and trivial mechanical edits | | |
43+
3544
## Intentional Deviations
3645

3746
| Surface | What deviates | Why | Expected lifetime |

.specify/presets/agent-parity-governance/templates/constitution-addendum.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,25 @@ surfaces declared by the project are mandatory for that project.
3737
- Runtime guidance text MUST name all maintained agent surfaces — never
3838
list only one or two.
3939

40+
### Spec-Kit model routing
41+
42+
Spec-Kit model routing guidance is part of shared agent guidance. It MUST
43+
stay agent-neutral and MUST NOT pin provider-specific model names in
44+
feature artifacts.
45+
46+
- `spec.md`, `plan.md`, `tasks.md`, and individual feature specs MUST NOT
47+
encode model names as requirements.
48+
- Each agent SHOULD map the routing guidance to its currently available
49+
models.
50+
- Specification, clarification, planning, task generation, and analysis
51+
SHOULD use the strongest available frontier reasoning/coding model.
52+
- Complete long-running implementation runs SHOULD use the strongest
53+
available long-running agent model, unless maximum judgment quality is
54+
more important than runtime stability.
55+
- Focused review and CI fixes SHOULD use a coding-optimized model.
56+
- Trivial cleanup, formatting, or low-risk mechanical edits MAY use a
57+
fast small coding model.
58+
4059
### Atomic change discipline
4160

4261
A single pull request or commit that touches shared agent guidance MUST

.specify/presets/agent-parity-governance/templates/plan-addendum.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,5 +8,8 @@
88
shared principles change.
99
- Plan documentation of any intentional deviation between surfaces (what
1010
deviates, why, expected lifetime).
11+
- If model-routing guidance changes, keep it agent-neutral and plan the
12+
update across all maintained agent surfaces; never pin model names in
13+
reproducible Spec-Kit feature artifacts.
1114
- Plan a parity check task that validates every declared surface reflects
1215
the same shared rules at the end of the change.

.specify/presets/agent-parity-governance/templates/spec-addendum.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,5 +8,8 @@
88
affected.
99
- Record whether any intentional deviation between surfaces is required
1010
and why.
11+
- If the feature changes Spec-Kit model-routing guidance, record it as an
12+
agent-guidance change. Do not write provider-specific model names into
13+
feature requirements.
1114
- Record any justified `N/A` decisions with rationale. Silent omission
1215
is not allowed.

0 commit comments

Comments
 (0)