Cada cliente Amazing recebe um vault Obsidian com regras de negócio, decisões técnicas, contexto e specs. Tudo linkado, visual, navegável. O graph view mostra como cada peça se conecta. Os agentes consultam antes de cada task. O contexto não evapora.
Por que essa decisão foi tomada? Quem aprovou? Qual o histórico desse fluxo? Em projeto longo, essas perguntas viram rotina. A resposta costuma estar no cérebro de quem decidiu há seis meses, na thread de Slack que ninguém acha, ou nos comentários de um PR que ninguém abre mais.
O custo é grande: re-debate de decisões já tomadas, retrabalho por desconhecimento, onboarding que demora porque o contexto está disperso. Conhecimento que devia ser ativo da empresa fica capturado em silos pessoais.
Obsidian resolve isso com vault navegável, linkado e visual. Cada decisão tem nó. Cada nó tem porquê. O graph mostra como as peças se conectam.
Toda operação começa com a mesma estrutura: regras de negócio, decisões técnicas (ADRs), specs ativas, glossário de domínio, mapa de fluxos, histórico de incidentes.
Cada nota referencia outras com wikilinks. Spec aponta pra ADR. ADR aponta pra incidente que motivou. Decisão é navegável até a origem.
O graph mostra densidade de conexão. Áreas mal documentadas saltam visualmente. Decisões críticas viram hubs, navegação fica intuitiva.
Cada task começa com leitura do contexto relevante no vault. O agente sabe por que algo é como é, não só o que é.
--- id: ADR-014 date: 2026-04-07 status: accepted tags: [pix, idempotencia, bacen] --- # Idempotência por chave do pagador ## Decisão Usar chave única (CPF + recebedor + data) para garantir idempotência em criação de Pix Automático. ## Contexto A norma BACEN exige que chamadas duplicadas não criem agendamentos múltiplos. ## Alternativas consideradas - UUID gerado pelo cliente → rejeitado (cliente pode não enviar) - Hash do payload → rejeitado (sensível a reordenação JSON) ## Linkagem - spec: [[specs/pix-auto.qmd]] - regra: [[bacen/idempotencia]] - impacto em: [[ADR-007]], [[ADR-011]] ## Aprovado por - @product-banking - @compliance-bacen
O vault não substitui processo, ele torna processo persistente. Decisão tomada hoje vira contexto amanhã, sem depender de quem estava na reunião.
Novo membro entende projeto em dias, navegando o graph.
Decisões já tomadas raramente voltam para a mesa.
Quem decidiu, quando, por quê, com referência a documento.
Vault é seu. No fim do contrato, vai junto.
A diferença entre wiki que vira museu e vault Amazing é como ele é integrado na operação: agentes leem, sênior atualiza junto com o código, evolução é parte do ciclo, não tarefa extra.
Não é doc esquecida em pasta. É contexto ativo no input do agente em cada task.
Toda decisão técnica nasce como ADR no PR. Vault evolui no mesmo commit do código que documenta.
No encerramento do contrato, o vault vai junto. Conhecimento vira ativo permanente da sua empresa.
Em projetos com mais de 6 meses, o vault costuma ter 200+ ADRs e specs linkadas. Onboarding de novo membro do cliente cai pra dias.
Ver onboardingEm 30 minutos a gente compartilha um exemplo anonimizado e mostra como o graph view conta a história de um projeto inteiro.
