Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
683 changes: 683 additions & 0 deletions .github/agents/copilot-instructions.md

Large diffs are not rendered by default.

12 changes: 7 additions & 5 deletions .github/copilot-instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -151,13 +151,15 @@ At the start of each session, detect the OS and call the matching script variant
- Update it after each completed feature/Lastenheft, each completed Spec-Kit phase, or when explicitly requested.
- Keep `## Fortschreibungsprotokoll` chronological: oldest entry first, newest entry last.
- Keep `## Gesamtstatistik` as the final top-level section.
- Include compact ASCII-only diagrams directly below the metrics table: artefact mix, phase volume, conservative reference bars, acceleration factors, and the experienced/Thorsten-Solo/AI-visible comparison.
- ASCII X/Y charts must use fixed-width X slots: every documented phase keeps its slot, missing values stay blank, and overly wide series are split into labelled blocks such as `0..15`, `16..31`, and `32..47`.
- Add a short CEFR-B2 explanation below every diagram in German first and English second.
- Use text-friendly output only: no color-dependent signalling and no symbols that break Braille or screen-reader readability.
- Treat `docs/project-statistics.config.json` and the marked Profile 2 block as the binding contract; update it with `render-project-statistics.*`.
- Profile 2 includes KPIs, artifact mix, 52-week daily activity, weekly and cumulative volume, phase or monthly volume, speedup gauges, and the experienced/Thorsten-Solo/AI-visible comparison.
- Use ASCII only: heatmap digits `0..4`, `-` for days not elapsed, and `#`/`.` gauges. Do not use Unicode blocks, color-only signals, or `\ | /` as intensity levels.
- Keep phase slots stable and split series into blocks of 16. Without reliable phase data, show monthly volume and do not invent phases.
- Keep charts at 100 characters or fewer and provide exact values plus a CEFR-B2 text alternative in German first and English second.
- Methodology v2 uses Git-tracked text and gross changes from non-merge commits while excluding the ledger, `STATS.md`, and binaries.
- Manual references for this repository are `80` lines/workday (conservative) and `100` lines/workday (Thorsten-Solo, scripting infrastructure).
- Default C#/.NET Thorsten-Solo baseline is `125` lines/workday unless the repository documents a justified deviation.
- Shared guidance and statistics-method changes must update `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, and `.github/copilot-instructions.md` together in the same change.
- Shared guidance and statistics-method changes must update all five shared agent surfaces, including `.github/agents/copilot-instructions.md`, together in the same change.

## Inklusion & Barrierefreiheit / Inclusion & Accessibility

Expand Down
13 changes: 8 additions & 5 deletions .specify/memory/constitution.md
Original file line number Diff line number Diff line change
Expand Up @@ -207,18 +207,21 @@ Every repository — including `home-baseline` and every Level-2 workspace — M
Mandatory content and update rules:

- **Fortschreibungsprotokoll**: chronological table (oldest entry first, newest last) recording cumulative lines, active days, and commit count at each milestone.
- **Gesamtstatistik**: always the final top-level section; includes compact ASCII-only diagrams (artefakt mix, phase volume, speedup factors, manual-reference comparison).
- **ASCII X/Y charts**: use fixed-width X slots; every documented phase keeps its slot, missing values stay blank, and overly wide series are split into labelled blocks such as `0..15`, `16..31`, and `32..47`.
- **Gesamtstatistik**: always the final top-level section; its marked ASCII Statistics Profile 2 block is rendered from `docs/project-statistics.config.json`.
- **Profile 2 chart set**: KPI summary, artifact mix, 52-week daily activity, weekly and cumulative gross change volume, phase or monthly volume, speedup gauges, manual-reference comparison, and an exact bilingual text alternative.
- **ASCII and width contract**: heatmaps use `0..4`, `-` marks days not elapsed, gauges use `#`/`.`, and every chart line is at most 100 characters. Unicode blocks, color-only meaning, and `\ | /` intensity scales are forbidden.
- **Stable phase slots**: configured phases keep their slot and split into blocks of 16; absent reliable phase data falls back to monthly volume without inventing phases.
- **Methodology version 2**: derives gross text changes from non-merge commits and current volume from Git-tracked text while excluding `docs/project-statistics.md`, `STATS.md`, and binaries.
- **Update triggers**: after each completed Spec-Kit implementation phase, after each merged feature, or when explicitly requested.
- **Reference baselines**:
- 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`.
- 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.
- TVöD workday: `7.8 h` (`7h 48m`). Month: `21.5` workdays. Vacation: 30 days until end of 2026, 31 days from 2027 onwards.
- **Acceleration factor** = blended repository speedup — delivery density against manual reference, **not** stopwatch time.
- **Diagram format**: compact ASCII-only; each diagram followed by a CEFR-B2 bilingual explanation (DE + EN).
- **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`.
- **Diagram format**: compact ASCII-only; exact values and a CEFR-B2 bilingual text alternative follow every visualization group (DE first, EN second).
- **Consistency rule**: When statistics methodology or shared guidance changes, all five shared agent surfaces, including `.github/agents/copilot-instructions.md`, MUST be updated together in the same commit. The same rules MUST also reach project templates and `.specify/memory/constitution.md`.

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`.
The bootstrap scripts (`bootstrap-project.sh` / `.ps1`) MUST create the initial ledger plus its Profile 2 configuration. `docs/` MUST be whitelisted in every project `.gitignore`.

**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.

Expand Down
17 changes: 11 additions & 6 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,8 @@ This repository is the top-level `home-baseline` workspace bootstrap. Keep chang
- `scripts/maintain-agentic-winget-apps.ps1`: maintains the Windows WinGet agentic-development toolchain from `scripts/config/winget-apps-registry.json`, VS Code extensions from `scripts/config/vscode-extensions-registry.json`, required CLI checks from `scripts/config/required-cli-tools-registry.json`, and npm agent CLIs from `scripts/config/npm-agent-cli-registry.json`.
- `scripts/maintain-powershell-modules.ps1`: installs and verifies pinned required PowerShell modules from `scripts/config/powershell-modules-registry.json`.
- `scripts/invoke-psscriptanalyzer.ps1`: analyzes every Git-tracked, repository-owned PowerShell script, module, and data file with the pinned PSScriptAnalyzer version and repository settings; generated GitHub Spec Kit upstream paths documented in the module registry are excluded.
- `scripts/render-project-statistics.*`: renders and verifies the reproducible ASCII Statistics Profile 2 block from the repository JSON configuration.
- `scripts/test-render-project-statistics.ps1`: runs deterministic fixture tests for schema, Git-history filtering, accessibility, phase splitting, idempotency, and Bash/PowerShell parity.
- `scripts/maintain-agentic-workspace.*`: orchestrates complete Level-0/1/2 fast-forward maintenance, home sync, registry/propagation checks, and the matching platform toolchain without committing or pushing target repositories.
- `scripts/propagate-agentic-toolchain-maintenance.*`: checks and synchronizes the canonical maintenance scripts, registries, and manpages across existing Level-1/Level-2 repositories without committing or pushing.
- `scripts/hooks/pre-push`: shared hook copied into target repositories; uses `gitleaks` for pushed commit ranges when available and keeps the regex fallback.
Expand All @@ -48,6 +50,7 @@ bash scripts/update-spec-kit.sh --dry-run
bash scripts/maintain-agentic-workspace.sh --check-only
bash scripts/maintain-agentic-workspace.sh --dry-run
bash scripts/maintain-agentic-brew-apps.sh --dry-run
pwsh -NoProfile -File scripts/test-render-project-statistics.ps1
pwsh scripts/bootstrap-workspace.ps1 -WorkspaceName FlutterProjects -WhatIf
pwsh scripts/install-hooks.ps1 -Verbose
pwsh scripts/setup-git-identity.ps1 -CheckOnly # Git-Identität prüfen / check identity
Expand Down Expand Up @@ -201,18 +204,20 @@ Or view at: `https://github.com/hindermath/home-baseline/blob/main/`
- Aktualisiere die Datei nach jedem abgeschlossenen Feature/Lastenheft, nach jeder abgeschlossenen Spec-Kit-Implementierungsphase und wenn explizit angefordert.
- Im `## Fortschreibungsprotokoll`-Abschnitt gilt: ältester Eintrag oben, neuester Eintrag unten; Einträge mit gleichem Datum behalten ihre Reihenfolge.
- Halte den `## Gesamtstatistik`-Abschnitt als letzten Top-Level-Abschnitt; hänge danach keine weiteren Top-Level-Abschnitte an.
- Innerhalb von `## Gesamtstatistik` stehen kompakte ASCII-Only-Diagramme direkt unter der Kennzahlen-Tabelle; zeige mindestens Artefaktmix, Phasenvolumen, konservative Referenz-Balken, Beschleunigungsfaktoren und den Vergleich Erfahren/Thorsten-Solo/KI-sichtbar.
- ASCII-X/Y-Diagramme verwenden feste X-Slots: jeder dokumentierte Phasenwert behält seinen Slot, fehlende Werte bleiben leer, und zu breite Reihen werden in beschriftete Blöcke wie `0..15`, `16..31` und `32..47` geteilt.
- Jedes ASCII-Diagramm erhält eine kurze CEFR-B2-Erklärung direkt darunter (deutsch und englisch).
- Halte die Statistik textfreundlich: keine Farben, keine Symbole, die auf Braille-Zeilen oder Screenreadern nicht lesbar sind.
- `docs/project-statistics.config.json` und der markierte Profil-2-Block in `## Gesamtstatistik` sind der verbindliche Daten- und Darstellungsvertrag; aktualisiere ihn mit `render-project-statistics.*`.
- Profil 2 zeigt KPI-Kopf, Artefaktmix, 52-Wochen-Tagesaktivität, Wochenvolumen, kumulative Entwicklung, Phasen- oder Monatsvolumen, Speedup-Gauges und den Vergleich Erfahren/Thorsten-Solo/KI-sichtbar.
- Diagramme verwenden nur ASCII: Heatmaps `0..4`, `-` für noch nicht abgelaufene Tage und Gauges `#`/`.`. Unicode-Blöcke, farbabhängige Signale und die Zeichenfolge `\ | /` als Intensitätsskala sind unzulässig.
- Phasen behalten feste Slots und werden ab 17 Einträgen in beschriftete 16er-Blöcke geteilt. Fehlen belastbare Phasenwerte, zeigt Profil 2 Monatsvolumen und erfindet keine Phasen.
- Jedes Diagramm bleibt höchstens 100 Zeichen breit und erhält exakte Zahlen sowie eine kurze CEFR-B2-Textalternative direkt darunter (Deutsch zuerst, Englisch danach).
- Methodik v2 zählt Git-getrackte Textdateien und Brutto-Textänderungen aus Nicht-Merge-Commits; `docs/project-statistics.md`, `STATS.md` und Binärdaten werden aus Volumen und Aktivität ausgeschlossen.
- Manuelle Referenzen für dieses Repository: `80` Zeilen/Arbeitstag (konservative Untergrenze) und `100` Zeilen/Arbeitstag (Thorsten-Solo, Scripting-Infra).
- Gemeinsame Default-Referenz für C#/.NET-Projekte: `125` Zeilen/Arbeitstag (Thorsten-Solo), sofern das jeweilige Repo keinen abweichenden, begründeten Wert dokumentiert.
- Beim Umrechnen in Stunden: `7.8` Stunden (`7h 48m`) pro Arbeitstag (TVöD-Basis).
- Beim Umrechnen in Monate: `21.5` Arbeitstage/Monat; Urlaubstage: 30 Tage bis Ende 2026, ab 2027 dann 31 Tage pro Jahr (TVöD, 5-Tage-Woche).
- Beschleunigungsfaktoren vergleichen die manuelle Referenz gegen sichtbare Git-Aktivtage — keine Stoppuhrmessung, sondern blended repository speedup.
- Shared guidance darf nicht nur in einer der Agenten-Dateien aktualisiert werden; intentionale Abweichungen müssen in derselben Änderung dokumentiert sein.
- Shared guidance darf nicht nur in einer Agenten-Datei aktualisiert werden; `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, `.github/copilot-instructions.md` und `.github/agents/copilot-instructions.md` werden gemeinsam gepflegt. Intentionale Abweichungen müssen in derselben Änderung dokumentiert sein.

*Maintain `docs/project-statistics.md` as the living statistics ledger for this repository. Update after each completed feature/Lastenheft, Spec-Kit phase, or on explicit request. Keep the Fortschreibungsprotokoll in chronological order (oldest first). Keep `## Gesamtstatistik` as the final top-level section. ASCII X/Y charts use fixed X slots and split overly wide series into labelled blocks. Manual references: `80` lines/workday (conservative) and `100` lines/workday (Thorsten-Solo, scripting infra). Default C#/.NET Thorsten-Solo baseline: `125` lines/workday unless the repo documents a justified deviation. TVöD workday: `7.8 h`. Acceleration factors compare manual reference against observable Git active days — not stopwatch time.*
*Maintain `docs/project-statistics.md` as the living statistics ledger and render its marked Profile 2 block from `docs/project-statistics.config.json`. Profile 2 uses ASCII digits `0..4`, `-`, and `#`/`.` gauges, exact values, bilingual text alternatives, fixed phase slots in blocks of 16, and a 100-character chart limit. It derives visible delivery density from Git-tracked text while excluding the ledger, `STATS.md`, and binaries. Manual references remain `80` and repository-specific Thorsten-Solo lines/workday; acceleration is not stopwatch time.*

