# 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_