Agente de Ejecución de Código
Cómo se realiza el trabajo de implementación a través del Agente de Orquestación y el Agente de Ejecución de Código — procedimiento, reglas y restricciones.
Propósito
Esta página documenta el flujo de trabajo de desarrollo utilizado al construir o modificar software. Define la secuencia de pasos, las responsabilidades de cada componente y las reglas que rigen la implementación.
Estado: Implementado (flujo de trabajo establecido y en uso en el desarrollo activo)
Responsabilidades
El Agente de Ejecución de Código es responsable de:
- Generación de código
- Modificación de código
- Tareas de implementación técnica
- Investigación o inspección de código bajo instrucciones explícitas
Regla importante: El Agente de Ejecución de Código no realiza operaciones de git directamente. Las operaciones de git permanecen bajo el control directo del usuario.
Diagrama del flujo de trabajo
Procedimiento paso a paso
1. Verificar contexto y permisos de escritura
Antes de comenzar cualquier trabajo de implementación, el Agente de Orquestación confirma:
- El directorio del proyecto correcto está activo
- Existen permisos de escritura para los archivos relevantes
- Se entiende el estado actual de la base de código
- No hay trabajo conflictivo en progreso
2. Diseñar la solución
El Agente de Orquestación diseña la solución antes de escribir ningún prompt:
- Identificar los archivos y componentes afectados
- Definir el comportamiento y la salida esperados
- Identificar restricciones, casos límite y áreas de riesgo
- Confirmar el enfoque con el usuario si hay ambigüedad significativa
3. Preparar un prompt de implementación
El Agente de Orquestación escribe un prompt explícito y acotado que describe:
- Qué construir, no cómo construirlo en detalle
- El contexto relevante (rutas de archivos, patrones existentes, restricciones)
- El formato de salida esperado
- Límites explícitos (qué no cambiar)
4. El Agente de Ejecución de Código escribe o modifica código
El Agente de Ejecución de Código ejecuta el prompt y devuelve la implementación generada. Este paso está aislado: no lee el historial de sesión, no tiene acceso a git y no envía cambios en ningún lugar.
5. Revisar, integrar y probar
El Agente de Orquestación revisa el código verificando corrección, consistencia, seguridad y cobertura de casos límite. Si el resultado no es aceptable, el flujo vuelve al paso 3 con alcance reducido o restricciones más explícitas.
6. Commit y push manual en git
Las operaciones de git permanecen bajo el control directo del usuario. El Agente de Ejecución de Código no interactúa con git bajo ninguna circunstancia.
7. Informar el resultado
El Agente de Orquestación informa el resultado y actualiza la documentación relevante.
Reglas clave
- El Agente de Ejecución de Código no interactúa con git bajo ninguna circunstancia
- Los prompts describen qué construir, no código preescrito para pegar
- Las tareas deben dividirse en unidades pequeñas y secuenciales
- Si el resultado es incorrecto, reintentar con alcance más pequeño y explícito
- Si la recuperación no es posible, detenerse y consultar al usuario antes de continuar
Gestión de errores
Actualmente no hay mecanismo de reintento automatizado. Si un prompt produce un resultado incorrecto, el camino de recuperación es:
- Identificar qué salió mal (alcance demasiado amplio, instrucción ambigua, contexto insuficiente)
- Escribir un prompt más explícito con alcance reducido
- Reintentar desde el paso 3
Si múltiples reintentos fallan, el Agente de Orquestación se detiene e informa el problema al usuario en lugar de continuar con un resultado parcialmente correcto.
Páginas relacionadas
→ Agente de Orquestación — planificación y coordinación → Flujo de Datos — cómo se mueven los resultados por el sistema → Resumen del Sistema — contexto de arquitectura completo