## Inklusion & Barrierefreiheit / Inclusion & Accessibility

Expand Down
12 changes: 7 additions & 5 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -189,14 +189,16 @@ At the start of each session, detect the OS and call the matching script variant
- Update it after each completed feature/Lastenheft, each completed Spec-Kit phase, or when explicitly requested.
- Keep the `## Fortschreibungsprotokoll` section chronological: oldest entry first, newest entry last.
- Keep `## Gesamtstatistik` as the final top-level section; do not append later top-level sections after it.
- Place compact ASCII-only diagrams directly below the metrics table inside `## Gesamtstatistik`; include at least artefact mix, phase volume, conservative reference bars, acceleration factors, and the experienced/Thorsten-Solo/AI-visible comparison.
- ASCII X/Y charts must use fixed-width X slots: every documented phase keeps its slot, missing values stay blank, and overly wide series are split into labelled blocks such as `0..15`, `16..31`, and `32..47`.
- Add a short CEFR-B2 explanation below every ASCII diagram in German first and English second.
- Use text-friendly presentation only: no color-dependent signalling and no symbols that are unreadable on Braille displays or screen readers.
- Treat `docs/project-statistics.config.json` plus the marked Profile 2 block as the binding data and presentation contract; update it with `render-project-statistics.*`.
- Profile 2 includes KPIs, artifact mix, 52-week daily activity, weekly and cumulative volume, phase or monthly volume, speedup gauges, and the experienced/Thorsten-Solo/AI-visible comparison.
- Charts use ASCII only: heatmap digits `0..4`, `-` for days not elapsed, and `#`/`.` gauges. Do not use Unicode blocks, color-only signals, or `\ | /` as an intensity scale.
- Keep phase slots stable and split series into blocks of 16. If no reliable phase data exists, show monthly volume without inventing phases.
- Keep every chart at 100 characters or fewer and add exact values plus a CEFR-B2 text alternative in German first and English second.
- Methodology v2 uses Git-tracked text and gross changes from non-merge commits while excluding the ledger, `STATS.md`, and binaries.
- Manual references for this repository are `80` lines/workday (conservative) and `100` lines/workday (Thorsten-Solo, scripting infrastructure).
- Default C#/.NET Thorsten-Solo baseline is `125` lines/workday unless the individual repository documents a justified deviation.
- TVöD conversion basis: `7.8 h` (`7h 48m`) per workday, `21.5` workdays per month, 30 vacation days until the end of 2026, 31 from 2027 onward.
- Shared guidance or statistics-method changes must update `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`, and `.github/copilot-instructions.md` together in the same change.
- Shared guidance or statistics-method changes must update all five shared agent surfaces, including `.github/agents/copilot-instructions.md`, together in the same change.

