Startseite / Artikel

Vier Regeln für das Kodieren des Agentengedächtnisses, das weiterhin ehrlich bleibt

Das Speichern mehrerer Notizen behebt das Speichermemory des Code-Agenten nicht. Vier Regeln sorgen für Ehrlichkeit: sichtbare Veraltetheit, automatische Redaktion bei Fehlern, laute Trunkierung sowie beibehaltene Einschränkungen.

Verlag: REACTAPP.TOP9 Min. Lesezeit2130 Wörter

Quellen: Your Coding Agent Has a Memory Problem. Storing More Won’t Fix It.

Öffnen Sie ein zweites Chat-Fenster – Ihr Programmier-Assistent weiß davon nichts. Nicht weniger als zuvor, aber einfach nichts. Die Entscheidung von vor vierzig Minuten, warum der warteschlangenbasierte Ansatz abgelehnt wurde, ist verschwunden. Ebenso wie die Einschränkung, dass das Sicherheitsteam des Kunden niemals eine neue Datenbank genehmigen wird, sowie die drei Sackgassen, die Sie bereits untersucht haben, damit niemand sie erneut durchlaufen muss. Der Kontext überlebt kein Fensterwechsel.

Deshalb die Routine: Kopieren Sie den alten Chat ein, tippen Sie alles ein, was Sie sich erinnern können, und erklären Sie erneut das, was Sie nicht herausfinden konnten. Das dauert leicht zehn bis fünfzehn Minuten pro Wechsel, und Premium-Anfragen werden mit Schlussfolgerungen verschwendet, die Sie bereits einmal erarbeitet haben.

Keines der Plattformen schließt diese Lücke, da jede Merkfunktion ausschließlich auf das ausgerichtet ist, was man eigentlich vergessen möchte. Die Lösung eines Entwicklers bestand darin, eine eigene Merkmalschicht zu erstellen: etwa 2.600 Zeilen in Node, ohne Laufzeitabhängigkeiten, die GitHub Copilot, Claude Code und Codex unterstützen. Fast sofort stieß dieses System auf das Problem, vor dem niemand warnt.

Mehr Speicher verschlimmert die Situation

Der eigentliche Fehler eines Merksystems liegt nicht im Vergessen. Er liegt darin, fälschlicherweise und mit Überzeugung zu merken.

Stellen Sie sich eine Notiz vor, die besagt „Authentifizierung verwendet JWT“, die zu der Zeit geschrieben wurde, als das zutraf, und vier Monate später wieder abgerufen wird, nachdem die Codebasis auf Server-seitige Sessions umgestellt wurde. Diese Notiz verschwindet nicht in Unklarheit. Sie wird weiterhin abgerufen, vertraut und darauf aufgebaut – am Ende erhält man einen Agenten, der gezielt und zuversichtlich falsch liegt und sogar eine Quelle nennen kann. Das ist streng genommen schlimmer als ein Agent, der sagt „Ich weiß nicht, wie die Authentifizierung hier funktioniert“, denn dieser Agent fragt nach, während der zuversichtliche Agent die falschen Lösungen bereitstellt.

Speicherung ist also nicht der Ort für raffinierte Ingenieurskunst, da sie im Grunde nur aus einer Datei und einem Schema besteht. Die schwierige Aufgabe besteht darin, sicherzustellen, dass das gespeicherte Wissen weiterhin korrekt bleibt, während sich der zugrundeliegende Code ändert. Die Lösung bestand aus vier Garantien, von denen jede nur wenig Code erforderte und viel Selbstkontrolle.

Wer schreibt die Notizen?

Der Autor ist ein Sprachmodell, und fast jede Gestaltungsentscheidung folgt daraus. Seine Eingaben sind nicht vertrauenswürdig – allerdings nicht, weil jemand böswillig ist: Sie stammen aus einem Gespräch, das möglicherweise eine API-Schlüssel, eine Verbindungszeichenkette oder die E-Mail-Adresse einer Person enthielt. Sein Ausgabeformat darf nicht als selbstverständlich angesehen werden, und jeder Korrekturvorgang verbraucht eine eigene Anfrage.

Der letzte Punkt tritt an einer unerwarteten Stelle auf: Der Validator meldet alle Probleme auf einmal, anstatt bei dem ersten aufzuhören.

export function validateNode(input) {
  const e = [];
  // ...every check pushes onto e instead of throwing...
  if (e.length) throw new ValidationError(e);
  return n;
}

