generated from admin365/TEMPLATE
43 lines
2.7 KiB
Markdown
43 lines
2.7 KiB
Markdown
# 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_
|