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:
co-authored by
Claude Fable 5
parent
6b8869f160
commit
bff1ca4477
@@ -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
|
||||
|
||||
@@ -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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user