@the-bearded-bear/claude-craft 8.23.3 → 8.26.0-next.2a54921

package/Dev/i18n/pt/Workflow/commands/start.md

@@ -1,20 +1,32 @@
 ---
-description: Preparação para Início do Sprint
-argument-hint: [arguments]
+description: "Preparação do início de sprint: pasta do sprint, entradas do sprint-status.yaml e decomposição em tarefas"
+argument-hint: "<N> [--tasks-only]"
 ---
 
-# Preparação para Início do Sprint
+# Preparação do Início de Sprint
 
-Você é um Scrum Master experiente. Você deve preparar e facilitar o início de um novo sprint verificando se todas as condições estão satisfeitas.
+Você é um Scrum Master e Tech Lead experiente. Você deve preparar e facilitar o início de um novo sprint: verificar as condições, criar a pasta do sprint, registrar o sprint em `.bmad/sprint-status.yaml` e decompor as histórias em tarefas (Sprint Planning Parte 2, "O Como").
+
+## Uso
+
+| Invocação | O que faz | Substitui |
+|-----------|-----------|-----------|
+| `/workflow:start <N>` | Início completo: pré-requisitos, capacidade, planning, `project-management/sprints/sprint-{N}-{slug}/` (sprint-goal.md, sprint-dependencies.md, board.md, `tasks/TASK-*.md`), sprint e histórias escritos em `.bmad/sprint-status.yaml`, tarefas registradas | etapas de início de `/sprint:*` |
+| `/workflow:start <N> --tasks-only` | Decompõe em tarefas as histórias de um sprint **existente** (apenas Etapas 7 a 9, pular as Etapas 1 a 6) | `/workflow:start <N>` |
 
 ## Argumentos
 $ARGUMENTS
 
 Argumentos:
-- Número do sprint (ex: `5`)
+- Número do sprint (ex.: `5`, `005`); se ausente, perguntar qual sprint iniciar
 - (Opcional) Duração em dias (padrão: 10 dias = 2 semanas)
+- `--tasks-only`: apenas decompõe em tarefas as histórias de um sprint existente
+
+Exemplos: `/workflow:start 5`, `/workflow:start 5 --tasks-only`
 
-Exemplo: `/workflow:start 5`
+> **O Plan Mode é obrigatório para a decomposição** (Etapa 7): analisar o código impactado, propor a divisão em tarefas e aguardar a validação antes de escrever arquivos.
+
+> **O status vive em `.bmad/sprint-status.yaml`** (esquema: `.claude/templates/project/sprint-status.md`), nunca no markdown. Os arquivos de sprint, de tarefas e de board contêm apenas conteúdo.
 
 ## MISSÃO
 
@@ -134,19 +146,23 @@ Para cada US selecionada:
 | Retrospectiva | {data final} | 16:30 | 1h30 | Sala A |
 ```
 
-### Etapa 4: Criar Estrutura do Sprint
+### Etapa 4: Criar a Estrutura do Sprint
 
-Criar pasta do sprint:
+Criar a pasta do sprint (templates em `.claude/templates/project/`):
 
 ```
 project-management/
-├── sprints/
-    └── sprint-{N}-{objetivo}/
+└── sprints/
+    └── sprint-{N}-{slug}/
         ├── sprint-goal.md
-        ├── sprint-backlog.md
-        ├── daily-notes/
-        │   ├── {YYYY-MM-DD}.md
+        ├── sprint-dependencies.md
+        ├── board.md                  # visão Kanban única, apenas conteúdo
+        ├── tasks/
+        │   ├── README.md             # visão geral: tarefas agrupadas por US
+        │   ├── TASK-001.md           # um arquivo por tarefa (.claude/templates/project/task.md)
         │   └── ...
+        ├── daily-notes/
+        │   └── {YYYY-MM-DD}.md
         ├── sprint-review.md
         └── sprint-retro.md
 ```
@@ -226,7 +242,7 @@ Pontos |
 
 ### Etapa 6: Sincronizar `.bmad/sprint-status.yaml`
 
-`/gate:validate-sprint` e os comandos `/sprint:*` leem o sprint em `.bmad/sprint-status.yaml`. Escreva-o agora a partir do `sprint-goal.md` acima e das fichas US selecionadas (`project-management/backlog/user-stories/US-*.md`):
+`/gate:check sprint` e `/workflow:implement` leem o sprint em `.bmad/sprint-status.yaml`. Escreva-o agora a partir do `sprint-goal.md` acima e das fichas US selecionadas (`project-management/backlog/user-stories/US-*.md`):
 
 1. Criar `.bmad/` se não existir.
 2. `metadata`: `sprint_id` (`sprint-{N}`), `name`, `start_date`, `end_date`, `goal`, `capacity_points`, retirados de `sprint-goal.md`.
@@ -260,7 +276,83 @@ archived_sprints:
       US-001: { status: "done", points: 5 }
 ```
 
