Цикл «план → правки → проверка»: как ставить задачи агенту

Хорошая задача укладывается в один дифф, который вы прочитаете за несколько минут. Практическое правило документации Claude Code: если вы можете описать дифф одним предложением, план не нужен; если правка затрагивает несколько файлов или вы не знаете код, план нужен. Большую работу разбейте на этапы и ставьте по одному: документация Codex советует просить «Implement Milestone 1 from the plan» и просматривать результат каждого этапа.

Критерий готовности — проверяемый факт, а не оценка. Сравните:

Документация Claude Code приводит те же примеры: дайте агенту проверку (тест, сборку, скриншот для сравнения) — это разница между сессией, за которой вы следите, и сессией, которую можно оставить.

План — это предложение агента, какие файлы он изменит и в каком порядке, без правок. Переделать план дешевле, чем дифф.

• В Claude Code режим плана включается клавишей Shift+Tab (статус показывает plan mode on), командой /plan с описанием задачи или запуском claude --permission-mode plan. Агент читает файлы и предлагает план, но источники не меняет. Клавиша Ctrl+G открывает план в вашем редакторе для правки.
• В Codex команда /plan включает режим плана: агент изучает проект и предлагает подход, прежде чем править.

Читая план, проверьте: те ли файлы, нет ли лишнего, есть ли шаг с тестом, не затрагивается ли запрещённое в файле правил. Поправьте словами: «не трогай src/db/, а тест положи в tests/».

После согласования плана дайте команду приступать и сформулируйте порядок: сначала падающий тест, потом реализация (подробно — в уроке 7). Агент запускает проверки и исправляет ошибки, пока команда не пройдёт. Просите показать вывод команд, а не фразу «тесты прошли»: документация Claude Code советует требовать доказательства, потому что проверять вывод быстрее, чем перепроверять самому.

Затем смотрите дифф:

• в Claude Code — команда /diff (изменения рабочей копии, включая правки агента) или обычный git diff;
• в Codex — /diff показывает git-дифф вместе с неотслеживаемыми файлами, а /review просит проверить изменения.

В Claude Code есть встроенный навык /code-review (проверка диффа на ошибки корректности). Просите его искать ошибки по требованиям задачи: ревьюер, которого просили найти недостатки, найдёт их почти всегда, и погоня за каждым замечанием ведёт к лишним абстракциям. Решение принимаете вы: читайте весь дифф по чек-листу из урока Ревью кода, написанного ИИ.

Шаблон одинаково работает в обоих ассистентах. Сохраните его в файл вне репозитория или вставляйте в сессию.

Задача: ограничить число попыток записи с одного телефона.

Контекст:
- обработчик записи: src/api/bookings.ts
- уже есть помощник src/lib/rate-limit.ts, используй его
- тесты записи: tests/bookings.test.ts

Цель: 4-й запрос с одного телефона за 10 минут возвращает 429.

Критерии готовности:
- тест на 4-й запрос проходит, на другие телефоны лимит не действует
- npm run typecheck, npm run lint, npm test проходят
- изменения только в src/api/, src/lib/, tests/

Вне задачи: интерфейс, схема базы, новые зависимости.

Порядок: сначала предложи план и дождись ответа; затем напиши
падающий тест и реализацию; покажи вывод проверок и перечисли, в чём не уверен.

Каждая часть отвечает на вопрос: где искать, что получить, как проверить, чего не трогать, как работать. Это те же четыре элемента, которые называет документация Codex: цель, контекст, ограничения и проверка.

Для долгой работы обе системы поддерживают команду /goal: условие завершения становится критерием, по которому агент решает, что работа окончена. Используйте её, когда критерий действительно можно проверить автоматически; как работает оценка условия, сверьте с документацией своего инструмента.

Следующий урок — разрешения и безопасность: что агенту нельзя и как это закрепить технически. Если нужно проверить, как ваш проект переживает работу агента, посмотрите услугу аудита ИИ-кода.