Depois que alguém escreve ou altera um ADR, uma spec, um épico, uma história ou um design
Procura pontos fracos, confere cada afirmação com a fonte e pergunta como o plano pode dar errado. Sem bajulação.
opus · max.projectstore / método / 1
Um ciclo com uma checagem independente dentro.
Agentes escrevem código rápido e, com a mesma rapidez, decidem de novo questões já resolvidas: toda sessão nova chega vazia. A solução não é um agente mais esperto. É reunir contexto → agir → verificar, aplicado ao projeto e não só ao código.
O ciclo
Oito passos. Dois deles são checagens feitas por um agente que não escreveu o rascunho.
- 01Você diz o que quer. O agente abre um artefato antes de abrir um editor.
- 02Um ADR quando algo precisa ser decidido, um épico e histórias para o trabalho, uma spec quando o “como” não é óbvio. Cada um é pré-visualizado e gravado com o seu sim.
- 03Um critic de contexto limpo, sem interesse no rascunho, ataca o texto. Espere um “revise”.
- 04Você aprova as correções. O artefato é marcado como revisado e vai para o backlog.
- 05Um agente pega uma história. O planner lê como os épicos anteriores entraram no código e diz onde esta mudança deve ficar.
- 06Código e testes, seguindo o plano da história.
- 07Um reviewer de contexto limpo confere o diff com cada critério de aceitação e pede evidência.
- 08Pronto, com evidência sob cada critério. O quadro, o grafo de vínculos e o mapa de código se regeneram.
Os agentes
6 agentes. Todos, menos um, só podem ler.
Os consultores verificam, planejam e organizam, sem mudar nada. Um único clerk salva só o que você aprovou, depois do seu Sim.
Antes de começar o trabalho em uma história (story plan)
Vê onde os épicos anteriores estão no código. Diz onde a mudança deve ficar, o que reaproveitar, com o que tomar cuidado e em que ordem trabalhar.
opus · maxDepois do código, antes do commit ou do story close
Pede evidência para cada critério de aceitação, inclusive os da spec. Depois verifica corretude, regressões e testes.
opus · maxDe tempos em tempos, antes de releases, depois que o vault cresce rápido
Encontra o que nenhuma regra pega: notas de pesquisa que contradizem um ADR aceito, duplicatas, vínculos faltando, documentos prontos para arquivamento.
opus · maxUma vez, depois de vincular uma base de código existente
Encontra decisões que ninguém registrou, no código, nos arquivos de configuração e no histórico do git. Sugere ADRs para elas, com evidência.
opus · maxSó dentro do fluxo de um comando, só depois do seu Sim
Salva exatamente o que você aprovou, nada mais. Depois reconstrói o quadro e roda as verificações. Não escreve nada por conta própria e não pergunta nada.
sonnet · maxOs modelos padrão são os do Claude Code. No Codex, cada papel é uma skill de mesmo nome que pede ao Codex para iniciar o papel, como $projectstore-critic para o critic; ele usa o modelo da sessão, a menos que você defina outro.
As proteções
Mecanismos sustentam o processo, não a disciplina.
Sem história, um lembrete
Um agente que começa a editar código sem nenhuma história aberta é lembrado de abrir uma. Uma mudança do tamanho de uma funcionalidade começa no vault.
O que não foi revisado fica marcado
Um artefato que precisa de revisão leva review_status: pending até que uma rodada do critic seja aplicada. “Ainda não revisado” é um estado que as ferramentas conseguem ler, não algo de que alguém precise se lembrar.
Um doctor sem IA
O doctor verifica de forma determinística a consistência mecânica do vault. No CI, roda sem agente e sem tokens.
Onde olhar, gerado
O graph.md guarda os vínculos de cada artefato nos dois sentidos; o code-map.md diz onde está o código de cada épico. Antes de uma escolha de arquitetura, o agente é levado primeiro ao índice de ADRs.
Depois do /compact, o vault volta
No Claude Code, depois de um /compact executado por você, a sessão recomeça com a orientação do vault e com os arquivos do vault que a conversa tocou antes dele.
Uma segunda sessão é avisada
Uma sessão que começa enquanto outra trabalha no mesmo vault abre com um aviso de várias sessões: busque antes de criar qualquer coisa nova.
Pronto quer dizer provado
Uma história fecha com evidência sob cada critério.
--- type: story epic: "CHECKOUT" title: "Cartões salvos aparecem no checkout" status: done code_refs: ["src/billing/cards/", "tests/cards.test.ts"] closed_at: "2026-07-14T16:02:11Z" --- ## Acceptance Criteria - [x] Cartões salvos aparecem primeiro — evidence: tests/cards.test.ts:21 - [x] Um cartão recusado mostra o motivo do banco — evidence: tests/cards.test.ts:58 - [x] Nenhum número de cartão chega aos logs — evidence: tests/cards.test.ts:73
O planner disse onde a mudança deve ficar antes do código, e o plano entrou na história com o seu sim; o reviewer conferiu o diff com cada critério depois. Cada linha de prova é um teste, um comando que rodou ou uma linha de código.
Qualquer agente pode ler este registro, com ou sem o plugin: pela CLI, que responde em JSON e não gasta tokens, ou pelas 8 ferramentas somente leitura do servidor MCP.
- orientation
- search
- status
- get_artifact
- lineage
- neighbors
- code_refs
- doctor
Letras miúdas
Letras miúdas
- Rodar o ciclo gasta tokens: os rascunhos, o critic e o reviewer rodam no modelo que você já paga. O README mede isso.
- No Claude Code, o critic e o reviewer são agentes separados, de contexto limpo. No Codex, os papéis são skills.
- O ProjectStore é contexto compartilhado do projeto e uma forma de trabalhar. Não é um orquestrador de agentes: iniciar agentes é tarefa do seu harness.