Schnell versagen zu wollen ist ein Reflex – und hier ist das falsch. Ein Modell, das seine eigene Ausgabe korrigiert, kann alles in einer einzigen Iteration reparieren, anstatt Fehler nacheinander zu finden, wobei jeder Fehler eine zusätzliche Anfrage erfordert. Es handelt sich um eine kleine Änderung, doch sie unterscheidet zwischen einem erneuten Versuch und fünf.

Notizen gibt es in vier Arten, was bald von Bedeutung sein wird: system, decision, convention und constraint.

Regel 1: Zeigen Sie die Veraltetheit an, wenn die Notiz verwendet wird

Das Problem zwischen JWT und Sessions lässt sich nicht verhindern. Eine Notiz kann am Montag korrekt sein und bis März falsch, unabhängig vom Design. Was möglich ist, ist die Anzeige des Alters einer Notiz genau in dem Moment, in dem jemand darauf vertrauen will – das ist der einzige Zeitpunkt, zu dem jemand handeln kann.

Jede Notiz speichert den HEAD-Pointer des Repositoriums, bei dem sie erstellt wurde:

id: auth-service
type: system
title: Auth uses server sessions
scope: repo
confidence: observed
captured_sha: a1b2c3d      # repo HEAD at capture
repos: [orders-api]
edges:
  - rel: depends-on
    dst: postgres-primary

Bei der Abrufung wird dies in eine Anzahl von Commit-Operationen umgewandelt:

captured 47 commits ago — verify before trusting

Es ist kein Modell beteiligt, es gibt keine geplanten Aufgaben und keinen Hintergrundscanner, der die Frische bewertet. Ein einziger Befehl git rev-list --count ..HEAD erledigt die Aufgabe, ist deterministisch und kostengünstig genug, um direkt ausgeführt zu werden.

Drei kleine Details erwiesen sich als wichtiger als die Hauptidee.

Eine umgeschriebene Historie ist eine andere Antwort. Wenn aufgrund eines Rebase oder Prune der Commit nicht mehr erreichbar ist, wäre das Ausgeben von null Commits in die beruhigende Richtung eine Falschdarstellung. Stattdessen gibt das Tool an: „Historie umgeschrieben, überprüfen.“ Unbekannt und frisch sind unterschiedliche Antworten, und sie müssen getrennt bleiben.

Anmerkungen werden nur in dem Repository annotiert, das sie angeben. Die Anzahl der Commits, gemessen an einer nicht verwandten Historie, ist Rauschen, das sich als Signal ausgibt. Eine Anmerkung, die auf orders-api beschränkt ist und während der Arbeit in billing-api abgerufen wird, bleibt unberührt und wird nicht als überarbeitet markiert.

if (Array.isArray(node.repos) && node.repos.length &&
!node.repos.includes(here)) return null;

Es gibt eine Obergrenze. Unter zehn Commits wird die Veraltetheit überhaupt nicht erwähnt, denn ein ständig ausgelöster Warnhinweis ist nur Dekoration und keine echte Warnung. Die Schwelle ist anpassbar. Eine zweite, höhere Schwelle bei 100 Commits aktiviert den Befehl doctor, der Notizen auflistet, die einer sorgfältigen Überprüfung bedürfen, sodass man selbst nach relevanten Notizen suchen kann, anstatt nacheinander darauf hingewiesen zu werden.

Regel 2: Löschvorgänge werden abgeschlossen

Der Inhalt des Stores liegt als unverschlüsselter Text auf einem Unternehmens-Desktop vor, und das Modell hat seine Inhalte aus Gesprächen extrahiert, die alles Mögliche enthalten haben könnten. Somit gelangt kein Inhalt ohne Scannen auf die Festplatte. Vierzehn Musterfamilien erkennen Dinge wie AWS-Schlüssel, GitHub- und Slack-Tokens, private Schlüssel, JWTs, Tragertokens, Datenbankverbindungsstrings, Sitzungsküsse, IPs aus dem privaten Bereich sowie interne Hostnamen, dazu E-Mail-Adressen – jeder erkannte Eintrag wird vor der Speicherung durch <redacted:kind> ersetzt.

„Fail-closed“ erfüllt eine spezifische Funktion, was in den ersten Zeilen der Funktion sichtbar ist:

