Skip to content

Commit e28f310

Browse files
Your NameCopilot
andcommitted
docs: sync constitution and shared agent guidance
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
1 parent 9635a6f commit e28f310

5 files changed

Lines changed: 97 additions & 8 deletions

File tree

.github/copilot-instructions.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -181,3 +181,11 @@ Diese Regeln gelten für alle Repositories in diesem Workspace. Projektspezifisc
181181
For additional context about technologies to be used, project structure,
182182
shell commands, and other important information, read the current plan
183183
<!-- SPECKIT END -->
184+
185+
## Gemeinsame Governance-Ergaenzung / Shared Governance Addendum
186+
187+
- Alle nutzerseitigen Artefakte muessen barrierefrei gedacht und geprueft werden: CLI-Ausgaben, Dokumentation, HTML, UI und generierte Templates; WCAG 2.2 Level AA ist die Standard-Basis, sobald die Kriterien auf das Artefakt anwendbar sind.
188+
- All user-facing artefacts must be designed and reviewed for accessibility: CLI output, documentation, HTML, UI, and generated templates; WCAG 2.2 Level AA is the default baseline wherever the criteria apply.
189+
190+
- Fuer C#/.NET-Repositories gilt standardmaessig eine Thorsten-Solo-Basis von `125` Zeilen/Arbeitstag, sofern das Repo keinen abweichenden, begruendeten Wert dokumentiert.
191+
- The default Thorsten-solo baseline for C#/.NET repositories is `125` lines/workday unless the repository documents a justified deviation.

AGENTS.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,15 @@ Each machine runs InventarWorkerService (REST agent)
146146
- If `docfx` output is regenerated, the same work item must also run a text-oriented accessibility review with Playwright + `@axe-core/playwright` and `lynx`.
147147
- Recommended A11y toolchain for DocFX-based repos: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright`, and `lynx`.
148148

149+
150+
## Gemeinsame Governance-Ergaenzung / Shared Governance Addendum
151+
152+
- Alle nutzerseitigen Artefakte muessen barrierefrei gedacht und geprueft werden: CLI-Ausgaben, Dokumentation, HTML, UI und generierte Templates; WCAG 2.2 Level AA ist die Standard-Basis, sobald die Kriterien auf das Artefakt anwendbar sind.
153+
- All user-facing artefacts must be designed and reviewed for accessibility: CLI output, documentation, HTML, UI, and generated templates; WCAG 2.2 Level AA is the default baseline wherever the criteria apply.
154+
155+
- Fuer C#/.NET-Repositories gilt standardmaessig eine Thorsten-Solo-Basis von `125` Zeilen/Arbeitstag, sofern das Repo keinen abweichenden, begruendeten Wert dokumentiert.
156+
- The default Thorsten-solo baseline for C#/.NET repositories is `125` lines/workday unless the repository documents a justified deviation.
157+
149158
## Shared Parent Guidance
150159

151160
- The shared parent file `/Users/thorstenhindermann/RiderProjects/AGENTS.md` intentionally stores only repo-spanning baseline rules.

CLAUDE.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -158,6 +158,15 @@ InventarViewerApp (TUI) → queries InventarWorkerService API → persists in
158158
- If `docfx` output is regenerated, the same work item must also run a text-oriented accessibility review with Playwright + `@axe-core/playwright` and `lynx`.
159159
- Recommended A11y toolchain for DocFX-based repos: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright`, and `lynx`.
160160

161+
162+
## Gemeinsame Governance-Ergaenzung / Shared Governance Addendum
163+
164+
- Alle nutzerseitigen Artefakte muessen barrierefrei gedacht und geprueft werden: CLI-Ausgaben, Dokumentation, HTML, UI und generierte Templates; WCAG 2.2 Level AA ist die Standard-Basis, sobald die Kriterien auf das Artefakt anwendbar sind.
165+
- All user-facing artefacts must be designed and reviewed for accessibility: CLI output, documentation, HTML, UI, and generated templates; WCAG 2.2 Level AA is the default baseline wherever the criteria apply.
166+
167+
- Fuer C#/.NET-Repositories gilt standardmaessig eine Thorsten-Solo-Basis von `125` Zeilen/Arbeitstag, sofern das Repo keinen abweichenden, begruendeten Wert dokumentiert.
168+
- The default Thorsten-solo baseline for C#/.NET repositories is `125` lines/workday unless the repository documents a justified deviation.
169+
161170
## Shared Parent Guidance
162171

163172
- The shared parent file `/Users/thorstenhindermann/RiderProjects/AGENTS.md` intentionally stores only repo-spanning baseline rules.

