Skip to main content
skill CX Codex

305-frameworks-spring-boot-modulith — Claude Code skill

305-frameworks-spring-boot-modulith guides Spring Modulith work in Spring Boot modular monoliths, from module boundaries to events and tests. Use it when reviewing or reshaping the architecture.

Apache-2.0 245 installs ★ 465 updated 2026-10-21

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jabrena/plinth --skill 305-frameworks-spring-boot-modulith -a claude-code
Open on GitHub

What 305-frameworks-spring-boot-modulith does

This skill inspects a Spring Boot project’s package layout and models application modules around business capabilities. It covers Spring Modulith dependencies, named interfaces, allowed module links, domain events, and architecture checks with ApplicationModules.verify(). It also guides @ApplicationModuleTest and scenario-based module integration tests.

The scope includes generated module documentation, actuator exposure, observability, and event publication registry choices. Before changing the project, run ./mvnw compile or mvn compile; after the changes, run ./mvnw clean verify or mvn clean verify. A compilation failure stops the workflow. Dependency choices are aligned with Spring Boot 4.0.x and the Spring Modulith compatibility matrix.

What it helps with

  • split a Spring Boot application into business-capability modules
  • check module boundaries with ApplicationModules.verify()
  • define named interfaces and permitted dependencies
  • add @ApplicationModuleTest coverage with module scenarios
  • generate module documentation and configure event publication

Example prompts for the agent

  • Add Spring Modulith to this Spring Boot application and review its module boundaries.
  • Find illegal dependencies between the application modules and add an ApplicationModules.verify() check.
  • Create @ApplicationModuleTest coverage for the orders module, then run full verification.

How to install 305-frameworks-spring-boot-modulith

1Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 305-frameworks-spring-boot-modulith -a claude-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/305-frameworks-spring-boot-modulith/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about 305-frameworks-spring-boot-modulith

How do I install 305-frameworks-spring-boot-modulith in Claude Code?

Run npx skills add jabrena/plinth --skill 305-frameworks-spring-boot-modulith -a claude-code. The skill file will be at ~/.claude/skills/305-frameworks-spring-boot-modulith/SKILL.md.

What does 305-frameworks-spring-boot-modulith do?

It guides Spring Modulith design and review in Spring Boot projects, including module boundaries, dependencies, domain events, architecture checks, and module tests.

What project does this skill require?

The project must be a Spring Boot application. Dependency choices should match Spring Boot 4.0.x and the Spring Modulith compatibility matrix.

Source text

SKILL.md · Apache-2.0
---
name: 305-frameworks-spring-boot-modulith
description: Use when you need to design, review, or improve modular monoliths with Spring Modulith in Spring Boot applications - including application module package structure, ApplicationModules verification, named interfaces, allowed dependencies, domain events, @ApplicationModuleTest, Scenario-based module tests, generated documentation, actuator exposure, observability, and event publication registry choices. This should trigger for requests such as Add Spring Modulith to a Spring Boot application; Review Spring Modulith module boundaries; Improve modular monolith architecture in Spring Boot; Add @ApplicationModuleTest tests; Generate Spring Modulith documentation. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Spring Boot - Spring Modulith

Apply Spring Modulith guidelines for Spring Boot modular monoliths.

**What is covered in this Skill?**

- Spring Modulith BOM and starter dependency selection
- Business-capability package structure for application modules
- ApplicationModules verification and architecture tests
- Named interfaces and explicit allowed dependencies
- Domain events for loose coupling between modules
- @ApplicationModuleTest and Scenario-based module integration tests
- Generated module documentation, actuator exposure, and observability
- Event publication registry choices for reliable domain events

**Scope:** Apply recommendations based on the reference rules, official Spring Modulith documentation, and good/bad examples.

## Constraints

Before applying Spring Modulith changes, ensure the project compiles. After improvements, run full verification including module structure tests.