export function redact(text, opts = {}) {
  if (typeof text !== 'string') {
    throw new TypeError('redact() requires a string; refusing to write unscanned content');
  }

Geben Sie ihm etwas, was es nicht scannen kann – dann überspringt es den Scan nicht und macht weiter. Stattdessen wird die Schreibvorgang abgebrochen. Eine Redaktionsphase muss dazu führen, dass „nichts geschrieben wird“, und niemals dazu, dass „dieser Eintrag durchkommt“. Es gibt auch kein Umgehungssymbol, denn ein solches würde man schließlich an einem Freitagabend um sechs Uhr verwenden.

Zwei Entscheidungen darin sind vertretbar.

Verbindungsstrings bleiben vollständig. Ein URI wie postgres://user:hunter2@db.internal:5432/orders enthält die Zugangsdaten direkt darin, sodass der gesamte URI ersetzt wird und nicht nur das Passwort. Ein halb-redigierter URI gibt dem Leser weiterhin Host, Port, Datenbanknamen und Benutzernamen preis.

Geheimnisse in Form von Aufgaben müssen sich beweisen. Eine naive Regel für password: <something> würde auch einen Satz wie „Die Passwortwechselrichtlinie beträgt 90 Tage“ erfassen, weshalb die Regel Anführungszeichen oder einen langen, ungeführten Textabschnitt vorschreibt:

{
  kind: 'assigned-secret',
  re: /\b(?:api[_-]?key|secret|password|token|client[_-]?secret|
access[_-]?key)\b\s*[:=]\s*(?:"[^"\n]{6,}"|'[^'\n]{6,}'|[^\s"'`,;)]{12,})/gi,
}

Eine Redaktion, die gewöhnlichen Prosa text verfälscht, wird deaktiviert – anschließend schützt sie nichts mehr. Das gesamte Modul weist genau eine Ausnahme auf: Ihre eigene Git-Identität bleibt erhalten, da sie bereits auf jedem von Ihnen hochgeladenen Commit gespeichert ist; ihr Verbergen würde die Notizen nur schwerer lesbar machen.

Regel 3: Die Trunkierung ist niemals lautlos

Eine Anfrage der Stufe 2 an einen gut vernetzten Knoten kann fünfzig Notizen zurückgeben und damit das Kontextfenster überschreiten, das vom Design geschützt wird. Deshalb gibt es ein Byte-Budget von standardmäßig 8 KB sowie das Abschneiden der Daten, sobald dieses Budget überschritten wird. Daran ist nichts Überraschendes. Entscheidend ist vielmehr, was nach dem Abschneiden geschieht:

3 nodes omitted for budget: legacy-batch-job, vendor-sftp-quirk,
old-retry-policy

Every omitted id gets printed, with no exceptions. This rule carries the most conviction, because silent truncation is the failure that looks like success. Given eight of eleven notes and no sign that three are missing, an agent assumes it sees everything and replies as confidently as that implies. The missing three are probably the ones it needed: they were dropped as peripheral to the query, and a surprising constraint often sits at the edge.

Pruning goes deepest-first, then least-connected:

.sort((a, b) => b.depth - a.depth || a.degree - b.degree || ...)

Depth means distance from what was actually asked, and a low degree suggests a node nobody needed as a hub. Breaking final ties by id gives identical bytes for the same query every time, so the reindex determinism test checks something real.

Rule 4: constraints are never dropped

Not at any cap, in either tier, with no exceptions.

const removable = nodes.filter((n) => n.depth > 0 && n.type !== 'constraint');

Zwei Elemente entgehen der Kürzung: die von Ihnen angeforderte Grundnote sowie jede Restriktion. Die Logik beruht auf Kosten, nicht auf Geschmack. Eine Restriktion besagt beispielsweise, dass der Kunde eine neue Datenbank nicht genehmigen wird, dass ein Service nicht auf das öffentliche Internet zugreifen kann oder dass das Plattformteam Kafka bereits abgelehnt hat. Es handelt sich dabei genau um die Faktoren, die verhindern, dass ein Agent Dutzende Anfragen für einen von Anfang an zum Scheitern verurteilten Ansatz sendet. Durch das Weglassen einer Anfrage, um vierhundert Bytes zu sparen, wird eine geringe Kostenfaktor durch einen teuren ersetzt: Bytes sind billig, doch ein Sackgassenszenario ist es nicht.

Dies führt zu einem Fall, bei dem der Code von vornherein Klarheit schaffen muss. Wenn die Grundnote zusammen mit den Restriktionen bereits das Budget überschreiten, muss das Budget geopfert werden:

Note: 9,412 bytes returned, over the 8,192 budget, because constraints
are never dropped.

Es wurde gemeldet, aber nicht behoben, denn die Behebung würde bedeuten, das zu entfernen, was beibehalten werden sollte.

Der Store ist in Markdown-Format, und der Index ist verwendbar einmalig

Eine strukturelle Entscheidung unterstützt alle vier Regeln: Die Notizen sind gewöhnliche Markdown-Dateien mit YAML-Frontmatter, und index.db ist ein Cache, den man jederzeit löschen kann.

~/.agents/memory/
  notes/<type>/<id>.md     the source of truth
  notes/archive/           superseded and decayed notes; never deleted
  index.db                 disposable SQLite cache
  ROUTING.md               generated map of everything known

Ein einziger index-Befehl regeneriert die Datenbank aus den Notizen, Byte für Byte. Die Datenbank existiert, weil das Durchlaufen eines Graphen in SQL schnell ist, während das Durchlaufen eines Dateidirectoriums langsam ist. Der Motor besteht aus einem rekursiven CTE mit einer Tiefebegrenzung sowie UNION anstelle von UNION ALL, sodass eine contradicts-Schleife nicht weiter rekursiv arbeiten kann, bis SQLite beendet wird. Über SQLite gibt es keine separate Graphenschicht; das CTE übernimmt diese Aufgabe.

Nichts Wertvolles wird ausschließlich im Index gespeichert. Ist SQLite beschädigt, geht der Cache verloren. Wenn das Tool entfernt wird, bleibt ein Ordner mit lesbarer Markdown-Datei übrig, der auch ohne Installation nützlich ist. Wissen sollte länger bestehen als die jeweiligen Indizes, und ein proprietärer Binärspeicher versagt bereits am ersten Tag.

Dies ist auch der Grund, warum es in einer stark eingeschränkten Umgebung installiert werden kann – das ursprüngliche Ziel. Seit Version 22.5 enthält Node node:sqlite bereits im Kern, sodass der Index weder ein Paket, keinen Dienst noch eine Netzverbindung benötigt. Auf einem verwalteten Desktop führen der Vorschlag eines Node-Skripts sowie der Vorschlag einer neuen Datenbank zu völlig unterschiedlichen Diskussionen und Ergebnissen.

Was absichtlich weggelassen wurde

Nichts wird automatisch erfasst: Entweder aktivieren Sie es selbst oder die zuständige Funktion. Das ist eine bewusste Einschränkung. Ein Hintergrundprozess, der Ihre Sitzung überwacht und entscheidet, was aufbewahrt werden soll, ist die Funktion, die alle wünschen – doch genau diese könnte den Store mit unzuverlässigen Daten überfluten. Alle oben genannten Regeln zur Ehrlichkeit werden schwächer, je mehr minderwertige Notizen anfallen. Zehn gute Notizen pro Woche sind wertvoller als vierhundert, die entstehen, wenn ein Modell eigenmächtig entscheidet.

Team-Teilen, Mehrrechner-Synchronisierung sowie ein MCP-Server werden ebenfalls verschoben. Ein MCP-Server würde denselben Speicher lesen, daher handelt es sich dabei um eine Erweiterung und nicht um eine Neuimplementierung.

Eine Behauptung ist noch nicht bewiesen. Der entscheidende Test ist ein „Kaltlesen“: Ein neuer Chat in einem seit einem Monat unberührten Repository, der allein auf der Grundlage des Routing-Digests korrekt antwortet. Dafür ist tatsächlicher Zeitverlauf erforderlich, der in einem Testumfeld nicht simuliert werden kann. Siebenundsiebzig Tests bestehen unter Linux, macOS und Windows mit Node 22 und 24, doch keiner davon zeigt das, was man wirklich wissen möchte.

Der Teil, der sich lohnt

Jeder, der Speicherfunktionen in einen Agenten-Workflow integriert – sei es seinen eigenen oder einen, den er veröffentlicht – kann diese vier Regeln auch außerhalb dieses Projekts anwenden:

  1. Legen Sie das Alter des Wissens dort ein, wo es verwendet wird, und nicht auf einem Dashboard, das niemand öffnet.
  2. Lassen Sie den Sanisierer durch Verschweigen jeglicher Ausgabe fehlschlagen, und fügen Sie kein Umgehungssymbol hinzu.
  3. Drucken Sie, was Sie ausgelassen haben, denn eine stille Kürzung wirkt wie vollständige Abdeckung.
  4. Klären Sie vor dem Budgetknappwerden alles, was niemals weggelassen werden darf, denn Entscheidungen unter Druck sind schlechter.

Niemand von diesen Punkten ist schwer umzusetzen. Alle vier lassen sich leicht übergehen und sind, solange sie funktionieren, unsichtbar – genau deshalb lohnt es sich, sie aufzuschreiben.