O arquivo de Tasks detalha a execução diária em unidades rastreáveis de entrega, baseadas no plano. É o quadro de trabalho real, o "kanban" descritivo do projeto, onde o commit e a quebra de atividades atômicas (como "Criar tela", "Ajustar API") vivem.
Fase: 6 — Planejamento (Desdobramento)
Pré-requisito: Docs/plan.md aprovado e Fases estruturadas.
Template: Templates/Full/tasks.md ou Templates/Quick/tasks.md
Artefato oficial: Docs/tasks.md
Próximo artefato: Docs/control.md
Quando criar ou revisar
- Ao criar o artefato
Docs/plan.md, para desdobrá-lo nas tarefas operacionais. - Diariamente, pelo Dev ou Agente, para atualizar status, checkpoints e inserir hashes de commits das tarefas concluídas.
- Sempre que houver uma mudança de prioridade, para rearranjar a fila de trabalho.
Full vs Quick
| Situação | Template |
|---|---|
| Projeto novo complexo, com múltiplas fases, Quality Gates, milestonnes e várias áreas | Templates/Full/tasks.md |
| Feature simples com escopo reduzido que se limita a editar códigos sem bootstrap | Templates/Quick/tasks.md |
| Quando surge necessidade de rastrear commit-a-commit evidências com CI rígido | Migrar para Full |
Estrutura — Tasks Full
O modelo Full dita 9 seções base. Os blocos documentam exatamente que tipo de política cada tarefa assume (se apenas edita código ou se cria infraestrutura zero).
1. Identificação
Nome do projeto:
Versão do documento:
Status: [rascunho / ativo / revisando / estabilização / concluído]
Documentos base: Docs/plan.md, Docs/project.md, Docs/contract.yaml, Docs/architecture.md, Docs/deploy.md
Data de criação:
Última atualização:2. Objetivo do Documento
Cobre:
- A organização de execução em: Fase > Módulo > Tarefa > Sub-tarefa > Meta > Critério de aceite.
- Permitir rastreabilidade contínua.
- Ditar marcação de checkbox textual:
( )para não concluído, e(x)para concluído.
Não cobre: Documentações amplas do Domínio da aplicação.
3. Regras Gerais
As amarras do funcionamento deste doc:
- Toda tarefa deve pertencer a uma fase e módulo.
- A primeira task (TASK-001) IMPRETERIVELMENTE tem política "bootstrap_estrutural". Só ela pode criar a árvore do projeto (files/diretórios).
- Demais tasks tem política "edição" (só alteram arquivos já existentes na árvore).
- Cada task concluída obriga a geração de exatamente 1 commit limpo.
- Mock, stub ou placeholder são probidos por padrão (ver Quality/).4. Bloco obrigatório de qualidade por task
Cada task inserida deve obrigatoriamente preencher:
Quality Gate: [aprovado / reprovado]
Evidências de qualidade: [lint pass, typecheck ok, build vivo no servidor, testes gerados]5. Estrutura das Fases
É o maior bloco, onde moram os "cards". Você clona os campos e preenche conforme o backlog, atrelando à FASE que veio do plan.md.
# FASE 01 — Fundação Estrutural
## MÓDULO: Base do Projeto
### TASK-001 — Inicializar base do repositório
Tipo: estrutura
Prioridade: alta
Milestone: M1
Dependências: nenhuma
Política de alteração: bootstrap_estrutural
Permite criar diretórios/arquivos: sim
Commit da task: [hash do git gerado]
Arquivos tocados: [Lista dos arquivos commitados]
Quality Gate: [aprovado]
Evidências de qualidade: [Rodado build limpo sem warnings TypeScript]
Meta(s):
- (x) Repositório com estrutura inicial criada.
Sub-tarefas:
- (x) Criar estrutura base package.json
- (x) Validar convenções
Critérios de aceite:
- (x) Projeto instala sem dependências órfãs.6. Resumo por Fase
Sumário executivo do status. Mostra as macrofases do plan.md no painel de Tarefas:
FASE 01 - Fundação Estrutural
- (x) concluída
FASE 02 - Base Funcional
- ( ) concluída7. Resumo por Milestone
M1 — Alpha funcional inicial
- (x) concluído
M2 — Backend consolidado
- ( ) M28. Diretrizes de Uso
Critérios operacionais para o time que lê o backlog:
- Tarefas não testadas viram dívida na mesma hora e reprovam o Quality Gate.
- Tasks muito grandes (> 4h reais) devem ser picotadas em mais tarefas.
- Dev ou AI operam task-a-task sem precisar "adivinhar" dependência. A chave "Dependências" trava e autoriza quem começa.9. Síntese Operacional para Dev e AI
Para desenvolvedores, a lógica é restrita a:
Fase = Contexto de onde estamos.
Módulo = Frente que estamos atacando.
Task = Escopo de 1 único Commit.
Sub-tarefa = Checkbox passo a passo.
Critério Válido = Prova tangível apontando o fim.
O que precisa ser respeitado: Vínculo c/ milestone, Quality Gate blindado.Prompt para gerar com agente
Atue como ExecutionAgent.
Objetivo: Transformar Docs/plan.md em lista executável no Docs/tasks.md
Contexto base:
- Docs/plan.md
- Templates/Full/tasks.md
Preencha as 9 seções do Template Full de tarefas de forma explícita.
Na *Seção 5*, crie a FASE 01 inicial e construa a TASK-001. Declare na TASK-001 que seu tipo de Política de alteração é "bootstrap_estrutural".
Para o restante de Fases derivadas do plan.md, gere TASKS utilizando SOMENTE "edição" no tipo da Política de alteração. Mantenha os blocos Quality Gate e Commits vazios a serem preenchidos na execução cotidiana.Definição de pronto
O tasks.md está corretamente mapeado do seu template matriz quando:
- As 9 seções se encontram individualizadas sem fusões.
- É explícito o "Bloco de Qualidade" para cada Card gerado.
- A TASK-001 foi criada com privilégios absolutos
bootstrap_estruturalditando que apenas ela cria as pastas, bloqueando as demais (Section 3). - Os Quadros de Resumo (seções 6 e 7) estão na ponta do arquivo servindo para leitura rápida do Tech Lead/Scrum.
Atenção
Permitir que tasks.md gere múltiplas tarefas diárias preenchidas como bootstrap_estrutural esmaga 100% da rastreabilidade arquitetural do Framework. Reforçar que apenas 1 task funda o projeto, a segunda em diante HERDA o que está lá e os altera (edição).
Erros comuns
| Erro | Correção |
|---|---|
Começar Tasks com (x) em blocos não concluídos | Agentes muitas vezes cometem o erro de assumir finalização. Marcar checkbox do MD requer prova real de execução acompanhado do hash de commit formal. |
| Omitir seção Quality Gate nas TASKS dentro da Fase 5 | É inalienável. A TASK só se dá por concluída quando responde (ou reprova) ao QA gate. |
Tarefas "soltas" sem relação direta a FASE original do PLAN Docs/plan.md | Tarefa sem endereço a Fase vira trabalho perdido e desperdiçado. Vincule sempre. |
Relação com outros artefatos
Docs/plan.md — Diz que a Fase 1 deve fazer X antes de Y.
↓
Docs/tasks.md — Cria dezenas de Tarefas minúsculas dentro da Fase 1, preenche checkboxes ao codar, atrela commits.
↓
Docs/control.md — Lê o tasks diário, rastreia quem tocou nessas dezenas de tarefas, aponta riscos e relata o avanço ou atraso.