Superpowers для Claude Code

Claude Code из коробки — это агент с доступом к файловой системе, шеллу и набору инструментов, но без методологии. Ему всё равно, пишете вы прототип за десять минут или продакшн-сервис: он одинаково охотно бросится сразу писать код, срежет тесты и объявит задачу выполненной по факту «файл создан», а не по факту «работает и проверено». Superpowers (репозиторий obra/superpowers, автор — Jesse Vincent) — плагин-методология, которая навязывает агенту дисциплинированный инженерный процесс: сначала спецификация и план, потом TDD, потом ревью, и только потом «готово». Это не библиотека функций и не MCP-сервер, а набор skills — markdown-документов с инструкциями, которые агент обязан находить и применять до того, как писать собственные ad hoc решения.

Важно сразу разделить два слоя: слой инструментов (шелл, файловый доступ, MCP-серверы) и слой процесса. Superpowers работает на втором слое — он не даёт Claude Code новых технических возможностей, он меняет порядок действий и вводит контрольные точки, которые агент не имеет права молча пропустить.

Skill — это markdown-файл с чёткой структурой: когда триггерится, что нужно сделать, какие есть анти-паттерны, какого результата ожидать. Bootstrap-инструкция, которая устанавливается вместе с плагином, говорит агенту: прежде чем изобретать решение с нуля — проверь, нет ли уже подходящего skill. Это форсированный reuse: агент не имеет права молча пропустить существующую практику, потому что сам системный промпт требует явной проверки.

Автор проекта прямо ссылается на принципы убеждения Роберта Чалдини — формулировки в skills написаны так, чтобы модель не могла рационализировать пропуск шага («это же простая задача, тесты не нужны»). Это специфика работы с LLM-агентами: обычные императивные инструкции легко «забываются» в длинном контексте, поэтому формулировки жёстче, чем в обычной документации для людей.

flowchart TD
    A[Brainstorming: уточняющие вопросы, варианты дизайна] --> B[Git worktree: изолированная ветка, baseline тестов]
    B --> C[Planning: план шагов по 2-5 минут]
    C --> D[Development: subagent на каждый шаг]
    D --> E[TDD: RED - GREEN - REFACTOR]
    E --> F[Code Review: проверка против плана]
    F -->|есть критичные issues| D
    F -->|ревью пройдено| G[Завершение ветки: merge или PR]

Superpowers оборачивает разработку в последовательность обязательных этапов:

1. Brainstorming — агент не бросается кодить по первой формулировке задачи. Он задаёт уточняющие вопросы, предлагает варианты дизайна по частям, ждёт подтверждения на каждом шаге.

2. Git worktrees — работа ведётся в изолированном worktree на отдельной ветке, с зафиксированным baseline: какие тесты проходили до начала работы.

3. Planning — задача режется на шаги по 2–5 минут исполнения каждый, с полной спецификацией: что именно нужно сделать, какой файл трогать, какой результат считается успешным.

4. Development через subagent'ов — на каждый шаг плана диспетчеризуется отдельный subagent, а не «главный» агент продолжает копить контекст. Затем идёт двухэтапное ревью.

5. Test-Driven Development — классический цикл RED → GREEN → REFACTOR: сначала пишется падающий тест, фиксируется, что он реально падает, затем минимальный код, чтобы тест прошёл, потом рефакторинг.

6. Code review — отдельный skill requesting-code-review сверяет результат с планом и репортит проблемы по степени серьёзности; критичные issues блокируют переход дальше.

7. Завершение ветки — решение по merge/PR и очистке worktree.

Это не жёсткий waterfall — фазы переиспользуются итеративно внутри задачи, но порядок «сначала спецификация, потом тест, потом код» соблюдается систематически.

Если вы уже работаете с Claude Code через собственные CLAUDE.md-инструкции — Superpowers не конфликтует с ними, а добавляется поверх: project-specific конвенции продолжают действовать, а Superpowers добавляет process-layer, общий для любого проекта.

Superpowers ставится как обычный плагин Claude Code, без npm-пакетов и конфиг-файлов, в одну команду внутри активной сессии:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

