Как написать план фичи в Claude Code: фазы и чекбоксы

Коротко: Правило простое: одна фича - один план - один файл в папке plans с фазами и чекбоксами. План живёт в файле, а не в памяти чата, поэтому его подхватит любой новый диалог. Пишется план в одном чате, критикуется во втором, реализуется в третьем: ошибка на плане стоит минуту, та же ошибка в коде - день.

План фичи в редакторе: файл в папке plans с фазами и чекбоксами, две фазы выполнены

Мелкую правку делают просто диалогом. Но большая фича без плана расползается: агент теряет нить, вы теряете контроль, к вечеру никто не помнит, что уже сделано. План в файле решает всё разом: это и техзадание, и трекер прогресса, и память между днями.

Содержание
  1. Формат плана
  2. Почему файл, а не режим планирования
  3. Цикл: план, критика, реализация
  4. Стресс-тест перед стартом
  5. Частые вопросы
  6. Что дальше

Формат плана

Файл plans/ГГГГ-ММ-ДД-название-фичи.md:

# План: лендинг с формой записи

Статус: в работе

## Фазы
- [x] Фаза 1. Каркас страницы: hero, услуги, форма
- [x] Фаза 2. Тексты из business/: оффер, боли, цены
- [ ] Фаза 3. Форма записи: имя, телефон, отправка в Telegram
- [ ] Фаза 4. Проверка ошибок и security review
- [ ] Фаза 5. Деплой и проверка на телефоне

## Итог
Реализовано частично. После каждой фазы - отметка здесь.

Каждая фаза - конкретный проверяемый результат, а не «поработать над сайтом». Агент отмечает выполненное сам, если правило «актуализируй план после каждой фазы» зашито в CLAUDE.md.

Почему файл, а не режим планирования

План в памяти диалога умирает вместе с чатом. Файл живёт: завтра, после сбоя, в новом окне - любой агент открывает план, видит, какие фазы закрыты, и продолжает с нужного места. А когда что-то сломается на проде, вы вернётесь к старому плану и поймёте, что и когда делали.

Цикл: план, критика, реализация

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

Чат 1 - черновик плана: «изучи задачу [описание], прочитай business/INDEX.md, напиши план реализации в plans/ с фазами и чекбоксами. Код не пиши».

Чат 2 - критика:

Открой план plans/[ФАЙЛ].md и прочитай business/INDEX.md для контекста.
По каждой фазе ответь честно:
1. Решает ли фаза задачу или это код ради кода?
2. Есть ли решение проще? Мы делаем первую версию, а не идеал.
3. Что сломается, если фазу выкинуть? Ничего - выкидывай.
4. Что нужно сделать раньше остального?
Собери итог списком правок. Критикуй жёстко.

Чат 3 - реализация оркестратором: «ты оркестратор плана plans/[ФАЙЛ].md: иди по фазам, после каждой - проверка ошибок и security review, отметка в файле; в конце запусти проект и дай ссылку».

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

Стресс-тест перед стартом

Для крупных фич добавьте пре-мортем: «представь, что прошло полгода и фича провалилась; назови десять самых вероятных причин и что поменять в плане уже сейчас». Если несколько причин выглядят серьёзно, дешевле поменять план сегодня, чем переделывать через месяц.

Главная ловушка

После первого черновика агент скажет «готов реализовывать». Не соглашайтесь: любой план с первого захода сырой. Минимум один круг критики до кода - это самая дешёвая страховка в методе.

Частые вопросы

Когда нужен план, а когда достаточно диалога?

Ориентир - объём: правка на минуты делается диалогом, работа на час и больше - через план. Сомневаетесь - пишите план: пять минут на файл окупаются всегда.

Сколько фаз должно быть?

Столько, сколько проверяемых результатов. У маленькой фичи их несколько, у крупной - десятки. Слишком крупные фазы дробите: «сделать сайт» - не фаза, «каркас страницы с hero и формой» - фаза.

Кто отмечает выполненные фазы?

Агент, если правило зашито в CLAUDE.md. Вы только проверяете: открыли файл - видите честную картину прогресса.

Что делать с планом после завершения?

Оставить в plans/ как историю: это документация того, как и что строилось. При разборе проблем старые планы экономят часы археологии.

Что дальше

Мнение редакции ENGRAM

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

ENGRAM решает это

Знания и наработки команды теряются в переписке. ENGRAM собирает их в единую ИИ-память с поиском по смыслу - данные остаются в России.

Читайте также