feat: Gedächtnis-Repo-Template (protokoll/ + langzeit/ + kurzzeit/ + README) für Claude-Code-Instanzen

README.md

@@ -1,2 +1,43 @@
-# TEMPLATE
+# 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_

kurzzeit/status.md

@@ -0,0 +1,9 @@
+# Kurzzeit — aktueller Arbeitsstand (<INSTANZ>)
+
+_Stand: <DATUM>. Flüchtig — offene Fäden; Dauerhaftes wandert nach langzeit/._
+
+## Offene Fäden
+- <was gerade läuft / worauf gewartet wird>
+
+## Zuletzt erledigt
+- <Kurzfassung; Details siehe protokoll/<DATUM>.md>

langzeit/MEMORY.md

@@ -0,0 +1,9 @@
+# Memory Index — <INSTANZ>
+
+> Langzeitgedächtnis-Index. **Eine Zeile je Fakt**, Format:
+> `- [Titel](datei.md) — kurzer Hook`
+> Wird beim Session-Start geladen; eine Datei je Fakt im selben Ordner.
+
+<!-- Beispiel (löschen, sobald echte Fakten da sind):
+- [Wer der Nutzer ist](user-<name>.md) — Rolle, Präferenzen, Arbeitsweise
+-->

langzeit/_FAKT-VORLAGE.md

@@ -0,0 +1,11 @@
+---
+name: <kebab-case-slug>
+description: <eine Zeile — wird zur Relevanz-Entscheidung beim Erinnern genutzt>
+metadata:
+  type: user | feedback | project | reference
+---
+
+<Der Fakt. Für feedback/project: danach **Warum:** und **Wie anzuwenden:** ergänzen.
+Mit [[anderer-name]] auf verwandte Fakten verlinken.>
+
+<!-- Vorlage-Datei — kopieren, umbenennen, Inhalt ersetzen; diese Datei dann löschen. -->

protokoll/_VORLAGE.md

@@ -0,0 +1,9 @@
+# Protokoll — <TT. Monat JJJJ> (<INSTANZ>)
+
+Tageschronik der Instanz. Append-only, nachvollziehbar. Dateiname je Tag: `YYYY-MM-DD.md`.
+
+## <Thema/Block>
+- **HH:MM** — was getan/entschieden wurde.
+- Verifikation: <Befehl/Ergebnis>.
+
+<!-- Vorlage — pro Tag eine eigene Datei YYYY-MM-DD.md anlegen. -->