Ваш агент для кода пишет план.Проверьте его, прежде чем он напишет код.

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

Неверное допущение в плане стоит одного комментария. То же допущение в коде стоит чтения диффа, отката и ещё одного запуска. Так что читайте план сначала, пока менять его дёшево.

В терминале план — длинный кусок текста, который приходится прокручивать. В 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-комментариев.

Вопросы разработчиков

Другие вопросы