3. Fluxo de ADR · versão 2.0.0
Quem faz o quê
Um fato, um lugar (princípio 4). O que é útil no contexto do repositório mora na ADR, versionado com o código: a ADR serve para o agente ver o projeto. O que é útil para gerir mora no Gestor: o Gestor serve para o dono (e o agente) saber o que está sendo feito e para quando. Um mostra o do outro como espelho de leitura; nunca se escreve no espelho.
Sem o Gestor, tudo o que está na coluna “Gestor” simplesmente não existe (ou volta à conversa) — ver Sem o Gestor.
A matriz, fato a fato
| Fato | Mora em | Aparece também em (espelho) | Quem escreve |
|---|---|---|---|
| A tarefa (“o que fazer”) | Gestor | o texto do Executar | a pessoa; a IA pelo MCP; o cliente pela solicitação |
| Subtarefas | Gestor (subitens) | o passo do 004 que também é tarefa leva o identificador | a pessoa; a IA pelo MCP |
| Solicitação do cliente e a triagem | Gestor | a ADR cita o identificador, nunca o texto | o cliente escreve; a equipe tria |
| Prazo da tarefa, ciclo, prioridade, responsável | Gestor | — | a pessoa (a IA, quando pedem) |
| Coluna da tarefa (Em andamento, Revisão, Concluído) | Gestor | — | a IA move para Em andamento e Revisão; o dono para Concluído |
| Horas e a conversa com o cliente | Gestor | nunca na ADR | a equipe e o cliente |
A decisão (001), com a situação e os prazos do trabalho técnico | ADR | a Documentação do Gestor | a IA; a pessoa aprova |
O plano e o quiz (003) | ADR | a Documentação (ao cliente, só com a liberação) | a IA propõe; a pessoa decide |
A execução viva (004): passos com situação, decisões do caminho | ADR | o andamento da ADR na Documentação | a IA |
Os relatórios (005, 006) | ADR | a Documentação (o 006 ao cliente sempre) | a IA |
| O vínculo ADR ↔ tarefa (implementa, contexto) | Gestor | copiado no 005 ao fechar | a IA pelo MCP; a pessoa pela tela |
| O número da próxima ADR | Gestor (a reserva) | a pasta criada no repositório | o Gestor, quando a IA pede |
| O índice das ADRs | repositório (.specs/readme.md, enxuto, sem “próxima”) | a Documentação calcula o próprio | a IA |
| Os commits | git (com Tarefa: e ADR: no rodapé) | o Gestor os lê e mostra no item e na ADR, só à equipe, sem guardar | a IA |
| A liberação da parte técnica ao cliente | Gestor | — | o admin |
O fluxo de ponta a ponta
PEDIDO a pessoa fala com a IA, ou cria uma tarefa, ou o cliente manda uma solicitação │ (a tarefa é opcional) DECIDIR a IA aplica a regra de "Tarefa ou ADR": ├─ não mexe no código ......... tarefa no Gestor (se valer registrar), e pronto └─ mexe no código ............. acha a ADR vinculada ou aberta do assunto, ou cria uma: número reservado + esqueleto │ COMEÇAR vincula a ADR à tarefa (se há tarefa) e move a tarefa para Em andamento 001–003 escritos; a pessoa decide o que importa (o escopo, o quiz) │ EXECUTAR código + testes; o 004 vivo (passos com situação, decisões do caminho) commits com "Tarefa:" e "ADR:" no rodapé │ FECHAR 005 (com as tarefas vinculadas) + 006, o 001 Concluído, a linha do índice, os PDFs e o commit; o formato conferido │ REVISAR a IA move a tarefa para Revisão, com um comentário interno (a ADR e os commits) o dono confere e move para Concluído (ou pede à IA que mova)Sem tarefa, o fluxo é o mesmo sem as linhas do Gestor. Sem ADR (o trabalho não mexe no código), é só a tarefa — ou nada.
Três perguntas, três lugares
| Pergunta | Onde se responde |
|---|---|
| Por quê, e como foi feito no código? | na ADR |
| Em que pé está, e para quando? | no Gestor |
| O que mudou no código? | no git (e, citado pelo rodapé, no item do Gestor) |
O dono acompanha pelo Gestor: o item mostra a coluna, as ADRs vinculadas (abertas numa gaveta ao lado) e os commits que citam a tarefa. Quem quer o detalhe abre a ADR.