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

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

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

В режиме Планирования Kodik работает только на чтение. Он не редактирует файлы, не запускает изменяющие команды и не создаёт файлы — даже если вы попросите. Доступны только инструменты чтения и анализа: read_file, glob, rg, codebase_search, read_lints, web_fetch, а также sub_agent и ask_questions.

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

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

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

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

Панель плана

После вызова generate_plan результат отображается в специальной панели плана в интерфейсе Kodik. Панель показывает шаги, риски и (если есть) Mermaid-диаграмму.

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

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

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

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

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

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

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

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

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

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

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

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

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

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