Skip to content

Guia de Gestão do Backlog ​

Fluxo de trabalho completo para criar e gerenciar um backlog SCRUM com o Bear-Craft.


Visão Geral ​

O Bear-Craft fornece um conjunto completo de comandos para gerenciar seu product backlog seguindo a metodologia SCRUM:

  • Um único comando /bear-project:backlog (add, list, edit, move, mais next story e move story --auto para o roteamento de histórias) junto com /bear-workflow:plan --only=backlog, /bear-workflow:start e /bear-workflow:status --board; os antigos comandos por entidade (add-, list-, update-*, move-task, generate-backlog, decompose-tasks, board) e o namespace de sprint foram removidos na 9.0 (ver MIGRATION-v9)
  • 5 templates para estrutura consistente
  • Vertical slicing obrigatório em todas as camadas tecnológicas
  • Validação do modelo INVEST para User Stories

Filosofia ​

Baseada em:

  • Princípios do Manifesto Ágil
  • 12 Princípios Ágeis
  • Fundamentos do SCRUM
  • Vertical slicing (cada US atravessa todas as camadas)

Geração Inicial do Backlog ​

A Partir de Especificações ​

Coloque as especificações do seu projeto em ./docs/ e execute:

bash
/bear-workflow:plan --only=backlog symfony+flutter

Estrutura Gerada ​

project-management/
├── README.md                    # Visão geral do projeto
├── personas.md                  # Personas (mín. 3)
├── definition-of-done.md        # Níveis de DoD progressivos
├── dependencies-matrix.md       # Dependências entre Epics e US
├── backlog/
│   ├── epics/                   # Arquivos EPIC-XXX-nome.md
│   └── user-stories/            # Arquivos US-XXX-nome.md
└── sprints/
    └── sprint-XXX-objetivo/     # Planos de sprint

Estrutura SCRUM ​

Personas ​

Mínimo de 3 personas exigidas, cada uma contendo:

  • Identidade: Nome, função, dados demográficos
  • Objetivos: O que desejam alcançar
  • Frustrações: Problemas que precisam ser resolvidos

Formato: P-001, P-002, P-003...

EPICs ​

Grandes funcionalidades que contêm múltiplas User Stories:

CampoDescrição
IDIdentificador único (EPIC-001, EPIC-002...)
MMFMinimum Marketable Feature
StatusDraft, Ready, In Progress, Done
Objetivos de NegócioPor que este EPIC é relevante
Critérios de SucessoComo medir o êxito

User Stories ​

Seguem o modelo INVEST:

LetraSignificadoValidação
IIndependent (Independente)Sem dependências de outras US
NNegotiable (Negociável)Detalhes podem ser discutidos
VValuable (Valiosa)Entrega valor ao usuário
EEstimable (Estimável)Pode ser dimensionada em pontos
SSized (Dimensionada)Máx. 8 story points
TTestable (Testável)Possui critérios de aceitação claros

Os 3 Cs ​

  1. Card (Cartão): Descrição resumida
  2. Conversation (Conversa): Detalhes da discussão
  3. Confirmation (Confirmação): Critérios de aceitação

Critérios de Aceitação (Gherkin) ​

Cada US exige:

  • 1 cenário nominal (caminho feliz)
  • 2 cenários alternativos
  • 2 cenários de erro
gherkin
Scenario: Usuário faz login com sucesso
  Given um usuário cadastrado com credenciais válidas
  When ele submete o formulário de login
  Then ele deve visualizar seu painel
  And uma sessão deve ser criada

Tarefas (Tasks) ​

Itens de trabalho técnico dentro de uma User Story:

TipoDescriçãoDuração Típica
[DB]Banco de dados (entidades, migrações)1–3h
[BE]Backend (serviços, APIs)2–4h
[FE-WEB]Frontend Web (controllers, templates)2–4h
[FE-MOB]Frontend Mobile (telas, blocs)3–5h
[TEST]Testes (unitário, integração, E2E)2–4h
[DOC]Documentação0,5–1h
[OPS]DevOps (CI/CD, deploy)1–2h
[REV]Revisão de código1–2h

Regras de estimativa:

  • Duração da tarefa: 0,5h – 8h máximo
  • Story points (Fibonacci): 1, 2, 3, 5, 8, 13, 21
  • Tamanho máximo de uma US: 8 pontos (dividir se maior)

Fluxo de Trabalho ​

Fluxo de Status ​

┌─────────┐     ┌─────────────┐     ┌──────┐
│  To Do  │ ──→ │ In Progress │ ──→ │ Done │
└─────────┘     └─────────────┘     └──────┘
     │                │
     │                ↓
     └────────→ ┌─────────┐
                │ Blocked │
                └─────────┘
                     │
                     ↓
              ┌─────────────┐
              │ In Progress │
              └─────────────┘

Transições proibidas:

  • To Do → Done (deve passar por In Progress)
  • Qualquer estado → To Do (exceto reabertura manual)

Referência de Comandos ​

Comandos de Criação ​

ComandoDescrição
/bear-workflow:plan --only=backlog [stack]Gerar backlog completo a partir das specs
/bear-project:backlog add epicCriar um novo EPIC
/bear-project:backlog add storyAdicionar uma User Story a um EPIC
/bear-project:backlog add taskCriar uma tarefa técnica para uma US

