Ваш агент для коду пише план.Перевірте його, перш ніж він напише код.

Перевірте план до коду

Хибне припущення в плані коштує одного коментаря. Те саме в коді коштує читання диффа, відкату й ще одного запуску. Тож спершу читайте план, поки змінювати його дешево.

У терміналі план — довгий шмат тексту, який доводиться прокручувати. У DotMD це оформлений документ, і кожне ваше зауваження прив’язане до свого уривка:

1. Попросіть план файлом

   «Напиши план у docs/plan.md і надішли мені в DotMD на рев’ю».

2. Коментуйте там, де неправильно

   Виділіть уривок, натисніть ⌥⌘M і напишіть потрібну зміну. Зробіть це по всьому плану, потім натисніть Send.

3. Перевірте правки як дифф

   Агент редагує файл; старий текст червоний, новий зелений, поруч із коментарем, на який відповідає кожна правка. Accept, Reopen або Accept All.

4. Схваліть і дайте йому будувати

   Натисніть Approve, і агент продовжить із кодом.

Агент бачить кожен коментар разом із уривком, рядками й автором, тож точно знає, що ви маєте на увазі. Він може прочитати й виділений вами уривок: «Перепиши абзац, який я виділив у DotMD».

Коли він закінчить, попросіть його «показати мені зміни в DotMD», і він відкриє рев’ю за вас.

Документи, які пишуть агенти

Плани — лише початок. Агенти пишуть і інше, і це можна перевіряти так само:

• Специфікації та дизайн-документи.
• Записи архітектурних рішень (ADR).
• README та записи в CHANGELOG.
• Плани міграції, розгортання й тестування.
• Порівняльні таблиці бібліотек і сервісів.

Другий агент може перевіряти й роботу першого: Claude Code пише, Codex залишає коментарі, вирішуєте ви. Див. Один агент перевіряє іншого.

Пасує до вашого середовища

DotMD запускає на вашому Mac невеликий MCP-сервер, і агент підключається до нього одним рядком. Працюють Claude Code, Codex, Cursor і Visual Studio Code; у кожному посібнику є точне налаштування.

• Файли, а не копія. DotMD читає й пише Markdown-файли в теці вашого проєкту. Нічого не треба імпортувати чи синхронізувати.
• git. Коли git, редактор або агент змінює файл, DotMD помічає це й зберігає попередній текст як версію. Коментарі йдуть за файлом, перейменованим через git mv, коли ви вперше відкриваєте його на новому місці.
• Docker. Агент у контейнері дістається до DotMD за адресою http://host.docker.internal:8089/mcp.

Зробіть це звичкою: кілька рядків в AGENTS.md

Агент надсилає документ на рев’ю, коли ви його про це просите. Щоб він робив це щоразу й шукав ваші коментарі в DotMD, додайте ці рядки до AGENTS.md для Codex або до CLAUDE.md для 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.

Найважливіший — перший рядок. Ваші коментарі зберігає DotMD, а не файл, тож агент, який не згадає про DotMD, шукає їх у проєкті й нічого не знаходить.

Ваші файли лишаються вашими

• Облікових записів немає. Ваші файли, коментарі й історія версій лишаються на вашому Mac.
• MCP-сервер відповідає лише на 127.0.0.1, тож інші комп’ютери до нього не дістануться, а вебсторінки не зможуть ним користуватися.
• Коментарі та історію зберігає DotMD, а не ваші файли. У Markdown вашого репозиторію немає ні маркерів, ні HTML-коментарів.

Запитання розробників

Інші запитання