spring-boot-modulith — скилл для Claude Code: модули и установка
Скилл spring-boot-modulith для Claude Code организует Spring Boot-приложение как набор модулей с границами и обменом событиями. Проверяет связи между частями модульного монолита.
MIT 1 установок ★ 23 обновлён 2026-10-16
npx skills add joaquimscosta/arkhe-claude-plugins --skill spring-boot-modulith -a claude-codeЧто делает spring-boot-modulith
Скилл описывает, как представить ограниченные контексты DDD пакетами приложения: типы в базовом пакете образуют публичный API, а классы в internal остаются скрытыми от других модулей. Он рассчитан на Spring Boot 4 и Spring Modulith 2.0. Коротко: границы задаются структурой пакетов.
Для связи между модулями предлагается использовать события и @ApplicationModuleListener, а не внедрять бины напрямую. Есть подходы к настройке @ApplicationModule, публикации событий, проверке границ через ApplicationModules.verify() и внешней отправке событий в Kafka или AMQP с @Externalized. Журнал событий JDBC обеспечивает доставку как минимум один раз.
Внутри есть примеры конфигурации, обработки событий на Java и Kotlin, теста с генерацией PlantUML и проверки через Scenario API. Прямое внедрение бина из другого модуля нарушает рекомендуемые границы; связи между модулями лучше выражать событиями или публичным API.
Какие задачи решает
- разложить DDD-контексты по пакетам приложения
- скрыть внутренние типы от соседних модулей
- связать модули событиями через
@ApplicationModuleListener - проверить границы модулей тестом
ApplicationModules.verify() - отправлять события во внешние Kafka или AMQP
Примеры запросов агенту
- Разложи это Spring Boot-приложение на модули по ограниченным контекстам DDD.
- Покажи, как передать событие между модулями через
@ApplicationModuleListener. - Добавь тест, который проверяет границы модулей через
ApplicationModules.verify().
Как установить spring-boot-modulith
1Через Skills CLI (Vercel)
npx skills add joaquimscosta/arkhe-claude-plugins --skill spring-boot-modulith -a claude-code2Вручную: положить файлы
~/.claude/skills/spring-boot-modulith/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/spring-boot-modulith/
1Через Skills CLI (Vercel)
npx skills add joaquimscosta/arkhe-claude-plugins --skill spring-boot-modulith -a codex2Вручную: положить файлы
.agents/skills/spring-boot-modulith/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add joaquimscosta/arkhe-claude-plugins --skill spring-boot-modulith -a cursor2Вручную: положить файлы
.cursor/skills/spring-boot-modulith/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install joaquimscosta/arkhe-claude-plugins plugins/spring-boot/skills/spring-boot-modulith2Вручную: положить файлы
.github/skills/spring-boot-modulith/SKILL.md1Через Skills CLI (Vercel)
npx skills add joaquimscosta/arkhe-claude-plugins --skill spring-boot-modulith -a gemini-cli2Командой платформы
gemini skills install https://github.com/joaquimscosta/arkhe-claude-plugins --path plugins/spring-boot/skills/spring-boot-modulithВручную: положить файлы
.devin/skills/spring-boot-modulith/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add joaquimscosta/arkhe-claude-plugins --skill spring-boot-modulith -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о spring-boot-modulith
Как установить spring-boot-modulith в Claude Code?
Выполните npx skills add joaquimscosta/arkhe-claude-plugins --skill spring-boot-modulith -a claude-code. Файл скилла появится по пути ~/.claude/skills/spring-boot-modulith/SKILL.md.
Что делает spring-boot-modulith?
Скилл помогает строить приложение на Spring Boot 4 как модульный монолит: задавать границы пакетами, связывать модули событиями и проверять их зависимости.
Как скилл предлагает связывать модули?
Через события и @ApplicationModuleListener либо через открытый API модуля. Прямое внедрение бинов между модулями считается анти-паттерном.
Исходный текст
SKILL.md · MIT
--- name: spring-boot-modulith description: Spring Modulith 2.0 implementation for bounded contexts in Spring Boot 4. Use when structuring application modules, implementing @ApplicationModuleListener for event-driven communication, testing with Scenario API, enforcing module boundaries, externalizing events to Kafka/AMQP, building a modular monolith, defining module dependencies, managing inter-module events, or organizing DDD modules as packages. Covers package-based module boundaries, named interfaces, event publication, and Scenario API testing. For architecture decisions, see domain-driven-design skill. spring-boot-version: "4.0" --- # Spring Modulith for Bounded Contexts Implements DDD bounded contexts as application modules with enforced boundaries and event-driven communication. ## Core Concepts | Concept | Description | |---------|-------------| | **Application Module** | Package-based boundary = bounded context | | **Module API** | Types in base package (public) | | **Internal** | Types in sub-packages (encapsulated) | | **Events** | Cross-module communication mechanism | ## Module Structure ``` src/main/java/ ├── com.example/ │ └── Application.java ← @SpringBootApplication ├── com.example.order/ ← Module: order │ ├── OrderService.java ← Public API │ ├── OrderCreated.java ← Public event │ ├── package-info.java ← @ApplicationModule config │ └── internal/ ← Encapsulated │ ├── OrderRepository.java │ └── OrderEntity.java ├── com.example.inventory/ ← Module: inventory │ ├── InventoryService.java │ └── internal/ └── com.example.shipping/ ← Module: shipping ``` Types in `com.example.order` = public API Types in `com.example.order.internal` = hidden from other modules ## Quick Patterns See [EXAMPLES.md](EXAMPLES.md) for complete working examples including: - **Module Configuration** with @ApplicationModule - **Event Publishing** with domain event records - **Event Handling** with @ApplicationModuleListener (Java + Kotlin) - **Module Verification Test** with PlantUML generation - **Event Externalization** for Kafka/AMQP ## Spring Boot 4 / Modulith 2.0 Specifics - **@ApplicationModuleListener** combines `@Async` + `@Transactional(REQUIRES_NEW)` + `@TransactionalEventListener(AFTER_COMMIT)` - **Event Externalization** with `@Externalized` annotation for Kafka/AMQP - **JDBC event log** ensures at-least-once delivery ## Detailed References - **Examples**: See [EXAMPLES.md](EXAMPLES.md) for complete working code examples - **Troubleshooting**: See [TROUBLESHOOTING.md](TROUBLESHOOTING.md) for common issues and Boot 4 migration - **Workflow**: See [WORKFLOW.md](WORKFLOW.md) for detailed step-by-step Modulith setup - **Module Structure**: See [references/MODULE-STRUCTURE.md](references/MODULE-STRUCTURE.md) for package conventions, named interfaces, dependency rules - **Event Patterns**: See [references/EVENTS.md](references/EVENTS.md) for publishing, handling, externalization, testing with Scenario API ## Related Skills | Need | Skill | |------|-------| | DDD concepts | `domain-driven-design` | | Data layer per module | `spring-boot-data-ddd` | | Module event testing | `spring-boot-testing` | | REST APIs for modules | `spring-boot-web-api` | ## Anti-Pattern Checklist | Anti-Pattern | Fix | |--------------|-----| | Direct bean injection across modules | Use events or expose API | | Synchronous cross-module calls | Use `@ApplicationModuleListener` | | Module dependencies not declared | Add `allowedDependencies` in `@ApplicationModule` | | Missing verification test | Add `ApplicationModules.verify()` test | | Internal types in public API | Move to `.internal` sub-package | | Events without data | Include all data handlers need | ## Critical Reminders 1. **One module = one bounded context** — Mirror DDD boundaries 2. **Events are the integration mechanism** — Not direct method calls 3. **Verify in CI** — `ApplicationModules.verify()` catches boundary violations 4. **Reference by ID** — Never direct object references across modules 5. **Transaction per module** — `@ApplicationModuleListener` ensures isolation
© joaquimscosta · MIT · joaquimscosta/arkhe-claude-plugins