Superpowers методология разработки

📖 Теория

Что такое Superpowers?

Superpowers — это plugin для Claude Code, который добавляет методологию разработки через специализированные скиллы. Вместо хаотичного написания кода, вы следуете структурированному процессу.

Философия Superpowers

"Если есть хотя бы 1% вероятность, что скилл применим к вашей задаче — вы ОБЯЗАНЫ его использовать. Это не переговоры."

Superpowers учит дисциплине: всегда проверять, есть ли скилл для текущей задачи, прежде чем действовать.

Основные скиллы Superpowers

Процесс разработки с Superpowers

1. superpowers:brainstorming  — генерация идей
   ↓
2. superpowers:writing-plans  — план реализации
   ↓
3. superpowers:executing-plans — выполнение
   ↓
4. superpowers:verification-before-completion — проверка
   ↓
5. Готово!

Если на любом этапе возникает баг:

superpowers:systematic-debugging → находим причину → фиксим → возвращаемся в цикл

Правило: проверяй скиллы ПЕРЕД действием

Superpowers учит не действовать импульсивно. Перед любым действием спросите себя:

• Есть ли скилл для этой задачи?
• Нужно ли сначала brainstorming?
• Есть ли план, или я пишу код вслепую?

🛠 Практика

Пример 1: Разработка фичи с полным циклом

Задача: Добавить фильтрацию товаров по цене в интернет-магазине.

Шаг 1. Brainstorming

Используй superpowers:brainstorming для фичи: фильтрация товаров по цене. Нужно решить: клиентская или серверная фильтрация, UI компонент, обновление URL.

Claude проводит brainstorming:

• Подход 1: Клиентская фильтрация (быстро, но не масштабируется)
• Подход 2: Серверная фильтрация (медленнее, но правильно для больших каталогов)
• Подход 3: Гибрид (первая страница клиент, остальное сервер)

Вы выбираете Подход 2.

Шаг 2. Планирование

Используй superpowers:writing-plans для реализации серверной фильтрации по цене.

Claude создаёт план:

## План: серверная фильтрация по цене

### 1. Backend
- Добавить query-параметры min_price и max_price в /api/products
- Обновить SQL-запрос с WHERE price BETWEEN
- Добавить валидацию min <= max

### 2. Frontend
- Компонент PriceFilter с двумя input полями
- Обновление URL при изменении фильтра
- Debounce на 500ms для запросов

### 3. Тесты
- test_filter_by_min_price()
- test_filter_by_max_price()
- test_filter_by_range()
- test_invalid_range()

Шаг 3. Выполнение

Используй superpowers:executing-plans для реализации плана.

Claude выполняет план пошагово, отмечая завершённые шаги.

Шаг 4. Верификация

Используй superpowers:verification-before-completion.

Claude проверяет:

• ✅ Все тесты пройдены
• ✅ Код соответствует плану
• ✅ Нет TODO комментариев
• ✅ Документация обновлена

Пример 2: Systematic debugging

Проблема: После деплоя пользователи не могут залогиниться.

Используй superpowers:systematic-debugging. Проблема: users can't login after deploy.

Claude проводит систематическую отладку:

## Гипотеза 1: ENV переменные не загружены
Тест: проверить логи сервера на startup
Результат: ❌ SECRET_KEY загружен корректно

## Гипотеза 2: База данных недоступна
Тест: curl /health-check endpoint
Результат: ❌ DB connection OK

## Гипотеза 3: JWT токены с неправильным SECRET_KEY
Тест: сравнить SECRET_KEY в старом и новом деплое
Результат: ✅ НАЙДЕНО! SECRET_KEY изменился, старые токены невалидны

Решение: Сбросить сессии или ротация ключа с grace period.

Пример 3: TDD с Superpowers

Используй superpowers:test-driven-development для функции calculate_discount(price, user_level).

Claude следует TDD циклу:

1. RED: Пишет failing тест
2. GREEN: Пишет минимальный код для прохождения теста
3. REFACTOR: Улучшает код без изменения поведения
4. Повторяет для следующего кейса

Пример 4: Git worktrees

Используй superpowers:using-git-worktrees. Мне нужно работать над feature/payments и одновременно фиксить hotfix/login-bug.

Claude создаёт изолированные worktree для обеих веток, и вы можете работать параллельно.

📝 Домашнее задание

🎓 После урока вы умеете

• Использовать методологию Superpowers для структурированной разработки
• Проводить brainstorming перед написанием кода
• Составлять и выполнять планы через скиллы
• Систематически отлаживать баги без хаотичного поиска
• Применять TDD через superpowers:test-driven-development
• Работать с git worktrees для параллельной разработки

⚠️ Частые ошибки

1. Пропуск brainstorming

Ошибка: Сразу начать писать код без обдумывания подходов.

Правильно: Всегда запускать brainstorming для нетривиальных задач.

2. Игнорирование скиллов

Ошибка: "Я знаю, как это сделать, мне не нужен скилл."

Правильно: Если скилл существует для вашей задачи — используйте его. Дисциплина важнее интуиции.

3. Выполнение без плана

Ошибка: Пропустить writing-plans и сразу перейти к executing-plans.

Правильно: План нужен всегда, даже для "простых" задач.

4. Пропуск верификации

Ошибка: "Код работает, можно коммитить."

Правильно: Всегда запускать verification-before-completion перед завершением.

🔗 Связанные материалы

• Superpowers GitHub: obra/superpowers (методология)
• Урок 31: gstack — дополняет Superpowers командой специалистов
• Урок 10: EnterPlanMode — встроенное планирование Claude Code

💡 Продвинутые техники

Комбинация Superpowers + gstack

Используйте Superpowers для процесса, gstack для экспертизы:

1. superpowers:brainstorming  — генерация подходов
2. /office-hours             — CEO валидирует идею
3. superpowers:writing-plans  — план
4. /plan-ceo-review          — CEO проверяет план
5. /plan-eng-review          — Tech Lead проверяет архитектуру
6. superpowers:executing-plans — выполнение
7. /review                   — Reviewer проверяет код
8. /qa                       — QA тестирует
9. superpowers:verification-before-completion — финальная проверка
10. /ship                    — Release Engineer деплоит

Сохранение решений в MEMORY.md

После brainstorming сохраняйте важные решения:

Сохрани в память: мы выбрали серверную фильтрацию вместо клиентской, потому что каталог содержит 50K товаров. Причина: производительность.

Это создаст запись в MEMORY.md (подробнее в уроке 33).