commit 6c61cabf3d1350bb068cff0e0e70984fa0c856e2 Author: Admin365 Date: Sun Jun 28 14:19:33 2026 +0200 Initial commit diff --git a/README.md b/README.md new file mode 100644 index 0000000..00a5531 --- /dev/null +++ b/README.md @@ -0,0 +1,43 @@ +# 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 +`` 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. ``). +2. Eigenen **Deploy-Key (Schreibzugriff)** am neuen Repo hinterlegen — **je Instanz ein eigener Key** (nicht teilen). +3. ``-Platzhalter in `README.md`, `kurzzeit/status.md` ersetzen; `_VORLAGE.md`/`_FAKT-VORLAGE.md` als + Muster behalten oder löschen. +4. Erstes `protokoll/.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 () + +_Stand: . Flüchtig — offene Fäden; Dauerhaftes wandert nach langzeit/._ + +## Offene Fäden +- + +## Zuletzt erledigt +- .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 — + +> 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. + + 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: +description: +metadata: + type: user | feedback | project | reference +--- + + + + 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 — () + +Tageschronik der Instanz. Append-only, nachvollziehbar. Dateiname je Tag: `YYYY-MM-DD.md`. + +## +- **HH:MM** — was getan/entschieden wurde. +- Verifikation: . + +