Files
management/verfahren
Thore Cimbal 0fde69a6f2 docs: first retro, and the ADR the history rewrite should have had
Retro 2026-08-09, the first one under the framework. Main finding: six silent failures in nine days - a green pipeline that uploaded nothing, a broken npm package, a blueprint rejected on every run, a working copy tracking the forbidden remote, empty pipelines going red for nothing, and a release build that nearly overwrote a published image. None was found by monitoring; four surfaced by accident while looking for something else.

ADR-0009 documents the commit conventions and the retroactive anonymisation of 251 commits. It is filed after the fact, which is exactly the mistake the ADR duty exists to prevent - stated in the ADR rather than smoothed over.

Also recorded: assigning status:next and reassigning milestones are forbidden to a session acting alone; both happened here in the refinement with sorb, so the rule stands unweakened.
2026-08-09 12:00:00 +00:00
..

Verfahren

Wiederkehrende Abläufe zwischen Personen und Hosts — dort festgehalten, wo sie nicht an einem einzelnen Projekt-Repo hängen.

Datei Inhalt
deploy-uebergabe.md Ablauf und Prüfliste für „einer baut, ein anderer rollt aus"
aar-vorlage.md Vorlage für den After Action Report nach einem Deploy
aar/ Abgelegte AARs, benannt JJJJ-MM-TT-<vorhaben>.md

textbloecke.md hält kurze, kopierbare Blöcke, die man einer Session voranstellt — sie verweisen auf die Konventionen, statt sie zu wiederholen. Baustein 4 (Abschluss) ist zugleich die Definition of Done für Änderungen ohne Deploy; für Deployments gilt deploy-uebergabe.md.

Die zugehörige Issue-Vorlage liegt unter .gitlab/issue_templates/Deploy-Übergabe.md und erscheint beim Anlegen eines Issues in diesem Repo im Auswahlfeld Description template als Deploy-Übergabe.

Abgrenzung zum Rest des Repos: hosts/ und shared/ halten offene Punkte, dieses Verzeichnis hält wie wir arbeiten. Ein Verfahren wird hier nur aufgenommen, wenn es mindestens einmal an einem echten Vorfall gescheitert oder bewährt ist — der auslösende AAR wird jeweils verlinkt.