Mikel Cantero
¿Te ha pasado que le pides un componente a un agente de IA y el resultado es un código espantoso que ignora la mitad de tus requisitos? No es culpa de la IA; es culpa del prompt.
Los ingenieros de software estamos dejando de ser simples “escribidores de código” para convertirnos en directores de orquesta. Y en este nuevo paradigma, el Spec-Driven Design (SDD) es nuestra mejor batuta.
A continuación, te muestro el workflow de 5 pasos para dominar el desarrollo asistido por IA sin perder el control de tu arquitectura.
El Workflow Ágil de 5 Pasos
1. La Especificación “Bulletproof” (El Prompt Maestro)
El primer paso es el más crítico. No le digas a la IA: “Hazme un formulario de registro”. Tienes que definir el problema y las características de la feature de forma quirúrgica.
- Casos de uso: Qué pasa si el usuario es VIP, qué pasa si el token expira.
- Gestión de errores: Define códigos de estado HTTP, mensajes de error para la UI y comportamientos ante caídas de red.
- Contratos de API: Si usas TypeScript, define las interfaces o los esquemas de OpenAPI (Swagger) antes de pedir una sola línea de lógica.
Regla de oro: Cuanto más específico seas en la especificación, menos iteraciones erráticas dará la IA después.
2. Iteración Guiada (Buscar el “Green Light”)
Una vez que la IA procesa la especificación, generará una primera versión del código. Aquí es donde actúas como revisor:
- No aceptes el código a ciegas. Pruébalo en un entorno local.
- Si falla, no le digas “no funciona”. Pásale el stack trace del error exacto o descríbele el comportamiento inesperado.
- Itera en ciclos cortos hasta que la funcionalidad base cumpla estrictamente con la especificación del paso 1.
3. Blindaje con Pruebas (Unit, Integration & E2E)
¿El código ya funciona? Genial, ahora asegúrate de que no se rompa mañana. Lo hermoso de tener una especificación detallada es que la IA es excelente traduciendo specs en tests.
Pídele al agente que genere:
- Pruebas unitarias: Para cubrir los happy paths y, sobre todo, los edge cases (valores nulos, strings vacíos, desbordamientos).
- Pruebas de integración: Para validar que el nuevo módulo se comunica bien con la base de datos o servicios externos.
- E2E (si aplica): Flujos críticos con herramientas como Playwright o Cypress.
4. Refactorización y Cultura de Equipo
El código generado por IA a menudo sufre de “ansiedad de complacer”: funciona, pero suele ser redundante o no sigue los estándares de tu empresa.
En este paso, le pides a la IA que limpie el código bajo tus reglas:
"Refactoriza este código aplicando principios SOLID, Clean Code y asegúrate de cumplir con la regla de hooks de React y la configuración de nuestro ESLint."
Es el momento de eliminar código duplicado, mejorar nombres de variables y asegurar la mantenibilidad.
5. Documentación Automatizada (Cerrar el Círculo)
El software que no se documenta, no existe. Pero como programadores, odiamos escribir READMEs. Por suerte, la IA adora hacerlo.
Aprovecha que el agente tiene el contexto fresco para:
- Actualizar el
README.mddel proyecto. - Generar comentarios de JSDoc / TSDoc si la lógica es compleja.
- Actualizar la documentación de la API en Postman o Swagger.
¿Por qué este enfoque nos hace ultra ágiles?
| Enfoque Tradicional con IA | Spec-Driven Design con IA |
|---|---|
| Prompts vagos e improvisados. | Contratos de diseño claros desde el inicio. |
| ”Efecto Frankenstein” (parches sobre parches). | Código modular, limpio y predecible. |
| El desarrollador testea manualmente en bucle. | Los tests automatizados validan el comportamiento. |
| Deuda técnica inmediata. | Código refactorizado y documentado al instante. |
Conclusión
El Spec-Driven Design impulsado por IA no te quita el control, te da el superpoder de enfocarte en la arquitectura y el valor de negocio, delegando la carpintería del código al agente. Quien escribe la mejor especificación, gana.
