Ensemble, el agente de código con specs ejecutables

El capítulo 5 del libro ejecutable de Ensemble se aprueba con 65 puntos acotados y una ruta de grading explícita, no con una revisión a ojo. Ese detalle es la parte interesante del proyecto: si el conocimiento para construir el sistema no se puede verificar, tampoco se puede transmitir a otro agente.

Ensemble es un agente de código que su autor usa para construirse a sí mismo. Bill Cox lo desarrolla siguiendo su propio libro ejecutable, The Art of Building AI Coding Agents, y la edición vigente es la 3, escrita en C# 14 / .NET 10 desde dentro de Ensemble con Cadence. La tesis invierte el orden habitual del trabajo con IA: la especificación no se escribe antes para que un agente la ejecute, y tampoco se vibe-codea el sistema para documentarlo después.

¿Qué es Development-Driven Specs y en qué se diferencia del resto?

El método que Cox documenta se llama Development-Driven Specs: se construyen el código y la especificación a la vez, y es el desarrollo el que gana el spec. El objetivo declarado no es el plan detallado ni el tour por el código terminado, sino convertirse en el experto mientras se pair-programa con la IA y preservar esa experiencia en un formato que otro agente pueda ejecutar.

Leíste lo que hace la IA. ¿Y en tu negocio?

Un agente de IA puede quedarse con parte de tu día: ordenar lo pendiente y pedirte el OK antes de actuar. El Kit «tu mano derecha con IA» trae un video de 11 minutos y una ficha para dejar al tuyo trabajando. CAR está cerrada por ahora; al anotarte, te avisamos cuando abra.

👥 Quiero el Kit →

El resultado tiene un nombre concreto: especificación ejecutable. Un manual que transfiere el criterio necesario para construir el sistema, no una lista de features deseadas. Según el propio proyecto, Ensemble V2 ejecutó el libro para construir la V3, y después Cox y Cadence trabajaron dentro de la V3 para mejorar tanto el agente como la enseñanza. El humano se vuelve experto durante el desarrollo en lugar de depender de una inspección final de código generado que nunca escribió.

¿Cómo funciona el flujo de trabajo en cuatro pasos?

El proceso es concreto y se puede copiar en cualquier equipo que use agentes de código:

Diseñar y acotar. Se discute el diseño con la IA y se redacta únicamente el TL;DR y los ejercicios del capítulo siguiente. Ni el capítulo completo ni el plan total: el siguiente tramo.
Pair-programar la implementación. Se dirige al agente en tiempo real, se prueban ideas, se corrigen errores y se registra qué quedó poco claro y por qué se tomó cada decisión importante.
Convertir las notas en el cuerpo del capítulo. Una vez que la implementación pasa los graders del ejercicio, esas notas se transforman en el texto: el proceso de construcción, las lecciones, los tradeoffs y las razones. Nunca un recorrido por el código final.
Probar con un agente estudiante. Un agente nuevo recibe el capítulo y los graders para comprobar si la enseñanza alcanza para reconstruir la implementación. Lo que ese intento revela se retroalimenta al capítulo.

La frase que resume la filosofía del repositorio es incómoda para quien espera magia: no documentes qué construir, enseña cómo y por qué construirlo así. Y eso no se puede hacer todo por adelantado.

¿En qué se diferencia del spec-driven development de Kiro y Spec Kit?

El spec-driven development (desarrollo guiado por especificación) es la corriente más visible hoy. Según TechTarget, Kiro —la herramienta de agentes de código de AWS— arranca cada proyecto preguntando si el usuario quiere empezar por el spec o por prompts, y genera los documentos de requisitos, diseño y tareas antes de tocar el código.

Según InfoWorld, esa especificación se materializa en tres archivos markdown: requirements.md, design.md y tasks.md, con los requisitos escritos en notación EARS (cuyo patrón es WHEN más condición, THE SYSTEM SHALL más comportamiento esperado). Kiro además genera pruebas basadas en propiedades a partir de esos requisitos.

