Cursor-rules-java 522-frameworks-micronaut-testing-integration-tests

Use when you need to write or improve integration tests for Micronaut — @MicronautTest, HttpClient, TestPropertyProvider with Testcontainers, transactional test mode where appropriate, and Maven Surefire/Failsafe splits for *Test, *Tests, *IT, and *AT. Part of the skills-for-java project

install

source · Clone the upstream repo

git clone https://github.com/jabrena/cursor-rules-java

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/jabrena/cursor-rules-java "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/522-frameworks-micronaut-testing-integration-tests" ~/.claude/skills/jabrena-cursor-rules-java-522-frameworks-micronaut-testing-integration-tests && rm -rf "$T"

manifest: skills/522-frameworks-micronaut-testing-integration-tests/SKILL.md

Micronaut Integration Testing

Prove real wiring in Micronaut with containers and HTTP.

What is covered in this Skill?

Scope: contracts and boundaries, not duplicated unit-test logic
TestPropertyProvider + static @Container for JDBC/Kafka properties
HttpClient full-stack HTTP assertions
@MicronautTest(transactional = true) for rollback where supported
Shared containers per class; pinned image tags
Maven Surefire/Failsafe: *Test / *Tests vs *IT / *AT; explicit plugin includes and excludes

Scope: Apply recommendations based on the reference rules and good/bad code examples.

Constraints

Before applying any integration test changes, ensure the project compiles. If compilation fails, stop immediately. After applying improvements, run full verification.

MANDATORY: Run
```
./mvnw compile
```
or
```
mvn compile
```
before applying any change
PREREQUISITE: Project must compile successfully and pass basic validation checks before any test refactoring
CRITICAL SAFETY: If compilation fails, IMMEDIATELY STOP and DO NOT CONTINUE with any recommendations
BLOCKING CONDITION: Compilation errors must be resolved by the user before proceeding with integration test changes
NO EXCEPTIONS: Under no circumstances should testing recommendations be applied to a project that fails to compile
VERIFY: Run
```
./mvnw clean verify
```
or
```
mvn clean verify
```
after applying improvements
BEFORE APPLYING: Read the reference for detailed rules and examples

When to use this skill

Add Micronaut integration tests with Testcontainers
Wire dynamic datasource or broker URLs for @MicronautTest

Reference

For detailed guidance, examples, and constraints, see references/522-frameworks-micronaut-testing-integration-tests.md.