Планирование и действие

Режимы Планирование и Действие — это два режима работы агента Kodik, описанных на странице Режимы. Они помогают структурировать задачи: сначала понять и спланировать изменения, затем реализовать их.

Режим планирования

В режиме Планирования нет терминала и инструментов редактирования файлов, поэтому агент не редактирует и не создаёт файлы и не запускает команды — даже если вы попросите. Во встроенный набор входят инструменты чтения и анализа: read_file, glob, grep, read_lints, web_fetch, а также ask_questions.

Включённые MCP-инструменты также доступны в Plan. Это установленные пользователем внешние возможности, и их побочные эффекты определяет сервер, поэтому отключайте нежелательные для этого режима инструменты через Настройки → Harness или настройки MCP.

Результат работы режима — структурированный артефакт плана, создаваемый через инструмент generate_plan. Если Mermaid-диаграмма архитектуры будет полезна, агент включит её в план.

Рабочий процесс внутри режима

1. Kodik читает и анализирует релевантный код.
2. Если задача неоднозначна — один раз вызывает ask_questions для уточнения.
3. Разбивает работу на небольшие шаги в порядке реализации. Каждое требование и каждый пункт, где сказано «все» или «каждый», получают свой шаг с критерием приёмки, дословно повторяющим приведённые вами имена, сообщения и значения.
4. Фиксирует допущения и открытые решения в кратком описании плана, а риски — вместе со способом проверить изменение. Разделы об архитектуре и зависимостях появляются, только если они есть в плане.
5. Один раз вызывает generate_plan, чтобы сохранить артефакт плана, и отвечает одной строкой.

Планирование не допускает обычного чата: все вопросы — через ask_questions, финальный план — через generate_plan, после чего следует ответ в одну строку. Никаких промежуточных текстовых сообщений.

Панель плана

После вызова generate_plan Kodik автоматически открывает специальную вкладку просмотра плана. В чате остаётся короткое подтверждение, а вкладка рендерит Markdown, список задач и (если есть) Mermaid-диаграмму — это не несохранённый файл .md в редакторе. Вкладка сохраняет позицию и всё, что в ней открыто, пока вы работаете в других редакторах; перезагрузка окна закрывает её, а вернуть план можно действием открытия плана в чате.

Диаграммы используют общий просмотрщик Markdown: разворачивайте SVG, перемещайте его, меняйте и сбрасывайте масштаб, смотрите и копируйте исходник. Escape закрывает увеличенный вид. Просмотрщик следует теме, а ошибка синтаксиса остаётся внутри диаграммы. Увеличенная диаграмма занимает всё окно, а не только вкладку.

Кнопка Начать реализацию занимает отдельную строку во всю ширину под заголовком панели плана, а кнопка открытия плана остаётся в самом заголовке. Отступы и размеры текста соответствуют остальным панелям над полем ввода; панель можно развернуть для прокручиваемого предпросмотра или открыть полный план. В узкой панели кнопка открытия плана показывает только значок; наведите на неё указатель или перейдите к ней с клавиатуры, чтобы увидеть название во всплывающей подсказке. Кнопка Начать реализацию остаётся видимой, пока агент генерирует ответ. В это время кнопка временно недоступна и снова включается после завершения ответа. После начала реализации она больше не отображается.

Для поиска по шагам и деталям плана нажмите Ctrl+F (Windows/Linux) или Cmd+F (macOS) во вкладке плана. Enter и Shift+Enter переходят между совпадениями. Escape закрывает поиск; та же комбинация Ctrl+F или Cmd+F открывает его снова.

Значок сохранения вверху панели шагов — Сохранить как Markdown, подпись появляется при наведении — сохраняет описание плана, исходник Mermaid и текущий список задач в .kodik/plans рабочей папки чата (или его worktree). Она доступна и после начала реализации. Каждое нажатие создаёт новый файл .md и показывает его путь; предыдущие копии сохраняются. При ошибке проверьте, что рабочая папка открыта и доступна для записи, и повторите попытку.

Планирование в Orchestrator

Когда нужен маршрут, Orchestrator делегирует планирование встроенному профилю Planner. Planner изучает доступные доказательства и публикует один структурированный черновик в Team Board сессии с помощью доступного только субагенту create_plan. Orchestrator рассматривает черновик как рекомендацию и не пишет или переписывает его сам.

Обоснованный рутинный план Orchestrator принимает самостоятельно и продолжает делегирование, не прерывая вас. Окно проверки открывается только когда нужны ваши полномочия: остались решения пользователя, расширяется область, требуется разрушительное или внешне видимое действие, есть существенный риск стоимости, безопасности или совместимости либо вы явно попросили показать план. Подтверждение продолжает делегирование в Orchestrator; запрос изменений отклоняет черновик и передаёт обратную связь Planner. Новый черновик заменяет предыдущий, а Team Board сохраняет старый для аудита и восстановления.

В чате опубликованный план — одна строка о произошедшем: «План создан» и его название, под которым идёт краткое описание. Клик по этой строке открывает Team Board, где хранятся маршрут, исполнители, риски и открытые вопросы; в переписке их копия не появляется.

Режим действия (Code / Act)

Как только план готов, переключитесь в режим Действия (Code). В этом режиме доступны все инструменты агента — редактирование файлов, запуск команд терминала, создание файлов. Контекст из сессии планирования сохраняется.

Типичный рабочий процесс

1. Начните задачу в режиме Планирования.
2. Опишите цель; Kodik изучит кодовую базу.
3. При необходимости ответьте на уточняющие вопросы.
4. Просмотрите сформированный план в панели.
5. Переключитесь в режим Действия — Kodik выполнит план.
6. При столкновении с неожиданной сложностью вернитесь в Планирование для уточнения стратегии.

Лучшие практики

Фаза планирования

• Заранее предоставьте контекст: требования, ограничения, ключевые файлы.
• Используйте @Упоминания для явного указания важных файлов.
• Не торопите Kodik: пусть он закончит чтение кода перед формированием плана.

Фаза реализации

• Следуйте плану; при отклонении переключайтесь обратно в Планирование.
• Используйте Чекпоинты, чтобы зафиксировать состояние перед крупными изменениями.
• Отслеживайте прогресс через Список задач.

Когда использовать каждый режим

Режим Планирования подходит, когда:

• подход к задаче неочевиден
• нужно разобраться в сложной ошибке перед исправлением
• принимаются архитектурные решения, затрагивающие несколько частей кодовой базы

Режим Действия подходит, когда:

• план уже готов
• вносятся рутинные изменения с понятным подходом
• запускаются тесты или небольшие правки