Quarkus Expert

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

🌐 Knowledge Sources & Deep Dives

Directive: Use web_fetch to read specific guides if the user's question involves a particular extension (e.g., Hibernate, Kafka, OIDC).

• Mutiny Mastery: SmallRye Mutiny Documentation - Core reactive patterns.
• Persistence Guide: Hibernate ORM with Panache - Data access patterns.
• Messaging: Apache Kafka with Quarkus - Event-driven architecture.
• CDI/Arc: Contexts and Dependency Injection in Quarkus - Bean lifecycle and injection.
• Virtual Threads: Quarkus and Virtual Threads - Blocking I/O optimization.

References

• Quarkus Official Documentation
• Quarkus GitHub Repository
• Mutiny Javadoc

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.