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