Skip to content

¿Qué camino elegir? Tu workflow en 30 segundos ​

¿Para quién? Para cualquiera que esté a punto de empezar con Bear Craft y se pregunte «¿qué comandos ejecuto y en qué orden?». Responde dos preguntas, sigue un solo camino.

Regla general: una situación = un camino = una secuencia corta de comandos. Nunca necesitas los otros 100+ comandos para empezar.


1. El árbol de decisión ​

                    ¿Qué haces hoy?
                         │
        ┌──────────────┬─┴────────────┬──────────────────┐
        ▼              ▼              ▼                  ▼
  Un producto      Código           Un bug por       Un sprint planificado
  nuevo desde      existente, aún   corregir         que quieres terminar
  cero             sin backlog                       sin supervisión
        │              │              │                  │
        ▼              ▼              ▼                  ▼
   GREENFIELD      BROWNFIELD      BUGFIX         SPRINT AUTÓNOMO
  /bear-workflow:init  /bear-project:reverse scan  /bear-qa:tdd   /bear-workflow:auto-sprint N
        │              │        (+ Quick Flow)          │
        ▼              ▼              ▼                  ▼
     Sección 2      Sección 3     Sección 4          Sección 5

  ¿Perdido en cualquier momento?  →  /bear-workflow:status   (Sección 6)

¿No estás seguro? Hazte estas preguntas:

  1. ¿Ya existe código? No → Greenfield. Sí → pregunta 2.
  2. ¿Ya existe un backlog (epics e historias)? No → Brownfield. Sí → pregunta 3.
  3. ¿Es un único bug? Sí → Bugfix. No → continúa el sprint con /bear-workflow:start N, o delégalo al Sprint autónomo.

2. Greenfield: un producto nuevo ​

Tienes una idea y un repositorio vacío. Sigue el camino principal, una fase a la vez:

/bear-workflow:init  →  /bear-workflow:plan  →  /bear-workflow:design  →  /bear-workflow:start 1
                →  /bear-workflow:implement  →  /bear-workflow:review  →  /bear-workflow:retro
PasoComandoQué obtienes
1/bear-workflow:initAnálisis del proyecto, track recomendado (Quick, Standard o Enterprise) y .bmad/sprint-status.yaml
2/bear-workflow:planPRD, personas y backlog generado
3/bear-workflow:designEspecificación técnica y arquitectura
4/bear-workflow:start 1Sprint 1 preparado: historias seleccionadas y listas para desarrollar
5/bear-workflow:implementHistorias construidas con TDD (Red → Green → Refactor)
6/bear-workflow:reviewPreparación de la revisión del sprint
7/bear-workflow:retroRetrospectiva, y vuelta a /bear-workflow:start 2

Para una versión narrada paso a paso, lee el tutorial del workflow completo.


3. Brownfield: código existente, sin backlog ​

Heredas (o ya escribiste) una base de código, pero nadie documentó lo que hace. Primero haz ingeniería inversa del producto y luego únete al camino principal:

/bear-project:reverse scan  →  /bear-project:reverse prd  →  /bear-project:reverse stories
               →  /bear-project:reverse gaps  →  /bear-workflow:start
PasoComandoQué obtienes
1/bear-project:reverse scanInventario de la base de código: stack, estructura, módulos
2/bear-project:reverse prdUn PRD reconstruido a partir de lo que el código hace realmente
3/bear-project:reverse storiesHistorias de usuario deducidas de las funcionalidades existentes
4/bear-project:reverse gapsFuncionalidades faltantes, pruebas faltantes, deuda técnica
5/bear-workflow:startPrimer sprint planificado a partir de las brechas; continúa con /bear-workflow:implement

Consulta también la guía de integración en un proyecto existente.


4. Bugfix: reproducir primero, corregir después ​

Un bug no necesita un PRD. Usa el track más ligero y deja que la prueba guíe la corrección:

/bear-qa:tdd        ← escribe PRIMERO la prueba que reproduce el bug (debe fallar)
/bear-workflow:init --quick    ← track Quick Flow: solo implementación
  1. Ejecuta /bear-qa:tdd y describe el bug. La prueba que lo reproduce se escribe antes de cualquier corrección y debe fallar.
  2. Ejecuta /bear-workflow:init --quick para forzar el track Quick Flow (sin fases de planificación ni de diseño).
  3. Corrige el código hasta que la prueba pase y después refactoriza. La prueba permanece en la suite como protección contra regresiones: un bug corregido nunca debe volver.

Consulta la guía de corrección de bugs para más detalles.


5. Sprint autónomo: un comando, del inicio al merge ​

Cuando el trabajo ya está planificado, deja que Bear Craft dirija todo el sprint:

/bear-workflow:auto-sprint N

Requisitos previos

  • Existe un backlog (del camino Greenfield o Brownfield).
  • El sprint N está planificado.

Qué hace: encadena el inicio, el desglose en tareas, la validación, la implementación, la pull request, la CI, la revisión, la retrospectiva y, por último, el merge. La ejecución termina con la PR, una CI en verde y el merge. Revisas el resultado en lugar de escribir cada comando.

¿Prefieres control a velocidad? Quédate en el camino principal manual de la Sección 2.


6. ¿Dónde estoy? ​

En cualquier momento, sea cual sea el camino:

/bear-workflow:status

Muestra la fase actual, el avance del sprint y la siguiente acción recomendada.

Fuente única de verdad: .bmad/sprint-status.yaml contiene el estado de cada historia (backlog → ready-for-dev → in-progress → review → done, o blocked). Lo crea /bear-workflow:init, y cada comando lo lee y lo actualiza. Si dos vistas no coinciden, este archivo manda.


Resumen rápido ​

SituaciónEmpieza conDespués
Producto nuevo/bear-workflow:init/bear-workflow:plan → /bear-workflow:design → /bear-workflow:start 1
Código existente, sin backlog/bear-project:reverse scan/bear-project:reverse prd → /bear-project:reverse stories → /bear-project:reverse gaps → /bear-workflow:start
Bug/bear-qa:tdd/bear-workflow:init --quick
Sprint planificado, sin intervención/bear-workflow:auto-sprint NRevisar la PR
Perdido/bear-workflow:statusSeguir la acción recomendada