PAO: el paquete que necesitas si usas agentes de IA con Laravel

Si usas Claude Code, Cursor o cualquier otro agente de IA para desarrollar en Laravel (o cualquier proyecto PHP), seguramente has notado algo: cada vez que el agente ejecuta los tests, vuelca una cantidad absurda de texto en el contexto. Puntos, checkmarks, barras de progreso, stack traces... todo eso que es bonito para leer en la terminal pero que para una IA no significa nada.

PAO, el nuevo paquete de Nuno Maduro, resuelve exactamente eso.

¿Qué hace PAO?

PAO detecta automáticamente si tus tests se están ejecutando dentro de un agente de IA. Si es así, sustituye el output habitual por JSON minimalista.

En lugar de esto:

PHPUnit 12.5.14 by Sebastian Bergmann and contributors.

.............................................................   61 / 1002 (  6%)
.............................................................  122 / 1002 ( 12%)
...

OK (1002 tests, 1002 assertions)

Tu agente recibe esto:

{
  "result": "passed",
  "tests": 1002,
  "passed": 1002,
  "duration_ms": 321
}

Y si hay fallos, incluye rutas de archivo, números de línea y mensajes de error — lo que el agente realmente necesita para actuar.

El output de PAO es constante: ~20 tokens, independientemente del tamaño de tu suite de tests.

En una sesión de desarrollo normal puedes ejecutar los tests 20, 30 o 50 veces. Esos ~11.000 tokens por ejecución se acumulan rápido y compiten con tu código, tu conversación y el razonamiento del agente en la misma ventana de contexto. PAO elimina ese ruido.

Instalación

composer require nunomaduro/pao:0.x-dev --dev

Nada más. PAO se engancha al autoloader de Composer y funciona automáticamente con PHPUnit, Pest y Paratest. Sin configuración.

Conclusión

El coste en tokens es lo llamativo, pero el argumento real es la ventana de contexto. Cada ejecución de tests sin PAO inyecta miles de tokens de ruido. Después de 50 ejecuciones en una sesión larga, eso es medio millón de tokens ocupados con dots y checkmarks en lugar de con tu lógica de negocio.

PAO es un ejemplo de algo que se va a ver más: herramientas diseñadas desde el principio para que las usen agentes, no personas.

Fuentes: Repositorio oficial de PAO