apm-agents-java

An APM package that equips any AI harness (GitHub Copilot, Claude Code, Cursor, Windsurf, OpenCode, Gemini) with deep Java expertise across the most common versions, build tools, frameworks, and testing libraries.

Install

apm install <your-github-handle>/apm-agents-java

What's included

Skills (auto-activate based on context)

Skill	Activates when you…
java-11	Work with Java 11 LTS, var, HTTP Client, JPMS
java-17	Use sealed classes, records, pattern matching
java-21	Use virtual threads, structured concurrency, sequenced collections
java-25	Use preview features, value types, Valhalla early access
maven	Edit pom.xml, run mvn commands, configure plugins
gradle	Edit build.gradle / build.gradle.kts, Gradle wrapper
maven-multimodule	Structure Maven/Gradle multi-module projects with Clean Architecture enforcement
gradle-multimodule	Gradle multi-project builds with convention plugins, version catalog, composite builds
spring-boot-3	Build Spring Boot 3.x apps with Jakarta EE namespace
spring-boot-4	Build Spring Boot 4.x apps (Java 17+ baseline)
quarkus-3.27	Use Quarkus 3.27 LTS, Panache, native image
quarkus-3.33	Use Quarkus 3.33 with latest extensions and dev services
junit-5	Write tests with JUnit 5 Jupiter API
junit-6	Write tests with JUnit 6 and new launcher API
cucumber	Write BDD scenarios with Gherkin and step definitions
spring-cloud-aws-2.3	Use Spring Cloud AWS 2.3.0 with Spring Boot 2.x
spring-cloud-aws-3.0	Use Spring Cloud AWS 3.0.0 with Spring Boot 3.x
spring-cloud-aws-4.0	Use Spring Cloud AWS 4.0.2 with Spring Boot 3.x+/4.x
aws-sdk-v1	Use com.amazonaws SDK v1 clients
aws-sdk-v2	Use software.amazon.awssdk SDK v2 clients
testcontainers	Write Docker-based integration tests
springdoc-openapi	Generate OpenAPI 3 / Swagger UI documentation
mapstruct	Map between DTOs and entities with @Mapper, @Mapping
localstack	Run and test AWS services locally with LocalStack + Docker
floci	Free LocalStack alternative — no auth token, 45 AWS services, MIT licensed
ministack	LocalStack alternative with official Testcontainers module (MiniStackContainer), @ServiceConnection, real RDS/ElastiCache

Prompts (invoke on demand)

Prompt	What it does
new-spring-boot-project	Scaffolds a Spring Boot 3 or 4 project
new-quarkus-project	Scaffolds a Quarkus 3.27 or 3.33 project
java-version-upgrade	Migrates code between Java LTS versions
java-code-review	Structured code review checklist
write-junit5-tests	Generates a full JUnit 5 test class
write-junit6-tests	Generates a full JUnit 6 test class
write-cucumber-scenarios	Generates Gherkin feature + step definitions
new-spring-cloud-aws-project	Scaffolds a Spring Cloud AWS project
aws-sdk-v1-to-v2-migration	Converts com.amazonaws code to SDK v2
write-testcontainers-test	Generates a Testcontainers integration test
add-springdoc-openapi	Adds SpringDoc OpenAPI to an existing project
write-localstack-test	Generates a full LocalStack integration test for S3/SQS/DynamoDB/SNS

Agents (invoke with @agent-name)

Agent	Invoke with
Java Architect	@java-architect
Java Code Reviewer	@java-code-reviewer
Java Test Engineer	@java-test-engineer
Spring Specialist	@spring-specialist
Quarkus Specialist	@quarkus-specialist

Learn more

• APM documentation
• APM sample package