Twój agent do kodu pisze plan.Zrecenzuj go, zanim napisze kod.

Zrecenzuj plan przed kodem

Błędne założenie w planie kosztuje jeden komentarz. To samo w kodzie kosztuje czytanie diffa, revert i kolejne uruchomienie. Czytaj więc plan najpierw, póki zmiana jest tania.

W terminalu plan to długi blok tekstu do przewijania. W DotMD to sformatowany dokument, a każda Twoja uwaga jest przypisana do swojego fragmentu:

1. Poproś o plan jako plik

   „Napisz plan do docs/plan.md i wyślij mi go w DotMD do recenzji”.

2. Komentuj tam, gdzie jest błąd

   Zaznacz fragment, naciśnij ⌥⌘M i napisz zmianę, której chcesz. Zrób to w całym planie, potem kliknij Send.

3. Sprawdź poprawki jako diff

   Agent edytuje plik; stary tekst jest czerwony, nowy zielony, obok komentarza, na który odpowiada każda poprawka. Accept, Reopen lub Accept All.

4. Zatwierdź i pozwól mu budować

   Kliknij Approve, a agent przechodzi do kodu.

Agent widzi każdy komentarz razem z fragmentem, wierszami i autorem, więc dokładnie wie, o co Ci chodzi. Może też przeczytać zaznaczony przez Ciebie fragment: „Przepisz akapit, który zaznaczyłem w DotMD”.

Poproś go, gdy skończy, żeby „pokazał mi zmiany w DotMD”, a otworzy recenzję za Ciebie.

Dokumenty, które piszą agenty

Plany to dopiero początek. Agenty piszą też inne rzeczy i możesz je recenzować tak samo:

• Specyfikacje i dokumenty projektowe.
• Zapisy decyzji architektonicznych (ADR).
• README i wpisy CHANGELOG.
• Plany migracji, wdrożenia i testów.
• Tabele porównawcze bibliotek i usług.

Drugi agent może też zrecenzować pracę pierwszego: Claude Code pisze, Codex zostawia komentarze, Ty decydujesz. Zobacz Jeden agent recenzuje drugiego.

Pasuje do Twojego środowiska

DotMD uruchamia na Twoim Macu mały serwer MCP, a agent łączy się z nim jedną linią. Działają Claude Code, Codex, Cursor i Visual Studio Code; każdy przewodnik ma dokładną konfigurację.

• Pliki, nie kopia. DotMD czyta i zapisuje pliki Markdown w folderze Twojego projektu. Nie ma nic do importowania ani synchronizowania.
• git. Gdy git, edytor lub agent zmienia plik, DotMD to zauważa i zachowuje poprzedni tekst jako wersję. Komentarze podążają za plikiem przemianowanym przez git mv, gdy po raz pierwszy otworzysz go w nowym miejscu.
• Docker. Agent w kontenerze łączy się z DotMD pod adresem http://host.docker.internal:8089/mcp.

Zrób z tego nawyk: kilka linii w AGENTS.md

Agent wysyła dokument do recenzji, gdy go o to poprosisz. Żeby robił to za każdym razem i szukał Twoich komentarzy w DotMD, dodaj te linie do AGENTS.md dla Codex lub do CLAUDE.md dla Claude Code:

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.

Najważniejsza jest pierwsza linijka. Twoje komentarze przechowuje DotMD, a nie plik, więc agent, który nie pomyśli o DotMD, szuka ich w projekcie i nic nie znajduje.

Twoje pliki pozostają Twoje

• Nie ma kont. Twoje pliki, komentarze i historia wersji zostają na Twoim Macu.
• Serwer MCP odpowiada tylko na 127.0.0.1, więc inne komputery go nie dosięgną, a strony internetowe nie mogą go używać.
• Komentarze i historię przechowuje DotMD, a nie Twoje pliki. Markdown w Twoim repozytorium nie ma znaczników ani komentarzy HTML.

Pytania programistów

Więcej pytań