Claude-Code-Instanz — Gedächtnis-Repo (TEMPLATE)

Vorlage für das persistente Gedächtnis einer Claude-Code-Instanz. Kopiere dieses Repo (Forgejo: „Use this template" / „Repository aus Vorlage erstellen") für eine neue Instanz und passe die Platzhalter <INSTANZ> an. Eine Instanz = ein Repo. Zweck: nichts geht bei Host-Verlust verloren, alles ist versioniert und nachvollziehbar.

Struktur

Ordner / Datei	Inhalt	Charakter
protokoll/	Tagesprotokolle YYYY-MM-DD.md — was an dem Tag getan/entschieden/verifiziert wurde	chronologisch, lückenlos
langzeit/	Langzeitgedächtnis: kuratierte, dauerhafte Fakten · MEMORY.md = Index, eine Datei je Fakt	destilliert, dedupliziert
kurzzeit/	Kurzzeitgedächtnis: aktueller Arbeitsstand & offene Fäden (status.md)	flüchtig, wird beschnitten

Was die Instanz zu tun hat

1. Protokollieren (täglich). Jeden Arbeitstag in protokoll/YYYY-MM-DD.md festhalten, was getan, entschieden, verifiziert wurde — mit Uhrzeit, append-only, jederzeit nachvollziehbar. (Vorlage: protokoll/_VORLAGE.md.)
2. Langzeit pflegen. Dauerhaft Wichtiges — wer der Nutzer ist, Feedback/Präferenzen, stabile Projekt-Fakten, Referenzen — als kuratierte Fakten in langzeit/. Dedupliziere, halte aktuell, lösche Falsches. langzeit/MEMORY.md = Index (eine Zeile je Fakt). (Format: langzeit/_FAKT-VORLAGE.md.)
3. Kurzzeit führen. Aktuellen Arbeitsstand + offene Fäden in kurzzeit/status.md. Flüchtig.
4. Konsolidieren (Kurzzeit/Protokoll → Langzeit). Was sich als dauerhaft erweist, nach langzeit/ destillieren; Kurzzeit beschneiden. Ohne diesen Kreislauf bläht Kurzzeit auf und Langzeit veraltet.
5. Sichern. Nach jeder wesentlichen Änderung committen + pushen (Deploy-Key) — so geht nichts verloren.

Einrichtung einer neuen Instanz

1. Repo aus diesem Template erzeugen, Name = Instanz (z. B. <INSTANZ>).
2. Eigenen Deploy-Key (Schreibzugriff) am neuen Repo hinterlegen — je Instanz ein eigener Key (nicht teilen).
3. <INSTANZ>-Platzhalter in README.md, kurzzeit/status.md ersetzen; _VORLAGE.md/_FAKT-VORLAGE.md als Muster behalten oder löschen.
4. Erstes protokoll/<heute>.md anlegen und mit dem Arbeiten beginnen.

Regeln

• Privat. Enthält interne Topologie / IPs / Pfade — niemals öffentlich.
• Nur das eigene Repo beschreiben. Eine Instanz = ein Repo, ein eigener Deploy-Key.
• Langzeit-Fakten mit Frontmatter (name, description, metadata.type = user|feedback|project|reference); im Text mit [[name]] auf verwandte Fakten verlinken.

Template · Xinion IT GmbH · git.xinion.de