docs: Gate 5 closeout - AAR, harvest, design doc done

The design doc closes with its AAR (planned/actual/why/learnings, the
six acceptance criteria checked off 6/6, the session's shakiest calls
named) and moves to docs/design/done/ with status done. Harvest: a
stolpersteine wiki page distilled from the AAR (hex is not a git SHA,
TZ on the git process, python floor, anonymous Gitea negatives,
negative tests, directory links), and the neckbeard feedback list
becomes issue 0040 - a deliberate separate act, per the design's
non-goals. Operational follow-up is issues 0041 (refine imported
wartegrund) and 0042 (go-live: push, first mirror run, CI schedule,
milestone for gitops#61). Final chain green: validate 0/0 over 36 open
issues, gen_status --check current, drift 0, prosa 0.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Thore Cimbal
2026-08-11 12:00:00 +00:00
co-authored by Claude Fable 5
parent 865d761fb0
commit c481165ab4
11 changed files with 230 additions and 19 deletions
+1 -1
View File
@@ -21,7 +21,7 @@ mit Inhalt. Projektfassung des neckbeard-Index (Original:
| `vision/` | Eine Datei je Linie: [axion1337.chat](vision/axion1337-chat.md) · [Homelab](vision/homelab.md) · [ThreadNet](vision/threadnet.md) | belegt |
| `user-guide/` | Für Nicht-Owner | entfällt — Gate 0: Publikum ist Owner + Sessions |
| `requirements/` | Eigenständige Anforderungssicht | nur bei echtem Bedarf |
| `faq/`, `stolpersteine/` | Nur aus AARs und geschlossenen Issues geerntet — nie auf Vorrat | leer, entsteht im Refinement |
| `faq/`, `stolpersteine/` | Nur aus AARs und geschlossenen Issues geerntet — nie auf Vorrat: [neckbeard-migration](stolpersteine/neckbeard-migration.md) | wächst im Refinement |
## Seitenregeln
@@ -0,0 +1,33 @@
---
type: wiki-page
area: stolpersteine
sources:
- "docs/design/done/2026-08-11-neckbeard-migration.md"
related: []
---
# Stolpersteine aus der neckbeard-Migration (2026-08-11)
Geerntet aus dem Gate-5-AAR der Migration; Belege dort.
- **Hex ≠ Git-SHA.** Authentik-uids und Alertmanager-Silence-IDs sehen
aus wie Commit-SHAs. Die SHA-Prüfung führt deshalb eine kuratierte
Ausnahmenliste (`scripts/sha_ausnahmen.tsv`) — jede Zeile mit Grund;
Einträge ohne Grund sind nicht zulässig.
- **`TZ` gehört an den git-Prozess.** `git log --date=format-local`
ohne `TZ=UTC` in der Prozessumgebung zeigt lokale Zeit und lässt
jeden 12:00Z-Commit „falsch" aussehen (Session-1-Lehre, zweimal
bestätigt).
- **`gen_status.py` braucht lokal Python ≥ 3.10**
(`Path.write_text(newline=)`); macOS-System-Python 3.9 reicht nicht —
venv nutzen, CI läuft auf 3.12.
- **Anonyme Gitea-Negative sind inkonklusiv.** Gitea verbirgt private
Repos hinter einer Auth-Abfrage; ein fehlgeschlagenes anonymes
`ls-remote` belegt keine Nichtexistenz (Feldtest F-007-Addendum,
dokumentiert in `docs/components/game-operating.md`).
- **Ein grüner Validator zählt erst mit Negativtests.** Alle vier
neuen Prüfregeln wurden mit absichtlich kaputten Artefakten
nachgewiesen — die Upstream-Lehre aus dem Schöpfungs-AAR hat sich
wiederholt bestätigt.
- **Verzeichnis-Links sind tote Links** für `validate.py` — immer auf
eine Datei zielen (README des Ordners oder konkrete Seite).