04. Manejo de un cambio pequeño (ciclo general - pequeño)

Guide4 min de lectura

Cuando ywc-plan juzga una solicitud como Pequeña , automáticamente entra en este camino.

Back to table of contents

04. Manejo de un cambio pequeño (ciclo general - pequeño)

Cuándo usar este flujo

Cuando ywc-plan juzga una solicitud como Pequeña, automáticamente entra en este camino. El criterio de decisión es "¿puede esto terminar como un único PR sin descomposición Task?" Si se aplica algún elemento de los siguientes, se eleva a Mediana/Grande en lugar de Pequeña (ver 05).

  • Incluye una migración de base de datos
  • Introduce una nueva biblioteca/marco
  • Se extiende a múltiples subsistemas

Flujo general

guidebook
ywc-plan -> ywc-code-gen -> ywc-impl-review -> ywc-create-pr
PasoSkillRol
unoywc-planAnaliza la solicitud y crea plan.md (Qué / Por qué / Fuera de alcance / Hecho cuando)
Dosywc-code-genGenerar código de Backend + Frontend + QA en paralelo
tresywc-impl-reviewRevisión final del código antes de abrir un PR
cuatroywc-create-prCreación de PR -> CI -> Comprobación de revisión del bot

Nota: El flujo Small hace que ywc-plan produzca plan.md (no un documento spec) directamente, por lo que ywc-spec-ready - que opera sobre un documento spec - no forma parte de este camino. ywc-spec-ready es el paso de convergencia de spec del flujo Medio/Grande (ver 05).

Nota: ywc-code-gen no tiene un indicador de revisión automática como --review. Si omite el paso 3 (ywc-impl-review), el PR se abre sin revisión de código, por lo que este flujo debe ejecutarlo explícitamente. Los ejecutores en el flujo Medio/Grande pueden automatizar este paso con el indicador --review - vea 05.

Ejemplo de ejecución

claude code
ywc-plan El mensaje de error de fallo de inicio de sesión es demasiado genérico, por lo que es difícil entender la causa. Se quiere mostrar razones específicas como cuenta bloqueada / error de tipeo / no registrado
claude code
ywc-code-gen --spec plan.md --feature "specific login failure reason"
claude code
ywc-impl-review
claude code
ywc-create-pr --title "fix: show specific login failure reason"

Si los comentarios de revisión del Bot, el fallo CI, o los problemas de preparación para la fusión permanecen, continúe con ywc-handle-pr-reviews <pr-number>. El flujo Small se basa en plan.md, por lo que no existe el directorio tasks/<task-name>/ y no encaja con la gestión de finalización de tareas de ywc-finish-branch.

Cuando te bloqueas en cada paso

SituaciónAcción
ywc-plan juzga el trabajo como Medio en lugar de PequeñoEsto es normal - muévete a 05. general cycle (medium/large)
ywc-code-gen devuelve BLOCKEDLa especificación puede ser poco clara o no se pudo leer el contexto del proyecto: verifica el bloqueo reportado
ywc-impl-review devuelve DONE_WITH_CONCERNSSi es un problema de corrección, corríjalo y vuelva a ejecutar; si es una observación, regístrela en la descripción PR y continúe
El PR falla CIywc-create-pr o ywc-handle-pr-reviews revisa el registro de fallos e intenta reparaciones hasta dos veces; si aún falla, el problema se presenta como DONE_WITH_CONCERNS o BLOCKED

Previous: 03. Ship your first feature in 5 minutes - Next: 05. Handling work split into multiple Tasks