06. Terminar automáticamente desde un objetivo (ywc-agentic)

Guide5 min de lectura

04 y 05 son flujos de control manual donde el usuario invoca cada paso uno por uno ( ywc-plan -> ...

Back to table of contents

06. Terminar automáticamente desde un objetivo (ywc-agentic)

Cuándo usar este flujo

04 y 05 son flujos de control manual donde el usuario invoca cada paso uno por uno (ywc-plan -> ... -> ejecutor). ywc-agentic toma un objetivo en lenguaje natural y repite automáticamente toda la secuencia como un bucle de Planificar -> Ejecutar -> Evaluar -> Repetir hasta que la verificación pase o se alcance el límite de iteraciones, sin intervención humana.

  • Si quieres dar un objetivo en lugar de rastrear manualmente la siguiente habilidad cada vez -> esta página
  • Si quieres control directo a nivel Task, decidiendo qué tarea se ejecuta cuándo -> utiliza el ejecutor directamente desde 05
  • Si quieres ejecutar un backlog tasks/ existente tal como está sin descomposición Task -> llama a ywc-sequential-executor / ywc-parallel-executor directamente, no de manera agentiva

Lo que automatiza

guidebook
Goal -> [Plan -> Execute -> Evaluate -> Repeat] -> Result

Internamente, orquesta las habilidades existentes ywc-* tal como están. No tiene una lógica de generación de código separada.

FaseQué pasa
PlanCrea un plan con ywc-plan --non-interactive (para Pequeño: plan.md; para Mediano/Grande: converge la especificación a DONE con ywc-spec-ready)
TaskSolo mediano/grande: descomponer con ywc-task-generator, luego elegir automáticamente un ejecutor basado en dependency-graph.md
EjecutarPara Small, ejecuta ywc-code-gen; para Medium/Large, ejecuta el ejecutor en modo --local-merge para iteración rápida sin PRs
EvaluarRevisa solo la diferencia de la iteración actual con ywc-impl-review, luego verifica lint/typecheck/test/build con ywc-verify-done
RepetirSi la verificación falla, replanifica con ywc-plan --update-spec y repite hasta el límite --max-iterations

Oráculo de Éxito - En cada ejecución, define de antemano qué hace que el trabajo esté terminado de manera falsable y mantiene esa definición a lo largo del proceso: Objetivo / Límite de calidad / Evidencia requerida / Condición de parada. Un Aprobado solo es válido cuando ywc-impl-review devuelve DONE y ywc-verify-done está en verde. Si la revisión es DONE pero las pruebas están rojas, la ejecución aún falla.

Ejemplo de ejecución

Dar un objetivo en lenguaje natural (predeterminado, hasta 3 iteraciones)

claude code
ywc-agentic "Agrega lógica de reintento automático cuando falle el pago"

Aumenta el límite de iteraciones para que siga intentando más tiempo

claude code
ywc-agentic "Agrega lógica de reintento automático cuando falle el pago" --max-iterations 5

--max-iterations es un límite de seguridad definido por el usuario. Si la ejecución no converge, el agente nunca aumenta el límite por sí mismo.

Elegir explícitamente al ejecutor

claude code
ywc-agentic "Agrega una pantalla de configuración de notificaciones y API" --executor sequential

El auto predeterminado inspecciona dependency-graph.md y elige secuencial o paralelo automáticamente.

Reanudar una ejecución interrumpida

claude code
ywc-agentic --resume

Si quedan tareas sin terminar en tasks/, se omite la Fase de Planificación y se continúa desde ese punto.

Previsualizar las fases sin ejecutarlas realmente

claude code
ywc-agentic "Agrega lógica de reintento automático cuando falle el pago" --dry-run

Se detiene cuando el objetivo es ambiguo

"Funciona de manera autónoma" no significa "rellena los espacios en blanco por sí solo." Antes de la Fase de Planificación, clasifica el objetivo y se detiene primero si es ambiguo:

Estado objetivoComportamiento
Específico (todas las condiciones qué/dónde/hecho están presentes)Proceda inmediatamente
Solo falta el por qué (el método de implementación y la condición de finalización están claros)Proceda, pero marque como incumplido
Ambiguo (sin condición de hecho completado, o posibles múltiples interpretaciones)Detén con NEEDS_CONTEXT; si hay conversación disponible, guía a ywc-brainstorm
Arriesgado/irreversible (autenticación, pago, permisos, eliminación de datos, migración de esquema)Debe pasar ywc-confidence-gate antes de continuar

Cuando te bloqueas en cada paso

SituaciónAcción
Ni siquiera puede arrancar y devuelve NEEDS_CONTEXTEl objetivo es ambiguo: reescríbelo de manera más específica, o utiliza ywc-brainstorm primero para una aclaración interactiva
BLOCKED (conflicto de fusión, error grave CI)No intenta la recuperación automática: lea el contenido registrado en tasks/agentic-log.md, resuelva directamente y luego vuelva a ejecutar
Se ha alcanzado el límite de iteraciones (--max-iterations)Termina como DONE_WITH_CONCERNS, con los hallazgos CRÍTICOS/ALTOS restantes listados: corríjalos directamente o aumente el límite y vuelva a ejecutar
La replanificación sigue volviendo al mismo alcanceTratado como un bloqueo de protección contra recursión y detenido automáticamente: la especificación o el objetivo en sí mismo necesita otra revisión

Qué revisar después de la finalización

  • tasks/agentic-log.md: fase, aprobado/reprobado, hallazgos y Success Oracle de cada iteración se registran solo para agregar
  • Si existieran hallazgos CRÍTICOS/ALTOS repetidos, se marcan como Learning candidate en el informe de finalización; revíselos y, si lo desea, regístrelos manualmente con ywc-review-learnings (no se registran automáticamente)

Previous: 05. Handling work split into multiple Tasks - Next: 07. Starting a new Project