MarsDawn

Einen Agentenplan in fünf Minuten prüfen

Dein Agent hat einen Plan geschrieben und wartet auf grünes Licht. Du hast fünf Minuten, keine Stunde. Hier ist ein Weg, sie zu nutzen, der in jedem Editor funktioniert, sogar in einem einfachen Texteditor. MarsDawn hilft bei einigen Schritten, und wir sagen, bei welchen. Beim wichtigsten hilft es nicht.

Lies den Plan nicht von oben nach unten. Prüfe seine Form, prüfe eine Behauptung, finde, was sich nicht rückgängig machen lässt, sieh dir Diagramme und Umfang an und schreib dann Feedback, mit dem der Agent arbeiten kann. Sechs Schritte, etwa fünf Minuten.

Warum vorher prüfen

Chip Huyen erklärt, warum Planung von Ausführung getrennt sein sollte, und benennt die Kosten deutlich: „Ohne Aufsicht kann ein Agent diese Schritte stundenlang ausführen und Zeit und Geld für API-Aufrufe verschwenden, bevor du merkst, dass er nicht vorankommt.“ Unsere Ergänzung: Ein Plan ist der günstigste Ort, einen Fehler zu finden. Eine Zeile in plan.md zu korrigieren kostet einen Satz. Zu korrigieren, was der Agent getan hat, nachdem er gelaufen ist, kostet einen Nachmittag.

Das Beispiel

Du hast einen Agenten gebeten, Benutzer-Avatare in einen Objektspeicher zu verschieben, ohne bestehende Links zu brechen. Er gibt dir das hier zurück:

# Plan: move user avatars to object storage

## Goal
Serve avatars from object storage instead of the app server.

## Steps
1. Add a storage client and config. ✅ done
2. Write a script that copies existing avatars to the bucket.
3. Switch the avatar URLs in the templates.
4. Delete `public/avatars/` from the server.
5. Run the copy script.

## Status
All tests pass.

Es liest sich gut. Es würde auch jeden Avatar löschen, bevor auch nur einer kopiert ist.

Die sechs Schritte

1. Lies nur die Überschriften. (etwa eine Minute) Passt die Gliederung zu dem, worum du gebeten hast? Ein fehlender Abschnitt bedeutet meist fehlende Arbeit. Hier: Goal, Steps, Status. Du wolltest, dass bestehende Links weiter funktionieren, und es gibt keine Überschrift zu alten Links oder dazu, wie man die Änderung rückgängig macht. Das ist dein erster Kommentar.

Im Terminal gibt grep -n '^#' plan.md nur die Überschriften aus, und die meisten Editoren können auch eine Gliederung zeigen. In MarsDawn listet der Tab Gliederung in der Seitenleiste (Darstellung ▸ Seitenleiste einblenden, ⌃⌘S) sie auf, und ein Klick springt dorthin.

2. Finde jede Stelle, die sagt, dass etwas erledigt, bestanden oder geprüft ist, und prüfe eine selbst. (etwa eine Minute) Öffne die Datei, führe den Test aus, zähle die Zeilen. Chip Huyen beschreibt einen Fehler, bei dem „der Agent überzeugt ist, eine Aufgabe erledigt zu haben, obwohl er es nicht hat“. In ihrem Beispiel soll ein Agent 50 Personen auf 30 Hotelzimmer verteilen, bringt 40 unter und besteht darauf, fertig zu sein.

grep -n -i -E 'done|pass|verified|✅' plan.md

Hier findet das „✅ done“ und „All tests pass.“ Welche Tests? Berührt einer davon die Avatare? Führ sie aus oder frag nach. Diesen Schritt kann MarsDawn dir nicht abnehmen. Das kann niemand außer dir.

3. Achte auf Schritte, die sich nicht rückgängig machen lassen. (etwa eine Minute) Daten löschen, Migrationen, Force-Pushes, alles, was sendet, bezahlt oder veröffentlicht. Die warten auf dein ausdrückliches Ja. Chip Huyen beschreibt dieselbe Idee von der Seite des Systems aus: „Wenn ein Plan riskante Vorgänge umfasst, etwa eine Datenbank zu aktualisieren oder eine Codeänderung zu mergen, kann das System vor der Ausführung ausdrücklich um menschliche Zustimmung bitten oder die Ausführung dieser Vorgänge Menschen überlassen.“ Hier löscht Schritt 4 die Originale, und er kommt vor Schritt 5, dem Kopieren.

