quarkus-patterns

quarkus-patterns is a reference/guidance skill documenting architecture and API patterns for building cloud-native, event-driven backend services with Quarkus 3.x LTS and Apache Camel. It solves the problem of inconsistent structure in Java backends by codifying conventions for layering, messaging, data access, logging, and async processing that an agent can apply when writing or reviewing Quarkus code.

The SKILL.md specifies when to activate (JAX-RS/RESTEasy Reactive APIs, resource-service-repository layering, Camel and RabbitMQ event-driven flows, Hibernate Panache, validation and exception mapping, environment profiles, GraalVM native compilation) and provides annotated Java examples. These include a service layer using constructor injection and @Transactional, a success/error event service with payload serialization, an MDC-style Logback logging-context pattern with a Logstash encoder, Camel routes for RabbitMQ publishing and in-memory direct routes, and error handling via onException. The patterns emphasize validating input before persistence or message publication and tracking success and error events.

It targets Java backend engineers working on Quarkus microservices with event-driven, message-based architectures. Typical uses include scaffolding REST resources and services, wiring Camel messaging, standardizing structured logging, and reviewing code for adherence to these conventions. It is documentation and example code only, with no destructive or network-exfiltration behavior; RabbitMQ hosts and queues are read from configuration properties.