нейропоток
ГайдыПродвинутый

Прокачиваем Claude Code до синьора: Superpowers и ECC на практике

Ставлю Superpowers и ECC на Claude Code — 7-фазный workflow, TDD, security-сканер. Показываю что реально работает, а что шум. Пошаговая установка.

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

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

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

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

Для кого: если вы уже пользуетесь Claude Code и хотите, чтобы агент работал не как хаотичный генератор кода, а как напарник с методологией. Базовый опыт с терминалом и git обязателен.

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

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

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

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

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

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

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

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 (Test-Driven Development — разработка через тестирование). RED → GREEN → REFACTOR: сначала пишешь тест, который падает (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 (встроенный сканер безопасности ECC) прогоняет 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. Система автоматически записывает все вызовы инструментов через хуки (hooks — автоматические действия, которые срабатывают в определённый момент, подробнее о них ниже), анализирует паттерны через Claude Haiku в фоне и генерирует «инстинкты» — атомарные правила поведения.

Пайплайн:

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

Допустим, ты трижды исправил агента, когда он использовал var вместо const. Система заметит, создаст инстинкт «всегда использовать const», присвоит ему confidence score (оценка уверенности от 0 до 1 — насколько система уверена, что правило действительно полезно). Когда 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 — наблюдает за каждым вызовом инструмента и собирает данные для анализа. Если хотите пойти дальше и дать агенту больше автономности — посмотрите на auto mode в Claude Code: там можно настроить, какие действия он выполняет без подтверждения, а какие всё равно требуют вашего ОК.

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

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-серверы — один из них я написал свой 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: каждый по отдельности полезен, а вместе тормозят.