The Complete Production SOP: How to Deploy and Run Micronaut Ahead-of-Time Dependency Injection Framework in Autonomous AI Agents

---
name: "micronaut-ahead-of-time-compilation"
description: "Eliminate runtime reflection and proxies using Micronaut compile-time dependency injection."
metadata:
  author: "Micronaut"
  version: "1.0.0"
  runtime_compatibility: ["codex", "claude-code", "cursor", "windsurf"]
triggers:
  - "micronaut compile time di"
  - "micronaut declarative @client"
  - "micronaut data repository"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <configuration>
    <annotationProcessorPaths combine.children="append">
      <path>
        <groupId>io.micronaut</groupId>
        <artifactId>micronaut-inject-java</artifactId>
        <version>${micronaut.version}</version>
      </path>
      <path>
        <groupId>io.micronaut.data</groupId>
        <artifactId>micronaut-data-processor</artifactId>
        <version>${micronaut.data.version}</version>
      </path>
    </annotationProcessorPaths>
    <compilerArgs>
      <arg>-Amicronaut.processing.incremental=true</arg>
      <arg>-Amicronaut.processing.annotations=example.micronaut.*</arg>
    </compilerArgs>
  </configuration>
</plugin>

package example.micronaut.payment;

import jakarta.inject.Singleton;
import io.micronaut.core.annotation.NonNull;

@Singleton
public class OrderProcessor {

    private final PaymentGatewayClient paymentClient;
    private final OrderRepository orderRepository;

    // Single constructor: No @Inject required in Micronaut AOT
    public OrderProcessor(
            @NonNull PaymentGatewayClient paymentClient,
            @NonNull OrderRepository orderRepository) {
        this.paymentClient = paymentClient;
        this.orderRepository = orderRepository;
    }

    public OrderResult process(OrderCommand cmd) {
        PaymentResponse response = paymentClient.authorize(new PaymentRequest(cmd.amount()));
        return orderRepository.save(new OrderEntity(cmd.orderId(), response.txId()));
    }
}

package example.micronaut;

import io.micronaut.context.ApplicationContext;
import io.micronaut.test.extensions.junit5.annotation.MicronautTest;
import jakarta.inject.Inject;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertTrue;

@MicronautTest
class BeanContextLoadTest {

    @Inject
    ApplicationContext applicationContext;

    @Test
    void contextLoadsWithoutDynamicProxies() {
        assertTrue(applicationContext.isRunning());
        assertTrue(applicationContext.containsBean(example.micronaut.payment.OrderProcessor.class));
    }
}