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

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

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

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

Цикл рев’ю

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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