Date: 2026-05-10
Tested by: Desktop Claude (claude-sonnet-4-6)
Repo: https://github.com/obra/superpowers
Plugin: superpowers@claude-plugins-official
Методологічний фреймворк для AI coding-агентів. Набір markdown-скілів (SKILL.md), які завантажуються в контекст Claude Code і auto-trigger з порогом "1% chance of relevance".
Ключові скіли (v5.1.0):
test-driven-development — RED-GREEN-REFACTOR цикл, обов'язкові failing testssystematic-debugging — 4-фазний root cause analysisrequesting-code-review — структурований чеклист (Plan/Quality/Arch/Testing/Security)writing-plans — задачі по 2-5 хвилин з exact file pathssubagent-driven-development — 2-рівневе ревью (spec + code quality)dispatching-parallel-agents — паралельні субагентиverification-before-completion — "якщо не бачив failing test — не перевіряв"Застосовано requesting-code-review чеклист до /srv/services/federation-broker/broker.py.
Знахідки (P2-P3, не critical):
get_or_create_shared_secret() читає файл при кожному connect_and_auth — мінімальний IO overheadauth — ризик у debug-логахВисновок по тесту: Чеклист корисний, знайшов реальні issues яких я б не зазначив без нього. Але без субагента-ревьюера (Task tool) це просто методологія в голові, не автоматизація.
Застосовано структуру requesting-code-review до Desktop ~/.federation/client.py.
Результат: Функція build_canonical_message() була неявно вбудована в sign_message() — скіл виявив відсутність явного публічного API для тестування.
Рефакторинг: Виокремлено build_canonical_message(msg) -> bytes з константою CANONICAL_FIELDS.
Оцінка: Скіл дає структуру для аналізу, але "document this" у superpowers — більше про process than automation.
Реалізовано RED → GREEN → REFACTOR для build_canonical_message():
RED: ImportError — функції не існує ✅
GREEN: 4/4 tests pass після реалізації ✅
Тести: test_canonical_includes_required_fields, test_canonical_is_sorted, test_canonical_excludes_signature, test_canonical_is_bytes.
Один тест упав через неточність у тесті ("signature" not in bytes), не в коді — класичний TDD момент.
Оцінка: Найсильніший скіл. Застосовний відразу, перевіряємо реальну поведінку.
| Критерій | superpowers | PM-Agent v0.3 | Dev Crew (7 roles) |
|---|---|---|---|
| Тип | Методологія в контексті | Автономний cron-агент | Crew з ролями |
| Автоматизація | Мінімальна (prompt injection) | Висока (cron + wiki) | Висока (Task tools) |
| TDD | ✅ вбудований | ❌ | ❌ |
| Code review | ✅ чеклист | ❌ | ✅ через ролі |
| Документування | ✅ методологія | ✅ авто-дока | ✅ |
| Вартість | Низька (токени) | Низька | Висока (багато викликів) |
| Гнучкість | Висока | Низька (жорсткий flow) | Середня |
Варто інтегрувати: Так, але як доповнення, не заміна.
Що дає: Структурований підхід до TDD і code review всередині Claude Code сесії. Особливо цінний test-driven-development і requesting-code-review.
Що НЕ дає: Не замінює PM-Agent (автономний моніторинг/дока). Не замінює Dev Crew (паралельна мультиагентна розробка). Не автоматизує — просто дисциплінує.
Ризики: Агресивний "1% threshold" для skill-checking може уповільнити прості задачі. Треба довіряти методології.
enabledPlugins: {"superpowers@claude-plugins-official": true} — вже додано в ~/.claude/settings.json/plugin install superpowers@claude-plugins-official в наступній інтерактивній сесії)subagent-driven-development замість Dev Crew — вони роблять різнеtest-driven-development для будь-яких нових Python/JS утилітrequesting-code-review перед мержем у production-сервіси~/.federation/test_client.py — pytest тести, написані по TDD~/.federation/client.py — оновлений (додано build_canonical_message)~/.claude/settings.json — enabledPlugins додано