mcpField
3
305-frameworks-spring-boot-modulith

305-frameworks-spring-boot-modulith

github.com/jabrenaDevelopment456222 installsUpdated 1d ago
Repository

About 305-frameworks-spring-boot-modulith

A skill for applying Spring Modulith to modular monoliths built with Spring Boot. It covers module boundaries, architecture verification, domain events, module tests, and generated documentation, with checks aligned to the project's Boot version and build process.

Key features

  1. 01Spring Modulith dependency guidance
  2. 02Business-capability module structure
  3. 03Module boundary verification
  4. 04Named interfaces and dependencies
  5. 05Domain events and publication
  6. 06Module tests and documentation

Use cases

  1. 01Introduce Spring Modulith in a Spring Boot app
  2. 02Review package and module boundaries
  3. 03Add module architecture tests
  4. 04Test module interactions with domain events

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/jabrena/plinth --skill 305-frameworks-spring-boot-modulith

After installing, type/305-frameworks-spring-boot-modulithin Claude Code to confirm it loaded.

Bundled filesreferences/305-frameworks-spring-boot-modulith.md

Details

From the project README

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.

  1. Model application modules

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

  1. Apply framework-aligned changes

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

  1. 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.

Comments

Markdown supported