Skip to content

Commit 887c727

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

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
@@ -161,3 +161,11 @@ Diese Regeln gelten für alle Repositories in diesem Workspace. Projektspezifisc
161161
- **Nicht davon ausgehen**, dass eine Cross-Repository-Regel projekt-spezifische Build-, Test- oder Release-Anforderungen ersetzt.
162162
- Wenn eine gemeinsame Regel sich ändert und mehrere Repositories betroffen sind, lokale Projektguidance **und** das jeweilige Statistik-Ledger gemeinsam aktualisieren.
163163
- `CODEX_CROSS_REPO_PROMPTS.md` synchron halten, wenn sich übergreifende Prompting-Guidance ändert, damit der wiederverwendbare Prompt mit der aktuellen Baseline übereinstimmt.
164+
165+
## Gemeinsame Governance-Ergaenzung / Shared Governance Addendum
166+
167+
- 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.
168+
- 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.
169+
170+
- Fuer C#/.NET-Repositories gilt standardmaessig eine Thorsten-Solo-Basis von `125` Zeilen/Arbeitstag, sofern das Repo keinen abweichenden, begruendeten Wert dokumentiert.
171+
- 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
@@ -87,6 +87,15 @@ For contributions:
8787
- Recommended A11y toolchain for DocFX-based repos: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright`, and `lynx`.
8888
- Treat bilingual CEFR-B2 delivery and the documented A11Y proof path as formal completion criteria for learner-facing documentation and active requirement artifacts.
8989

90+
91+
## Gemeinsame Governance-Ergaenzung / Shared Governance Addendum
92+
93+
- 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.
94+
- 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.
95+
96+
- Fuer C#/.NET-Repositories gilt standardmaessig eine Thorsten-Solo-Basis von `125` Zeilen/Arbeitstag, sofern das Repo keinen abweichenden, begruendeten Wert dokumentiert.
97+
- The default Thorsten-solo baseline for C#/.NET repositories is `125` lines/workday unless the repository documents a justified deviation.
98+
9099
## Shared Parent Guidance
91100

92101
- 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
@@ -106,6 +106,15 @@ Governed by `.editorconfig`:
106106

107107
`CALC.HLP` must be resolvable at runtime. It lives both at `src/MicroCalc.Tui/Resources/CALC.HLP` (bundled as a resource) and at the repo root (legacy reference). Path changes must preserve both locations.
108108

109+
110+
## Gemeinsame Governance-Ergaenzung / Shared Governance Addendum
111+
112+
- 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.
113+
- 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.
114+
115+
- Fuer C#/.NET-Repositories gilt standardmaessig eine Thorsten-Solo-Basis von `125` Zeilen/Arbeitstag, sofern das Repo keinen abweichenden, begruendeten Wert dokumentiert.
116+
- The default Thorsten-solo baseline for C#/.NET repositories is `125` lines/workday unless the repository documents a justified deviation.
117+
109118
## Active Technologies
110119
- C# 14 / .NET 10 + xUnit 2.x (tests); Terminal.Gui (TUI — untouched by this feature) (001-project-context)
111120
- N/A — JSON persistence format unchanged; new functions evaluated at runtime from (001-project-context)

GEMINI.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -106,6 +106,15 @@ The original Pascal files (`CALC.PAS`, `CALC.INC`) and the help file (`CALC.HLP`
106106
- Recommended A11y toolchain for DocFX-based repos: Node 24 LTS, `npm`, Playwright, `@axe-core/playwright`, and `lynx`.
107107
- Treat bilingual CEFR-B2 delivery and the documented A11Y proof path as formal completion criteria for learner-facing documentation and active requirement artifacts.
108108

109+
110+
## Gemeinsame Governance-Ergaenzung / Shared Governance Addendum
111+
112+
- 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.
113+
- 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.
114+
115+
- Fuer C#/.NET-Repositories gilt standardmaessig eine Thorsten-Solo-Basis von `125` Zeilen/Arbeitstag, sofern das Repo keinen abweichenden, begruendeten Wert dokumentiert.
116+
- The default Thorsten-solo baseline for C#/.NET repositories is `125` lines/workday unless the repository documents a justified deviation.
117+
109118
## Shared Parent Guidance
110119

111120
- 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)