quarkus-expert

Keyword: quarkus | Platforms: gemini,claude,codex

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

• java-expert ☕: Core language and JVM features.
• vertx-expert 🌀: Reactive engine for non-blocking operations.
• graalvm-expert 🚀: Native Image generation and AOT optimization.