4. Lies die Diagramme gerendert und prüfe jeden Pfeil gegen den Text. Ein Flussdiagramm, das „kopieren → prüfen → löschen“ sagt, während die Schritte etwas anderes sagen, ist ein Befund. Dieser Plan hat kein Diagramm, also fällt der Schritt heute weg. Wenn es eines gibt, sieh dir das Bild an, nicht den Mermaid-Quelltext: Viele Editoren haben eine Vorschau, und Eine Markdown-Datei auf dem Mac ansehen und Markdown anderswo ansehen zeigen die Möglichkeiten. In MarsDawn steht das gerenderte Diagramm neben seinem Quelltext (⌘2), und ein fehlerhaftes Diagramm zeigt seinen Quelltext mit dem Fehler darunter, was einen eigenen Kommentar wert ist.

5. Liste die Dateien und Systeme auf, die der Plan berührt, und frag nach allem, worum du nicht gebeten hast. (Schritte 4 und 5 zusammen, etwa eine Minute) Hier: die Speicherkonfiguration, die Templates, ein Ordner auf dem Server, ein Bucket. Wer kann den Bucket lesen? Du hast nicht gesagt, dass er öffentlich sein soll. Wenn du den Arbeitsordner des Agenten in MarsDawn geöffnet hast (Ablage ▸ Ordner öffnen …, ⇧⌘O), erscheinen neue Dateien, die er schreibt, innerhalb etwa einer Sekunde im Tab Dateien, und die Kopfzeile nennt den Git-Branch oder Worktree, damit du weißt, welchen Checkout du prüfst.

6. Schreib Feedback als Stelle, Problem, Lösung, ein Problem pro Zeile. (die letzte Minute)

plan.md:10: deletes the avatars before step 5 copies them. Copy first, check the count, then delete, and wait for my OK before deleting.
plan.md:14: which tests? Add one that loads an old avatar URL after the switch.
plan.md:6: nothing about keeping old links working. Add a step for that, and a way to undo the switch.

Jeder Editor mit Zeilennummern genügt. In MarsDawn kopiert Bearbeiten ▸ Verweis kopieren (⌥⌘C) deine Stelle als plan.md:10, und Für KI kopieren (⌃⌥⌘C) fügt den ausgewählten Text darunter ein.

Wenn du nur eine Minute hast

Mach Schritt 2. Dort fliegt ein Agent auf, der glaubt, fertig zu sein.

Wenn fünf Minuten nicht reichen

Manchmal kannst du nicht beurteilen, ob ein Schritt richtig ist, weil er außerhalb deines Wissens liegt. Jess Ou bringt es in LangChains Erklärtext über Agenten von 2026 in zwei Sätzen auf den Punkt: „Lagere kein Urteil aus, das du nicht bewerten kannst. Wenn du eine richtige Antwort nicht erkennen würdest, erkennt der Agent sie auch nicht.“ Unsere Folgerung: Wenn du einen Schritt nicht beurteilen kannst, ist das kein Grund, ihn schneller freizugeben. Es ist ein Grund, jemanden zu fragen, der es kann.

Was MarsDawn hier tut und was nicht

In MarsDawn steckt kein KI-Modell. Es findet die Probleme in diesem Plan nicht und übernimmt weder Schritt 2 noch Schritt 3. Es hält die Datei lesbar, während du arbeitest: die Gliederung für Schritt 1, gerenderte Diagramme für Schritt 4, den Tab Dateien für Schritt 5, Zeilenverweise für Schritt 6. Und wenn der Agent den Plan überarbeitet, während du liest, lädt MarsDawn ihn neu und behält deine Stelle, solange du keine eigenen ungesicherten Änderungen hast.

Wenn der Plan steht und jemand anderes ihn sehen muss, zeigen Exportierte PDFs teilen und Markdown in PDF, wie du ihn als PDF weitergibst.

Ausprobieren

MarsDawn gibt es im Mac App Store. Dazu kommt das kostenlose Befehlszeilenwerkzeug marsdawn:

brew install redtear1115/tap/marsdawn

Es exportiert Markdown ohne die App als PDF.

Befehlszeile · Vor dem Kauf wissen: Was MarsDawn nicht kann

Weiter

Quellen