нейропоток
Гайды

Superpowers Claude Code: прокачиваем AI-агента до синьора

Superpowers Claude Code и everything-claude-code — два фреймворка, которые превращают AI-агента в системного разработчика. Установка, сравнение, практика.

Павел·10 мин чтения
Superpowers Claude Code: прокачиваем AI-агента до синьора
Поделиться:TelegramVK

Claude Code из коробки — талантливый джун. Пишет код быстро, знает кучу языков, не жалуется на переработки. Но дай ему задачу посложнее — и начинается: код без тестов, рефакторинг на ровном месте, забытый контекст через полчаса работы. Знакомо?

Superpowers Claude Code — фреймворк, который решает эту проблему. Ставишь за 30 секунд, и агент начинает работать по методологии: сначала дизайн, потом план, потом тесты, и только потом код. Есть и альтернатива — everything-claude-code (ECC), который идёт дальше: 28 агентов, 119 скиллов, система обучения между сессиями.

Я поставил оба. Вот что получилось.

Что понадобится

  • Claude Code с активной подпиской (Max Plan или API)
  • Терминал — всё через CLI
  • Git — оба фреймворка используют worktrees
  • 5 минут на установку Superpowers, 10-15 на ECC
  • $0 — оба бесплатные, MIT-лицензия

Если вы уже работаете с Claude Code — всё готово. Если только начинаете — советую сначала пройти базовый вайб-кодинг гайд, а потом вернуться сюда.

Почему Claude Code из коробки — это джун без методологии?

Без фреймворка Claude Code работает как талантливый, но недисциплинированный разработчик: получил задачу, сразу пишет код, надеется, что заработает. Тесты? Может напишет, если попросишь. План? Какой план — надо кодить. Superpowers Claude Code и everything-claude-code решают именно эту проблему — добавляют структуру и методологию поверх сырого агента.

Это и есть главная проблема. Не в качестве кода — с этим нормально. А в процессе. Нет системы. Каждая сессия начинается с чистого листа. Контекст теряется. Решения не документируются.

Я столкнулся с этим на реальном продакшн-проекте — когда через неделю работы агент не помнил, почему мы выбрали определённую архитектуру. Приходилось объяснять заново. Каждый. Раз.

Superpowers и ECC — два подхода к решению этой проблемы.

Superpowers: 7-фазный workflow вместо хаоса

Superpowers создал Джесси Винсент — ветеран open source с 20+ годами опыта (Request Tracker, Perl 5, клавиатуры Keyboardio). 107 тысяч звёзд на GitHub, принят в официальный Anthropic Plugin Marketplace.

Его философия простая: «Mandatory workflows, not suggestions». Не рекомендации — жёсткие правила.

Как работает

Ты говоришь Claude: «Добавь авторизацию через OAuth». Без Superpowers он сразу полезет писать код. С Superpowers — запустит 7-фазный пайплайн:

Фаза 1. Brainstorming. Сократический диалог: один вопрос за раз, несколько вариантов на выбор. Какой провайдер? Нужен ли refresh token? Где хранить сессии? Результат — дизайн-документ в docs/superpowers/specs/.

Фаза 2. Git worktree. Автоматически создаёт изолированную ветку. Никаких конфликтов с основным кодом.

Фаза 3. План. Задача разбивается на порции по 2-5 минут. Каждая — с точными путями к файлам и ожидаемым результатом.

Фаза 4. Субагенты. Каждую подзадачу берёт свежий субагент — чтобы не терялся контекст. Двухстадийный код-ревью: соответствие спецификации + качество кода.

Фаза 5. TDD. RED → GREEN → REFACTOR. И тут жёсткое правило: код, написанный до тестов, удаляется. Без разговоров.

Фаза 6. Code review. Ревью против плана. Критические проблемы блокируют прогресс.

Фаза 7. Финализация. Четыре варианта: merge, PR, оставить ветку, удалить. Worktree очищается автоматически.

Звучит как бюрократия? Первые полдня — бесило. Серьёзно. Ты хочешь быстренько добавить кнопку, а агент тебя допрашивает: «А какой accessibility label? А edge cases какие?» Хочется сказать: да просто напиши кнопку, блин.

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

Совет

Жёсткий TDD в Superpowers — это не просто «хорошая практика». Код без тестов удаляется автоматически. Если привыкли к вайб-кодингу без тестов — будет непривычно, но результат стоит того.

Everything Claude Code: когда одной методологии мало

Первое, что меня зацепило в ECC — /security-scan. Набираешь команду, и AgentShield прогоняет 1282 теста по 102 правилам. На моём TypeScript-проекте нашёл три потенциальных XSS-вектора, которые я бы пропустил. Вот это практическая польза с первой минуты.

