Glossário

Termos da metodologia. O glossário de domínio (cliente, pedido, projeto, etc.) é próprio de cada projeto — o manifesto apenas orienta sua criação, ele vive em .specs/stack/ do projeto.

Termo	Significado
ADR	Architecture Decision Record. A unidade do trabalho que mexe no código: pasta numerada em .specs/adr/ com seis arquivos — o contexto do repositório e a execução viva.
Os seis arquivos	001-executive, 002-resources, 003-plan, 004-tasks, 005-relatorio-tecnico, 006-relatorio-executivo.
Tarefa	Um item do Gestor (a tela Tarefas, o quadro): o controle do que fazer, com coluna, prazo, ciclo e responsável. É opcional. Até a 1.x, “task” era o item técnico do 004; agora esse é o passo.
Subtarefa	Um subitem de uma tarefa no Gestor.
Passo	Um item técnico do 004-tasks.md de uma ADR (T1, T2…), com situação (todo / doing / done / blocked). Recomenda-se 1 passo = 1 commit. O passo que também é tarefa leva o identificador dela ao lado (KBP-12). O nome do arquivo 004-tasks.md não muda.
Execução viva	O 004 mantido em dia durante o trabalho: os passos com a situação, as decisões do caminho e a estratégia da IA.
Vincular	Associar uma ADR a uma tarefa do Gestor, com um papel: implementa (a tarefa executa a ADR) ou contexto (só a lê). O vínculo mora no Gestor e é copiado no 005 ao fechar.
Reserva de número	O número de uma ADR nova dado pelo Gestor, sem colisão entre sessões paralelas e nunca reusado. Sem o Gestor: o maior + 1.
Orquestração autônoma	A IA decide sozinha, pela regra de Tarefa ou ADR, se o trabalho é ADR, acha ou cria a ADR, vincula e anda a tarefa — sem a pessoa pedir cada passo.
Gestor	O Gestor de Projetos, a ferramenta de gestão recomendada do método: projetos, tarefas, ciclos, horas, solicitações, a documentação das ADRs e os espaços. Ver Gestor.
MCP do Gestor	A porta da IA para o Gestor: tarefas, ciclos, as ADRs vinculadas, a reserva de número, o esqueleto e a conferência do formato.
Solicitação	O pedido de um cliente no Gestor, que vira tarefa depois da triagem.
Ciclo	O período de trabalho de um projeto no Gestor, com as tarefas dele.
Quiz	O conjunto de perguntas decididas no 003-plan.md, em formato ( )/(X) com alternativas, escolha e justificativa.
Plan mode	Modo da IA em que ela planeja e pergunta antes de executar; perguntas e respostas são registradas na ADR.
Manifesto	Esta metodologia (pasta manifesto/), universal. Muda só na origem (o repositório jhowdev), por ADR, com versão em VERSION; nos projetos é read-only.
manifesto:pull	O comando que traz a versão nova do Manifesto do jhowdev para um projeto: troca a pasta e mostra o diff, sem commitar.
Modelos de projeto	Os pontos de partida de um repositório novo (Vazio, Manifesto e Monorepo), gerados por pnpm boilerplate:build no jhowdev (ADR 076 de lá).
Kit de ferramentas	Os scripts que todo projeto traz (banco local, backup, restauração, compartilhamento, e-mail, armazenamento, PDFs) — ver Ferramentas padrão.
Padrões	Guias técnicos universais em manifesto/architecture/.
.specs/stack	Stacks e decisões técnicas próprias de um projeto, adicionais à stack universal.
Estratégia da IA	Abordagem de execução: agente único, subagentes, agentes exploradores, paralelismo em massa.
Smoke test	Verificação rápida e pronta para rodar dos fluxos principais — focada na API.
Orquestrador	O agente principal (a sessão que conversa com o dono): distribui as frentes, é o único que opera o banco principal (migrations, seeds, schema) e integra uma frente de cada vez — ver Orquestração de agentes.
Teammate	Agente secundário que trabalha numa frente conversando com o orquestrador, no seu worktree, com porta e banco de teste próprios; para o trabalho longo, ajustado no caminho. Não toca o banco principal nem faz push.
Workflow	Execução roteirizada de vários agentes, com etapas fixas (implementar → revisão adversarial contra as palavras do dono → integrar); para um lote de ADRs bem definidas. Ninguém conversa no meio; nenhum agente dele faz push.
OpenAPI	Spec do contrato da API, derivado dos schemas Zod.
Scalar	Interface interativa de testes da API (“powered by Scalar”), servida a partir do spec OpenAPI.