К основному содержанию
скилл CX Codex

spring-boot-modulith — скилл для Claude Code: модули и установка

Скилл spring-boot-modulith для Claude Code организует Spring Boot-приложение как набор модулей с границами и обменом событиями. Проверяет связи между частями модульного монолита.

MIT 1 установок ★ 23 обновлён 2026-10-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add joaquimscosta/arkhe-claude-plugins --skill spring-boot-modulith -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/spring-boot-modulith/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/spring-boot-modulith/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
305-frameworks-spring-boot-modulith Juan Antonio Breña Moral Скилл 305-frameworks-spring-boot-modulith для Claude Code проектирует и проверяет модульные монолиты на Spring Modulith в приложениях Spring Boot. Помогает задавать границы модулей, работать с событиями и тестировать архитектуру. CX Codex +1 245установок spring-boot-event-driven-patterns giuseppe-trisciuoglio Скилл spring-boot-event-driven-patterns для Claude Code и Cursor: доменные события, @TransactionalEventListener, Kafka и transactional outbox — заменяют синхронные вызовы между сервисами на событийную архитектуру в Spring Boot 3.x. CX Codex +1 4 000установок spring-boot-crud-patterns giuseppe-trisciuoglio Скилл spring-boot-crud-patterns собирает полный CRUD-слой для сервисов на Spring Boot 3: агрегаты, JPA-репозитории, DTO и REST-контроллеры по feature-архитектуре. CX Codex +1 4 100установок create-spring-boot-java-project официальный github Скилл create-spring-boot-java-project разворачивает каркас приложения Spring Boot через start.spring.io с готовой конфигурацией базы данных, тестов и Docker. Запускается при запросе на генерацию нового сервиса на Java. CX Codex +1 9 516установок spring-boot-engineer https://github.com/Jeffallan Скилл spring-boot-engineer разворачивает архитектуру Spring Boot 3.x, контроллеры, репозитории Spring Data JPA и правила Spring Security 6. Пригодится при сборке REST API, реактивных сервисов и микросервисов на Java. CX Codex +1 8 900установок spring-boot-testing официальный github Скилл spring-boot-testing подбирает способ тестирования Spring Boot: от JUnit-тестов и test slices до интеграции с Testcontainers. Учитывает различия Spring Boot 3 и 4. CX Codex +1 2 000установок

Из того же набора2

Спонсоры проекта

Компании, которые помогают держать аналитику открытой