Files

T

Thore CimbalandClaude Fable 5 889cd47be7 verfahren: Textbausteine fuer Sessions (Workshop #17 , Punkt 6)

Die Konventionen stehen kanonisch in CLAUDE.md, aber eine Session liest sie nur,
wenn sie dazu aufgefordert wird. Diese fuenf Bloecke sind die Aufforderung:
Session-Start, Host-Session, Deploy-Uebergabe, Abschluss, Entscheidungsvorlage.

Zwei Gestaltungsentscheidungen, beide aus Fehlern dieser Woche:

Die Bausteine VERWEISEN auf die Regeln, statt sie zu wiederholen. Waeren sie
ausgeschrieben, gaebe es eine zweite Fassung, die driftet - genau das ist am
2026-08-02 passiert, als gitops/CLAUDE.md 'keine Gitea-Ausnahme mehr' behauptete,
waehrend management/CLAUDE.md zwei nannte.

Und hoechstens acht Zeilen je Block, maschinell geprueft. Der Test ist banal: Wer
zum Kopieren scrollen muss, benutzt es nicht. Der Host-Block musste dafuer zweimal
umgeschrieben werden; die Deploy-/AAR-Zeile ist rausgeflogen und steht jetzt als
Prosa daneben - Prosa muss niemand kopieren.

Die Inhalte sind nicht ausgedacht, sondern die Fehler der Woche: erfundene
Theme-Paletten statt gelesener Quelle, ein Sweep nach dem Pfad statt nach dem
Namen, ein zur Haelfte gelesenes Issue samt uebersehenem Korrekturkommentar, die
.netrc-gegen-PRIVATE-TOKEN-Falle und der Ping, der immer fehlschlaegt.

Pflegeregel dabei: ergaenzt wird ein Baustein, wenn derselbe Fehler ZWEIMAL
passiert ist - nicht vorsorglich. Sonst wachsen sie, bis sie niemand mehr kopiert.

Verlinkt aus CLAUDE.md und verfahren/README.md. 59 relative Links geprueft,
keiner tot.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PKhFj1S3UdD6xL2fbWPeYj

2026-08-06 12:00:00 +00:00

1.1 KiB

Raw Blame History

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.

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.

1.1 KiB Raw Blame History

Verfahren

1.1 KiB

Raw Blame History