plannotator setzt vor jeden Agent-Diff einen menschlichen Prüfpunkt

Es gibt einen bestimmten Moment in der agentengestützten Entwicklung, in dem es schlechter statt besser wird. Der Agent beendet eine Aufgabe, druckt eine Zusammenfassung und bittet dich, sie anzunehmen. Du scrollst. Der Diff hat vierhundert Zeilen. Du stimmst zu, weil richtiges Lesen länger dauern würde als das eigene Schreiben.
plannotator, ein Projekt mit rund 10.500 Sternen, das diese Woche schnell steigt, ist der Versuch, diesen Moment zu reparieren. Es ist eine lokale Review-Fläche im Browser, die sich an einen Coding-Agenten hängt und sich öffnet, wenn der Agent etwas zu entscheiden hat. Du markierst den Plan, das Dokument oder den Diff, und deine Kommentare gehen als nächste Eingabe an den Agenten zurück.
Der Slogan handelt davon, im Loop zu bleiben. Die Architektur handelt von etwas Engerem und Nützlicherem: die Aufmerksamkeit des Menschen zu einem eigenen Schritt zu machen statt zu einer Option.
Wie es sich anhängt
Es ersetzt deinen Agenten nicht. Es hängt sich an einen an. Das README listet Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp, DeepSeek Harness und Pi, und der Inbox funktioniert auch mit persönlichen Assistenten wie Grok Bot, Muse, Hermes und OpenClaw. Die Verbindung läuft über Plugins, Hooks und Kommandos des jeweiligen Harness, deshalb fällt die Integrationstiefe je nach Werkzeug unterschiedlich aus.
Die Kommandos haben die vertraute Form:
/plannotator-review # uncommitted changes
/plannotator-review <github-pr-url> # a pull request
/plannotator-annotate README.md # a file
/plannotator-annotate https://docs.rs # a URL
/plannotator-last # the agent's last message
plannotator inbox # the queue
Auf Codex werden die Slash-Kommandos zu `!plannotator ...` oder zu den gepackten Skills. Der Planmodus braucht gar kein Kommando: er ist über die Hooks jedes Harness verdrahtet, also öffnet sich die Review-Fläche von selbst, wenn der Agent einen Plan schreibt. Dieses Detail ist wichtiger, als es klingt. Ein Prüfpunkt, an den man sich erinnern muss, wird an den Tagen übersprungen, an denen man beschäftigt ist, und das sind die Tage, an denen er zählt.
Die Review deckt Git, GitButler, Jujutsu, Perforce, GitHub und GitLab ab, die Fläche hängt also nicht an einer einzigen Forge. Du kommentierst Zeilen, schlägst Code vor, und die Kommentare gehen an den Agenten zurück statt in einen PR-Thread, den niemand liest.
Der Posteingang ist der interessante Teil
Review mit einem Agenten ist ein gelöstes Problem mit einer langweiligen Lösung: Diff öffnen, Kommentare hinterlassen.
Der Inbox ist das, was das Team für die Lage gebaut hat, in der die meisten Leute tatsächlich sind, nämlich mehrere Agenten gleichzeitig. Es ist ein lokales Fenster, in dem Agenten Nachrichten, Fragen, Dateien und geführte Reviews hinterlegen, während sie weiterarbeiten. Du beantwortest eine Frage per Klick, annotierst eine Datei und drückst auf Senden, wenn du dazu kommst. Nichts hält dabei eine Agentensitzung offen, und deine Antwort geht an die Sitzung zurück, die gefragt hat.
Dieser eine Satz löst einen echten Deadlock. Das Standardmuster für Human-in-the-loop ist, dass der Agent anhält und wartet. Mit einem Agenten ist das in Ordnung. Mit vier bist du der langsamste Prozess im System, und drei davon verbrennen Kontext, während du zu Mittag isst. Ein asynchroner Posteingang lässt den Agenten die Frage parken statt die Sitzung.
Claude Code, Pi und OpenCode verbinden sich über Plugins, Antworten kommen als nächster Turn an. Alles andere erreicht ihn über MCP mit `plannotator inbox mcp`, und `plannotator inbox --help` dient zugleich als das Dokument, das der Agent liest, um das Protokoll zu lernen. Das ist ein kleines Stück Design mit großer Wirkung: Der Hilfetext ist die Integrationsspezifikation.
Warum ein Browser, und warum lokal
Ein Diff im Terminal ist gut zum Lesen von Code und schlecht für alles andere. Eine Produktspezifikation, ein HTML-Mockup oder einen gerenderten Report im Pager zu reviewen ist eine Übung im Augen-Zusammenkneifen, und Agenten produzieren inzwischen alle drei regelmäßig. Sie im Browser zu rendern und den Reviewer Pins auf das Ergebnis setzen zu lassen, ist die richtige Fläche für dieses Artefakt.

