Настройка Claude Code под Use Case Pattern: плагины и скиллы пошагово

Установка стека за 5 шагов: usecase-pattern-skills, superpowers (orchestration), context7 (актуальная документация). Два примера workflow — один UseCase и целый сервис от спеки до прода. Troubleshooting.

После настройки Claude Code знает ваши правила методологии, оркеструет сборку сервиса от спеки до прода и подтягивает актуальные версии библиотек. Это инструкция на 5 шагов: установка, проверка, два примера workflow.

Статья — продолжение «AI пишет код. Зачем тогда методология?» и «Как ревьюить код, который написал AI». Там — почему всё это нужно. Тут — как поставить и заставить работать.

Что в стеке

Три независимых компонента, которые композируются:

Компонент	Что это	Зачем нужен
usecase-pattern-skills	12 скиллов Use Case Pattern	Атомарные операции: «спроектируй UseCase», «проверь Handler», «сгенерируй спеку из бизнес-брифа»
superpowers	Meta-workflow plugin	Оркестратор больших задач: брейншторм → план → исполни → проверь → закрой
context7	MCP-сервер документации	Актуальные версии и API библиотек (Spring Boot, jOOQ и т.д.) — не протухают

Каждый по отдельности полезен. Вместе — pipeline «бизнес-описание → готовый сервис в проде» с одним workflow в Claude Code.

Важно: только один из 12 скиллов (ucp-spec-design) опционально использует superpowers и context7. Остальные 11 работают без них. То есть установка плагинов — улучшение, не предусловие.

Шаг 1. Claude Code

Если ещё нет — claude.com/code. Установите CLI и убедитесь, что в терминале работает:

claude --version

Дальше предполагаем, что Claude Code установлен.

Шаг 2. usecase-pattern-skills

Скиллы методологии живут в одном репо. Подключение — клон + install.sh.

git clone git@github.com:remodov/usecase-pattern-skills.git ~/projects/usecase-pattern-skills
cd ~/projects/usecase-pattern-skills

# подключить в конкретный Java-проект (рекомендуется):
./install.sh ~/my-java-project

# или глобально для всех проектов:
./install.sh ~/.claude

