# spring-boot-modulith

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 установка · ★ 23 у репозитория
- Автор: joaquimscosta
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/joaquimscosta/arkhe-claude-plugins/tree/HEAD/plugins/spring-boot/skills/spring-boot-modulith/SKILL.md
- Обновлён: 2026-10-16
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
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/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add joaquimscosta/arkhe-claude-plugins --skill spring-boot-modulith -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/spring-boot-modulith/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add joaquimscosta/arkhe-claude-plugins --skill spring-boot-modulith -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/spring-boot-modulith/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install joaquimscosta/arkhe-claude-plugins plugins/spring-boot/skills/spring-boot-modulith
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/spring-boot-modulith/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add joaquimscosta/arkhe-claude-plugins --skill spring-boot-modulith -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/joaquimscosta/arkhe-claude-plugins --path plugins/spring-boot/skills/spring-boot-modulith
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/spring-boot-modulith/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add joaquimscosta/arkhe-claude-plugins --skill spring-boot-modulith -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/joaquimscosta/arkhe-claude-plugins/tree/HEAD/plugins/spring-boot/skills/spring-boot-modulith/SKILL.md

## Когда брать
- разложить DDD-контексты по пакетам приложения
- скрыть внутренние типы от соседних модулей
- связать модули событиями через `@ApplicationModuleListener`
- проверить границы модулей тестом `ApplicationModules.verify()`
- отправлять события во внешние Kafka или AMQP

## Примеры запросов агенту
- Разложи это Spring Boot-приложение на модули по ограниченным контекстам DDD.
- Покажи, как передать событие между модулями через `@ApplicationModuleListener`.
- Добавь тест, который проверяет границы модулей через `ApplicationModules.verify()`.

## Похожие
- [305-frameworks-spring-boot-modulith](https://affpapa.org/nevibecode/skills/305-frameworks-spring-boot-modulith.md) — скилл · 245 установок
- [spring-boot-event-driven-patterns](https://affpapa.org/nevibecode/skills/spring-boot-event-driven-patterns.md) — скилл · 4000 установок
- [spring-boot-crud-patterns](https://affpapa.org/nevibecode/skills/spring-boot-crud-patterns.md) — скилл · 4100 установок
- [create-spring-boot-java-project](https://affpapa.org/nevibecode/skills/create-spring-boot-java-project.md) — скилл · 9516 установок
- [spring-boot-engineer](https://affpapa.org/nevibecode/skills/spring-boot-engineer.md) — скилл · 8900 установок
- [spring-boot-testing](https://affpapa.org/nevibecode/skills/spring-boot-testing.md) — скилл · 2000 установок

Из того же набора: [joaquimscosta/arkhe-claude-plugins](https://affpapa.org/nevibecode/by/joaquimscosta/arkhe-claude-plugins.md) — 2 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