Der Datenschutzabschnitt des README ist für ein Werkzeug dieser Größe ungewöhnlich konkret, und es lohnt sich, ihn im Kern zu zitieren statt ihn zusammenzufassen. Es gibt keine Telemetrie. Pläne, Diffs, Annotationen, Entwürfe und Verlauf bleiben standardmäßig lokal. Jede Fläche prüft beim Laden GitHub auf die neueste Version, und diese Prüfung lässt sich nicht abschalten. Die lokale Git-Review kann `git ls-remote` gegen deine konfigurierte Origin laufen lassen, um den Default-Branch und eine veraltete Basis zu erkennen, und diese Abfrage geht raus, wenn die Review sich öffnet, wenn der Diff lädt, wenn du die Basis wechselst und wenn du auf Fetch drückst. Eine untätige Review-Seite macht keine Netzwerkaufrufe, was ein stärkeres Versprechen ist als das der meisten Werkzeuge.
Inhalte verlassen die Maschine nur, wenn eine Netzwerkfunktion sie braucht: URL-Annotation ruft die Seite ab, die GitHub-Review nutzt deine authentifizierte CLI, Ask AI schickt die ausgewählte Frage und den Kontext an den konfigurierten Anbieter, und Teilen lädt Chiffrat zu einem Paste-Dienst hoch.
Für ein Werkzeug, das auf Quellcode sitzt, ist dieses Maß an Offenlegung der richtige Instinkt. Der typische Fehlermodus von Agentenwerkzeugen ist der hilfreiche Helfer, der dein Repository ohne ein Wort auf einen Server schickt, und die einzige Verteidigung des Nutzers ist ein Maintainer, der die Grenzen dokumentiert, bevor man ihn fragt.
Die unbequeme Konsequenz
Alles an diesem Projekt ist eine Wette darauf, dass die Engstelle der Agentenarbeit die Review-Bandbreite des Menschen ist und nicht die Fähigkeit des Modells.
Die Wette wirkt auf mich richtig. Die Leute, die ich kenne und mehrere Agenten laufen lassen, verbringen ihren Tag mit Lesen: Pläne, Diffs, Testausgaben, Zusammenfassungen dessen, was der Agent glaubt getan zu haben. Der generative Teil ist schnell und wird schneller. Der prüfende Teil ist dadurch begrenzt, wie schnell ein Mensch liest und entscheidet.
Es gibt einen Effekt zweiter Ordnung, der einen Namen verdient. Eine Review-Fläche, die Entscheidungen festhält, erzeugt ein Verzeichnis dieser Entscheidungen. plannotator hat ein archive-Kommando, das gespeicherte Planentscheidungen schreibgeschützt durchblättert, und Annotationen bleiben im Datenverzeichnis, sodass Terminal-Reviews und App-Reviews an einer Stelle zusammenlaufen. Wenn du ein paar hundert freigegebene Pläne mit den Kommentaren hast, die sie geformt haben, besitzt du etwas, das keine einzelne Sitzung enthält: eine Beschreibung davon, wie dein Team entscheidet.
Das ist der Vermögenswert. Den Diff-Viewer kann jeder bauen. Die Spur der Begründung nicht.
Wo es noch weh tut
Zwei Dinge, beide inhärent.
Das erste: Review-Werkzeuge verbessern die Review, und Review ist nicht dasselbe wie Korrektheit. Eine gut annotierte Freigabe einer schlechten Architektur bleibt die Freigabe einer schlechten Architektur, und eine aufgeräumte Review-Fläche lässt Zustimmen wie Sorgfalt aussehen. Besonders der Inbox macht es leicht, eine Warteschlange abzuarbeiten, und Abarbeiten ist ein anderes Verhalten als Verstehen.
Das zweite: Das Werkzeug fügt einem Workflow, der vorher ein Terminal war, einen Browser, einen lokalen Server und eine Hook-Schicht hinzu. Das sind drei Dinge mehr, die kaputtgehen können, und wenn ein Hook kaputtgeht, ist das lautlos: Der Agent läuft ohne den Prüfpunkt weiter, und du merkst es später.
Beides sind akzeptable Kosten für das, was gekauft wird, nämlich ein Ort, an dem der Mensch stehen kann. Die Alternative, und das machen die meisten Teams heute, ist, ein Chat-Transkript zu lesen und zu hoffen, dass das Wichtige darin steht.
Wenn du nur eins ausprobierst
Starte `/plannotator-review` bei deiner nächsten nicht committeten Änderung und kommentiere drei Zeilen, auch wenn du nichts zu sagen hast. Die Kommentare sind Nebensache. Du lernst, wie lange eine echte Review dauert, wenn die Fläche dafür entworfen ist, und diese Zahl ist deine neue Durchsatzgrenze. Die meisten Teams haben sie nie gemessen.
Verwandte Artikel
Der 99-Milliarden-Kreislauf um die eigenen Kunden
Nvidia finanziert die Käufer seiner Hardware. Solange das wächst, nennt man es Ökosystem. Wenn nicht, nennt man es Lieferantenfinanzierung – und fragt nach den Bedingungen.
74 Prozent Bruttomarge haben ein Verfallsdatum
Speicherpreise, Waferpreise, ein schwererer Produktmix: Alle drei Kräfte treffen auf dasselbe Jahr wie der Führungswechsel. Das macht aus einer gewöhnlichen Margenstory eine politische.
175.000 Unterschriften bringen ihn nicht zurück
Die Kampagne ist ein Loyalitätsbeweis und governance-technisch fast irrelevant. Genau in dieser Lücke liegt das Interessante: Je länger sie dauert, desto schwächer wird sie.
Die Exportregel kontrolliert den Kunden, nicht den Chip
Nicht der Chip ist jetzt der Kontrollpunkt, sondern die Beziehung zum Kunden. Die Regel verbietet nichts – sie verschiebt, wer künftig fragen muss.