Del vibe coding al Spec-Driven Development: Spec-Kit y agentes de IA en proyectos reales: especificaciones, gobernanza y código mantenible

La primera semana programando con un agente de IA parece magia. El sexto mes, alguien tiene que mantener lo que generó. Y ese alguien eres tú. Servicios duplicados que ya existían. Convenciones que el agente ignoró. Una base de código que crece más rápido de lo que nadie puede leer. El vibe coding —generar a golpe de intuición, sin especificación— es cómodo para un prototipo y letal en un proyecto real. Lo sabes porque ya lo has vivido. Este libro trata de lo contrario: convertir la intención en un contrato que la IA respeta. En el desarrollo guiado por especificaciones (Spec-Driven Development), la especificación es el código fuente y el código ejecutable es solo un artefacto derivado. Mantener software deja de ser mantener código: pasa a ser mantener specs. Y no con demos de juguete. Casi todo lo que se ha escrito sobre agentes de IA asume un proyecto nuevo y vacío. Aquí el foco es el campo de batalla real: bases de código legadas, equipos, restricciones corporativas, seguridad y coste. Donde la IA de verdad se rompe, y donde de verdad importa domarla. Aprenderás a: Configurar GitHub Spec-Kit de principio a fin y operar su ciclo completo con Claude Code, GitHub Copilot o Cursor. Redactar una "constitución" de proyecto que restringe al agente de verdad, en lugar de sugerirle cosas que ignora. Impedir que el agente duplique servicios o rompa las convenciones de tu código legado. Descomponer tareas para que el modelo no tome decisiones catastróficas por su cuenta. Blindar el flujo con el enfoque OWASP para LLM, controlar el gasto y desplegar incluso en entornos aislados. No encontrarás promesas de que la IA lo hará todo por ti. Encontrarás, junto a cada capacidad, su modo de fallo conocido. Porque el SDD funciona precisamente porque restringe a los agentes, no porque confíe ciegamente en ellos. Es para desarrolladores con experiencia y para tech leads que deben introducir la IA en su equipo sin que el repositorio se degrade. Si buscas un tutorial de "hola mundo" o magia sin disciplina, este no es tu libro. Más de 300 páginas y un repositorio de código listo para clonar y ejecutar. Deja de generar código que nadie podrá mantener. Empieza a escribir las especificaciones que lo gobiernan.