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

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

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

В режиме Планирования встроенные инструменты Kodik для рабочего пространства работают только на чтение. Они не редактируют файлы, не запускают изменяющие команды и не создают файлы — даже если вы попросите. Во встроенный набор входят инструменты чтения и анализа: read_file, glob, rg, codebase_search, read_lints, web_fetch, а также sub_agent и 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 в редакторе.

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

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

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

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

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

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

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

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

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

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

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

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

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

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