После установки нужно перезапустить сессию (или начать новую) — тогда системный промпт агента дополняется инструкциями об обязательном поиске и использовании skills. Есть альтернативный путь — через официальный маркетплейс Anthropic, если плагин там подключён (/plugin install superpowers@claude-plugins-official); механика та же, разница только в источнике каталога.

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

Сравним два сценария на одном и том же запросе: «добавь эндпоинт для экспорта отчёта в CSV».

Без Superpowers. Агент читает роут-файлы, добавляет функцию, пишет обработчик, в лучшем случае — один happy-path тест, коммитит, говорит «готово». Ошибки в edge cases (пустой отчёт, некорректная кодировка, права доступа) всплывают на ревью у человека или в проде.

С Superpowers. Сначала — вопросы: какой формат разделителя, нужна ли пагинация экспорта, у кого есть права дёргать эндпоинт. Дальше — план из мелких шагов: «добавить роут-заглушку», «написать тест на пустой отчёт», «реализовать сериализацию», «тест на права доступа», «интеграционный тест». Каждый шаг идёт через RED-GREEN-REFACTOR: тест на пустой отчёт пишется и запускается до того, как код существует — агент обязан увидеть красный результат, прежде чем писать реализацию. Только после прохождения всех шагов и code review skill предлагает варианты завершения ветки.

Это заметно меняет соотношение затрат: independent-бенчмарки (по данным нескольких обзоров плагина) показывают порядка 9% снижения стоимости и 14% снижения расхода токенов в среднем на средних и сложных задачах — экономия достигается за счёт меньшего числа повторных исправлений после code review. На простых задачах эффект обратный: накладные расходы на brainstorming и планирование могут увеличить расход токенов, потому что сама задача не требовала такой церемонии.

Церемония на тривиальных задачах. Если попросить «переименуй переменную» или «поправь опечатку в комментарии», Superpowers всё равно может попытаться запустить brainstorming и планирование. Для микро-правок это чистый оверхед — формулируйте такие запросы явно как «без планирования, просто примени правку», чтобы не провоцировать полный цикл.

Subagent'ы теряют общий контекст. Диспетчеризация задач в отдельных subagent'ах защищает от разрастания контекста «главного» агента, но если план составлен плохо — шаги описаны неполно — subagent, не видящий предыдущих итераций напрямую, может продублировать работу или упустить неявную зависимость между шагами. План должен быть самодостаточным для каждого шага — это ответственность фазы Planning, а не что-то, что чинится позже.

Git worktrees путают тех, кто не работал с ними раньше. Изоляция ветки в отдельном worktree — это не тот же самый git checkout в текущей директории; если вы параллельно открываете тот же репозиторий в IDE, легко запутаться, в каком именно worktree сейчас лежат актуальные изменения. Стоит явно спросить агента, в каком пути находится текущий worktree, прежде чем руками лезть в файлы.

TDD-цикл ломается на легаси-коде без тестовой инфраструктуры. Если в проекте изначально нет настроенного test runner'а, RED-GREEN-REFACTOR не может стартовать — агент либо застревает, либо (хуже) имитирует прохождение фазы. Прежде чем полагаться на Superpowers в таком проекте, стоит убедиться, что базовый набор тестов и команда для их запуска уже существуют.

Не панацея от галлюцинаций. Методология структурирует процесс, но не гарантирует, что модель правильно поняла бизнес-требования. Brainstorming снижает вероятность недопонимания, но не устраняет её — уточняющие вопросы агента всё равно нужно внимательно читать, а не проматывать не глядя.

Superpowers — не новый инструмент для Claude Code, а навязанный процесс поверх существующих возможностей: brainstorming перед кодом, мелкая нарезка плана, обязательный TDD-цикл, диспетчеризация подзадач по subagent'ам и ревью перед завершением ветки. Ставится одной командой плагина, работает через markdown-skills, которые агент обязан искать и применять вместо изобретения решений с нуля. Выигрыш ощутим на задачах средней и высокой сложности — меньше повторных исправлений после ревью; на тривиальных правках он скорее добавляет накладные расходы. Практический вывод: включайте полную методологию там, где cost реальной ошибки высок, и просите агента срезать церемонию для простых механических правок.