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 <noreply@anthropic.com>
This commit is contained in:
Thore Cimbal
2026-08-11 20:45:18 +02:00
co-authored by Claude Fable 5
parent 6b8869f160
commit bff1ca4477
3 changed files with 28 additions and 6 deletions
@@ -1,7 +1,7 @@
---
type: adr
id: "0011"
status: proposed
status: accepted
date: 2026-08-11
supersedes: null
superseded_by: null
@@ -1,7 +1,7 @@
---
type: adr
id: "0012"
status: proposed
status: accepted
date: 2026-08-11
supersedes: null
superseded_by: null
+26 -4
View File
@@ -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/<host>.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