Настройка Claude Code под Use Case Pattern

← назад к разделу

Когда методология описана только в PDF-документе, её игнорируют. Не специально — просто некогда читать, забывается под давлением дедлайнов. Use Case Pattern решает это иначе: правила зашиты в скиллы Claude Code, и модель их применяет автоматически при каждом вызове.

В этой статье — как установить все компоненты и убедиться, что они работают.

Из чего состоит стек

Четыре независимых компонента, каждый полезен сам по себе:

Компонент	Что делает
usecase-pattern-skills	44 скилла по методологии: «спроектируй UseCase», «проверь Handler», «напиши спеку из бизнес-описания»
superpowers	Плагин-оркестратор для больших задач: брейншторм → план → исполнение → проверка
context7	MCP-сервер, который подтягивает актуальную документацию библиотек (Spring Boot, FastAPI, TypeORM и т.д.)
mcp-language-server + jdtls	Java LSP через MCP — семантический поиск в коде вместо grep: `find_references`, `definition`, `rename`

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

Каталог скиллов

Скиллы организованы парами «спроектируй ↔ проверь» по жизненному циклу задачи.

Спецификация

ucp-spec-design — написать Use Case спеку из бизнес-описания. Определяет нужный уровень зрелости (1 — слоёная архитектура, 2 — UCP с CQRS, 3 — DDD + Hexagonal) и заполняет разделы с правильной глубиной. На выходе — docs/spec/: корневой файл контекста и отдельный файл на каждый домен-юнит.

ucp-spec-tier-0 — реверс-инжиниринг спеки из существующего кода. Вход — репо (исходники, миграции, конфиги, тесты), выход — та же структура docs/spec/ с level: 0. Поля, для которых данных нет, заполняются not-declared — это сигнал, что нужно уточнить.

Проектирование

ucp-pattern-design — UseCase + Handler + контроллер + маппер. Самый часто используемый скилл для конкретной задачи.

ucp-api-design — REST API из раздела «Commands» в спеке: OpenAPI YAML, сигнатуры контроллеров, DTO, формат ошибок по RFC 9457.

ucp-ddd-tactical-design — агрегат, Value Objects, события и репозиторий из раздела «Domain Model». Применяется на Уровне 3.

ucp-auth-design — Spring Security + OAuth2 Resource Server + JWT + ABAC + audit-аспект.

ucp-bootstrap-design — Spring Boot c нуля: три профиля (production / local / integration-test), Liquibase, jOOQ codegen, конфигурация безопасности.

ucp-test-design — интеграционные и unit-тесты по Use Case и бизнес-правилам из спеки. Использует Testcontainers PostgreSQL + WireMock.

Ревью

ucp-pattern-review — код сервиса против методологии: UseCase как immutable record, Handler с транзакционностью, контроллер через UseCaseDispatcher.

ucp-api-review — REST-контракт: URL в kebab-case, HTTP-методы и коды, имена полей в JSON, OpenAPI-метаданные.

ucp-ddd-tactical-review — доменный код против тактических паттернов DDD: Entity, Value Object, Aggregate Root, Domain Event, Repository.

ucp-java-style-review — стиль кода, который не ловит checkstyle: аббревиатуры, имена тестов, большие лямбды, guard expressions.

ucp-auth-review — авторизация: JWT, RBAC, ABAC, S2S, audit, работа с персональными данными и секретами. Каждое нарушение цитируется кодом правила.

Идея пар design ↔ review

Для каждого правила методологии есть два скилла: один создаёт код по правилу, второй проверяет существующий код на это правило. Так «PDF-документ с правилами» превращается в исполняемый стандарт — его не нужно читать отдельно, он применяется автоматически.

Установка

Шаг 1. Claude Code

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

claude --version

Шаг 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

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

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

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

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