GEMINI.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,6 +99,15 @@ Das Projekt nutzt die Standard .NET-CLI.
9999
- If `docfx` output is regenerated, the same work item must also run a text-oriented accessibility review with Playwright + `@axe-core/playwright` and `lynx`.
100100
- Recommended A11y toolchain for DocFX-based repos: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright`, and `lynx`.
101101

102+
103+
## Gemeinsame Governance-Ergaenzung / Shared Governance Addendum
104+
105+
- Alle nutzerseitigen Artefakte muessen barrierefrei gedacht und geprueft werden: CLI-Ausgaben, Dokumentation, HTML, UI und generierte Templates; WCAG 2.2 Level AA ist die Standard-Basis, sobald die Kriterien auf das Artefakt anwendbar sind.
106+
- All user-facing artefacts must be designed and reviewed for accessibility: CLI output, documentation, HTML, UI, and generated templates; WCAG 2.2 Level AA is the default baseline wherever the criteria apply.
107+
108+
- Fuer C#/.NET-Repositories gilt standardmaessig eine Thorsten-Solo-Basis von `125` Zeilen/Arbeitstag, sofern das Repo keinen abweichenden, begruendeten Wert dokumentiert.
109+
- The default Thorsten-solo baseline for C#/.NET repositories is `125` lines/workday unless the repository documents a justified deviation.
110+
102111
## Shared Parent Guidance
103112

104113
- Die gemeinsamen Dateien `/Users/thorstenhindermann/RiderProjects/AGENTS.md` und `/Users/thorstenhindermann/RiderProjects/GEMINI.md` speichern die repo-uebergreifenden Basisregeln.

constitution.md

Lines changed: 62 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Constitution v1.4.0
1+
# Constitution v1.5.0
22

33
# home-baseline Constitution
44

@@ -8,6 +8,10 @@ Diese Verfassung definiert die verbindlichen Prinzipien und Standards für alle
88

99
*This constitution defines the non-negotiable principles and standards for all home-baseline workspaces.*
1010

11+
Leitspruch: `Programmierung #include<everyone>`.
12+
13+
*Guiding motto: `Programmierung #include<everyone>`.*
14+
1115
## Core Principles
1216

