bruh2211/universal-agent-skills

🧠 Memory Bank — Persistentes Agentengedächtnis & Kontextprotokoll

Sie sind ein Agent, der mit Memory Bank ausgestattet ist, einem strukturierten externen Gedächtnissystem. Sprachmodelle setzen zwischen Sitzungen zurück und verlieren während langer Arbeitsabläufe den Kontext. Die Memory Bank löst dies, indem sie die Projektkontinuität in ein strukturiertes Verzeichnis einfacher Markdown-Dateien innerhalb des Repositorys externalisiert.

---

📁 Memory Bank-Architektur

Die Memory Bank befindet sich in einem memory-bank/-Verzeichnis im Projektstammverzeichnis:

project-root/
└── memory-bank/
    ├── projectbrief.md     # Kernmission, Umfang, Ziele, unverhandelbare Punkte
    ├── productContext.md   # Warum dies existiert, gelöste Benutzerprobleme, Benutzerreisen
    ├── activeContext.md    # AKTUELLER FOKUS, aktive Entscheidungen, aktuelle Änderungen, unmittelbare nächste Schritte
    ├── systemPatterns.md   # Architektur, Komponentenstruktur, Entwurfsmuster, Datenflüsse
    ├── techContext.md      # Technologie-Stack, Abhängigkeiten, Laufzeitbeschränkungen, Umgebungseinrichtung
    └── progress.md         # Was funktioniert, was gebaut ist, bekannte Fehler, Fahrplan

---

⚡ Progressives Ladeprotokoll

Um den Token-Verbrauch gering zu halten und eine Verdünnung des Kontexts zu vermeiden:

1. Bei Sitzungsstart / Wiederaufnahme der Arbeit:
   • Überprüfen, ob memory-bank/ existiert.
   • Wenn es existiert, zuerst memory-bank/activeContext.md lesen. Dies stellt sofort das Situationsbewusstsein wieder her.
   • memory-bank/systemPatterns.md oder techContext.md NUR lesen, wenn relevante Architektur- oder Build-Konfigurationen geändert werden.
2. Bei wichtigen Entscheidungen / Sitzungsende:
   • memory-bank/activeContext.md mit dem aktualisieren, was sich geändert hat und was noch bleibt.
   • memory-bank/progress.md mit neu abgeschlossenen Meilensteinen oder entdeckten Fehlern aktualisieren.

---

🛠️ Gedächtnisbefehle & Aktionen

1. /memory init (Memory Bank initialisieren)

Wenn memory-bank/ nicht existiert:

• Die Repository-Struktur scannen (package.json, README.md, Quelldateien, git log).
• Alle 6 Kerndateien generieren, gefüllt mit verifizierten Details aus der aktuellen Codebasis.

2. /memory update (Aktuellen Zustand synchronisieren)

• Die Codeänderungen, architektonischen Wendepunkte und aktiven Aufgaben der aktuellen Sitzung in activeContext.md zusammenfassen.
• Abgeschlossene Elemente in progress.md von "In Bearbeitung" nach "Abgeschlossen" verschieben.

3. /memory record <decision> (Technische Entscheidung protokollieren)

• Die Entscheidung, Begründung und in Betracht gezogenen Alternativen an systemPatterns.md anhängen.

---

📋 Dateivorlagen

activeContext.md

# Aktiver Kontext

## Aktueller Fokus
- [Kurze Zusammenfassung des aktuellen Ziels]

## Aktuelle Änderungen
- [Geänderte Datei oder Komponente] — [Begründung]

## Aktive Entscheidungen & Überlegungen
- [Abgestimmter Kompromiss oder Muster]

## Nächste Schritte
1. [Unmittelbare Aufgabe 1]
2. [Unmittelbare Aufgabe 2]

progress.md

# Projektfortschritt

## Was funktioniert
- [Funktion A] — funktionsfähig verifiziert
- [Funktion B] — mit Unit-Tests verifiziert

## Was noch zu bauen ist
- [ ] Meilenstein 1
- [ ] Meilenstein 2

## Bekannte Probleme / Blocker
- [Problembeschreibung und mögliche Behebung]