From ff22d63a733a4d14afc858b457fd89ead5bca33b Mon Sep 17 00:00:00 2001
From: VULCAN-v1 <vulcan@xinion.it>
Date: Sun, 28 Jun 2026 10:18:40 +0200
Subject: [PATCH] =?UTF-8?q?feat:=20Ged=C3=A4chtnis-Repo-Template=20(protok?=
 =?UTF-8?q?oll/=20+=20langzeit/=20+=20kurzzeit/=20+=20README)=20f=C3=BCr?=
 =?UTF-8?q?=20Claude-Code-Instanzen?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                 | 43 ++++++++++++++++++++++++++++++++++++++-
 kurzzeit/status.md        |  9 ++++++++
 langzeit/MEMORY.md        |  9 ++++++++
 langzeit/_FAKT-VORLAGE.md | 11 ++++++++++
 protokoll/_VORLAGE.md     |  9 ++++++++
 5 files changed, 80 insertions(+), 1 deletion(-)
 create mode 100644 kurzzeit/status.md
 create mode 100644 langzeit/MEMORY.md
 create mode 100644 langzeit/_FAKT-VORLAGE.md
 create mode 100644 protokoll/_VORLAGE.md

diff --git a/README.md b/README.md
index e7be195..00a5531 100644
--- a/README.md
+++ b/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_
diff --git a/kurzzeit/status.md b/kurzzeit/status.md
new file mode 100644
index 0000000..a95088b
--- /dev/null
+++ b/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>
diff --git a/langzeit/MEMORY.md b/langzeit/MEMORY.md
new file mode 100644
index 0000000..ca92602
--- /dev/null
+++ b/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
+-->
diff --git a/langzeit/_FAKT-VORLAGE.md b/langzeit/_FAKT-VORLAGE.md
new file mode 100644
index 0000000..1481b54
--- /dev/null
+++ b/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. -->
diff --git a/protokoll/_VORLAGE.md b/protokoll/_VORLAGE.md
new file mode 100644
index 0000000..7904fbd
--- /dev/null
+++ b/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. -->