.claude/skills/ucp-*/ — 44 скилла
docs/*.md — файлы style-guide, которые скиллы читают как входные данные

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

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

Плагин из маркетплейса Claude Code:

claude plugins install superpowers

Если команда недоступна — проверьте claude help или документацию Claude Code.

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

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

Без superpowers скиллы ucp-* — это независимые операции, порядок шагов нужно помнить самостоятельно. С ним — связный конвейер, в котором план держится между шагами.

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

context7 — MCP-сервер, который подтягивает актуальную документацию библиотек. Подключение:

claude mcp add context7

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

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

Особенно полезно при работе со скиллом ucp-spec-design — он не напишет в спеке устаревшую версию библиотеки. Без context7 версии в спеке нужно проверять вручную.

Шаг 5. LSP через MCP (рекомендуется для крупных сервисов)

По умолчанию Claude работает с кодом через чтение файлов и поиск по тексту. Это достаточно для небольших задач, но на крупных сервисах теряется семантика. «Найди всех вызывающих Repository.save()» через текстовый поиск даёт лишние совпадения с Map.save, List.save и перегрузками. С LSP (find_references, definition, diagnostics, rename_symbol) — точность как в IDE.

Когда стоит настраивать: сервис от 30 файлов или 5 модулей. На маленьких — накладные расходы на настройку превышают выгоду.

Установка для Java (macOS, около 10 минут):

brew install jdtls go
go install github.com/isaacphi/mcp-language-server@latest

Подключить к Claude Code как MCP-сервер для конкретного workspace:

claude mcp add --scope user java-lsp-<service> \
  $HOME/go/bin/mcp-language-server \
  -- -workspace /Users/<you>/IdeaProjects/<service> \
     -lsp /opt/homebrew/bin/jdtls

Замените <service> на название проекта (например, orders). Имя сервера определяет имена инструментов: mcp__java-lsp-<service>__find_references и т.д.

Проверка:

claude mcp list

Должна быть строка java-lsp-<service>: ... ✓ Connected.

Первый запуск: после добавления нужно перезапустить Claude Code — MCP-серверы загружаются при старте сессии. Первый вызов LSP-инструмента занимает 1–3 минуты: jdtls в фоне импортирует Gradle-проект, скачивает зависимости и строит индекс. Последующие вызовы — мгновенные.

Несколько проектов: добавляйте отдельный сервер на каждый репо (java-lsp-orders, java-lsp-catalog и т.д.). Каждый потребляет 1–2 ГБ оперативной памяти — не стоит подключать все проекты сразу, только активные.

Linux и WSL: вместо brew install jdtls скачайте релиз с github.com/eclipse-jdtls/eclipse.jdt.ls/releases и распакуйте. Остальное — то же самое.

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

Скиллы UCP — откройте Claude Code в проекте и наберите:

/ucp-pattern-review

Должен появиться скилл с описанием. Если нет — проверьте симлинки:

ls -la .claude/skills/

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

/superpowers:writing-plans

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

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

Попробуйте в чате Claude Code попросить найти актуальную версию любой библиотеки вашего проекта — Claude должен обратиться к mcp__context7__* инструментам.

Java LSP (если устанавливали):

Попросите Claude найти всех вызывающих конкретного метода в проекте. LSP даст меньше лишних совпадений, чем текстовый поиск.

Если что-то не работает

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

ls -la .claude/skills/

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

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

claude plugins list

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

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

claude mcp list

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

Скилл ucp-spec-design предупреждает об отсутствии зависимостей:

Без superpowers скилл работает без TodoWrite-планирования. Без context7 версии библиотек нужно проверять вручную. Это мягкая деградация, не блокер — остальные 43 скилла не зависят от внешних плагинов вообще.

Коротко

Стек из четырёх компонентов: 44 скилла UCP + superpowers (оркестратор) + context7 (актуальная документация) + LSP через MCP (семантический поиск в коде).
Компоненты независимы: скиллы работают без superpowers и context7; только ucp-spec-design опционально их использует.
Установка скиллов: git clone + ./install.sh <проект>, создаёт симлинки — обновления подтягиваются автоматически.
LSP стоит настраивать для сервисов от ~30 файлов; на маленьких — накладные расходы не оправданы.
Скиллы организованы парами «спроектируй ↔ проверь»: design-скилл создаёт код по правилу, review-скилл проверяет существующий код на это правило.
Первый запуск Java LSP занимает 1–3 минуты на индексирование; последующие — мгновенные.

Что почитать дальше

Use Case Pattern: пошаговый гид по применению — как применять методологию от первого UseCase.
Уровни зрелости UCP — чем отличаются Уровень 1, 2 и 3.
AI пишет код. Зачем тогда методология? — почему скорость генерации кода не отменяет необходимость в стандартах.