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
npx skills add jabrena/plinth --skill 305-frameworks-spring-boot-modulith -a claude-codeWhat 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
@ApplicationModuleTestcoverage 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
@ApplicationModuleTestcoverage 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-code2Manually: put the files in place
~/.claude/skills/305-frameworks-spring-boot-modulith/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/305-frameworks-spring-boot-modulith/
1Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 305-frameworks-spring-boot-modulith -a codex2Manually: put the files in place
.agents/skills/305-frameworks-spring-boot-modulith/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 305-frameworks-spring-boot-modulith -a cursor2Manually: put the files in place
.cursor/skills/305-frameworks-spring-boot-modulith/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install jabrena/plinth skills/305-frameworks-spring-boot-modulith2Manually: put the files in place
.github/skills/305-frameworks-spring-boot-modulith/SKILL.md1Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 305-frameworks-spring-boot-modulith -a gemini-cli2Platform CLI
gemini skills install https://github.com/jabrena/plinth --path skills/305-frameworks-spring-boot-modulithManually: put the files in place
.devin/skills/305-frameworks-spring-boot-modulith/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add jabrena/plinth --skill 305-frameworks-spring-boot-modulith -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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