ECC создал Аффаан Мустафа — победитель Anthropic-хакатона в Нью-Йорке (собрал zenith.chat за 8 часов, получил $15,000 API-кредитов). 101 тысяча звёзд, 769 коммитов, 10+ месяцев ежедневной разработки.

Масштаб

Внутри — 28 специализированных агентов. architect.md для системного дизайна, security-reviewer.md для уязвимостей, build-error-resolver.md для автоматического исправления сборки, языковые ревьюеры для TypeScript, Python, Go, Java, Rust, C++. Плюс 119 скиллов и 60+ команд.

Честно — 80% из этого я даже не открывал. market-research скилл? investor-materials? Для моих задач это мимо. Но если ты строишь стартап или работаешь в команде на пяти языках — тут каждый второй скилл попадает в точку.

Главная же фишка ECC — Continuous Learning.

Continuous Learning: агент, который учится

Это то, чего нет в Superpowers. Система автоматически записывает все вызовы инструментов через хуки, анализирует паттерны через Claude Haiku в фоне и генерирует «инстинкты» — атомарные правила поведения.

Пайплайн:

Наблюдение → Хранение (JSONL) → Анализ (Haiku) → Инстинкт → Эволюция → Промоция

Допустим, ты трижды исправил агента, когда он использовал var вместо const. Система заметит, создаст инстинкт «всегда использовать const», присвоит ему confidence score. Когда score достигнет 0.8 и паттерн повторится в двух+ проектах — инстинкт станет глобальным.

Команды для управления:

  • /instinct-status — все инстинкты с confidence scores
  • /evolve — кластеризация инстинктов в скиллы
  • /promote — повышение до глобального scope
  • /prune — удаление устаревших

Инстинкты хранятся в ~/.claude/homunculus/ — проектные и глобальные отдельно.

У меня за две недели накопилось 14 инстинктов. Из них реально полезных — штук пять: конвенции именования, предпочтение конкретных хуков React, формат коммитов. Остальные — шум, типа «предпочитает использовать const» (спасибо, ESLint тоже умеет). Команда /prune решает проблему, но хотелось бы более строгой фильтрации из коробки.

Инфо

Continuous Learning в ECC — это не RAG и не fine-tuning. Это система поведенческих правил, которые автоматически извлекаются из твоих сессий и применяются в следующих. Ближайшая аналогия — мышечная память: агент запоминает не факты, а привычки.

Superpowers vs ECC: когда что выбрать

КритерийSuperpowersECC
ФокусМетодология разработкиПроизводительность агента
TDDЖёсткий, код без тестов удаляетсяTDD-guide агент, команда /tdd
ОбучениеНетContinuous Learning v2
БезопасностьНетAgentShield (1282 теста)
ЯзыкиЛюбой12 экосистем с правилами
Установка30 секунд10-15 минут
Версияv5.0.5v1.9.0

Superpowers — когда нужна дисциплина. Чёткие требования, продакшн-код, длинные сессии разработки. Фреймворк не даст срезать углы.

ECC — когда нужна гибкость. Несколько языков, security-валидация, memory между сессиями, команда с разными IDE.

Оба вместе — можно. Plugin system позволяет ставить оба одновременно, они не конфликтуют.

Установка Superpowers: две команды

Самый быстрый способ — через официальный Anthropic Marketplace:

bash
/plugin install superpowers@claude-plugins-official

Всё. Начни новую сессию, попроси спланировать фичу — агент автоматически запустит brainstorming.

Для Cursor — ищи «superpowers» в plugin marketplace. Для Gemini CLI:

bash
gemini extensions install https://github.com/obra/superpowers

Проверка

Открой новую сессию Claude Code и напиши что-нибудь вроде «добавь форму регистрации». Если Superpowers работает — агент не полезет сразу писать код, а задаст уточняющие вопросы. Это brainstorming skill в действии.

Установка ECC: плагин + языковые правила

ECC ставится в два шага.

Шаг 1 — плагин:

bash
/plugin marketplace add affaan-m/everything-claude-code /plugin install everything-claude-code@everything-claude-code

Шаг 2 — языковые правила (обязательно):

bash
git clone https://github.com/affaan-m/everything-claude-code.git cd everything-claude-code ./install.sh typescript # один язык ./install.sh typescript python # несколько

Для Windows:

bash
npx ecc-install typescript

После установки проверь: набери /tdd в сессии. Должен активироваться TDD-workflow с red-green-refactor циклом.

Внимание

ECC требует manual rules install через скрипт — одного плагина недостаточно. Без этого шага часть агентов и скиллов не подключится. Не пропускай.

SKILL.md — как устроены skills в Claude Code

Если вы работали с gstack для Claude Code, то знаете, что такое скиллы. Но как они устроены внутри?

Каждый скилл — это директория с файлом SKILL.md. Формат: YAML frontmatter (метаданные) + markdown (инструкции).

