O que é o Manifesto

O que é o Manifesto

O Manifesto é a metodologia única de desenvolvimento, criada por Joseph Trupel, usada em todos os projetos. Ele existe para que qualquer pessoa — humano ou IA — construa software do mesmo jeito, com a mesma estrutura, a mesma stack e o mesmo fluxo de decisão.

Não é um guia de sugestões. É um caminho só. Onde o Manifesto define uma regra, ela vale; onde ele recomenda, há liberdade. A diferença entre regra e recomendação está sempre explícita.

Para que serve

• Padronizar a forma de planejar, decidir, executar e entregar.
• Preservar memória técnica: toda decisão fica registrada e não se perde entre sessões.
• Acelerar com controle: a IA executa, o humano revisa, o repositório é a fonte da verdade.

AI First

O Manifesto assume que o desenvolvimento é conduzido por uma IA agente (Claude Code) operando sobre o repositório, com revisão humana. A IA é o executor central; o humano define o que importa, revisa e aprova. A fonte da verdade é sempre o filesystem do repositório — ferramentas externas (planilhas, Discord, Drive) são espelhos de visibilidade, nunca a origem das decisões.

Um fluxo só: tudo é ADR

Toda unidade de trabalho — de um módulo inteiro a um bugfix — nasce como uma ADR (Architecture Decision Record), uma pasta numerada em .specs/adr/ com seis arquivos fixos que percorrem o ciclo do trabalho: decisão executiva, recursos, plano, execução, relatório técnico e relatório executivo.

Não há épicos, specs avulsas, decision logs paralelos ou fluxos alternativos. Há a ADR. Ver Fluxo de ADR.

As três camadas de documentação

Camada	Onde vive	O que é
Manifesto	manifesto/	Esta metodologia. Universal, read-only nos projetos.
Padrões	manifesto/architecture/	Guias técnicos universais (não específicos de um projeto).
Projeto	.specs/ do projeto	ADRs, stack própria, models — gerados durante o desenvolvimento.

Neste boilerplate, a .specs/ já é real e viva: traz a ADR de fundação (001-fundacao-boilerplate) que montou o próprio repositório. Em cada projeto novo, a .specs/ continua dentro do repositório daquele projeto, acumulando as ADRs do seu desenvolvimento.