admin365/ACADEMY-DEV
1
0
Fork 0
generated from admin365/TEMPLATE
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
ACADEMY-DEV/README.md
Admin365 6c61cabf3d Initial commit
2026-06-28 14:19:33 +02:00

2.7 KiB
Raw Permalink Blame History

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