El otro referente es Spec Kit, el kit open source de Microsoft para spec-driven development. InfoWorld describe un proceso estructurado en cuatro fases que se integra con alrededor de 30 agentes de código, con comandos dedicados para constitución del proyecto, requisitos, aclaraciones, plan técnico, tareas, análisis de consistencia e implementación.

La diferencia de fondo la puso Birgitta Böckeler, de Thoughtworks, en tres niveles que recoge InfoWorld: spec-first (escribes el spec y lo usas durante la tarea), spec-anchored (mantienes el spec después, para evolución y mantenimiento) y spec-as-source (el spec es el archivo fuente y el humano nunca toca el código). El propio medio señala que ningún tool actual implementa del todo el tercer nivel. Development-Driven Specs no encaja en los tres: el spec no precede al código ni lo reemplaza, nace de haberlo construido.

Vale recordar de dónde viene la alternativa. InfoWorld sitúa en febrero de 2025 el mensaje en el que Andrej Karpathy acuñó el término vibe coding para proyectos desechables de fin de semana, y advierte que aplicado a proyectos serios produce bugs ocultos y deuda técnica.

¿Cuánta verificación exige este método?

Aquí está la parte que más debería interesar a un equipo técnico. El repositorio de Ensemble no se apoya en la confianza: cada capítulo conserva sus límites de verificación documentados y los graders mantienen su numeración original. El capítulo 5, por ejemplo, se ejecuta por una ruta explícita con sus 65 puntos acotados, y el proyecto aclara que el código C# no se puede enviar a un grader consumidor escrito en Go.

También hay requisitos prácticos que conviene leer antes de intentarlo: hace falta un SDK de .NET 10 instalado (el runtime por sí solo no compila la aplicación), el histórico de las ediciones 1 y 2 se conserva congelado sin reescribirse, y la GUI embebe sus assets en tiempo de compilación. La recomendación del proyecto es elegir tu propio directorio de datos, workspace y puerto libre, y no reemplazar un host en ejecución solo para refrescar el código. Para los agentes de código de AWS, TechCrunch reportó en diciembre de 2025 que la apuesta es la autonomía de varios días con contexto persistente entre sesiones, y que AWS presentó además un agente de seguridad y otro de DevOps para revisar el código mientras se escribe.

¿Qué significa esto para tu startup?

El mensaje central aplica incluso si nunca vas a escribir un libro ejecutable: el código es un output; el activo reutilizable es el conocimiento para volver a construirlo. En un equipo chico, eso es la diferencia entre tener un producto y tener un producto que otra persona (o otro agente) puede extender sin arqueología.

Acciones concretas que puedes implementar esta semana:

Mantén un archivo de notas durante el pair programming. Anota en el momento qué no quedó claro, qué alternativa descartaste y por qué. Cuando los tests pasen, esas notas son tu especificación real: escribirla después, de memoria, es donde se pierde el criterio.
Haz la prueba del agente estudiante. Antes de cerrar una feature, entrega el documento y los tests a un agente limpio y mira qué reconstruye sin acceso al código original. Lo que no pueda reconstruir es lo que falta en el documento, no en el código.
Define el alcance antes de invertir en herramientas. InfoWorld es claro en el criterio: para proyectos personales, features pequeñas y corrección de bugs puedes trabajar sin especificaciones; las specs se vuelven necesarias en features grandes, refactors mayores y proyectos de nivel enterprise.
Compara el costo real de las alternativas. Según TechTarget, Kiro ofrece hasta 50 interacciones mensuales en su plan gratuito, 1.000 en el nivel Pro de US$19 por usuario y mes y 3.000 en Pro+ de US$39, precios que aplican cuando el producto salga de disponibilidad general. Spec Kit, en cambio, es open source.

La advertencia final es la misma que hace el propio autor del libro: dejar que el agente genere código que nadie entiende y luego inspeccionarlo al final no te convierte en experto en tu propio sistema. El momento de aprender la arquitectura es mientras la estás dirigiendo, no cuando ya está escrita.