Dein Coding-Agent schreibt den Plan.Prüf ihn, bevor er den Code schreibt.

Den Plan prüfen, bevor der Code entsteht

Eine falsche Annahme im Plan kostet einen Kommentar. Dieselbe Annahme im Code kostet einen Diff zum Lesen, ein Revert und einen weiteren Lauf. Lies also zuerst den Plan, solange Ändern billig ist.

Im Terminal ist der Plan ein langer Textblock, durch den du scrollst. In DotMD ist er ein gerendertes Dokument, und jede Anmerkung hängt an der Stelle, um die es geht:

1. Den Plan als Datei anfordern

   „Schreib den Plan nach docs/plan.md und schick ihn mir in DotMD zum Review.“

2. Dort kommentieren, wo er falsch ist

   Markiere eine Stelle, drücke ⌥⌘M und schreib die gewünschte Änderung. Mach das für den ganzen Plan, dann klicke auf Send.

3. Die Korrekturen als Diff prüfen

   Der Agent ändert die Datei; alter Text ist rot, neuer grün, neben dem Kommentar, auf den die Korrektur antwortet. Accept, Reopen oder Accept All.

4. Freigeben, dann bauen lassen

   Klicke auf Approve, und der Agent macht mit dem Code weiter.

Der Agent sieht jeden Kommentar mit seiner Stelle, seinen Zeilen und seinem Autor und weiß so genau, was du meinst. Er kann auch die Stelle lesen, die du markiert hast: „Schreib den Absatz um, den ich in DotMD markiert habe.“

Bitte ihn, wenn er fertig ist, dir „die Änderungen in DotMD zu zeigen“, dann öffnet er das Review für dich.

Die Dokumente, die Agenten schreiben

Pläne sind erst der Anfang. Agenten schreiben auch weitere Dokumente, und du kannst sie genauso prüfen:

• Specs und Design-Dokumente.
• Architecture Decision Records (ADRs).
• READMEs und CHANGELOG-Einträge.
• Migrations-, Rollout- und Testpläne.
• Vergleichstabellen für Bibliotheken und Dienste.

Ein zweiter Agent kann auch die Arbeit des ersten prüfen: Claude Code schreibt, Codex kommentiert, du entscheidest. Siehe Ein Agent prüft den anderen.

Passt zu deinem Setup

DotMD betreibt einen kleinen MCP-Server auf deinem Mac, und dein Agent verbindet sich mit einer Zeile. Claude Code, Codex, Cursor und Visual Studio Code funktionieren alle; jede Anleitung hat die genaue Einrichtung.

• Dateien, keine Kopie. DotMD liest und schreibt die Markdown-Dateien in deinem Projektordner. Es gibt nichts zu importieren oder zu synchronisieren.
• git. Ändert git, ein Editor oder ein Agent eine Datei, bemerkt DotMD das und behält den früheren Text als Version. Kommentare folgen einer mit git mv umbenannten Datei, sobald du sie am neuen Ort zum ersten Mal öffnest.
• Docker. Ein Agent im Container erreicht DotMD unter http://host.docker.internal:8089/mcp.

Mach es zur Gewohnheit: ein paar Zeilen in AGENTS.md

Ein Agent schickt ein Dokument zum Review, wenn du ihn darum bittest. Damit er das jedes Mal tut und in DotMD nach deinen Kommentaren sucht, füge diese Zeilen in AGENTS.md für Codex oder in CLAUDE.md für Claude Code ein:

Comments and reviews on Markdown files are kept in DotMD (MCP server `dotmd`), not in the files.
When I mention comments, a review or remarks on a .md file, read them with get_review_comments,
fix each one and send it back with resolve_review_comments.
After writing or substantially changing a spec, plan or design doc for me, send it to me with
request_review and wait for my answer; call it again after fixing my comments, until I approve.

Am wichtigsten ist die erste Zeile. Deine Kommentare liegen in DotMD, nicht in der Datei. Ein Agent, der nicht an DotMD denkt, durchsucht das Projekt danach und findet nichts.

Deine Dateien bleiben deine

• Es gibt keine Konten. Deine Dateien, Kommentare und der Versionsverlauf bleiben auf deinem Mac.
• Der MCP-Server antwortet nur auf 127.0.0.1, andere Computer erreichen ihn also nicht, und Webseiten können ihn nicht nutzen.
• Kommentare und Verlauf liegen bei DotMD, nicht in deinen Dateien. Das Markdown in deinem Repo hat keine Markierungen und keine HTML-Kommentare.

Fragen von Entwicklern

Weitere Fragen