Communitygithub.com

usereportly/decision-memory-skill

Eine Agenten-Fertigkeit, die Code-Agenten lehrt, Entscheidungsgedächtnis-Kommentare zu lesen, zu schreiben und zu bewahren – markierte Notizen im Code, die festhalten, warum ein Design existiert und was nicht kaputt gemacht werden darf, damit eine spätere Änderung es nicht unbemerkt rückgängig macht.

Was ist decision-memory-skill?

Diese Fertigkeit befähigt KI-Code-Agenten (wie Claude Code, Cursor oder Codex), explizite Entscheidungsgedächtnis-Kommentare in Codebasen zu lesen, zu schreiben und zu erhalten. Sie ist besonders nützlich für langlebige Projekte mit mehreren Entwicklern oder KI-gestützten Editoren, bei denen das Risiko besteht, dass wichtige Designentscheidungen versehentlich überschrieben werden. Die Fertigkeit etabliert ein standardisiertes Kommentarformat, z. B. `// DM(why): Diese Implementierung priorisiert Speicher gegenüber Geschwindigkeit, da das Zielsystem nur 256 KB RAM hat.` oder `// DM(what): Diese Funktion darf niemals null zurückgeben, da der Aufrufer keine Nullprüfung durchführt.`. Agenten werden trainiert, diese Kommentare während der Codeanalyse zu identifizieren, sie beim Refactoring zu bewahren und selbst neue solche Kommentare zu generieren, wenn sie Designentscheidungen treffen. Dies reduziert das Risiko von „regression bugs“ und verbessert die Zusammenarbeit zwischen menschlichen und KI-Entwicklern.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add usereportly/decision-memory-skill

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht decision-memory-skill?

Eine Agenten-Fertigkeit, die Code-Agenten lehrt, Entscheidungsgedächtnis-Kommentare zu lesen, zu schreiben und zu bewahren – markierte Notizen im Code, die festhalten, warum ein Design existiert und was nicht kaputt gemacht werden darf, damit eine spätere Änderung es nicht unbemerkt rückgängig macht.

Übersicht

Diese Fertigkeit identifiziert spezielle Kommentare im Format // DM(why|what): <Beschreibung> und behandelt sie als ausführbare Dokumentation.

  • DM(why) – Erklärt die Begründung hinter einer Implementierungsentscheidung.
  • DM(what) – Markiert eine Einschränkung oder ein Verhalten, das erhalten bleiben muss.

Funktionsweise

  1. Lesen: Der Agent analysiert den Quellcode auf bestehende DM-Kommentare.
  2. Schreiben: Der Agent fügt selbst DM-Kommentare hinzu, wenn er eine neue Entscheidung trifft, die bewahrt werden muss.
  3. Bewahren: Beim Refactoring oder Bearbeiten von Code mit DM-Kommentaren stellt der Agent sicher, dass diese nicht entfernt werden, es sei denn, der Grund dafür ist explizit überholt.

Verwendung

// DM(why): Asynchrone Iteration gewählt, um den Hauptthread nicht zu blockieren.
// DM(what): Diese Schleife muss mindestens einmal ausgeführt werden, auch bei leerer Eingabe.

Unterstützte Plattformen

  • Claude Code
  • Cursor
  • Codex CLI
  • GitHub Copilot (Chat-Modus)

Konfiguration

Keine spezielle Konfiguration erforderlich. Die Fertigkeit funktioniert durch Erkennung des Kommentarpräfixes.

Lizenz

MIT

Verwandte Skills