-### Etapa 7: Checklist Final
+### Etapa 7: Decompor as Histórias em Tarefas
+
+Ler `sprint-goal.md`, `sprint-dependencies.md` e cada US referenciada em `project-management/backlog/user-stories/` (com `--tasks-only`, começar aqui). Adaptar os tipos de tarefa à stack real do projeto (ler `CLAUDE.md` / `.claude/rules/`); a tabela abaixo é um exemplo típico.
+
+| Camada | Prefixo | Tarefas típicas |
+|--------|---------|-----------------|
+| Banco de dados | `[DB]` | Entidade, migração, repositório, fixtures |
+| Backend | `[BE]` | Serviço, recurso API, DTO, processor, voter |
+| Frontend Web | `[FE-WEB]` | Controlador, template, componente |
+| Frontend Mobile | `[FE-MOB]` | Modelo, repositório, estado, tela |
+| Testes | `[TEST]` | Unitários, integração, API, E2E |
+| Documentação | `[DOC]` | Documentação do código, README, OpenAPI |
+| DevOps | `[OPS]` | Docker, CI/CD |
+| Revisão | `[REV]` | Code review |
+
+**Boa tarefa (SMART)**: Específica (ação clara), Mensurável (sabe-se quando termina), Atribuível (um único responsável), Realista, Com prazo (estimada em horas, não em pontos).
+
+**Regras de tamanho**: mínimo 30 min, máximo 8 h (1 dia), ideal 2 a 4 h. Acima de 8 h: dividir em subtarefas.
+
+**Fatiamento vertical**: cada US recebe as tarefas DB + API + front + testes + doc + revisão conforme necessário. Tamanho típico: CRUD simples ~15 tarefas, funcionalidade de negócio ~18, apenas UI ~11.
+
+Para cada US, criar um `tasks/TASK-{NNN}.md` por tarefa a partir de `.claude/templates/project/task.md` (os IDs continuam após o último `TASK-*` existente, como faz `/project:backlog add task`) com: tipo, estimativa, `Depends on`, descrição, arquivos a criar ou modificar, critérios de validação. Depois adicionar uma seção em `tasks/README.md`:
+
+```markdown
+## US-XXX: [Título] (Epic EPIC-XXX, [X] pontos)
+
+| ID | Tipo | Tarefa | Estimativa | Depende de |
+|----|------|--------|------------|-----------|
+| TASK-001 | [DB] | Criar a entidade [Nome] | 2h | - |
+| TASK-002 | [DB] | Migração | 1h | TASK-001 |
+| TASK-003 | [BE] | Recurso API | 3h | TASK-001 |
+| TASK-004 | [TEST] | Testes de API | 2h | TASK-003 |
+
+**Total estimado**: XXh
+```
+
+Adicionar as dependências como grafo Mermaid (`TASK-001 --> TASK-002`) e um resumo por camada (tarefas e horas). Adicionar também uma seção "Tarefas técnicas transversais" (ambiente, atualização de dependências, pipeline CI, refatoração identificada) com um `tasks/TASK-{NNN}.md` cada (sem US).
+
+Regras:
+1. Estimativa em horas (não em pontos)
+2. Uma tarefa = um responsável
+3. Máx. 2 tarefas em andamento por pessoa
+4. Dependências explícitas (grafo Mermaid)
+
+### Etapa 8: Board e Visão Geral das Tarefas
+
+Criar `board.md` (template `.claude/templates/project/board.md`):
+
+```markdown
+# Task Board - Sprint {N}
+
+> Visão gerada: regenerada a partir de `.bmad/sprint-status.yaml` por `/workflow:status --board`. Não editar à mão.
+
+## to-do
+| ID | US | Tarefa | Estimativa | Atribuído |
+|----|-----|--------|------------|----------|
+
+## in-progress | review | done | blocked
+(mesmo formato, uma tabela por coluna)
+
+## Métricas
+- **Tarefas**: X no total | X concluídas (X%)
+- **Horas**: Xh estimadas | Xh gastas | Xh restantes
+```
+
+`tasks/README.md` contém também a tabela de resumo (US, título, pontos, tarefas, horas), a divisão por tipo e as convenções: ID `TASK-[NNN]`, tamanho 0,5 h a 8 h, status acompanhados em `.bmad/sprint-status.yaml` (`to-do | in-progress | done | blocked`).
+
+### Etapa 9: Registrar as Tarefas em `.bmad/sprint-status.yaml`
+
+Para cada tarefa criada (tarefas de US e tarefas transversais), conforme `.claude/templates/project/sprint-status.md`:
+
+1. Criar `.bmad/sprint-status.yaml` a partir do esqueleto de `/workflow:init` se não existir (com `--tasks-only`, o sprint e as histórias já existem; senão, executar o `/workflow:start <N>` completo)
+2. Adicionar os ids TASK a `stories.<US>.tasks.list`
+3. Definir `stories.<US>.tasks.status.<TASK>: to-do`
+4. Atualizar `stories.<US>.tasks.total` (`completed` continua sendo o número de tarefas `done`)
+
+### Etapa 10: Checklist Final
 
 ```
 ══════════════════════════════════════════════════════════════
@@ -320,24 +412,22 @@ archived_sprints:
 - Equipe estabelecida: 70-80%
 - Equipe madura: 80-90%
 
-## Próximo passo
+## Próximo Passo
 
 ```
 ╔══════════════════════════════════════════════════════════╗
 ║                    PRÓXIMO PASSO                         ║
 ╠══════════════════════════════════════════════════════════╣
 ║                                                          ║
-║  → /gate:validate-sprint {N}                             ║
+║  → /gate:check sprint {N}                                ║
 ║    Verificar se o sprint está pronto (gate)              ║
 ║                                                          ║
-║  → /sprint:next-story                                    ║
-║    Pegar a primeira story do sprint backlog              ║
-║                                                          ║
-║  → /sprint:dev                                           ║
+║  → /workflow:implement {N}                               ║
 ║    Iniciar o desenvolvimento TDD/BDD                     ║
 ║                                                          ║
 ║  Veja também:                                            ║
-║  • /workflow:status  — Verificar o progresso             ║
+║  • /project:backlog next story — Pegar a 1ª história     ║
+║  • /workflow:status  — Acompanhar o progresso do sprint  ║
 ║                                                          ║
 ╚══════════════════════════════════════════════════════════╝
 ```