13 — GitHub Projects como Tracker Oficial
9 status · campos customizados · LOG de eventos · DECISAO issues · single source of truth
ETAPA 13/17
orquestração · projeto
BACKLOG
#12 autenticação OAuth
priority: P2 · pts: 5
#15 relatório PDF
priority: P3 · pts: 3
#18 export CSV
priority: P3 · pts: 2
READY
#21 endpoint users
priority: P1 · pts: 8
#22 validação input
priority: P1 · pts: 3
IN PROGRESS
#19 POST /users
S-042 · worktree aberto
#20 GET /users/:id
S-043 · em revisão
IN REVIEW
#17 schema DB
PR #89 · aguard. revisor
QA
#14 login flow
usability-agent testando
#16 forgot password
acessibilidade checando
DONE
#08 setup projeto
merged · deploy staging
#10 env config
merged · em prod
#11 CI/CD pipeline
merged · automatizado
CAMPOS DO PROJETO
Status 9 opções (ver abaixo)
Priority P0 · P1 · P2 · P3
Story Points 1 · 2 · 3 · 5 · 8 · 13
Sprint Sprint 01 · 02 …
Agent S-042 · S-043 …
Worktree ../worktrees/…
Reviewer (não é o implementador)
Gate Status passed · rejected
Linked PR #89 · #91 …
Campos obrigatórios antes de mover para In Progress
Automação: mudar status via PR label ou comment /status
Vistas: Board (padrão) · Table · Roadmap · Backlog
Milestone filter por sprint → velocity tracking automático
DECISAO issues
label: decisao · status: Em decisão
Toda decisão arquitetural ou de produto
abre issue própria com contexto, opções
e rationale. Decisão é registrada no body.
Nunca no chat. Sempre rastreável no histórico.
LOG DE EVENTOS
issue LOG · sempre aberta · pinned no topo
Registra: gates passados/rejeitados,
escalações, mudanças de escopo,
milestones, crashes e recuperações.
Formato: [ISO 8601] EVENTO: detalhe
ex: [2025-11-14T10:23Z] GATE_PASSED: #19
9 STATUS DO BOARD
Backlog
Ready
In Progress
In Review
QA
Em Decisão
Bloqueado
Done
Cancelado
CONVENÇÕES DE LABELS
tipo: feat · fix · refactor · docs · test · chore
area: backend · frontend · infra · security · ux
priority: P0 (crítico) · P1 · P2 · P3 (nice-to-have)
estado: blocked · needs-decision · waiting-review
especial: decisao · log · alerta-perigo · lgpd
Labels aplicados na criação da issue pelo orquestrador
Obrigatório: tipo + area + priority antes de Ready
blocked: issue deve referenciar o bloqueador (#id)
Automatizado: PR merge → label "done" + fecha issue
Busca: label:"P0" is:open → lista todos críticos abertos
ESTRUTURA DE ISSUE PADRÃO
## Contexto
Por que esta task existe; qual problema resolve.
## Critérios de Aceite
- [ ] Dado X quando Y então Z
- [ ] Testes cobrindo o happy path e edge cases
## Referências
Links para doc, ADR, PR relacionado, issue pai.
## Log de Progresso (agent preenche)
- 2025-11-14: criado S-042, worktree aberto
- 2025-11-14: PR #89 aberto, aguardando QA
Issues fechadas apenas por PR merge — nunca manualmente
AUTOMAÇÕES DO BOARD
PR opened → issue muda para In Review
PR merged → issue muda para Done
PR closed (no M) → issue volta para Ready
label: blocked → status muda para Bloqueado
comment /status QA → move para QA
CI falha → issue recebe label "ci-failed"
Implementado via GitHub Actions + gh CLI
Orquestrador atualiza campos (agent, worktree)
via API: gh project item-edit --field-value
Nenhum status é atualizado manualmente — sempre rastreado
ETAPA 13
·
9 status · campos obrigatórios · DECISAO issues · LOG pinned · automações via GitHub Actions
GITHUB PROJECTS
LEGENDA
Backlog / Cancelado
Ready
In Progress
In Review
QA / Em Decisão
Bloqueado
Done
DECISAO issue = registro permanente de decisão arquitetural · LOG issue = histórico de eventos do projeto · ADR = Architecture Decision Record