Implementación guiada

La implementación guiada parte de una spec validada. El objetivo no es que la IA “haga código” lo más rápido posible, sino que construya dentro de límites claros y con evidencias suficientes para revisar.

Papel del Implementer

El agente Implementer trabaja con tres entradas obligatorias:

• Spec aprobada.
• Contexto del proyecto.
• Guardarraíles de calidad.

Su responsabilidad es ejecutar tareas pequeñas, respetar arquitectura y dejar el resultado preparado para revisión.

Flujo recomendado

1. Seleccionar una tarea elegible de tasks.md.
2. Revisar spec, diseño técnico y criterios.
3. Cargar contexto del proyecto e instrucciones relevantes.
4. Identificar guardarraíles aplicables.
5. Implementar el cambio mínimo que cierra la tarea.
6. Ejecutar checks locales definidos para el tipo de cambio.
7. Actualizar estado, evidencias y aprendizajes.

Qué significa tarea elegible

Una tarea es elegible si puede implementarse y validarse con el contexto disponible.

No es elegible si:

• Tiene decisiones de producto abiertas.
• Contradice criterios de aceptación.
• Requiere una fuente externa no disponible.
• Cambia arquitectura sin acuerdo.
• No tiene validación definida.

Guardarraíles durante la implementación

El Implementer debe comprobar qué guardarraíles aplican:

• Design System.
• Accesibilidad.
• Traducciones.
• Analítica.
• Privacidad.
• Arquitectura.
• Tests y lint.
• Convenciones de código.

No todos aplican a cada tarea, pero sí deben considerarse explícitamente.

Errores habituales

• Implementar sin spec aprobada.
• Tocar varias tareas a la vez.
• Cambiar archivos no relacionados.
• Ignorar guardarraíles porque la tarea parece pequeña.
• No registrar por qué se omitió una validación.

Default recomendado

Trabaja en ciclos cortos: una tarea, una validación, una actualización de estado. Si aparece información nueva, vuelve a la spec antes de ampliar alcance.