yaml
--- name: explain-code description: Explains code with visual diagrams and analogies. Use when explaining how code works or when the user asks "how does this work?" --- When explaining code: 1. Start with an analogy from everyday life 2. Draw an ASCII diagram of the flow 3. Walk through step-by-step 4. Highlight a common gotcha

Поле description — ключевое. Claude использует его для auto-discovery: решает, когда автоматически активировать скилл. Поэтому в описании важно указать не только «что делает», но и «когда использовать».

Скиллы живут в трёх местах:

  • ~/.claude/skills/ — глобальные, для всех проектов
  • .claude/skills/ — проектные
  • Внутри плагинов — подключаются вместе с плагином

Это работает по тому же принципу, что и контекст инжиниринг — агент хорош ровно настолько, насколько качественен его контекст. SKILL.md — это способ дать агенту правильный контекст для конкретной задачи.

Hooks в Claude Code: автоматизация без надежды на LLM

Хуки — shell-команды, которые срабатывают в определённых точках работы Claude Code. Не промпты, не «рекомендации» — детерминированный код.

Пример: автоформатирование после каждого редактирования файла.

json
{ "hooks": { "PostToolUse": [ { "matcher": "Edit|Write", "hooks": [ { "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" } ] } ] } }

Конфигурация в .claude/settings.json. Типы событий: SessionStart, PreToolUse, PostToolUse, SubagentStart, Stop и другие.

Exit codes решают всё:

  • 0 — действие разрешено, stdout добавляется в контекст
  • 2 — действие заблокировано, stderr передаётся Claude как фидбек

Практическое применение: блокировка редактирования .env, автоформатирование, валидация типов перед коммитом. ECC использует хуки для Continuous Learning — наблюдает за каждым вызовом инструмента и собирает данные для анализа.

Git worktrees: три задачи параллельно

С версии v2.1.49 Claude Code нативно поддерживает git worktrees. Запуск:

bash
claude --worktree feature-auth

Создаётся изолированная копия репозитория в .claude/worktrees/feature-auth/ с отдельной веткой. Можно запустить три агента на три задачи одновременно — они не будут мешать друг другу.

В субагентах worktree включается через frontmatter:

yaml
isolation: worktree

ECC идёт дальше — скилл /batch анализирует задачу, разбивает на 5-30 частей и запускает субагента на каждую часть в отдельном worktree. Каждый реализует свою часть, запускает тесты, открывает PR.

Superpowers интегрирует worktrees прямо в workflow: фаза 2 автоматически создаёт изолированное пространство, а фаза 7 — очищает.

По сути это та же идея, что в управлении reasoning-токенами — только вместо параллельных потоков мышления получаем параллельные потоки кодинга.

Мой сетап: что оставил после двух недель

Тестировал на контент-пайплайне этого блога (Next.js + MDX, TypeScript, 5 агентов, MCP-серверы) и на паре pet-проектов.

Superpowers — основной фреймворк. Brainstorming реально экономит время: одна фича, которую я раньше бы переделывал, теперь проходит с первого раза. Но жёсткий TDD иногда бесит. Когда ты добавляешь строчку в конфиг и агент требует тест для конфига — хочется выключить всё нафиг. Не выключил, потому что в остальных случаях это работает.

ECC — cherry-pick. Из 119 скиллов оставил два: /security-scan (нашёл реальные проблемы, которые бы пропустил) и Continuous Learning (пока больше интересно, чем полезно, но потенциал виден). Пробовал /multi-execute для параллельной работы — дважды получил merge-конфликты, вернулся к Superpowers'овским worktrees. Возможно, для больших проектов /multi-execute раскрывается лучше.

Hooks — три штуки: автоформат через Prettier после каждого Edit, блокировка .env и валидация TypeScript типов перед коммитом. Третий хук добавил после того, как Claude закоммитил файл с any — теперь не пролезет.

Что не сработало:

  • ECC's doc-updater агент — обновлял документацию, но генерировал шаблонный текст, который всё равно приходилось переписывать
  • Superpowers brainstorming на мелких задачах — баг в одну строчку не требует сократического диалога на 15 вопросов. Для таких случаев отключаю skill вручную

Итог: Superpowers как база + несколько скиллов из ECC сверху. Пять минут установки, и агент из хаотичного генератора кода превращается в предсказуемого напарника. Не идеального — но такого, с которым можно выстроить процесс. А если вам ближе автоматизация без кода через n8n — это другой путь к той же цели: AI, который работает системно.

Совет

Начни с Superpowers — одна команда, моментальный результат. Через неделю поймёшь, чего не хватает: security scanning, memory между сессиями, языковые правила. Тогда добавляй ECC точечно. Ставить все 119 скиллов сразу — как ставить 50 плагинов в IDE: каждый по отдельности полезен, а вместе тормозят.