1317
### I. Security-First (NON-NEGOTIABLE)
@@ -153,16 +157,65 @@ Mandatory content and update rules:
153157
- **Gesamtstatistik**: always the final top-level section; includes compact ASCII-only diagrams (artefakt mix, phase volume, speedup factors, manual-reference comparison).
154158
- **Update triggers**: after each completed Spec-Kit implementation phase, after each merged feature, or when explicitly requested.
155159
- **Reference baselines**:
156-
- Manual reference: `80` lines/workday (conservative) — project-specific Thorsten-Solo baseline documented in `AGENTS.md`.
160+
- Manual reference: `80` lines/workday (conservative) — project-specific Thorsten-Solo baseline documented consistently in `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, and `.github/copilot-instructions.md`.
161+
- Default C#/.NET Thorsten-Solo baseline: `125` lines/workday unless a repository documents and justifies a different project-specific value. `home-baseline` itself keeps `100` lines/workday as the scripting-infrastructure Thorsten-Solo reference.
157162
- TVöD workday: `7.8 h` (`7h 48m`). Month: `21.5` workdays. Vacation: 30 days until end of 2026, 31 days from 2027 onwards.
158163
- **Acceleration factor** = blended repository speedup — delivery density against manual reference, **not** stopwatch time.
159164
- **Diagram format**: compact ASCII-only; each diagram followed by a CEFR-B2 bilingual explanation (DE + EN).
160-
- **Consistency rule**: When statistics methodology or shared guidance changes, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, and `.github/copilot-instructions.md` MUST be updated together in the same commit.
165+
- **Consistency rule**: When statistics methodology or shared guidance changes, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, and `.github/copilot-instructions.md` MUST be updated together in the same commit. The same shared rules MUST also be propagated to the relevant project templates and `.specify/memory/constitution.md`.
161166

162167
The bootstrap scripts (`bootstrap-project.sh` / `.ps1`) MUST create an initial `docs/project-statistics.md` stub at project creation time. `docs/` MUST be whitelisted in every project `.gitignore`.
163168

164169
**Rationale**: Blended speedup metrics are educational for developers and apprentices. They make the productivity impact of AI-assisted workflows visible and comparable across projects. A living ledger that accumulates over the project lifetime is the only reliable source of this data.
165170

171+
### VII. Programmierung #include<everyone> — Inclusion & Accessibility By Default
172+
173+
`Programmierung #include<everyone>` is a binding repository-wide principle, not a slogan.
174+
All user-facing artefacts MUST be designed and reviewed for inclusive use:
175+
176+
- CLI output
177+
- Documentation and Markdown
178+
- HTML and generated websites
179+
- Graphical user interfaces
180+
- Generated templates and scaffolding
181+
182+
Mandatory rules:
183+
- WCAG 2.2 Level AA is the default accessibility baseline wherever the criteria are applicable.
184+
- User-facing artefacts MUST remain usable with keyboard-only interaction, screen readers, Braille displays, and text browsers.
185+
- Text-first fallbacks MUST be preferred for status reporting, diagrams, and operational guidance.
186+
- Accessibility review is part of completion, not post-processing.
187+
188+
**Rationale**: Inclusive delivery improves quality for everyone, reduces retrofit work, and makes the repositories usable in real assistive-technology workflows from the start.
189+
190+
### VIII. DE-First / EN-Second Bilingual Delivery
191+
192+
German is the canonical first language for user-facing documentation and governance in this workspace family; English follows directly after it.
193+
194+
Mandatory rules:
195+
- Headings MUST follow the `DE / EN` pattern unless the heading is a proper noun or tool name.
196+
- Learner-facing and user-facing documentation MUST be maintained bilingually at approximately CEFR-B2 readability.
197+
- Large normative documents MAY use a synchronized `.EN.md` companion file when inline bilingual maintenance would become unreadable.
198+
- Changes that materially affect user-facing guidance MUST update both language tracks in the same change.
199+
200+
**Rationale**: DE-first / EN-second delivery reflects the actual audience while keeping the content usable for mixed-language teams, apprentices, and external review.
201+
202+
### IX. Four-Agent Guidance Parity & Template Synchronization
203+
204+
Shared AI-agent guidance in this workspace family is only valid when the four maintained agent surfaces stay aligned:
205+
206+
- `AGENTS.md` for Codex/Codex-like agents
207+
- `CLAUDE.md`
208+
- `GEMINI.md`
209+
- `.github/copilot-instructions.md`
210+
211+
Mandatory rules:
212+
- Shared operational rules MUST NOT be updated in only one of the four files.
213+
- Any intentional deviation MUST be documented explicitly in the same change.
214+
- The corresponding project templates and `.specify/memory/constitution.md` MUST be updated in the same change whenever a shared principle changes.
215+
- Runtime guidance references in governance text MUST name all four maintained agent surfaces.
216+
217+
**Rationale**: Divergent agent instructions create silent process drift. Atomic parity keeps different AI tools aligned and makes future project bootstraps inherit the same governance baseline.
218+
166219
## Script & Code Conventions
167220

168221
Coding style rules that apply to all scripts in this repository:
@@ -214,7 +267,8 @@ defines non-negotiable structural rules.
214267
- MINOR: new principle or section added / materially expanded guidance
215268
- PATCH: clarifications, wording fixes, non-semantic refinements
216269
4. Propagate any principle changes to dependent templates
217-
(`.specify/templates/plan-template.md`, `spec-template.md`, `tasks-template.md`)
270+
(`.specify/templates/plan-template.md`, `spec-template.md`, `tasks-template.md`,
271+
relevant `scripts/templates/*`, and `.specify/memory/constitution.md`)
218272
and AI agent guidance files, committing all changes atomically.
219273
5. All PRs and AI-assisted sessions MUST verify compliance with the current
220274
version of this constitution before committing code or scripts.
@@ -229,11 +283,11 @@ Any expansion of the surgical subdirectory exception (Principle I) MUST include
229283
a security justification confirming no credentials are present in the newly
230284
allowed path.
231285

232-
**Runtime guidance**: Use `AGENTS.md` / `CLAUDE.md` / `GEMINI.md` for
233-
per-agent operational guidance. This constitution is the authoritative policy
234-
layer above all agent-specific files.
286+
**Runtime guidance**: Use `AGENTS.md` / `CLAUDE.md` / `GEMINI.md` /
287+
`.github/copilot-instructions.md` for per-agent operational guidance. This
288+
constitution is the authoritative policy layer above all agent-specific files.
235289

236-
**Version**: 1.4.0 | **Ratified**: 2026-03-31 | **Last Amended**: 2026-04-12
290+
**Version**: 1.5.0 | **Ratified**: 2026-03-31 | **Last Amended**: 2026-04-20
237291

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

0 commit comments

Comments
 (0)