Cuando los agentes de IA ejecutan código, la calidad de su salida está limitada por la calidad de su entrada. El desarrollo basado en especificaciones trata las especificaciones estructuradas como la interfaz principal entre la intención humana y la ejecución de la máquina, y cambia la forma en que los equipos de ingeniería trabajan con herramientas autónomas.
En el desarrollo tradicional, un ticket vago aún puede producir un buen código porque el desarrollador llena los vacíos con contexto, hace preguntas y toma decisiones. Los agentes de IA no pueden hacer esto de manera confiable. Ejecutan literalmente en contra de lo que se les da. Un mensaje vago produce un código vago. Una especificación precisa produce una implementación precisa.
El desarrollo basado en especificaciones invierte el trabajo: en lugar de dedicar tiempo a escribir código y depurar, los ingenieros dedican tiempo a escribir especificaciones claras y revisar los resultados. La especificación se convierte en el artefacto que captura la intención, las limitaciones, los criterios de aceptación y los límites arquitectónicos.
Una especificación útil para los agentes de IA incluye: el planteamiento del problema con límites claros, criterios de aceptación que se pueden verificar mediante programación, restricciones arquitectónicas que la implementación debe respetar, referencias a patrones existentes en el código base y no objetivos explícitos que eviten el desplazamiento del alcance.
Esta no es una idea nueva: es lo que siempre parecían las buenas especificaciones de ingeniería. La diferencia es que con los agentes de IA, la especificación no es solo una herramienta de comunicación para humanos. Es la entrada literal la que determina lo que se construye. La ambigüedad en la especificación se convierte en ambigüedad en el resultado.
La ingeniería de contexto (curar lo que ve un agente de IA) es fundamentalmente un problema de especificación. Los archivos de reglas de cursor especifican convenciones de codificación. Los archivos CLAUDE.md de Claude Code especifican el contexto del proyecto. Los pasos de configuración del Codex especifican las expectativas ambientales. Todas estas son especificaciones, simplemente distribuidas en diferentes mecanismos.
El desarrollo basado en especificaciones consolida esto en una práctica deliberada: antes de pedirle a un agente que implemente algo, escriba la especificación que define el éxito. Incluya archivos, patrones, restricciones y criterios de verificación relevantes. La especificación es el contexto.
Con agentes autónomos, el flujo de trabajo se convierte en: escribir especificaciones, delegar al agente, revisar el resultado según las especificaciones, iterar. Este bucle es más rápido que escribir código manualmente para tareas bien especificadas, pero más lento para tareas donde la especificación en sí no está clara.
La idea clave es que la redacción de especificaciones es un trabajo de ingeniería. Requiere comprender el sistema, anticipar casos extremos, definir límites y tomar decisiones arquitectónicas. El agente maneja la traducción mecánica de la especificación a la implementación; el ingeniero maneja el problema más difícil de definir qué significa "correcto".
Diferentes herramientas consumen especificaciones de manera diferente. Claude Code funciona bien con especificaciones de rebajas en línea en la conversación. Codex espera descripciones de tareas que definan el alcance y los criterios de aceptación por adelantado. El modo agente de Cursor se beneficia de archivos de reglas que definen convenciones persistentes además de instrucciones por tarea en el chat.
El patrón común es: las especificaciones globales (convenciones, arquitectura, patrones) se encuentran en archivos de configuración que persisten en todas las tareas. Las especificaciones específicas de la tarea (qué construir ahora, qué restricciones se aplican) se proporcionan por invocación. Ambas capas son importantes para lograr resultados consistentes.
Las especificaciones fallan cuando son incompletas, contradictorias o desconectadas de la realidad base del código. Un agente al que se le dé una especificación que diga "seguir patrones existentes" pero no se le muestren esos patrones inventará los suyos propios. Una especificación que define el comportamiento pero no los puntos de integración producirá un código aislado que no se ajusta al sistema.
La solución no son más palabras, sino más precisión. Haga referencia a archivos específicos, nombre funciones específicas, señale pruebas específicas. Las mejores especificaciones son breves, concretas y verificables. Le dicen al agente cómo se ve el éxito en términos que el agente puede comparar.
Cuando las especificaciones son la interfaz, la ingeniería se vuelve más paralelizable. Los ingenieros superiores redactan las especificaciones. Los agentes (e ingenieros junior) los implementan. La revisión se centra en si la implementación coincide con la especificación y si la especificación era correcta. No se trata de reemplazar a los ingenieros, sino de separar el trabajo cognitivo del diseño del trabajo mecánico de traducción.
Artículo de desarrollo basado en especificaciones que cubre especificaciones estructuradas para agentes de IA, ingeniería de contexto, especificaciones ejecutables por máquina, Claude Code CLAUDE.md, reglas de cursor, definiciones de tareas del Codex, bucle de verificación de implementación de especificaciones y prácticas de ingeniería para herramientas de codificación autónomas.