Comandos de Visualização ​

ComandoDescrição
/bear-project:backlog list epicExibir todos os EPICs com status
/bear-project:backlog list story [filtro]Listar User Stories (por EPIC, Sprint, Status)
/bear-project:backlog list task [filtro]Listar tarefas (por US, Sprint, Tipo, Status)
/bear-workflow:status --board [sprint]Exibir quadro Kanban
/bear-workflow:status [sprint]Relatório detalhado de progresso do sprint

Comandos de Atualização ​

ComandoDescrição
/bear-project:backlog move story [id] [status/sprint]Alterar status da US ou atribuir ao sprint
/bear-project:backlog move task [id] [status]Alterar status de uma tarefa
/bear-project:backlog edit epic [id]Modificar um EPIC existente
/bear-project:backlog edit story [id]Modificar uma User Story existente

Comandos Avançados ​

ComandoDescrição
/bear-workflow:start [sprint]Decompor as US do sprint em tarefas
/bear-gate:check backlogAuditar a qualidade do backlog (conformidade SCRUM)

Exemplo Completo: Novo Projeto ​

Passo 1: Gerar o Backlog Inicial ​

bash
# Certifique-se de que as specs estão em ./docs/
/bear-workflow:plan --only=backlog symfony+flutter

Passo 2: Validar a Qualidade ​

bash
/bear-gate:check backlog

Isso gera scrum-validation-report.md com:

  • Pontuação de conformidade INVEST
  • Verificação dos 3 Cs
  • Análise dos critérios SMART
  • Consistência das estimativas

Passo 3: Revisar o Sprint 1 ​

bash
/bear-workflow:status --board 1

Exibe o quadro Kanban com as colunas:

  • To Do | In Progress | In Review | Done | Blocked

Também é possível gerenciar o backlog pela interface web Kanban (npx @the-bearded-bear/bear-craft kanban): criar, editar e excluir histórias, planejá-las em um sprint, e criar, iniciar e encerrar sprints. Ela complementa os comandos /bear-workflow:* e /bear-project:*, que continuam válidos e escrevem o mesmo arquivo (.bmad/sprint-status.yaml).

Passo 4: Decompor em Tarefas ​

bash
/bear-workflow:start 1

Cria o detalhamento das tarefas:

  • Tarefas agrupadas por US
  • Grafo de dependências (Mermaid)
  • Estimativas de tempo por camada

Passo 5: Iniciar o Trabalho ​

bash
# Mover primeira tarefa para em andamento
/bear-project:backlog move task TASK-001 in-progress

# Depois, marcar como concluída
/bear-project:backlog move task TASK-001 done

# Se bloqueada
/bear-project:backlog move task TASK-002 blocked "Aguardando specs da API"

Passo 6: Acompanhar o Progresso ​

bash
/bear-workflow:status 1

Passo 7: Configurar Monitoramento Recorrente (Opcional) ​

Use /loop (v2.1.71+) para monitorar automaticamente o progresso do sprint:

bash
# Verificar status do sprint a cada 30 minutos
/loop 30m /bear-workflow:status 1

# Executar verificações pré-commit a cada 5 minutos durante o desenvolvimento
/loop 5m /bear-gate:check commit

Alias: /proactive (v2.1.105+).

Exibe:

  • Progresso geral e burndown
  • Métricas por User Story
  • Bloqueios e riscos
  • Ações recomendadas

Templates ​

O Bear-Craft fornece 5 templates para estrutura consistente do backlog:

TemplateFinalidade
epic.mdEstrutura do arquivo EPIC com metadados, objetivos e lista de US
user-story.mdEstrutura de US com critérios Gherkin e tabela de tarefas
task.mdEstrutura de tarefa com checklist de DoD
board.mdQuadro Kanban com cálculo de métricas
index.mdÍndice do backlog com resumo global

Regras SCRUM Aplicadas ​

RegraValor
Duração do sprint2 semanas (fixo)
Velocidade20–40 pontos/sprint
Tamanho máximo de US8 pontos (dividir se maior)
Escala de estimativaFibonacci (1, 2, 3, 5, 8, 13, 21)
Duração da tarefa0,5h – 8h máximo

Sprint 1: Walking Skeleton ​

O primeiro sprint deve incluir:

  • Configuração completa da infraestrutura
  • 1 funcionalidade end-to-end (não apenas configuração)
  • Testável tanto em Web quanto em Mobile

Vertical Slicing ​

Cada User Story DEVE atravessar todas as camadas:

UI (Web/Mobile) → API → Lógica de Negócio → Banco de Dados

Não são permitidas User Stories "somente Backend", "somente Frontend" ou "somente Mobile".


Checklist: Backlog Pronto ​

  • [ ] Mínimo de 3 personas definidas
  • [ ] EPICs com MMF e critérios de sucesso
  • [ ] User Stories seguem o modelo INVEST
  • [ ] Critérios de aceitação no formato Gherkin
  • [ ] Stories estimadas em pontos Fibonacci
  • [ ] Sprint 1 = Walking Skeleton
  • [ ] Definition of Done documentada
  • [ ] Backlog validado (/bear-gate:check backlog)

← Resolução de Problemas | Próximo: Configurar Novo Projeto →