From bff1ca44776497f43c22aaf1ef5fd528d0ac55fa Mon Sep 17 00:00:00 2001 From: Thore Cimbal Date: Tue, 11 Aug 2026 12:00:00 +0000 Subject: [PATCH] docs: close Gate 2 - sources taxonomy, upstream drift check, ADRs accepted Amendments decided with the human at the Gate-2 STOP: docs/sources/ gets a by-source-type taxonomy (regelwerk/upstream/protokolle/ migration, proposed by sorb), the pinned v0.1.1 originals become a byte-compare baseline against silent framework-file rewrites, AGENTS.md carries the change-only-with-sorb rule forward, and the issue import may read descriptions via the token (read-only). ADR-0011 and ADR-0012 flipped to accepted. Co-Authored-By: Claude Fable 5 --- .../0011-issues-im-repo-gitlab-als-spiegel.md | 2 +- ...12-gruppenregeln-kanonisch-mit-pruefung.md | 2 +- docs/design/2026-08-11-neckbeard-migration.md | 30 ++++++++++++++++--- 3 files changed, 28 insertions(+), 6 deletions(-) diff --git a/docs/adr/0011-issues-im-repo-gitlab-als-spiegel.md b/docs/adr/0011-issues-im-repo-gitlab-als-spiegel.md index c39b739..03f0768 100644 --- a/docs/adr/0011-issues-im-repo-gitlab-als-spiegel.md +++ b/docs/adr/0011-issues-im-repo-gitlab-als-spiegel.md @@ -1,7 +1,7 @@ --- type: adr id: "0011" -status: proposed +status: accepted date: 2026-08-11 supersedes: null superseded_by: null diff --git a/docs/adr/0012-gruppenregeln-kanonisch-mit-pruefung.md b/docs/adr/0012-gruppenregeln-kanonisch-mit-pruefung.md index 9cb79bb..07c57f1 100644 --- a/docs/adr/0012-gruppenregeln-kanonisch-mit-pruefung.md +++ b/docs/adr/0012-gruppenregeln-kanonisch-mit-pruefung.md @@ -1,7 +1,7 @@ --- type: adr id: "0012" -status: proposed +status: accepted date: 2026-08-11 supersedes: null superseded_by: null diff --git a/docs/design/2026-08-11-neckbeard-migration.md b/docs/design/2026-08-11-neckbeard-migration.md index f9259ef..ab796cf 100644 --- a/docs/design/2026-08-11-neckbeard-migration.md +++ b/docs/design/2026-08-11-neckbeard-migration.md @@ -193,21 +193,22 @@ werkzeugwidersprechend — Nicht-Ziel „kein Umschreiben"): | Alt | Neu | |---|---| -| `CLAUDE.md` | Ein-Zeilen-Pointer; Regeln → `AGENTS.md` (Upstream-Abschnitte wörtlich + Abschnitt „Gruppenregeln"); Karpathy-Block wortgleich → `docs/sources/karpathy-guidelines.md`, aus AGENTS.md zitiert *(Freigabe sorb nötig — stehende Regel)* | +| `CLAUDE.md` | Ein-Zeilen-Pointer; Regeln → `AGENTS.md` (Upstream-Abschnitte wörtlich + Abschnitt „Gruppenregeln"); Karpathy-Block wortgleich → `docs/sources/regelwerk/karpathy-guidelines.md`, aus AGENTS.md zitiert *(freigegeben von sorb, 2026-08-11)* | | `decisions/0001…0010` | `docs/adr/0001…0010`, Frontmatter ergänzt, Text unverändert; `decisions/` entfällt, Verweise nachgezogen | | `roadmap.md` | Bleibt als Linien/Reihenfolge-Prosa; alle Zählungen und „Stand"-Blöcke raus (→ generiertes STATUS.md); M5 statt „offene Frage" (F-001) | | `verfahren/aar/*` (5) | `docs/aar/*`, Frontmatter (`open`/`harvested` nach Retro-Lage) | -| `verfahren/retro/*` | `docs/sources/retro/*` (unveränderliche Protokolle) | +| `verfahren/retro/*` | `docs/sources/protokolle/*` (unveränderliche Protokolle) | | `verfahren/refinement.md` | `docs/wiki/admin/refinement.md` | | `verfahren/deploy-uebergabe.md` | `docs/wiki/deployment/deploy-uebergabe.md` | | `verfahren/stillstandspruefung.md` | `docs/wiki/admin/stillstandspruefung.md` | | `verfahren/textbloecke.md` | `docs/wiki/admin/textbloecke.md` (Pfade angepasst) | -| `verfahren/issue-migration/` | `docs/sources/issue-migration/` | +| `verfahren/issue-migration/` | `docs/sources/migration/issue-migration/` | | `verfahren/aar-vorlage.md` | ersetzt durch neckbeards `docs/aar/template.md` | | `hosts/*` (4) | `docs/wiki/admin/.md`; offene Arbeitspunkte → Issues (F-004, 5/5) | | `vision/*` (3) | `docs/wiki/vision/*` (neue Wiki-Area `vision` — Alt-Wert „eine Datei je Linie", altes ADR-0005) | | `shared/branding.md`, `lab-netzwerk.md`, `zone-axion1337.md` | `docs/wiki/architecture/*` | -| `shared/commit-zuordnung-2026-08-07.md` | `docs/sources/commit-zuordnung-2026-08-07.md` | +| `shared/commit-zuordnung-2026-08-07.md` | `docs/sources/migration/commit-zuordnung-2026-08-07.md` | +| — *(neu)* | `docs/sources/upstream/neckbeard-v0.1.1/` — gepinnte Originale als Baseline für den Drift-Check | | — *(neu)* | `PROJECT.md` ✓, `WORKFLOW.md` (wörtlich v0.1.1), `schema.yaml` (v0.1.1 + ausgewiesene Erweiterungen), `STATUS.md` (generiert), `docs/components/` (6 Deklarationen: 5 Komponenten + management; `game-operating`/`gameserver` als `external`), `docs/issues/` (importierte offene management-Issues + F-004-Nachzügler) | | `scripts/stillstandspruefung.py`, `ci/` | Bleiben; dazu `validate.py`, `gen_status.py` (v0.1.1) und die neuen Prüfskripte; `.gitlab-ci.yml` erhält einen Offline-Job `validate` (jeder Push) neben der geplanten Stillstandsprüfung | @@ -269,6 +270,27 @@ Feature-lokale Entscheidungen (bleiben hier): (Lücke +8). 6. **`analysis/` und `drafts/`** des Analyse-Branches bleiben dort; nichts davon wird auf diesen Branch geholt. +7. **`docs/sources/` wird nach Quellenart untergliedert** (Vorschlag + sorb, 2026-08-11): `regelwerk/` (wortgleiche Regeltexte), + `upstream/` (gepinnte Framework-Originale), `protokolle/` + (Retro-/Workshop-Protokolle), `migration/` (Zuordnungen, + Umzugsunterlagen). Kriterium bleibt *lebendig → Wiki, unveränderlich + → sources*; AARs sind Artefakte mit Lebenszyklus, keine Quellen. +8. **Drift-Check gegen Upstream-Baseline:** die v0.1.1-Originale liegen + unter `docs/sources/upstream/neckbeard-v0.1.1/`; ein Offline-Check + vergleicht die Instruktionsdateien (CLAUDE.md-Pointer, AGENTS.md bis + zur Projektabschnitts-Marke, WORKFLOW.md, Templates) byteweise. + Stilles Umschreiben durch eine Session wird damit roter Befund; + Framework-Upgrade = bewusste Baseline-Aktualisierung. `schema.yaml` + und die Skripte sind **erklärt projekterweitert** — Original liegt + zur Diffbarkeit bei, wird aber nicht byte-erzwungen. +9. **AGENTS.md-Änderungsschutz:** die alte Fußzeilen-Regel zieht in den + Projektabschnitt um — Änderungen an AGENTS.md nur mit sorb + abgestimmt. +10. **Issue-Import liest Beschreibungstexte** der offenen + management-Issues read-only über den Token (freigegeben von sorb, + 2026-08-11); Kommentare bleiben auf GitLab, der Tokenwert erscheint + nirgends. ### Constraints