Qual caminho seguir? Seu workflow em 30 segundos
Para quem? Para qualquer pessoa prestes a começar com o Bear Craft e que se pergunta: «quais comandos executo e em que ordem?». Responda a duas perguntas e siga um único caminho.
Regra prática: uma situação = um caminho = uma sequência curta de comandos. Você nunca precisa dos outros 100+ comandos para começar.
1. A árvore de decisão
O que você vai fazer hoje?
│
┌──────────────┬───┴──────────┬──────────────────┐
▼ ▼ ▼ ▼
Um produto Código Um bug a Um sprint planejado
novo, do zero existente, ainda corrigir que você quer concluir
sem backlog sem supervisão
│ │ │ │
▼ ▼ ▼ ▼
GREENFIELD BROWNFIELD BUGFIX SPRINT AUTÔNOMO
/bear-workflow:init /bear-project:reverse scan /bear-qa:tdd /bear-workflow:auto-sprint N
│ │ (+ Quick Flow) │
▼ ▼ ▼ ▼
Seção 2 Seção 3 Seção 4 Seção 5
Perdido a qualquer momento? → /bear-workflow:status (Seção 6)Não tem certeza? Faça-se estas perguntas:
- Já existe código? Não → Greenfield. Sim → pergunta 2.
- Já existe um backlog (épicos e histórias)? Não → Brownfield. Sim → pergunta 3.
- É um único bug? Sim → Bugfix. Não → continue o sprint com
/bear-workflow:start Nou entregue-o ao Sprint autônomo.
2. Greenfield: um produto novo
Você tem uma ideia e um repositório vazio. Siga o caminho principal, uma fase de cada vez:
/bear-workflow:init → /bear-workflow:plan → /bear-workflow:design → /bear-workflow:start 1
→ /bear-workflow:implement → /bear-workflow:review → /bear-workflow:retro| Etapa | Comando | O que você obtém |
|---|---|---|
| 1 | /bear-workflow:init | Análise do projeto, track recomendado (Quick, Standard ou Enterprise) e .bmad/sprint-status.yaml |
| 2 | /bear-workflow:plan | PRD, personas e backlog gerado |
| 3 | /bear-workflow:design | Especificação técnica e arquitetura |
| 4 | /bear-workflow:start 1 | Sprint 1 preparado: histórias selecionadas e prontas para desenvolvimento |
| 5 | /bear-workflow:implement | Histórias construídas com TDD (Red → Green → Refactor) |
| 6 | /bear-workflow:review | Preparação da revisão do sprint |
| 7 | /bear-workflow:retro | Retrospectiva e retorno a /bear-workflow:start 2 |
Para uma versão narrada passo a passo, leia o tutorial do workflow completo.
3. Brownfield: código existente, sem backlog
Você herdou (ou já escreveu) uma base de código, mas ninguém documentou o que ela faz. Primeiro faça a engenharia reversa do produto e depois junte-se ao caminho principal:
/bear-project:reverse scan → /bear-project:reverse prd → /bear-project:reverse stories
→ /bear-project:reverse gaps → /bear-workflow:start| Etapa | Comando | O que você obtém |
|---|---|---|
| 1 | /bear-project:reverse scan | Inventário da base de código: stack, estrutura, módulos |
| 2 | /bear-project:reverse prd | Um PRD reconstruído a partir do que o código realmente faz |
| 3 | /bear-project:reverse stories | Histórias de usuário deduzidas das funcionalidades existentes |
| 4 | /bear-project:reverse gaps | Funcionalidades ausentes, testes ausentes, dívida técnica |
| 5 | /bear-workflow:start | Primeiro sprint planejado a partir das lacunas; continue com /bear-workflow:implement |
Veja também o guia de integração em um projeto existente.
4. Bugfix: reproduzir primeiro, corrigir depois
Um bug não precisa de PRD. Use o track mais leve e deixe o teste conduzir a correção:
/bear-qa:tdd ← escreva PRIMEIRO o teste que reproduz o bug (ele deve falhar)
/bear-workflow:init --quick ← track Quick Flow: apenas implementação- Execute
/bear-qa:tdde descreva o bug. O teste que o reproduz é escrito antes de qualquer correção e deve falhar. - Execute
/bear-workflow:init --quickpara forçar o track Quick Flow (sem fases de planejamento nem de design). - Corrija o código até o teste passar e depois refatore. O teste permanece na suíte como proteção contra regressões: um bug corrigido nunca deve voltar.
Veja o guia de correção de bugs para mais detalhes.
5. Sprint autônomo: um comando, do início ao merge
Quando o trabalho já está planejado, deixe o Bear Craft conduzir o sprint inteiro:
/bear-workflow:auto-sprint NPré-requisitos
- Existe um backlog (vindo do caminho Greenfield ou Brownfield).
- O sprint
Nestá planejado.
O que ele faz: encadeia o início, a decomposição em tarefas, a validação, a implementação, a pull request, a CI, a revisão, a retrospectiva e, por fim, o merge. A execução termina com a PR, uma CI verde e o merge. Você revisa o resultado em vez de digitar cada comando.
Prefere controle a velocidade? Fique no caminho principal manual da Seção 2.
6. Onde estou?
A qualquer momento, seja qual for o caminho:
/bear-workflow:statusO comando mostra a fase atual, o progresso do sprint e a próxima ação recomendada.
Fonte única da verdade:
.bmad/sprint-status.yamlguarda o status de cada história (backlog → ready-for-dev → in-progress → review → done, oublocked). Ele é criado por/bear-workflow:init, e todo comando o lê e o atualiza. Se duas visões divergirem, este arquivo prevalece.
Resumo rápido
| Situação | Comece com | Depois |
|---|---|---|
| Produto novo | /bear-workflow:init | /bear-workflow:plan → /bear-workflow:design → /bear-workflow:start 1 |
| Código existente, sem 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 planejado, sem intervenção | /bear-workflow:auto-sprint N | Revisar a PR |
| Perdido | /bear-workflow:status | Seguir a ação recomendada |