Ваші агенти пишуть специфікації.Ви доводите їх до ладу в DotMD.

Claude Code, Codex і Cursor пишуть специфікації, плани та дизайн-документи за хвилини. DotMD перетворює кожен на документ, який ви перевіряєте як pull request: коментарі до точного уривка, правки просто у файлі й ваше схвалення наприкінці.

macOS 14 або новіша. Читати можна безкоштовно; редагування й рев'ю оплачуються один раз.

Коротко

DotMD дає змогу перевіряти специфікації, плани й документи, які пишуть Claude Code, Codex і Cursor, так само, як ви перевіряєте pull request: коментарі до точного фрагмента, виправлення у файлі й ваше схвалення наприкінці. Рев'ю входить до DotMD Reviewer, разової покупки; читати безкоштовно.

Чому чат — невдале місце для рев’ю

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

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

Цикл рев’ю

  1. Агент надсилає вам файл

    Він пише специфікацію й надсилає її на рев’ю. Сповіщення повідомляє вам про це, файл чекає в бічній панелі в розділі Needs You, і агент теж чекає.

  2. Ви коментуєте уривки

    Читайте документ таким, яким він буде: з таблицями, діаграмами та кодом. Виділіть уривок, який треба змінити, натисніть ⌥⌘M і напишіть, що хочете. Пройдіть увесь файл, перш ніж щось надсилати.

  3. Ви натискаєте Send

    Натисніть Send унизу панелі Review. Агент отримає всі коментарі разом, кожен з уривком і рядками.

  4. Правки з’являються у файлі

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

  5. Ви приймаєте або повертаєте, потім схвалюєте

    Accept приймає правку, Reopen повертає її з кращою нотаткою, Accept All приймає все. Коли змінювати більше нічого, натисніть Approve, і агент продовжить своє завдання.

@DotMD зі специфікацією, яку агент надіслав на рев’ю: уривки виділено жовтим, коментарі в панелі Review праворуч, а внизу кнопка Send, поки агент чекає
Специфікація чекає на рев’ю: коментарі праворуч, Send унизу.

Що варто перевіряти так

Усе, що агент пише як Markdown-файл і що треба довести до ладу, перш ніж він почне діяти:

  • Специфікації та дизайн-документи для функції.
  • Плани реалізації, до того як агент напише код.
  • Плани міграції та розгортання, де пропущений крок коштує дорого.
  • README та документація, за якими працюватимуть інші.
  • Порівняльні таблиці, де кожен рядок може бути хибним сам по собі.

Коментарі працюють і без агента, як нотатки собі на чернетці.

Ніщо не чекає непомітно

Агента, який на вас чекає, легко забути. DotMD тримає його на видноті, не втручаючись у те, чим ви зайняті:

  • Needs You угорі бічної панелі перелічує кожен файл, де на вас хтось чекає: агент чекає вашого рев’ю або є правки, яких ви ще не перевірили.
  • Значок у Dock показує, скільки файлів чекають на вас.
  • У файлі банер повідомляє, що чекає, з кнопкою Review, а кнопка Review на панелі інструментів показує червоним кількість правок на перевірку.
  • Агент чекає в одному виклику й не витрачає токени, поки ви читаєте, скільки б це не тривало.

Що вам потрібно

  • Mac з macOS 14 або новішою.
  • DotMD Reviewer для рев'ю та агентів: $39.99 один раз, або $24.99 для власників Editor. Читати Markdown безкоштовно. Див. ціни.
  • Агент із підтримкою MCP, підключений до DotMD. У посібниках з Claude Code і Codex налаштування для кожного займає один рядок.

Запитання про рев’ю ШІ-специфікацій

Як перевірити специфікацію ШІ-агента, перш ніж він почне писати код?

Підключіть агента до DotMD через MCP і попросіть надіслати специфікацію. Прокоментуйте фрагменти, натисніть Send, прийміть кожну правку або відкрийте її знову, потім натисніть Approve; агент чекає, доки ви це не зробите.

Чому б не перевіряти специфікацію в чаті?

У чаті ви цитуєте абзац, агент може переписати пів файлу, а ви не зрозумієте, що змінилося. У DotMD кожен коментар прив'язаний до фрагмента, правка показується поруч як diff, і кожна версія файлу зберігається.

Як побачити, що агент змінив понад те, про що я просив?

Відкрийте панель Review. Правки, яких не просив жоден коментар, перелічені в Other changes, а Version History дає змогу відкотити один блок або весь файл.

Які агенти можуть надіслати мені документ?

Будь-який MCP-клієнт: Claude Code, Codex, Cursor, Visual Studio Code та інші.

Чи витрачає агент токени, поки чекає?

Ні. Він чекає в одному виклику інструмента, доки ви не натиснете Send або Approve.

Чи можу я сам надіслати документ, якщо агент не просив?

Так. Прокоментуйте будь-який файл і скажіть агентові: «Прочитай мої коментарі в DotMD і виправ». У панелі Review є цей промпт із кнопкою Copy.

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