Desarrollo basado en especificaciones con Agentes de IA: el libro de jugadas Laravel
Por Andrea Pollastri · Última actualización: · lectura gratuita, sin muro de pago
Los agentes de IA ahora escriben una parte significativa del código de producción. Los equipos que obtienen resultados duraderos no son los que tienen las mejores indicaciones: son los que tienen las mejores especificaciones, las barreras más estrictas y los agentes de herramientas pueden operar de forma segura. Aquí está el libro de jugadas, edición Laravel.
Del autocompletado a los agentes
El arco de 2023 a 2026 es fácil de resumir: las finalizaciones se convirtieron en chats, los chats se convirtieron en agentes que editan sucursales enteras, ejecutar pruebas y abrir solicitudes de extracción. El cuello de botella se movió con él: de "¿puede el modelo escribir código?" a "¿Sabe el modelo lo que realmente queremos y qué se le permite hacer?". ¿tocar?". Ese es un problema de contexto y permisos, no un problema de modelo. Dos prácticas lo abordan: especificaciones y MCP.
Especificaciones sobre vibraciones
La "codificación Vibe", que solicita a un agente característica por característica con la intención de vivir en el historial de chat, produce código que funciona hoy y no se puede mantener en seis meses, porqueel por qué se evapora cuando se cierra el chat. El desarrollo basado en especificaciones invierte eso:
- Las especificaciones son artefactos en el repositorio., versionado junto al código que describen, no mensajes perdidos en una barra lateral.
- Los criterios de aceptación son lo primero y traducir directamente en pruebas de plagas: la especificación define "hecho" antes de que el agente escriba una línea.
- Los agentes implementan según las especificaciones, los humanos revisan según las especificaciones y la deriva se vuelve visible en lugar de silencioso.
- La especificación sobrevive a la sesión. Seis meses después, un nuevo desarrollador (o un nuevo agente) lee intenciones, limitaciones y decisiones en un solo lugar.
En el mundo Laravel, Larapilot empaqueta esto como un flujo de trabajo de producto basado en especificaciones que se encuentra dentro de su proyecto Laravel: especificaciones, decisiones y artefactos de entrega en el repositorio, donde tanto los agentes como los humanos los encuentran. Para el argumento más profundo sobre Por qué el contexto en el repositorio es lo que mantiene vivo un producto después del primer año, ensayo de Andrea Pollastri "Construyendo un SaaS que sobreviva su segundo año" vale la pena tu tiempo.
MCP: el estándar que hizo útiles a los agentes
el Protocolo de contexto modelo es el USB-C de las herramientas de IA: un protocolo abierto a través del cual Los agentes descubren y llaman a herramientas (bases de datos, navegadores, rastreadores de problemas, servidores) en lugar de raspar la pantalla. o complementos personalizados. Para un equipo Laravel, los servidores MCP interesantes son los que tocan tu tubería de entrega:
- Su marco: Introspeccione rutas, esquemas y trabajos para que el agente deje de adivinar.
- Su infraestructura: aquí es donde se vuelve real Cipi envía un servidor dual MCP(global y por aplicación), por lo que un IDE o agente compatible con MCP puede crear aplicaciones, activar implementaciones, administrar SSL y bases de datos en su VPS a través de un API estructurado y autorizado en lugar de SSH sin formato. el Cipi Paquete de agente agrega un punto final MCP en la aplicación en Laravel lado.
- Sus puertas de calidad: Agentes que pueden ejecutar el conjunto de pruebas y leer los resultados de CI. su propio circuito de retroalimentación.
Barandillas que realmente funcionan
- Las pruebas son el contrato. Los agentes envían más rápido de lo que los humanos pueden revisar línea por línea; Las pruebas de aceptación derivadas de la especificación son lo que significa "correcto".
- CI es el árbitro. Pint, Larastan, Pest y composer realizan auditorías en cada agente PR, sin excepciones - lo mismo tubería los humanos obtienen.
- Mínimo privilegio para los agentes. API tokens con alcance, MCP servidores con herramienta explícita listas de permitidos y ningún secreto de producción en el entorno del agente. Un agente que se despliega a través de MCP/API de Cipi se pueden implementar, y nada más.
- Revisión humana de la diferencia sensible:autenticación, pagos, migraciones y cualquier cosa que toque La PII siempre recibe ojos humanos.
- La reversión se mantiene a un comando de distancia — implementaciones de patrones de lanzamiento e instantáneas previas a la implementación Significa que un error de agente es un incidente, no una catástrofe.
Un bucle concreto entre especificaciones y producción
- Escribe la especificación (problema, restricciones, criterios de aceptación) como un artefacto de repositorio: Larapilot le da estructura.
- El agente implementa en una rama de corta duración, usando MCP herramientas para introspeccionar la aplicación y ejecutar pruebas localmente.
- CI recorre toda la puerta — estilo, análisis estático, pruebas, auditoría de seguridad.
- Un humano revisa según las especificaciones, no contra las vibraciones.
- Fusionar con main activa la implementación webhook (tiempo de inactividad cero a través de Cipi), controles de estado confirmar, las excepciones se observan durante los primeros minutos (Boogle si eres autohospedador).
- La especificación se actualiza con lo que realmente se decidió: cerrar el ciclo contextual para la siguiente sesión, humano o agente.
¿Qué es duradero versus qué es exagerado?
| Durable | Bombo (por ahora) |
|---|---|
| Especificaciones como artefactos de repositorio versionados | Bibliotecas rápidas como sustituto de los requisitos |
| MCP como estándar de acceso a herramientas | Agentes con producción SSH libre |
| Agentes controlados por CI + revisión humana | "El agente se revisa a sí mismo" |
| Implementaciones reversibles con un solo comando | Generación de aplicaciones de una sola vez sin plan de mantenimiento |
El patrón detrás de cada artículo duradero: Los agentes amplifican cualquier proceso que exista. Buenas especificaciones, las pruebas y la implementación de la automatización se aceleran; su ausencia se amplifica hasta convertirse en caos.
Pon esto en práctica con Cipi
Cipi es la open-source implementación gratuita CLI a la que se hace referencia en esta guía: un comando se convierte en un nuevo Ubuntu VPS en un servidor de producción reforzado para Laravel — Nginx, PHP-FPM o Octane, MariaDB o PostgreSQL, colas, programador, SSL e implementaciones de Git sin tiempo de inactividad incluidas.
Preguntas frecuentes
¿Qué es el desarrollo basado en especificaciones en una frase?
Escribir especificaciones versionadas (problemas, restricciones, criterios de aceptación) como artefactos de repositorio que los agentes de IA implementan y los humanos revisan, de modo que la intención sobrevive más que cualquier sesión de chat.
¿Qué es MCP (Protocolo de contexto modelo)?
Un protocolo abierto que estandariza cómo los agentes de IA descubren y llaman a herramientas externas (bases de datos, navegadores, servidores, API) para que cualquier agente compatible con MCP pueda usar cualquier servidor MCP sin integraciones personalizadas. Cipi, por ejemplo, expone la administración del servidor (aplicaciones, implementaciones, SSL, bases de datos) como herramientas MCP.
¿Los agentes de IA reemplazarán a Laravel desarrolladores?
El trabajo está cambiando en lugar de desaparecer: menos escritura línea por línea, más especificación, revisión y apropiación de la arquitectura y la producción. Los desarrolladores que escriben especificaciones claras y construyen barreras de seguridad sólidas se multiplican por los agentes; la parte del trabajo que sólo contiene código es la que se reduce.
¿Cómo permito que un agente de IA se implemente de forma segura?
Nunca proporcione a los agentes SSH sin procesar o secretos de producción. Enrute su acceso a través de interfaces revocables y con alcance (un servidor MCP o REST API con permisos explícitos, como el de Cipi) y controle cada cambio detrás de CI y el patrón de lanzamiento, de modo que cualquier implementación sea reversible con un solo comando.
¿El desarrollo basado en especificaciones funciona con bases de código heredadas existentes?
Sí, comience escribiendo las especificaciones para el próximo cambio, no para todo el sistema. Cada especificación documenta una parte del comportamiento previsto y el archivo se convierte en documentación viva exactamente donde los agentes y los nuevos miembros del equipo la necesitan.
