07 — Execução e Git Worktrees worktree isolado por agente · brief → implementação → handoff → PR · padrões de projeto · fluxo git completo ETAPA 07/17 execução paralela · git PIPELINE DE EXECUÇÃO POR AGENTE · ciclo completo de uma tarefa ① TAREFA DESPACHADA orchestrator envia brief agente: backend-agent tarefa: S-042 implementar endpoint POST /api/users tier: standard ② CRIAR WORKTREE branch isolada criada git worktree add ../worktrees/backend-S-042 -b feat/backend-S-042 pasta isolada do main branch ③ IMPLEMENTAÇÃO agente escreve o código · segue padrões do projeto · usa estrutura existente · escreve testes (80% cov) · commita incrementalmente ④ HANDOFF entrega ao gate · diff do worktree · evidências dos testes · notas de decisão · checklist DoD ⑤ PULL REQUEST merge ao main · PR feat/backend-S-042 · 4-eyes aprovado · CI/CD verde · worktree removido EXECUÇÃO PARALELA · múltiplos worktrees simultâneos, sem conflito main ────────────────────────────────────────────────────────────── HEAD feat/backend-S-042 ../worktrees/backend-S-042/ feat/frontend-S-043 ../worktrees/frontend-S-043/ feat/security-S-044 ⟨ em andamento ../worktrees/security-S-044/ Cada worktree é uma pasta separada no sistema de arquivos — o agente trabalha nela sem interferir nos outros. Ao terminar, o PR é aberto e o worktree é removido com git worktree remove ../worktrees/backend-S-042 PADRÕES OBRIGATÓRIOS NO WORKTREE ① Leia o README e os arquivos de configuração antes de codar ② Siga a estrutura de pastas existente (não invente novas) ③ Reutilize funções e classes já escritas (evite duplicação) ④ Nomeação: snake_case (Python/SQL), camelCase (JS/TS), PascalCase (classes) ⑤ Todo commit inclui mensagem descritiva + referência S-NNN ⑥ Nunca commitar secrets, .env ou credenciais ⑦ Diff final deve cobrir apenas a tarefa despachada, nada além ANATOMIA DE UM COMMIT feat(api): POST /api/users endpoint — S-042 - Valida body com Zod schema - Hash de senha com bcrypt (salt 12) - Testes unitários: 14 casos (100% branch cov.) Refs: S-042 Worktree: feat/backend-S-042 tipo: feat/fix/docs/test/refactor/chore · escopo: módulo · referência obrigatória S-NNN ETAPA 07 · worktree isolado · brief → impl → handoff → PR · padrões obrigatórios · formato de commit GIT WORKTREES LEGENDA worktree ativo (em execução) worktree em andamento (gate pendente) merge concluído (worktree removido) worktree: pasta git isolada criada com git worktree add — permite múltiplos agentes trabalharem em paralelo sem conflito de branch