Spec-First Engineering (Desarrollo de IA Basado en RFC)

1. Visión general del concepto y problema sistémico

La principal trampa para principiantes en vibecoding es la prisa. El desarrollador abre su IDE de agente y escribe de inmediato en el chat: "Crea una página de carrito de compras con códigos promocionales". El agente genera 1000 líneas de código en 15 segundos, pero:

• Se utiliza un hook obsoleto en lugar de un moderno gestor de estado del proyecto.
• Los códigos promocionales se calculan en el cliente en lugar de en el backend (brecha de seguridad).
• Los nombres de tipos se duplican y la localización se ignora por completo.

Spec-First Engineering es la regla de oro para la codificación productiva con IA: nunca tocar el código sin un plan aprobado. El ingeniero actúa como el arquitecto principal, que formula un contrato exhaustivo (implementation_plan.md), acuerda los casos extremos y solo después da la orden al agente para la generación.

2. Taxonomía arquitectónica y modelo mental

┌─────────────────────────────────────────────────────────────┐
│                 CICLO DE DESARROLLO ESPECÍFICO              │
├─────────────────────────────────────────────────────────────┤
│ 1. Exploración de Intenciones (Intent Exploration)          │
│    • Lluvia de ideas, Entrevista de Casos Extremos ("Grill-Me") │
│    • Definición de Anti-Objetivos (lo que NO debe haber)     │
├─────────────────────────────────────────────────────────────┤
│ 2. Creación de Artefactos de Especificación Formal          │
│    • Tipos y Contratos de Datos (interfaces de TypeScript / Zod) │
│    • Mapa de Mutación de Archivos ([NEW], [MODIFY], [DELETE]) │
│    • Criterios de Verificación (comandos de prueba automatizados) │
├─────────────────────────────────────────────────────────────┤
│ 3. Puerta Humana y Aprobación entre Pares                   │
│    • El ingeniero revisa el plan, realiza correcciones       │
├─────────────────────────────────────────────────────────────┤
│ 4. Ejecución Autónoma Determinista                           │
│    • El agente ejecuta el plan paso a paso sin desviaciones  │
└─────────────────────────────────────────────────────────────┘

3. Pipeline técnico y mecánica interna

01. Entrevistando al modelo antes de la función (patrón Grill-Me)

Antes de escribir el plan, el desarrollador da la instrucción: "Quiero agregar un sistema de pago Stripe. Hazme 5 preguntas rigurosas sobre el manejo de webhooks, pagos recurrentes y seguridad, antes de escribir el plan". Esto revela problemas ocultos en la etapa de idea, no en producción.

02. Protección contra la erosión arquitectónica

Si el proyecto es liderado por un equipo de tres ingenieros con agentes, todos los cambios pasan primero por un PR en la carpeta docs/specs/. El equipo ve la intención antes de que el modelo cree 50 nuevos componentes.

4. Errores comunes, trampas y seguridad

• Parálisis por Análisis: Escribir un plan de 20 páginas para cambiar el color de un botón es una pérdida de tiempo. Para ediciones triviales, se aplica la regla de edición directa. La especificación es necesaria para tareas que afectan más de 2 archivos o la lógica de negocio.
• Deriva del plan durante la ejecución (Spec Drift): Si durante la codificación el agente descubre un nuevo detalle y cambia la arquitectura sin actualizar la especificación, el sistema pierde control. Exija al agente que actualice el plan ante cualquier dificultad imprevista.

5. Estrategia para el ingeniero del 2026

En un mundo donde la generación de código cuesta cero centavos, la habilidad de ingeniería más valiosa no es la velocidad de escritura, sino la profundidad y precisión en la formulación de la especificación técnica. Quien controla la especificación, controla el sistema.