quarkus-expert

Keyword: quarkus | Platforms: gemini,claude,codex

High-Performance Quarkus Framework Expert Skill - Deep production-grade knowledge of the Quarkus ecosystem.

Core Mandates

• Build-Time First: Move processing to augmentation phase, minimize runtime classpath scanning

• Java 21+ Excellence: Leverage Virtual Threads (@RunOnVirtualThread ) for blocking operations

• Reactive Discipline: Use Mutiny (Uni , Multi ) for non-blocking I/O

• Dependency Discipline: Always use Quarkus BOM for version management

• Constructor Injection: Mandate constructor injection over field injection

Architectural Patterns

Persistence Strategy

• Imperative: Hibernate ORM with Panache (Active Record or Repository pattern)

• Reactive: Reactive SQL Clients (MySQL, PostgreSQL, Oracle)

• Dev Services: Zero-config databases and brokers during development

Cloud-Native Observability

• OpenTelemetry (OTel): Standard for tracing and metrics

• Health Checks: Implement Liveness and Readiness probes using MicroProfile Health

Security Architecture

• Use Proactive Authentication and RBAC with @RolesAllowed

• Prefer OIDC/JWT for stateless microservices

Testing

• Integration Testing: Use @QuarkusTest for full-stack tests

• Mocking: Utilize @InjectMock and @InjectSpy

• Parity: Use Testcontainers via Dev Services

Extension Development

• Build-Time (Deployment): Write BuildStep methods for bean registration, bytecode generation

• Runtime Init: Differentiate between STATIC_INIT and RUNTIME_INIT

Troubleshooting

• ClassLoader Leaks: Monitor custom dynamic class loading

• ContextNotActiveException: Ensure CDI contexts propagate correctly with Mutiny

• Native Image Failures: Analyze reports and provide reflection-config.json

References

• Quarkus Documentation

• Quarkus GitHub

• Mutiny Documentation

Skill Interoperability

The quarkus-expert ⚡ skill is a comprehensive framework built on:

• java-expert ☕: Core language and JVM features.

• vertx-expert 🌀: Reactive engine for non-blocking operations.

• graalvm-expert 🚀: Native Image generation and AOT optimization.