16 — Metodologias Ágeis e Git
Scrum/Kanban · hierarquia de issues · git worktree · polyrepo · labels · conventional commits
ETAPA 16/17
metodologia · git
CICLO SCRUM — SPRINT 2 SEMANAS
PLANNING
define sprint backlog
story points
DAILY
status agentes
bloqueios
REVIEW
demo entregues
aceite do orq.
RETROSPECTIVA
o que funcionou · o que melhorar · action items
velocity do sprint → ajuste de pts próximo sprint
DEFINIÇÃO DE DONE (DoD)
· Código implementado + testes passando (≥ 80% coverage)
· Gates de revisão (tech + sec + privacy) aprovados
· PR merged em main + deploy em staging sem erros
· Issue fechada no GitHub Projects com evidência
HIERARQUIA DE ISSUES
EPIC — objetivo maior
USER STORY
USER STORY
TASK #A
TASK #B
TASK #C
TASK #D
BUG (deriva de task)
Epic → "Implementar autenticação"
Story → "Como usuário, quero fazer login"
Task → POST /auth/login (agente S-042)
Bug → login falha com email maiúsculo
GIT WORKTREE + ESTRUTURA POLYREPO
CRIAR:
git worktree add ../worktrees/agent-S-042 -b feat/agent-S-042
LISTAR:
git worktree list
REMOVER:
git worktree remove ../worktrees/agent-S-042 --force
ESTRUTURA DE PASTAS (polyrepo):
~/projects/
├── my-app/ ← repo principal (main)
├── worktrees/
│ ├── agent-S-042/ ← feat/agent-S-042
│ ├── agent-S-043/ ← feat/agent-S-043
│ └── agent-S-044/ ← feat/agent-S-044
└── diário/ live-state.md
VANTAGENS DO WORKTREE
· Sem stash entre agents
· Isolamento total de branches
· Paralelo real (2+ agentes)
· Contexto de diretório isolado
· .env por worktree (opcional)
· Crash não afeta outros agents
CONVENTIONAL COMMITS — PADRÃO OBRIGATÓRIO
FORMATO: <tipo>(<escopo>): <descrição curta> — <AGENT-ID>
feat(api): POST /api/users endpoint — S-042
fix(auth): handle expired JWT tokens — S-043
refactor(db): extract query helpers — S-044
test(users): add integration tests — S-042
chore(ci): add cache for node_modules — S-045
docs(api): update OpenAPI spec — S-046
tipo descrição gera release?
feat nova funcionalidade minor (1.x.0)
fix correção de bug patch (1.0.x)
refactor sem funcionalidade nova/bug não
test adiciona/melhora testes não
chore manutenção, deps, CI não
BREAKING ! após tipo: breaking change major (x.0.0)
Changelog gerado automaticamente em releases semânticos
KANBAN × SCRUM — QUANDO USAR CADA UM
SCRUM (padrão)
· Sprints de 2 semanas com escopo fixo
· Backlog refinado antes de cada sprint
· Velocity tracking para previsibilidade
· Planning + Review + Retro obrigatórios
· Story points por item de backlog
· Ideal para: features novas, projetos com
escopo definido e equipe estável
QUANDO USAR:
Sprint 1: setup + infra + auth
Sprint 2: CRUD principal
Sprint 3: integrações + UX
Sprint 4: segurança + launch
KANBAN (operacional)
· Fluxo contínuo sem sprints fixos
· WIP limits por coluna (ex: máx 3 in-progress)
· Cicle time como métrica principal
· Pull system: pega item quando livre
· Sem planning formal — prioridade no topo
· Ideal para: bugs, suporte, manutenção
e operações contínuas pós-launch
QUANDO USAR:
Hotfixes urgentes em produção
Time de suporte / SRE on-call
Melhorias incrementais pós-MVP
Projetos exploratórios / research
ETAPA 16
·
Scrum 2 semanas · hierarquia Epic→Story→Task · git worktree · polyrepo · conventional commits
ÁGIL & GIT
LEGENDA
Scrum/Sprint (features novas)
Git Worktree / isolamento
Kanban (operações)
Bug / bloqueio
WIP = Work in Progress · DoD = Definition of Done · Velocity = story points entregues/sprint · Cycle time = tempo médio de conclusão de um item
BREAKING CHANGE (!) = incrementa major version no semver