CLAUDE.md и AGENTS.mdчитайте, правьте и проверяйте на Mac.
Эти файлы говорят Claude Code и Codex, как работать в вашем проекте. DotMD показывает их страницами, хранит каждую версию и может добавить строки, по которым агент присылает вам свои спецификации на ревью.
macOS 14 или новее. Чтение бесплатно; редактирование и ревью оплачиваются один раз.
Коротко
CLAUDE.md и AGENTS.md — обычные Markdown-файлы, поэтому DotMD открывает их как любой .md: оформленными, с оглавлением и со всеми сохранёнными версиями. В Settings → MCP → Agent rules кнопка Add to Claude Code или Add to Codex вносит правила ревью DotMD в ~/.claude/CLAUDE.md или ~/.codex/AGENTS.md, чтобы агент присылал вам каждую спецификацию и ждал ваших комментариев.
Как открыть и править CLAUDE.md и AGENTS.md
Нажмите ⌘O и выберите папку проекта: его CLAUDE.md и AGENTS.md появятся в боковой панели вместе с остальным Markdown и откроются страницами с оглавлением. Боковая панель не показывает скрытые папки, поэтому для ~/.claude/CLAUDE.md нажмите ⌘O, затем ⇧⌘G в окне и введите путь.
Чтобы изменить файл, нажмите ⌘E. Страница превращается в текст, который оформляется по мере набора, а каждая правка сразу попадает в файл. Редактирование входит в DotMD Editor.
Когда файл правит агент
Когда Claude Code, Codex или git меняет файл в вашем рабочем пространстве, открытая страница обновляется сама, а баннер показывает Changed on disk с числом добавленных и удалённых строк. Show Changes открывает историю версий; с DotMD Reviewer старый текст выделен красным, а новый — зелёным.
Если файл изменился, пока вы в нём печатаете, DotMD спросит Load from Disk или Keep My Version и в любом случае сохранит ваш текст в истории.
Чтобы проверить исправления агента по одному, смотрите как проверять изменения агента.
Добавьте правила ревью DotMD одним нажатием
Модели придают вашим собственным CLAUDE.md и AGENTS.md больше веса, чем тому, что инструмент говорит о себе, поэтому DotMD может вписать в них строки, по которым агент пользуется ревью. Откройте Settings → MCP, раскройте Agent rules и нажмите Add to Claude Code или Add to Codex. Правила попадут в ~/.claude/CLAUDE.md или ~/.codex/AGENTS.md:
<!-- dotmd:begin (added by DotMD; DotMD can update or remove this block) -->
## DotMD
- When you create or substantially change a spec, plan, design doc or any Markdown document for the user, your LAST step is to call the DotMD MCP tool `request_review` with the file's path and wait for the answer. While it says the user is still reviewing, call it again. Never end your turn by just saying the file is ready.
- Fix each review comment, call `resolve_review_comments`, then `request_review` again until the user approves.
- When you review a file for the user, leave your remarks with `add_review_comments` and finish with `complete_review`.
<!-- dotmd:end -->
DotMD меняет только часть между двумя своими строками-маркерами и хранит копию файла, сделанную до первого изменения, с окончанием .dotmd-backup. Update заменяет блок, когда в новой версии DotMD правила лучше, а Remove убирает его.
Для собственного файла проекта, а также для Cursor и других агентов нажмите в том же месте Copy и вставьте строки туда, где агент читает свои правила. В руководствах по Claude Code и Codex есть более короткий набор, который тоже можно использовать.
Что агент делает с этими правилами
С этими правилами агент присылает вам каждую спецификацию, план или проектный документ, который пишет (request_review), ждёт, пока вы комментируете, исправляет каждый комментарий и присылает снова, пока вы не утвердите. Ревью с агентами через MCP входят в DotMD Reviewer.
Вопросы о CLAUDE.md и AGENTS.md
Что такое CLAUDE.md и AGENTS.md?
Markdown-файлы с инструкциями для кодинг-агента. Claude Code читает CLAUDE.md, а Codex — AGENTS.md, в вашем проекте или, для всех проектов, в ~/.claude и ~/.codex.
Меняет ли DotMD мой CLAUDE.md сам по себе?
Нет. DotMD пишет в файл только когда вы нажимаете Add или Update в Settings → MCP → Agent rules, и только между двумя своими строками-маркерами. Перед этим он сохраняет копию файла как .dotmd-backup.
Можно ли править CLAUDE.md в DotMD, пока работает агент?
Да. Когда агент меняет файл, страница обновляется. Если вы как раз печатали, DotMD спросит, загрузить ли файл с диска или оставить вашу версию.
Нужен ли DotMD Reviewer, чтобы править эти файлы?
Нет. Открывать их бесплатно, а редактирование входит в DotMD Editor ($14.99 один раз). Ревью с агентами через MCP, которыми правила просят агента пользоваться, входят в DotMD Reviewer ($39.99 один раз).