Projektgedächtnis

Das Projektgedächtnis merkt sich, was in einem Projekt schon untersucht, entschieden und gemessen wurde, und sagt es einem Agenten, bevor dieser dasselbe noch einmal tut.

Das Problem

In einem langen Sprint entstehen Hunderte Tickets, Research-Berichte und Messungen. Ein frischer Agent kennt davon nichts. Er beantwortet eine Frage, die ein Bericht von vor drei Wochen schon beantwortet hat, und niemand merkt es: Das Ergebnis sieht plausibel aus, es hat nur Zeit und Geld gekostet.

Was es tut

  • Es legt einen Index über Tickets, Research, Berichte, Konzepte und optional den Code des Projekts an. Er bleibt lokal im Projektordner.
  • Im Sprint vergleicht es jeden Auftrag an einen Research-, Implementierungs- oder Plan-Check-Agenten und jedes neue Ticket mit diesem Index.
  • Findet es Vorarbeit, die der Auftrag nicht erwähnt, wird der Aufruf angehalten. Die Meldung nennt als Erstes, was zu tun ist, und danach die Fundstellen mit Datei und Zeile.
  • Der Auftraggeber liest die Fundstelle und bestätigt es im Auftrag: Entweder verweist er auf die Vorarbeit, oder er begründet, warum die Frage trotzdem neu gestellt wird.
  • Von Hand lässt sich dieselbe Frage vorher stellen, mit addp-hook graph query.

Ein Beispiel

Ein Lead möchte einen Agenten beauftragen, den CSV-Export der Berichte zu untersuchen. Das Gedächtnis findet das erledigte Ticket .addp/tickets/done/042-berichtsexport.md (alle Namen in diesem Beispiel sind erfunden). Der Hook nennt die Fundstelle (im Standard als Hinweis; wer die Sperre für eine Rolle einschaltet, hält den Aufruf an). Der Lead liest das Ticket, sieht, dass nur die Testumgebung gemessen wurde, und ergänzt im Auftrag eine Zeile: „neu untersucht, weil die Messung in 042 nur die Testumgebung betraf“. Der Agent startet jetzt, mit der alten Messung als Ausgangspunkt statt bei null.

Was gemessen wurde

Alle Zahlen stammen aus Messungen vom 01.11.2026 auf einem Rechner (Apple M3 Max) und beschreiben diese Messungen, nicht jedes Projekt.

  • Erprobung an echten Daten: Eine echte Sitzung mit 2.282 Agentenstarts wurde nachgespielt. Die beiden darin bekannten Doppelarbeiten hat die Sperre beide erkannt (2 von 2). Das ist eine kleine Stichprobe: sie zeigt, dass echte Doppelarbeit gefunden wird, nicht, wie selten die Sperre sich irrt. Sie schlug auch bei Aufträgen an, die keine Doppelarbeit waren, und wird deshalb an echten Sprints nachjustiert.
  • Aufbau: Bei einem Projekt mit 2.473 Dateien dauert der vollständige Aufbau im Median 4,8 Sekunden.
  • Abfrage von Hand: Im selben Projekt im Median 0,32 Sekunden, in 95 von 100 Läufen unter 0,41 Sekunden. Bei einem größeren Index (2.664 Dateien) waren es im Median 0,69 Sekunden.
  • Größe: Das Programm wächst auf macOS (arm64) von 8,25 auf 10,82 MB, rund 2,6 MB.
  • Startzeit: Hook-Aufrufe ohne Gedächtnisbezug brauchen rund 3,6 bis 4,4 ms länger.

Was es nicht ist

  • Kein Freispruch: Konnte die Prüfung nicht laufen, sagt die Meldung „Prüfung NICHT durchgeführt“, nie „keine Treffer“.
  • Kein Ersatz für Lesen: Es zeigt, wo Vorarbeit liegt, es bewertet sie nicht.
  • Keine Cloud: Der Index entsteht und bleibt im Projektordner.

Wo es weitergeht

Konfiguration, Befehle, die Formen der Bestätigung und Hilfe bei Problemen stehen in der Dokumentation im Lieferumfang (Datei 25-projektgedaechtnis.md im Ordner docs/de). Die Sperre selbst ist Teil des Hooks AgentGate und im Notfall abschaltbar.

Vollständige Dokumentation im Lieferumfang

Die detaillierte Konfigurationsreferenz, Troubleshooting-Guide und Hook-Dokumentation sind als PDF im Download enthalten.

Jetzt kaufen →