Урок 2.7. Superpowers

Зачем это нужно

Superpowers важен для курса не только как популярный open-source инструмент. Он показывает принцип, который нужен любому зрелому AI-agent workflow:

Хорошая разработка с агентом - это не один хороший prompt.
Это набор повторяемых engineering procedures.

Когда разработчик работает с coding agent без процесса, агент часто делает типичные ошибки:

• начинает писать код до понимания задачи;
• пропускает design discussion;
• не создает отдельный worktree или branch;
• пишет implementation до тестов;
• объявляет работу завершенной без fresh verification;
• не просит independent review;
• смешивает несколько задач в один большой diff.

Superpowers превращает эти engineering habits в skills и workflow. Идея проста: если agent должен вести себя как дисциплинированный инженер, его нужно не только попросить "работай аккуратно", а дать ему reusable процедуры, которые включаются в нужный момент.

Основная идея

Superpowers - это software development methodology, упакованная как набор composable skills для coding agents.

Обычный project rule говорит агенту:

Пиши тесты. Делай review. Не усложняй.

Superpowers пытается сделать иначе:

Перед coding используй brainstorming.
После approved design создай worktree.
Перед implementation напиши plan.
В implementation используй RED-GREEN-REFACTOR.
После task запроси code review.
Перед завершением проверь branch.

То есть акцент переносится с "советов" на "процедуры".

Ключевые термины

Как это устроено

Superpowers можно представить как слой между user intent и coding agent:

Важный момент: Superpowers не заменяет coding agent. Он задает agent behavior поверх выбранного harness: Claude Code, Codex, Cursor, OpenCode, Kimi, Gemini CLI и других supported environments.

Базовый workflow

Типовой Superpowers flow:

Как пользоваться

На обзорном уровне Superpowers используется так:

1. Установить Superpowers в тот agent harness, где работает команда.
2. Начинать задачу не с просьбы "напиши код", а с problem statement.
3. Дать agent пройти brainstorming и design.
4. Остановиться на approval gate.
5. После approval перейти к worktree and plan.
6. Выполнять tasks через TDD.
7. Запрашивать review после значимых increments.
8. Завершать branch только после свежей verification.

Пример правильного входа:

I want to add project templates to the task manager.
Use the Superpowers workflow.
Start with brainstorming and do not write code until the design is approved.

Плохой вход:

Add project templates. Use Superpowers.

Во втором случае agent может понять инструмент как декоративную добавку к coding task. В первом случае workflow явно начинается с design, а не с code.

Какие artifacts появляются

Точный набор зависит от installed integration, но в Superpowers-подходе важны не только files, а workflow artifacts:

• design notes;
• implementation plan;
• task list;
• failing and passing tests;
• review findings;
• verification summary;
• branch/worktree state.

В некоторых environments Superpowers устанавливается как plugin или набор skills/commands. В repository могут появиться plugin metadata, skills, hooks, scripts или agent-specific folders. Перед production-внедрением нужно проверить, какие именно files добавляет выбранный install mode.

Пример: добавление project templates

Задача:

Пользователь может создать project из template:
- Empty project
- Kanban project
- Bug triage project

Workflow:

brainstorm
-> clarify templates and constraints
-> design data model and UI behavior
-> approve design
-> create worktree
-> write plan
-> TDD for backend template creation
-> TDD for frontend selection behavior
-> review
-> final verification

Task для агента:

Use Superpowers.

Goal:
Add project templates to the task manager.

Constraints:
- Do not change auth.
- Do not introduce a new database table unless design justifies it.
- Existing project creation must keep working.

Process:
- Start with brainstorming.
- Produce design for review.
- After approval, create a worktree and implementation plan.
- Use TDD for each behavior.
- Request review before finishing.

Когда Superpowers полезен

Superpowers хорошо подходит, когда:

• agent часто спешит в implementation;
• команда хочет enforced TDD;
• review должен быть частью workflow, а не пожеланием;
• нужно работать через worktrees;
• есть длинные tasks, где agent может потерять контекст;
• команда хочет reusable procedures;
• в проекте уже есть культура Git, tests и review.

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

• module 6: skills;
• module 8: development loop;
• module 9: TDD and tests;
• module 10: Git safety;
• module 11: subagents and review.

Когда не стоит брать

Superpowers может быть избыточен, если:

• задача совсем маленькая;
• проект еще не имеет tests;
• команда не готова к TDD;
• разработчику нужно быстро исследовать throwaway prototype;
• workflow конфликтует с уже утвержденным process;
• agent harness плохо поддерживает нужные plugin/skill mechanisms.

Если команда пока не умеет писать хороший spec.md, Superpowers не исправит это автоматически. Сначала нужно научиться формулировать intent, acceptance criteria и boundaries.

Риски

Prompt patterns

Начать feature

Use Superpowers for this feature.
Start with brainstorming.
Do not implement until I approve the design.

Feature:
...

Попросить plan

The design is approved.
Create an implementation plan with small TDD-friendly tasks.
Each task must include files to change and verification commands.

Попросить review

Review the implementation against the approved design and plan.
Focus on:
- behavioral gaps
- missing tests
- scope creep
- regressions
- verification evidence

Практика

Возьмите любую небольшую feature и опишите ее так, чтобы Superpowers workflow не мог начать с coding.

Минимальная структура:

Goal:
Non-goals:
Constraints:
Expected workflow:
Approval gate:
Verification:

Проверьте себя:

• есть ли явный запрет на implementation до design approval;
• есть ли место для TDD;
• есть ли review step;
• есть ли final verification.

Критерии готовности

После урока студент должен уметь:

• объяснить Superpowers как skill-first SDLC methodology;
• отличить procedure от generic project rule;
• описать базовый workflow Superpowers;
• понять, где Superpowers помогает, а где добавляет лишний overhead;
• сформулировать prompt, который запускает brainstorming before coding;
• встроить TDD, review и finishing branch в agent workflow.

Краткое резюме

Superpowers показывает, что mature AI development строится не вокруг одного сильного prompt, а вокруг повторяемых engineering procedures. Его ценность в том, что brainstorming, planning, TDD, review и finishing branch становятся частью agent behavior.

Но Superpowers не заменяет specification, tests и review. Он помогает заставить agent пользоваться ими consistently.

Вопросы для самопроверки

1. Чем skill-first workflow отличается от project rules?
2. Почему Superpowers начинает с brainstorming, а не с implementation?
3. Когда Superpowers будет избыточен?
4. Какие evidence artifacts должны остаться после завершения branch?
5. Почему TDD skill не полезен без стабильного test baseline?

Источники для актуализации

• Superpowers repository: https://github.com/obra/superpowers
• Superpowers skills and workflow overview: https://github.com/obra/superpowers
• Глубокий разбор Superpowers по официальной документации - модуль 17, начиная с урока 17.1: философия и механизм срабатывания скиллов, установка на разные harness-каркасы, полный жизненный цикл, диагностика сессий и написание собственных скиллов.

Что дальше

Следующий урок разберет GitHub Spec Kit - более явно specification-driven подход, где workflow строится вокруг constitution, specify, plan, tasks и implement.