O problema
Em quase todo projeto de produto que vi, a verdade fica espalhada, com uma regra na ata de uma reunião, outra num comentário do design e outra só na cabeça de quem falou com o cliente. Quem desenha entende uma coisa, quem desenvolve constrói outra, e a diferença só aparece no teste, quando consertar já custa caro.
Com a IA no meio isso piorou, porque ela constrói rápido qualquer coisa que você pedir, inclusive a coisa errada, e com toda a confiança do mundo. O Atlas nasceu para resolver isso, como um lugar só onde o produto está escrito e que todo mundo lê e atualiza, gente ou IA, sem documentos paralelos.
Os pilares
Objetos antes de fluxos. Primeiro vêm as coisas que o produto manipula, o que elas são, por quais estados passam e quem pode fazer o quê com elas, e só depois vêm as jornadas. A regra mora no objeto e o fluxo só aponta para ela, porque toda cópia de uma regra vira uma segunda verdade, e é sempre a cópia que fica desatualizada.
Contradição à vista. A especificação e o protótipo ficam lado a lado, e quando os dois discordam a divergência fica registrada, com os dois lados, até alguém decidir, sem que ninguém resolva em silêncio.
Extrair, não inventar. Pergunta sem resposta vira uma definição pendente, com dono, e nada entra por chute, nem quando quem está escrevendo é a IA.
O texto descreve o agora. A página diz como o produto é hoje, e o que mudou, quando e por quê fica no histórico de versões, e não no meio do texto.
Como ele liga produto e desenvolvimento
Cada pessoa tem a sua parte e todas mexem no mesmo lugar, já que quem decide escreve as regras, quem desenha parte delas e devolve o protótipo para a mesma página, quem desenvolve implementa a partir dela e o teste confere o produto contra ela.
Para isso funcionar, cada parte do Atlas passa por fases, do rascunho até o entregue, e só avança quando atravessa um portão, então não dá para mandar para o design algo com decisão em aberto, nem para o desenvolvimento algo cujo protótipo ainda contradiz a especificação.
Antes de dar uma parte por pronta, ainda tem a auditoria de buracos, que é reler tudo como se fosse implementar no dia seguinte, procurando o que ficou sem resposta, e é ali que aparecem perguntas como “e se duas pessoas fizerem isso ao mesmo tempo?” ou “de que jeito se sai desse estado?”.
A IA entra em todas essas pontas e ajuda a documentar, a desenhar e a construir, sempre a partir do Atlas. Foi assim no Subasta, em que passei 45 minutos escrevendo o produto antes de qualquer tela e a IA construiu o resto em poucas horas sem precisar adivinhar nada.
Do Notion para o GitHub
O Atlas nasceu no Notion, porque era onde o time já trabalhava, e para escrever funcionou bem, só que a fragilidade apareceu na hora de atualizar.
O Notion guarda mal o passado, porque não mostra o que mudou entre duas datas nem quem mudou cada regra, e a gente acabava escrevendo o histórico dentro do próprio texto (“antes era assim, agora é assado”) até a página virar uma escavação. Com várias pessoas e uma IA mexendo ao mesmo tempo, ficava difícil saber qual versão tinha sido aprovada.
Em outubro de 2026 migramos para o GitHub, e cada produto ganhou o próprio repositório, com o versionamento guardando quem mudou, quando e por quê, o que deixou a página livre para descrever só o agora. Cada decisão vira um registro escrito para gente ler e cada rodada aprovada sobe a versão do Atlas, então quem cuida do cliente compara duas versões e quem desenvolve lê só o que mudou desde a última entrega.
Nem tudo foi junto, e os roteiros de teste chegaram a ir para o repositório, mas voltaram para o Notion, porque mudam a cada rodada de testes e quem os usa trabalha lá.
O dia a dia
Hoje uso o Atlas em três empresas, em projetos de tamanhos bem diferentes, e por isso um produto grande ganha o Atlas completo, enquanto um site simples ganha uma versão leve, só com o essencial, e o resto aparece quando precisar.
O que mais mudou foi a conversa com a IA, porque em vez de explicar o produto de novo a cada pedido eu aponto para o Atlas e ela lê as regras antes de mexer em qualquer coisa. Quando uma decisão muda, ela muda num lugar só, e todo mundo vê.
A pergunta que ainda não respondi é quanto aprofundar e quanto simplificar, já que um método detalhado demais ninguém segue e um simples demais não segura um produto de verdade, e venho ajustando isso a cada projeto.