4. Stack · versão 2.0.0
Gestor
O Gestor de Projetos é a ferramenta de gestão do jhow.net, e o Manifesto é escrito para ser usado com ele. Ele é recomendado, não obrigatório: o método funciona inteiro sem ele (ver Sem o Gestor). O que ele guarda e o que fica no repositório está em Quem faz o quê.
O que o Gestor dá ao método
| O quê | Para quê |
|---|---|
| Projetos e tarefas (com subitens, ciclos, prazos e o quadro) | O controle do dono: o que fazer, para quando, em que pé |
| Solicitações do cliente, com triagem | O pedido do cliente vira tarefa sem passar pelo chat |
| Documentação (as ADRs lidas do repositório) | A equipe e o cliente leem as ADRs sem abrir o git; o cliente lê o 001 e o 006 sempre e o resto com a liberação |
| ADRs vinculadas às tarefas | Do item, a ADR abre numa gaveta ao lado; da ADR, as tarefas e o andamento |
| Os commits que citam a tarefa ou a ADR | Lidos do git na hora (nada guardado), no item e na página da ADR, só à equipe |
| A reserva do número da ADR | Sem colisão entre sessões paralelas; nunca reusado |
| Criar projeto | O repositório a partir dos modelos, o projeto de tarefas e o espaço de desenvolvimento num passo |
| Espaços e Executar | Uma sessão do Claude Code num espaço, a partir de uma ou mais tarefas |
| O MCP do Gestor | A porta da IA para tudo isso |
O MCP do Gestor
A IA fala com o Gestor sempre pelo MCP do Gestor: nos espaços de desenvolvimento, ele já vem configurado; fora deles, a pessoa gera um token pessoal no Gestor e o adiciona ao Claude Code. As instruções do servidor MCP trazem a regra de Tarefa ou ADR lida deste Manifesto, e dizem qual ferramenta faz cada ação da regra. As ações:
| Ação da regra | O que o Gestor faz |
|---|---|
| Ler a tarefa e as ADRs vinculadas | Devolve a tarefa com as ADRs (número, título, situação, papel e os caminhos) |
| Reservar o número de uma ADR nova | Dá o próximo número do repositório, reservado, e o esqueleto dos seis arquivos preenchido |
| Conferir o formato | Confere a pasta (os seis arquivos, os cabeçalhos, a situação, as seções, os links) antes do commit |
| Vincular (ou desvincular) a ADR | Grava o vínculo com o papel: implementa ou contexto |
| Mover a tarefa | Em andamento ao começar; Revisão ao terminar, com o comentário interno; Concluído quando o dono pede |
| Comentar | O comentário interno de fechamento (a ADR, os commits, o que ficou de fora) |
O Gestor nunca escreve no repositório: quem escreve as ADRs e commita é a IA, no espaço ou na máquina da pessoa. Também nunca guarda o conteúdo de uma ADR: ele o lê do repositório.
A branch e o repositório que o Gestor lê
O Gestor lê a branch cadastrada para o repositório do projeto (a mesma que o cliente vê). Um projeto com mais de um repositório escolhe, na Documentação, qual deles é a fonte das ADRs. A ADR que ainda não chegou a essa branch se vincula pelo número reservado.
Usar o Gestor num projeto
O caminho de um projeto novo é o Criar projeto do Gestor. Num projeto que já existe: cadastrar
o projeto e o repositório no Gestor, configurar o MCP do Gestor no Claude Code e tirar do
CLAUDE.md e do .specs/readme.md qualquer “a próxima ADR é a…”. As ADRs que já existem não mudam.