Pular para o conteúdo

4. Stack · versão 2.0.0

Gestor

manifesto/03-stack/08-gestor.md

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 triagemO 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 tarefasDo item, a ADR abre numa gaveta ao lado; da ADR, as tarefas e o andamento
Os commits que citam a tarefa ou a ADRLidos do git na hora (nada guardado), no item e na página da ADR, só à equipe
A reserva do número da ADRSem colisão entre sessões paralelas; nunca reusado
Criar projetoO repositório a partir dos modelos, o projeto de tarefas e o espaço de desenvolvimento num passo
Espaços e ExecutarUma sessão do Claude Code num espaço, a partir de uma ou mais tarefas
O MCP do GestorA 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 regraO que o Gestor faz
Ler a tarefa e as ADRs vinculadasDevolve a tarefa com as ADRs (número, título, situação, papel e os caminhos)
Reservar o número de uma ADR novaDá o próximo número do repositório, reservado, e o esqueleto dos seis arquivos preenchido
Conferir o formatoConfere a pasta (os seis arquivos, os cabeçalhos, a situação, as seções, os links) antes do commit
Vincular (ou desvincular) a ADRGrava o vínculo com o papel: implementa ou contexto
Mover a tarefaEm andamento ao começar; Revisão ao terminar, com o comentário interno; Concluído quando o dono pede
ComentarO 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.