Pular para o conteúdo

3. Fluxo de ADR · versão 2.0.0

Quem faz o quê

manifesto/02-fluxo-adr/05-quem-faz-o-que.md

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

FatoMora emAparece também em (espelho)Quem escreve
A tarefa (“o que fazer”)Gestoro texto do Executara pessoa; a IA pelo MCP; o cliente pela solicitação
SubtarefasGestor (subitens)o passo do 004 que também é tarefa leva o identificadora pessoa; a IA pelo MCP
Solicitação do cliente e a triagemGestora ADR cita o identificador, nunca o textoo cliente escreve; a equipe tria
Prazo da tarefa, ciclo, prioridade, responsávelGestor—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 clienteGestornunca na ADRa equipe e o cliente
A decisão (001), com a situação e os prazos do trabalho técnicoADRa Documentação do Gestora IA; a pessoa aprova
O plano e o quiz (003)ADRa 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 caminhoADRo andamento da ADR na Documentaçãoa IA
Os relatórios (005, 006)ADRa Documentação (o 006 ao cliente sempre)a IA
O vínculo ADR ↔ tarefa (implementa, contexto)Gestorcopiado no 005 ao fechara IA pelo MCP; a pessoa pela tela
O número da próxima ADRGestor (a reserva)a pasta criada no repositórioo Gestor, quando a IA pede
O índice das ADRsrepositório (.specs/readme.md, enxuto, sem “próxima”)a Documentação calcula o próprioa IA
Os commitsgit (com Tarefa: e ADR: no rodapé)o Gestor os lê e mostra no item e na ADR, só à equipe, sem guardara IA
A liberação da parte técnica ao clienteGestor—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

PerguntaOnde 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.