|
1 | | -# Constitution v1.5.1 |
| 1 | +<!-- |
| 2 | +Sync Impact Report |
| 3 | +Version change: 1.5.1 -> 1.6.0 |
| 4 | +Modified principles: |
| 5 | +- X. Level-2 Project Environment Addenda -> expanded with the shared Level-2 environment registry rule |
| 6 | +Added sections: |
| 7 | +- Level-2 Project Environment Registry / Level-2-Projektumgebungsregister |
| 8 | +Removed sections: |
| 9 | +- None |
| 10 | +Templates requiring updates: |
| 11 | +- ✅ .specify/templates/plan-template.md |
| 12 | +- ✅ .specify/templates/spec-template.md |
| 13 | +- ✅ .specify/templates/tasks-template.md |
| 14 | +- ✅ .specify/templates/commands/ (not present in this repository) |
| 15 | +Runtime guidance requiring updates: |
| 16 | +- ✅ AGENTS.md |
| 17 | +- ✅ CLAUDE.md |
| 18 | +- ✅ GEMINI.md |
| 19 | +- ✅ .github/copilot-instructions.md |
| 20 | +Follow-up TODOs: |
| 21 | +- None |
| 22 | +--> |
| 23 | + |
| 24 | +# Constitution v1.6.0 |
2 | 25 |
|
3 | 26 | # home-baseline Constitution |
4 | 27 |
|
@@ -219,27 +242,50 @@ Mandatory rules: |
219 | 242 | ### X. Level-2 Project Environment Addenda |
220 | 243 |
|
221 | 244 | Level-2 project constitutions MUST preserve the shared policy layer and add a |
222 | | -project-local environment addendum instead of replacing the constitution with a |
223 | | -generic copy. |
| 245 | +project-local environment addendum or a clearly applicable entry in the shared |
| 246 | +Level-2 environment registry instead of relying on a generic copy. |
224 | 247 |
|
225 | 248 | Mandatory rules: |
226 | 249 | - Each Level-2 `constitution.md` MUST document the local runtime, build system, |
227 | 250 | test framework, documentation/A11Y toolchain, statistics baseline, and |
228 | 251 | repository-specific agent surfaces. |
| 252 | +- The shared Level-2 Project Environment Registry in this constitution is the |
| 253 | + canonical cross-repository index for those project environments. |
229 | 254 | - Project-specific addenda MUST enrich the shared constitution; they MUST NOT |
230 | 255 | weaken Security-First, A11Y, bilingual, statistics, or four-agent parity |
231 | 256 | requirements. |
232 | | -- When a project-specific runtime or tooling baseline changes, the local |
233 | | - `constitution.md`, `.specify/memory/constitution.md`, and affected agent |
234 | | - guidance files MUST be reviewed together. |
| 257 | +- When a project-specific runtime or tooling baseline changes, this registry, |
| 258 | + the local `constitution.md`, `.specify/memory/constitution.md`, and affected |
| 259 | + agent guidance files MUST be reviewed together. |
235 | 260 | - Level-0 and Level-1 constitutions define shared policy. Level-2 constitutions |
236 | | - define the same policy plus the concrete project environment. |
| 261 | + define the same policy plus the concrete project environment. A Level-2 |
| 262 | + repository MUST treat its registry row as binding local context for Spec-Kit |
| 263 | + plans, generated tasks, and agent runtime decisions. |
237 | 264 |
|
238 | 265 | **Rationale**: A generic constitution is not sufficient for real project work. |
239 | 266 | Agentic tools need the binding shared rules and the local build/test/runtime |
240 | 267 | context in the same policy surface so generated plans do not drift away from |
241 | 268 | the actual project environment. |
242 | 269 |
|
| 270 | +## Level-2 Project Environment Registry / Level-2-Projektumgebungsregister |
| 271 | + |
| 272 | +This registry consolidates the constitution-relevant Level-2 project facts |
| 273 | +extracted from the project-local `.specify/memory/constitution.md` files. |
| 274 | +Spec-Kit planning and agent-generated work MUST use the matching row as binding |
| 275 | +project context. |
| 276 | + |
| 277 | +| Level-2 Project | Runtime / Language | Build & Test Baseline | Docs / A11Y Baseline | Statistics Baseline | Agent Surfaces | |
| 278 | +|---|---|---|---|---|---| |
| 279 | +| `C64Projects/cc65` | C/C89-oriented host tools, 6502 assembler/runtime libraries, C64 and 8-bit target support | GNU `make`; `make`, `make test`, `make check`, `make checkstyle`, `make -C targettest SYS=c64` | `doc/`, `samples/`, generated `html/`; DE-first/EN-second additions where local scope allows; no color-only meaning | Manual conservative `80` lines/workday; no C# default unless a justified Thorsten-Solo baseline is documented | `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, Spec-Kit command/prompt surfaces | |
| 280 | +| `DataGripProjects/InventarDb` | Database/schema artefacts with C#/.NET Framework integration context where documented | Repository-specific DataGrip/database validation plus homogeneity checks after agent-guidance changes | SQL, documentation, generated templates, and reports remain text-first, bilingual where user-facing, and WCAG 2.2 AA-oriented where applicable | Manual conservative `80` lines/workday; C#/.NET integration work uses `125` lines/workday unless justified otherwise | `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, Spec-Kit surfaces | |
| 281 | +| `RiderProjects/InventarWorkerService` | .NET 10 / C# 14 multi-project inventory solution: worker/API, harvester, Terminal UI, shared libraries, SQLite/MongoDB/PostgreSQL | `dotnet restore/build/test` on `InventarWorkerService.sln`; MSTest unit/integration tests; Playwright setup when required | DocFX output and learner-facing docs require text-oriented A11Y review; generated `api/` and `_site/` remain build artefacts | Manual conservative `80`; repo-specific Thorsten-Solo `100` lines/workday unless all agent files change it | `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, Spec-Kit surfaces | |
| 282 | +| `RiderProjects/TinyCalc` | .NET 10 / C# spreadsheet and Terminal.Gui TUI port; Pascal reference artefacts for behaviour parity | `dotnet restore/build/test MicroCalc.sln`; xUnit suites; non-interactive TUI smoke mode | DocFX changes require text-oriented A11Y smoke review; documentation and didactic comments stay DE-first/EN-second at CEFR B2 | Manual conservative `80`; Thorsten-Solo `125` lines/workday for this Pascal-derived C#/.NET port | `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, Spec-Kit surfaces | |
| 283 | +| `RiderProjects/TinyPl0` | .NET 10 / C# 14 compiler, VM, CLI, and Terminal.Gui IDE for PL/0 | `dotnet restore/build/test`; coverage collection; `scripts/update-golden-code.sh` for intentional compiler-output changes | Learner-facing compiler docs, examples, generated API docs, and IDE flows follow DE-first/EN-second and WCAG 2.2 AA-oriented review | Manual conservative `80`; C#/.NET Thorsten-Solo `125` unless all agent files justify a deviation | `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, `.codex` prompt/rule surfaces, Spec-Kit surfaces; `.codex` credentials/logs/history/SQLite state are forbidden | |
| 284 | +| `RiderProjects/TuiVision` | .NET 10 / C# terminal UI framework and Turbo Vision port: framework libraries, managed console driver, compatibility, controls, serialization, examples | `dotnet restore/build/test`; MSTest suites; Coverlet coverage gates for core assemblies; `dotnet format` where configured | DocFX regeneration requires Playwright + axe and lynx-oriented A11Y smoke review for generated documentation | Manual conservative `80`; C#/.NET Thorsten-Solo `125` unless all agent files justify a deviation | `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, `.github/agents/copilot-instructions.md`, Spec-Kit surfaces | |
| 285 | +| `RiderProjects/WebApplication1` | .NET 10 / C# single-project ASP.NET Core MVC application | `dotnet build`; `dotnet build -c Release/Debug`; `dotnet run --project WebApplication1/WebApplication1.csproj` | HTML views, documentation, templates, and UI output follow WCAG 2.2 AA where applicable and stay keyboard/AT usable | Manual conservative `80`; C#/.NET Thorsten-Solo `125` unless all agent files justify a deviation | `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, Spec-Kit surfaces | |
| 286 | +| `RiderProjects/inventarworkerservice2` | .NET 9.0 via `global.json`; cross-platform Worker Service; Windows/Systemd hosting; hardware inventory; PowerShell SDK; YAML/JSON status output | `dotnet build InventarWorkerService2.sln`; `dotnet run --project InventarWorkerService2/InventarWorkerService2.csproj`; CI includes Gitleaks and agent-secret-scan | CLI/service status output, generated templates, docs, JSON/YAML reports, and logs remain text-first and accessibility-aware | Manual conservative `80`; C#/.NET Thorsten-Solo `125` unless all agent files justify a deviation | `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, `.opencode`, Spec-Kit surfaces; credentials/history/logs/SQLite state are forbidden | |
| 287 | +| `RiderProjects/sysinfotool` | .NET 10 / C# 14 cross-platform system-information CLI; Spectre.Console; Windows/macOS/Linux/FreeBSD services; DE/EN localization | `dotnet restore/build/test`; coverage collection; `docfx docfx.json`; GitLab CI stages `build/test/docs/scan` | Generated DocFX HTML targets WCAG 2.2 AA; DocFX regeneration requires Playwright + axe and lynx-oriented review where applicable | Manual conservative `80`; repo-specific Thorsten-Solo `100` lines/workday for this .NET CLI codebase | `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md`, `.opencode`, Spec-Kit surfaces; credentials/history/logs/SQLite state are forbidden | |
| 288 | + |
243 | 289 | ## Script & Code Conventions |
244 | 290 |
|
245 | 291 | Coding style rules that apply to all scripts in this repository: |
@@ -311,7 +357,7 @@ allowed path. |
311 | 357 | `.github/copilot-instructions.md` for per-agent operational guidance. This |
312 | 358 | constitution is the authoritative policy layer above all agent-specific files. |
313 | 359 |
|
314 | | -**Version**: 1.5.1 | **Ratified**: 2026-03-31 | **Last Amended**: 2026-04-22 |
| 360 | +**Version**: 1.6.0 | **Ratified**: 2026-03-31 | **Last Amended**: 2026-04-22 |
315 | 361 |
|
316 | 362 | <!-- EN: constitution.md placeholder |
317 | 363 | [DE-Zusammenfassung: constitution.md beschreibt die Prinzipien und Standards für alle home-baseline Workspaces.] |
|
0 commit comments