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

Источник: https://docs.kodik.ru/agent/planning

Режимы **Планирование** и **Действие** — это два режима работы агента Kodik, описанных на странице [Режимы](https://docs.kodik.ru/agent/modes). Они помогают структурировать задачи: сначала понять и спланировать изменения, затем реализовать их.

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

В режиме Планирования 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 автоматически открывает специальную вкладку просмотра плана. В чате остаётся короткое подтверждение, а вкладка рендерит Markdown, список задач и (если есть) Mermaid-диаграмму — это не несохранённый файл `.md` в редакторе.

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

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

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

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

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

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

- Заранее предоставьте контекст: требования, ограничения, ключевые файлы.
- Используйте [@Упоминания](https://docs.kodik.ru/context/mentions) для явного указания важных файлов.
- Не торопите Kodik: пусть он закончит чтение кода перед формированием плана.

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

- Следуйте плану; при отклонении переключайтесь обратно в Планирование.
- Используйте [Чекпоинты](https://docs.kodik.ru/agent/checkpoints), чтобы зафиксировать состояние перед крупными изменениями.
- Отслеживайте прогресс через [Список задач](https://docs.kodik.ru/agent/task-management).

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

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

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

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

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