install.sh создаёт симлинки на .claude/skills/* и docs/*.md. Симлинки означают, что обновления в репо автоматически прилетят в проект — не нужно re-копировать.

После установки в проекте появятся:

.claude/skills/ucp-*/ — 12 скиллов (ucp-pattern-review, ucp-api-design, ucp-spec-design и т.д.)
docs/*.md — снапшоты style-guide-ов, которые скиллы читают как input

Проверка: откройте Claude Code в проекте, наберите /ucp- — должен появиться автокомплит со списком скиллов.

Шаг 3. superpowers (опционально)

Плагин из Claude Code marketplace. Точная команда установки зависит от версии Claude Code; начните с:

claude plugins install superpowers

Если команды нет — посмотрите claude help или docs Claude Code.

После установки в чате появятся скиллы:

superpowers:brainstorming — для размытых требований
superpowers:writing-plans — план реализации из спецификации
superpowers:executing-plans — пошаговое исполнение по плану
superpowers:test-driven-development — TDD-дисциплина
superpowers:verification-before-completion — проверка перед коммитом
superpowers:requesting-code-review — внешний review через subagent

И ряд других orchestration-скиллов.

Что даёт: оркестратор для больших задач. Без него ucp-*-скиллы — независимые операции, надо помнить порядок шагов руками. С ним — связной pipeline, в котором план держится между шагами.

Шаг 4. context7 (опционально)

context7 — это MCP-сервер (Model Context Protocol). Подключается через:

claude mcp add context7

Или вручную в ~/.claude/settings.json:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@context7/mcp-server"]
    }
  }
}

После Claude может вызывать mcp__context7__* инструменты — например, найти библиотеку по имени и подтянуть свежую документацию.

Что даёт: актуальные версии и API. Особенно полезно для скилла ucp-spec-design — он не напишет в спеке «Spring Boot 2.7» когда уже актуальная 3.4. Без context7 версии в спеке нужно проверять руками.

Шаг 5. Проверка установки

Откройте Claude Code в вашем проекте, проверьте каждый компонент.

Скиллы UCP:

/ucp-pattern-review

Должен показаться скилл с описанием. Если нет — проверьте ls .claude/skills/, должны быть симлинки на 12 директорий.

Superpowers (если установили):

/superpowers:writing-plans

Должен показаться скилл с описанием.

Context7 (если установили):

mcp__plugin_context7_context7__resolve-library-id

Должен быть доступен как tool. Можно проверить простой запрос — найти библиотеку Spring Boot.

Если что-то не работает — см. раздел Troubleshooting ниже.

Workflow-1: Маленькая задача (один UseCase)

Здесь нужен только usecase-pattern-skills. superpowers и context7 — оверкилл.

Открыли Claude Code в проекте, запустили один скилл:

/ucp-pattern-design Команда «отменить заказ» с проверкой статуса DRAFT|PAID и ABAC по customerId

Ответ — record CancelOrderUseCase, CancelOrderHandler с @Transactional, контроллер с @PreAuthorize, мини-набор unit-тестов. Без планирования, без context7, без superpowers. Скилл всё знает сам.

Время — 2-3 минуты от запроса до готового кода.

Workflow-2: Целый сервис от спеки до прода

Здесь нужны все три плагина. Полный pipeline:

1. Спека из бизнес-описания

/ucp-spec-design Сервис каталога маркетплейса. Продавец публикует и скрывает товары, Order Service берёт цену по productId. Tier B

С context7 включенным — версии библиотек в спеке актуальные. С superpowers — TodoWrite-планирование внутри скилла, проще не пропустить раздел.

Выход — docs/spec/01-context.md … 17-stack.md (16 разделов спецификации, минус §8 events и §12 sagas для Tier B).

2. План реализации из спеки

/superpowers:writing-plans

Читает спеку, производит план шагов: «scaffold gradle → Liquibase migrations → jOOQ codegen → ProductRepository → 3 UseCase + Handler → controllers → security → integration tests → ArchUnit». Каждый шаг с критериями приёмки.

3. Исполнение по плану

/superpowers:executing-plans

Идёт по плану шаг за шагом. На каждом шаге вызывает соответствующий ucp-*-design:

Bootstrap → ucp-bootstrap-design
Доменные классы → ucp-ddd-tactical-design (если Tier C) или прямо handler-ы (Tier B)
UseCase + Handler + контроллер → ucp-pattern-design
Spring Security → ucp-auth-design
API + ProblemDetails → ucp-api-design
Тесты → ucp-test-design

После каждого шага — superpowers:verification-before-completion: gradle compileJava, gradle test. Не зелёное — не двигаемся дальше.

4. Финальный review

/ucp-pattern-review
/ucp-api-review
/ucp-ddd-tactical-review
/ucp-java-style-review
/ucp-auth-review

Все скиллы методологии прогоняются по diff. Каждое замечание цитирует код правила (R-7, JS-2.5, BR-C5).

И финальный внешний взгляд:

/superpowers:requesting-code-review

Subagent-ревьюер читает PR с позиции «не знаком с кодом, но знаком с UCP» и оставляет комментарии о трассировке, о неочевидных моментах, о том, что разработчик упустил из-за привычности.

Время

В реальности от бизнес-описания до работающего сервиса — день-два, если методология и инструменты установлены. Без них и без AI — недели на ту же постановку. Это и есть множитель производительности, про который много говорят, но без явного workflow он остаётся лозунгом.

Skills vs multi-agent с ролями

Часто спрашивают: «а почему не делать команду агентов с ролями — Java-разработчик, тестировщик, code-reviewer — которые переговариваются автономно? AutoGen, Crew AI же это и предлагают».

Это другой подход к AI, не лучше и не хуже — но для production-команды на UCP он плохо подходит:

Размывается voice consistency. У каждой роли немного свой стиль. На большой кодовой базе через год получится 20 разных интерпретаций «правильного UCP», что ровно та проблема, против которой методология и существует.
Audit trail рвётся. Кто принял решение по архитектуре — «разработчик»-агент, «архитектор»-агент или их диалог? Для compliance-команд (банки, госкомпании) это серьёзный блокер.
Стоимость в подписках растёт. Цикл из 10 вызовов агентов на задачу — реальные деньги в месячном счёте. На индивидуальной разработке терпимо, на команде из 20+ инженеров с десятками задач в день — нет.
Контроль уходит из loop-а. Человек смотрит на итог, не на процесс. Это ОК для эксперимента, не ОК для production.

Где multi-agent силён: соло-разработка, прототипы, креативные задачи где разнообразие полезно (несколько вариантов решения), exploration большого скоупа.

В нашем стеке multi-agent примитивы тоже есть — но не как «команда персон», а как специализированные субагенты для конкретных задач:

superpowers:code-reviewer — субагент-ревьюер с другой ментальной моделью, чем у автора кода
superpowers:dispatching-parallel-agents — параллельный запуск независимых задач (fan-out/gather, не диалог)
superpowers:subagent-driven-development — оркестратор с субагент-исполнителями для параллельных шагов плана

Идея: subagent под конкретную задачу — да, "команда персон" с автономным диалогом — нет. Меньше шума, больше контроля, дешевле в эксплуатации.

Troubleshooting

Скиллы /ucp-* не видны в Claude Code:

ls -la .claude/skills/

Должны быть 12 симлинков на директории в ~/projects/usecase-pattern-skills/.claude/skills/. Если нет — повторите install.sh.

Superpowers не установлен:

claude plugins list

Если в списке нет superpowers — переустановите. Точная команда установки зависит от версии Claude Code, начните с claude help plugins.

Context7 MCP не отвечает:

claude mcp list

Если статус down или error — проверьте, что npx доступен в PATH и что есть интернет (npx скачивает пакет при первом запуске). Возможно, нужны права на запись в ~/.npm/.

Скилл ucp-spec-design ругается на отсутствие зависимости:

ucp-spec-design — единственный скилл, опционально использующий superpowers и context7. Если их нет, скилл работает, но:

без superpowers — нет TodoWrite-планирования внутри
без context7 — версии библиотек могут протухнуть, проверяйте руками

Это graceful degrade, не блокер.

Все остальные скиллы (ucp-*-review, ucp-*-design кроме spec) работают без внешних плагинов вообще, только на стандартных Claude Code tools. Если они «не работают» — проблема не в зависимостях, а в установке самих скиллов.

Что дальше

Если ещё не читали — «AI пишет код. Зачем тогда методология?» и «Как ревьюить код, который написал AI»
Запустите ucp-spec-design на своём реальном бизнес-описании — посмотрите как из текста рождается структурированная 16-разделовая спека
Прочитайте Use Case Pattern — основная методология, под которую вы только что настроили инструменты
Если внедряете в команде — могу помочь: внедрение Use Case Pattern в команде