02 / 06 · Продвинутый

Workflow разработки

Spec-driven development с Claude Code: от идеи до смёрджённого PR за предсказуемое время. Один воркдерево — одна задача.

7 шагов TDD · worktrees spec как точка истины
Одна задача — один worktree

Смешивать фичи в одном worktree — значит потерять контроль над диффом. Каждая ветка живёт в своей папке, агенты не мешают друг другу.

7 шагов от идеи до PR

1
Brainstorm

Описываете задачу свободным языком, агент предлагает 2–3 подхода с trade-offs. Не выбирайте реализацию до этого шага — часто лучший вариант неочевиден.

bash
/brainstorm
2
Spec

Фиксируете договорённость: что делаем, что не делаем, как проверим готовность. Spec — единственная точка истины на протяжении всей работы.

путь к файлу
bash
docs/superpowers/specs/2026-06-24-feature-name.md
3
Plan

Агент разбивает spec на атомарные шаги — каждый можно проверить отдельно. Вы читаете план и корректируете до того, как начнётся изменение кода.

bash
/write-plan
4
Worktree

Создаёте изолированную копию репозитория — main остаётся чистым, а фича развивается в отдельной папке. Параллельные задачи не пересекаются.

bash
git worktree add ../wt/feat-payments feat/payments
5
Execute

Запускаете агента в worktree. Он работает по плану, запускает тесты после каждого шага. Вы можете параллельно делать другую задачу в main.

bash
cd ../wt/feat-payments && claude
6
Review

Агент делает ревью своей же работы по чеклисту: безопасность, тесты, соответствие spec. Это не замена человеческому ревью, но ловит 80% типовых проблем.

bash
/code-review
7
Merge

Тесты зелёные, ревью пройдено — мёрджим и убираем worktree. Следующая задача начинается с чистого листа.

bash
git worktree remove ../wt/feat-payments

Spec решает всё

Без spec угадывание
  • Агент уточняет требования прямо в процессе
  • Диф непредсказуемый, scope расползается
  • Нет критерия завершённости — работа бесконечна
  • Ревью субъективно — непонятно с чем сравнивать
Со spec предсказуемость
  • Агент работает по договорённости, не угадывает
  • Диф ожидаемый, scope зафиксирован
  • Тесты зелёные = готово, критерий объективный
  • Ревью проверяет соответствие spec — конкретно

Шаблоны для старта

Нужно реализовать: [описание фичи одним абзацем] Стек: Laravel 11 + PostgreSQL + Vue 3 Ограничения: [что нельзя трогать] Критерий готовности: [как поймём что фича работает] Предложи 2–3 подхода с trade-offs.
# [Название фичи] — Spec [YYYY-MM-DD] ## Проблема [Что сейчас не работает или чего не хватает] ## Решение [Что делаем, одним абзацем] ## Интерфейс [API-контракт / UI-поведение / схема БД] ## Не делаем [Явные исключения из scope] ## Критерий готовности - [ ] [Тест или поведение 1] - [ ] [Тест или поведение 2]

Параллельные worktree

Пока агент работает над фичей в одном worktree, вы можете делать хотфикс в другом — ни один файл не пересекается.

../wt/feat-payments Фича оплаты Ветка feat/payments. Агент пишет интеграцию со Stripe, гоняет тесты. в работе
../wt/fix-auth-bug Хотфикс авторизации Ветка fix/auth-session. Вы сами смотрите баг, агент рядом помогает. на ревью
../wt/refactor-api Рефакторинг API Ветка refactor/api-v2. Запланировано — стартует после мёрджа фичи. ожидает