Files

T

Thore CimbalandClaude Fable 5 92b448fe30 feat: slice 3 - wiki, sources and AARs in their neckbeard homes

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>

2026-08-11 12:00:00 +00:00

5.0 KiB

Raw Blame History

type, area, related

type

area

wiki-page

admin

Textbausteine für Sessions

Kurze, kopierbare Blöcke, die man einer Claude-/Agenten-Session voranstellt.

Die Konventionen stehen kanonisch in CLAUDE.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 — 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.

5.0 KiB Raw Blame History Unescape Escape