Thore CimbalandClaude Fable 5
92b448fe30
Gate 4, slice 3: verfahren/, hosts/, vision/ and shared/ moved via git mv - six AARs to docs/aar/ (four harvested by the 2026-08-09 retro, two open), procedures and host knowledge to docs/wiki/ (admin, deployment, architecture, new area vision), the retro protocol and the commit mapping table to docs/sources/ (protokolle/, migration/). New: the wiki index linking every page, and the mirror-topology page carrying the why-two-places reasoning verbatim from the old CLAUDE.md (F-013 preserved). All moved-path references retargeted; the link checker drove the sweep to zero. pruefe_prosa.py added (pattern C+D): SHA citations resolve via repo, mapping table, optional component clones or a curated exemption list (documented dead Gitea-force-push commits, a vendor-repo tag, an Authentik uid that is hex but no git SHA, the external neckbeard reference); wiki task prose without an issue reference errors, with a visible pragma for deliberate checklists; the dead-tracker denylist now covers every mirrored repo's retired Gitea tracker (F-005) - two links re-verified against live GitLab titles and retargeted, five defused into honest historical citations. Verified: validate 0/0, gen_status --check current, drift 0. Demo on the pre-migration state fires 6 findings (3 orphaned SHAs, 3 task blocks); on the current tree exactly the 3 F-004 task blocks remain - they turn green in slice 4 when the issues exist, which is why pruefe_prosa joins CI only then. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
123 lines
5.0 KiB
Markdown
123 lines
5.0 KiB
Markdown
---
|
||
type: wiki-page
|
||
area: admin
|
||
related: []
|
||
---
|
||
|
||
# Textbausteine für Sessions
|
||
|
||
Kurze, kopierbare Blöcke, die man einer Claude-/Agenten-Session voranstellt.
|
||
|
||
Die Konventionen stehen kanonisch in [`CLAUDE.md`](../../../AGENTS.md) — aber eine
|
||
Session liest sie nur, wenn sie dazu aufgefordert wird. Diese Bausteine sind die
|
||
Aufforderung.
|
||
|
||
## Zwei Regeln für diese Datei
|
||
|
||
**Die Bausteine verweisen auf die Regeln, sie wiederholen sie nicht.** Stünden die
|
||
Regeln hier ausgeschrieben, gäbe es eine zweite Fassung, die driftet — real
|
||
passiert am 2026-08-02, als `gitops/CLAUDE.md` „keine Gitea-Ausnahme mehr" behauptete,
|
||
während die `management/CLAUDE.md` zwei nannte.
|
||
|
||
**Höchstens acht Zeilen je Baustein.** Der Test ist banal: Wer zum Kopieren scrollen
|
||
muss, benutzt es nicht. Was länger wäre, gehört in die CLAUDE.md — nicht hierher.
|
||
|
||
---
|
||
|
||
## 1 · Session-Start (Mac, mit Lab-Zugang)
|
||
|
||
```
|
||
Lies zuerst CLAUDE.md im management-Repo auf git.lab und halte dich daran.
|
||
Kanonisch ist git.lab; nie direkt nach Gitea pushen.
|
||
Alles Offene wird zum Issue, nicht zur Chat-Notiz — auch Nebenbefunde.
|
||
Bevor du ein Issue schließt oder darüber urteilst: vollständig lesen, inklusive
|
||
Kommentare.
|
||
Bevor du aus einer Vorlage/Spezifikation ableitest: die Quelle öffnen, nicht raten.
|
||
Verifiziert und vermutet klar trennen; fremde Messungen als fremde kennzeichnen.
|
||
```
|
||
|
||
> Die letzten drei Zeilen stehen hier, weil genau das dreimal an einem Tag
|
||
> schiefging: erfundene Theme-Paletten statt gelesener Skill-Quelle; ein Sweep nach
|
||
> dem Pfad `sorb/Backlogs` statt nach dem Namen `Backlogs`; und ein Issue, von dem
|
||
> 750 von 1237 Zeichen gelesen wurden — samt übersehenem Korrekturkommentar, der
|
||
> seit 16 Stunden darunterstand.
|
||
|
||
## 2 · Host-Session (CFGMON, MATRIX — ohne Lab-Zugang)
|
||
|
||
```
|
||
Du arbeitest auf einem Hetzner-Host ohne direkte Lab-Route.
|
||
Konventionen: CLAUDE.md im management-Repo — von hier lesbar über den Gitea-Mirror
|
||
rohana.axion1337.de/sorb/management. Dort NUR lesen, niemals hinpushen.
|
||
Für git.lab (Issues, Pushes) muss sorb erst den Site-to-Site-Tunnel einschalten.
|
||
git.lab-API: PRIVATE-TOKEN-Header — .netrc gilt nur für clone/push (sonst 401,
|
||
bei privaten Projekten irreführend 404, sieht aus wie "Projekt gibt es nicht").
|
||
Ping auf 10.58.73.17 schlägt IMMER fehl (nur 443 + DNS offen), das ist kein
|
||
Tunnelproblem — prüfen mit: curl https://git.lab/users/sign_in
|
||
```
|
||
|
||
> Soll in dieser Session etwas ausgerollt werden, kommt **Baustein 3** dazu — der
|
||
> Deploy-Weg samt AAR-Pflicht steht dort, nicht hier, damit dieser Block kurz bleibt.
|
||
|
||
## 3 · Deploy-Übergabe
|
||
|
||
```
|
||
Öffne auf git.lab ein Issue aus der Vorlage "Deploy-Übergabe"
|
||
(Feld "Description template") und fülle ALLE Felder — Verfahren und Begründung
|
||
je Feld: verfahren/deploy-uebergabe.md.
|
||
Pflicht: Stand (Repo/Branch/Commit) · Testtiefe (ehrlich, "ungetestet" ist gültig)
|
||
· Mengengerüst (geschätzt oder gemessen, dazuschreiben welches) · vollständiges
|
||
Deploy-Kommando inkl. Reload/Recreate · Verifikation DORT WO DER DIENST LIEST
|
||
· Außenwirkung und Not-Aus · Rollback · bewusst offen Gelassenes.
|
||
Wo nichts zutrifft: "-" eintragen, nicht das Feld löschen.
|
||
```
|
||
|
||
## 4 · Abschluss einer Session
|
||
|
||
> **Dieser Baustein ist zugleich unsere Definition of Done für Änderungen ohne
|
||
> Deploy** (festgelegt 2026-08-06). Für Deployments gilt weiterhin das
|
||
> [Übergabe-Verfahren](../deployment/deploy-uebergabe.md) — das ist die längere DoD.
|
||
>
|
||
> Bewusst kein eigenes DoD-Dokument: Es wäre die dritte Fassung derselben Regeln
|
||
> und damit die dritte, die driften kann.
|
||
|
||
```
|
||
Vor dem Ende prüfen und benennen:
|
||
- Alle Commits über git.lab gepusht, kein Rest im Arbeitsverzeichnis, Mirror grün.
|
||
- Jeder offene Punkt und Nebenbefund ist ein Issue — nichts bleibt nur im Chat.
|
||
- Zeitkritisches trägt ein Datum im due_date-Feld, nicht nur im Fließtext.
|
||
- Genau ein status:*-Label je angefasstem Issue; status:wartet nur mit Grund.
|
||
- Gedächtnis aktualisiert: nur was kein Repo festhält.
|
||
- Wiederaufsetzpunkt in einem Satz: Was ist als Nächstes dran, und wer ist dran?
|
||
```
|
||
|
||
## 5 · Entscheidungsvorlage
|
||
|
||
```
|
||
Leg mir das als Entscheidung vor, nicht als offene Frage:
|
||
2–4 Optionen, je eine Zeile Konsequenz, und deine Empfehlung zuerst mit Begründung.
|
||
Sag dazu, was du gemessen und was du angenommen hast.
|
||
Wenn die Entscheidung eine dauerhafte Ausnahme von einer Regel schafft, ist sie
|
||
ADR-pflichtig (decisions/, siehe CLAUDE.md) — dann leg die ADR gleich mit vor.
|
||
```
|
||
|
||
---
|
||
|
||
## Wann welcher
|
||
|
||
| Situation | Baustein |
|
||
|---|---|
|
||
| Neue Session auf dem Mac | 1 |
|
||
| Session auf CFGMON/MATRIX/game | 2 |
|
||
| Etwas gebautes soll ausgerollt werden | 3 |
|
||
| Session neigt sich dem Ende | 4 |
|
||
| Eine Frage braucht sorbs Entscheidung | 5 |
|
||
|
||
Bausteine 1 und 2 schließen sich aus; 3–5 kommen anlassbezogen dazu.
|
||
|
||
## Pflege
|
||
|
||
Ein Baustein wird ergänzt, wenn **derselbe Fehler zweimal** passiert ist — nicht
|
||
vorsorglich. Sonst wachsen sie, bis sie niemand mehr kopiert, und dann wirken sie
|
||
gar nicht mehr. Wächst einer über acht Zeilen, gehört der Inhalt in die CLAUDE.md
|
||
und hier bleibt der Verweis.
|