Зачем нужен Plan Mode в Claude Code и когда переходить в Build?

Plan Mode = чтение и обсуждение без правок. Переход в Build только при наличии архитектурной картинки.

Описание

Разработчик использует режим планирования агента (Plan Mode), в котором у агента физически закрыт доступ к изменению файлов. Цель — собрать минимальный контекст и сформировать понятный план до того, как агент начнёт что-либо менять.

Предусловия

• Агент (OpenCode / Codex / Claude Code и т. п.) запущен в директории проекта
• В проекте есть AGENTS.md или аналогичный файл с базовыми соглашениями (см. UC-003 · AGENTS.md)
• Выбрана модель, соответствующая уровню задачи (см. UC-010 · Выбор модели под задачу)

Постусловия / гарантия успеха

• Сформулирован концептуальный план изменений: какие файлы и слои затрагиваются, какая архитектурная картинка получится в итоге
• Разработчик принял осознанное решение: переходить в Build Mode или продолжить уточнение
• Код проекта не изменён до явного согласия разработчика

Основной сценарий

1. Разработчик открывает сессию агента и переключает её в режим Plan
2. Разработчик формулирует задачу максимально нейтрально, без предположений о решении (например, «проверь, почему не работает», а не «исправь конкретный конфиг»)
3. Агент анализирует код, читает релевантные файлы и рассуждает в режиме thinking
4. Агент предлагает варианты решения и поясняет последствия
5. Разработчик задаёт уточняющие вопросы и просит составить пошаговый план
6. Когда план соответствует целевой архитектурной картинке, разработчик переключает сессию в режим Build с командой выполнения плана

Расширения / альтернативные потоки

• 5a. Если предложенное решение неочевидно — разработчик просит сравнить альтернативы (плюсы/минусы), не выбирая заранее «правильный» вариант
• 5b. Если план содержит лишние пункты (например, неожиданная установка библиотек) — разработчик явно исключает их перед выполнением

Исключения и риски

Бизнес-правила и ограничения

• Переход в Build Mode возможен только при наличии в голове разработчика «картинки решения» на архитектурном уровне, а не на уровне конкретных строк кода
• Любое изменение требует возможности отката (контроль версий, частые коммиты)

Примечания

Plan Mode также чистит контекст перед выполнением: в Build уходит только согласованный план, что уменьшает шум и стоимость токенов. Это особенно важно для длинных сессий — переключение в Build с уже отфильтрованным контекстом даёт более стабильный результат и меньше «галлюцинаций» от перегруженного окна.