Thore CimbalandClaude Fable 5
889cd47be7
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
24 lines
1.1 KiB
Markdown
24 lines
1.1 KiB
Markdown
# 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](deploy-uebergabe.md) | Ablauf und Prüfliste für „einer baut, ein anderer rollt aus" |
|
|
| [aar-vorlage.md](aar-vorlage.md) | Vorlage für den After Action Report nach einem Deploy |
|
|
| [aar/](aar/) | Abgelegte AARs, benannt `JJJJ-MM-TT-<vorhaben>.md` |
|
|
|
|
[`textbloecke.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.
|