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