Arnold Moya
Newsletter
Vibecodear no es suficiente. Spec-Driven es la solución
Los agentes de código no solo necesitan prompts. Necesitan estructura, contexto y especificaciones claras. Spec-Driven Development no es un complicarse, es el proceso que diferencia experimentos fallidos de sistemas confiables.
¿Por qué es importante?
Sin límites explícitos, cada prompt genera decisiones aisladas. Un agente elige una estructura de carpetas. Otro usa convenciones distintas. El tercero implementa autenticación diferente. El código "funciona" y es generado 10x más rápido pero no es un sistema. Es una colección de fragmentos.
Los problemas escalan en silencio. Hoy es inconsistencia. Mañana es deuda técnica. Luego es arquitectura que nadie entiende. Reescribir ya no es opción, es obligación. Y eso es CARO. Lo peor que con todo el código generado, la correción será 10x más cara que la generación inicial.
Sin contexto compartido, cada ejecución es una apuesta. Por eso, equipos que escalan con IA necesitan lo opuesto a "vibrar". Necesitan precisión. Especificación clara. Eso es el fundamento de Spec-Driven development.
Ir más fondo
Estructura básica
mission.md, tech-stack.md, roadmap.md. No son documentos. Son límites que garantizan que cada generación de código sigue la misma verdad.
🛠️ Cómo empezar
El enfoque no es nuevo. DeepLearning.AI ofrece un curso gratuito: Spec-Driven Development with Coding Agents. Enseña el método exacto: constitución clara, especificaciones ejecutables, validación continua.
📋 La constitución técnica
Define tu arquitectura sin ambigüedad. mission.md responde: ¿qué construimos? tech-stack.md asegura coherencia: ¿con qué herramientas? roadmap.md: ¿hacia dónde? Cuando el agente tiene estas tres, sus decisiones se alinean.
🔌 Ecosistema de plugins
Composio mantiene awesome-claude-plugins. Infraestructura lista para extender capacidades sin reinventar integración. Los agentes que usan plugins especializados generan código más preciso.
🌍 Movimiento más amplio
Spec-Driven no es tendencia. Es movimiento. GitHub lanzo Spec Kit para formalizar el proceso. OpenSpec.dev documenta estándares abiertos. Es el futuro de cómo trabajamos con agentes.