## Inklusion & Barrierefreiheit / Inclusion & Accessibility

Expand Down
12 changes: 7 additions & 5 deletions GEMINI.md
Original file line number Diff line number Diff line change
Expand Up @@ -164,14 +164,16 @@ Zu Beginn jeder Session das Betriebssystem ermitteln und die passende Skript-Var
- Nach jedem abgeschlossenen Feature/Lastenheft, nach jeder abgeschlossenen Spec-Kit-Phase und auf explizite Anforderung aktualisieren.
- `## Fortschreibungsprotokoll` chronologisch halten: ältester Eintrag oben, neuester unten.
- `## Gesamtstatistik` bleibt immer der letzte Top-Level-Abschnitt.
- Direkt unter der Kennzahlen-Tabelle in `## Gesamtstatistik` kompakte ASCII-only-Diagramme pflegen: mindestens Artefaktmix, Phasenvolumen, konservative Referenz-Balken, Beschleunigungsfaktoren und Vergleich Erfahren/Thorsten-Solo/KI-sichtbar.
- ASCII-X/Y-Diagramme verwenden feste X-Slots: jeder dokumentierte Phasenwert behält seinen Slot, fehlende Werte bleiben leer, und zu breite Reihen werden in beschriftete Blöcke wie `0..15`, `16..31` und `32..47` geteilt.
- Jedes ASCII-Diagramm bekommt eine kurze CEFR-B2-Erklärung in DE zuerst, EN danach.
- Textfreundlich bleiben: keine farbabhängigen Signale und keine Symbole, die auf Braille-Zeilen oder mit Screenreadern schlecht lesbar sind.
- `docs/project-statistics.config.json` und der markierte Profil-2-Block bilden den verbindlichen Vertrag; mit `render-project-statistics.*` aktualisieren.
- Profil 2 zeigt KPI, Artefaktmix, 52-Wochen-Tagesaktivität, Wochen- und kumulatives Volumen, Phasen- oder Monatsvolumen, Speedup-Gauges und den Vergleich Erfahren/Thorsten-Solo/KI-sichtbar.
- Nur ASCII verwenden: Heatmap `0..4`, `-` für noch nicht abgelaufene Tage, Gauges `#`/`.`. Keine Unicode-Blöcke, Farbcodierung oder `\ | /` als Intensitätsskala.
- Phasenslots stabil halten und ab 17 Einträgen in 16er-Blöcke teilen. Ohne belastbare Phasendaten Monatsvolumen zeigen und keine Phasen erfinden.
- Jedes Diagramm bleibt höchstens 100 Zeichen breit und erhält genaue Werte sowie eine CEFR-B2-Textalternative in DE zuerst, EN danach.
- Methodik v2 nutzt Git-getrackten Text und Bruttoänderungen aus Nicht-Merge-Commits; Ledger, `STATS.md` und Binärdaten bleiben ausgeschlossen.
- Für dieses Repository gelten `80` Zeilen/Arbeitstag als konservative Referenz und `100` Zeilen/Arbeitstag als Thorsten-Solo-Basis für Scripting-Infrastruktur.
- Gemeinsame Default-Basis für C#/.NET-Repositories: `125` Zeilen/Arbeitstag, sofern das jeweilige Repo keinen abweichenden, begründeten Wert dokumentiert.
- TVöD-Basis: `7.8 h` pro Arbeitstag, `21.5` Arbeitstage pro Monat, 30 Urlaubstage bis Ende 2026 und 31 ab 2027.
- Änderungen an Statistikmethodik oder gemeinsamer Guidance immer gleichzeitig in `AGENTS.md`, `CLAUDE.md`, `GEMINI.md` und `.github/copilot-instructions.md` pflegen.
- Änderungen an Statistikmethodik oder gemeinsamer Guidance immer gleichzeitig in allen fünf Agentenflächen einschließlich `.github/agents/copilot-instructions.md` pflegen.

## Inklusion & Barrierefreiheit / Inclusion & Accessibility

Expand Down
Loading
Loading