- **MANDATORY**: Run `./mvnw compile` or `mvn compile` before applying any change
- **PRECONDITION**: The project must be a Spring Boot application; for non-Boot Java modularity use architecture or design skills instead
- **BASELINE**: Align dependency choices with Spring Boot 4.0.x and the Spring Modulith compatibility matrix
- **SAFETY**: If compilation fails, stop immediately
- **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` after applying improvements
- **BEFORE APPLYING**: Read the reference for detailed rules, good/bad patterns, and official documentation links

## When to use this skill

- Add Spring Modulith to a Spring Boot application
- Review Spring Modulith module boundaries
- Improve modular monolith architecture in Spring Boot
- Add @ApplicationModuleTest tests
- Generate Spring Modulith documentation
- Refactor Spring Boot modules with Spring Modulith

## Workflow

1. **Read reference and inspect project structure**

Read `references/305-frameworks-spring-boot-modulith.md` and inspect the Spring Boot version, Maven dependencies, main application package, and current package/module boundaries.

2. **Model application modules**

Identify business-capability modules, public APIs, internal packages, named interfaces, and intentional allowed dependencies.

3. **Apply framework-aligned changes**

Add or refine Spring Modulith dependencies, package annotations, architecture verification tests, domain events, and module tests following the reference patterns.

4. **Run verification and report results**

Execute appropriate build/tests, especially `ApplicationModules.verify()` and `@ApplicationModuleTest` coverage, then summarize changes, risks, and follow-up module design work.

## Reference

For detailed guidance, examples, and constraints, see [references/305-frameworks-spring-boot-modulith.md](references/305-frameworks-spring-boot-modulith.md).

© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth

Similar skills

All skills for Backend and APIs →
spring-boot-modulith joaquimscosta spring-boot-modulith is a Claude Code skill that structures Spring Boot apps as bounded modules connected through events. It supports modular monolith design and module boundary checks. CX Codex +1 1installs spring-boot-4-migration official github The spring-boot-4-migration GitHub Copilot skill guides Spring Boot 3.x projects through a move to 4.0. It also handles migration-related build or test failures and reviews an existing upgrade. CX Codex +1 ★ 41,430repo stars create-spring-boot-java-project official github create-spring-boot-java-project scaffolds a Spring Boot Java application via start.spring.io with preset defaults for databases, testing, and Docker. Triggers when asked to bootstrap a new Java service. CX Codex +1 9,516installs spring-boot-project-creator giuseppe-trisciuoglio spring-boot-project-creator — a skill that automates Spring Boot project creation (3.x or 4.x) via Spring Initializr with architecture selection (DDD or Layered), JPA setup, OpenAPI documentation, and Docker Compose services. CX Codex +1 3,700installs spring-boot Mindrally Gives your agent Spring Boot conventions: REST controllers, JUnit tests, security, build and deploy. Useful when the project is Java. CX Codex +1 881installs spring-boot-dependency-injection giuseppe-trisciuoglio spring-boot-dependency-injection sets up constructor-first dependency injection patterns for Spring Boot projects. It eliminates field injection and organizes bean selection via @Primary and @Qualifier. CX Codex +1 4,000installs

From the same set123

The whole set →
514-frameworks-micronaut-kafka 514-frameworks-micronaut-kafka guides Kafka messaging setup in Micronaut applications. Covers producers, consumers, SerDes configuration, retry handling, and integration tests. CX Codex +1 275installs 515-frameworks-micronaut-mongodb The 515-frameworks-micronaut-mongodb skill guides MongoDB work in Micronaut, from document models and repositories to indexes and error handling. Use it when adding or reviewing persistence. CX Codex +1 272installs 123-java-design-patterns The 123-java-design-patterns skill helps choose, review, and apply Java patterns for APIs, Kafka, persistence, and integrations. CX Codex +1 267installs 183-java-observability-tracing-opentelemetry 183-java-observability-tracing-opentelemetry guides OpenTelemetry distributed tracing setup in Java services with context propagation and semantic attributes. CX Codex +1 253installs 704-technologies-sql The 704-technologies-sql skill guides schema design, SQL queries, indexes, and migrations without tying the advice to a Java framework. Use it for database reviews and changes. CX Codex +1 227installs 300-frameworks-spring-boot-create-project 300-frameworks-spring-boot-create-project scaffolds Maven-based Spring Boot 4.0.x projects using Java 25 and SDKMAN tools. Useful when starting new backend services with automated build verification. CX Codex +1 225installs 706-technologies-containers-docker 706-technologies-containers-docker is a Claude Code skill for reviewing Java Dockerfiles, Maven image builds, jlink runtimes, and container security. CX Codex +1 225installs 003-skills-inventory 003-skills-inventory generates a Java system prompt checklist document in INVENTORY-SKILLS-JAVA.md from skills.xml. Useful for maintaining skill registries in Plinth Toolkit. CX Codex +1 224installs

Project sponsors

Companies that keep this analytics open