3. Fluxo de ADR · versão 2.0.0
Papéis e responsabilidades
Papéis
- CEO — dirige o negócio. Decide escopo e prioridades, aprova o executivo e, quando o projeto
pede aval para promover à
main, dá esse aval. - Arquiteto — responde pela arquitetura e pela qualidade técnica. Cura recursos, decide o plano e revisa a entrega.
- Dev — executa as ADRs aprovadas. Trabalha na
develop(branch própria opcional, sem pull request, push só com a autorização do dono; ver Git e commits), conduz a execução e escreve os relatórios.
A IA (Claude) não é um papel: é a ferramenta que o Dev e o Arquiteto operam. Ela executa, redige, propõe e orquestra (decide se o trabalho pede ADR, acha ou cria a ADR, vincula e anda as tarefas); as decisões que importam e a responsabilidade são dos papéis humanos.
Responsável por arquivo
| Arquivo | Responsável |
|---|---|
001-executive.md | CEO + Arquiteto |
002-resources.md | Arquiteto |
003-plan.md | Dev + Arquiteto |
004-tasks.md | Dev |
005-relatorio-tecnico.md | Dev |
006-relatorio-executivo.md | Dev |
Decisões de governança
- Abrir ADR: a IA, sozinha, pela regra de Tarefa ou ADR — ninguém
precisa pedir. O CEO e o Arquiteto aprovam o
001e decidem o quiz do003; podem também pedir uma ADR (ou recusar uma) a qualquer momento. - Criar tarefa no Gestor: quem quiser se organizar — o CEO, o Dev, o cliente (pela solicitação) ou a IA, quando ajuda a acompanhar. A tarefa é opcional: trabalho pequeno segue sem ela.
- Aprovar o plano (003): a IA propõe; o humano (Dev + Arquiteto) decide.
- Andar a tarefa: a IA move para Em andamento ao começar e para Revisão ao terminar a ADR; o Concluído é do dono (a IA o marca quando ele pede).
- Promover para a
main: segue a regra do projeto (por exemplo, aval do Arquiteto e do CEO); não é um portão fixo do Manifesto (ver Git e commits). - Update diário (feito / fazendo / bloqueios / risco): com o Gestor, é o próprio quadro (a
situação das tarefas, os comentários, os prazos); um resumo no Discord ou em outro canal é
opcional. O detalhe técnico vive no
004-tasks.mdda ADR.
Não há gates rígidos de aprovação burocrática. O controle vem da entrega obrigatória dos seis arquivos — sem eles, não há trabalho concluído.