Clone o segundo cérebro
da sua agência
Este guia ensina a metodologia completa por trás do wiki que a ClickGrowth usa pra guardar histórico de cliente, benchmark de segmento e regras de automação de campanha Google/Meta Ads — e termina com o prompt pronto pra você colar no Claude Code e construir a sua versão do zero.
Tudo começa com um artigo
Cada pasta, cada regra e cada convenção deste sistema é uma implementação direta de um conceito chamado Wiki LLM. Entender essa ideia é entender o porquê de tudo o que vem depois.
"Em vez de simplesmente recuperar informações de documentos brutos no momento da consulta, o LLM constrói e mantém incrementalmente um wiki persistente — uma coleção estruturada e interligada de arquivos Markdown. O conhecimento é compilado uma única vez e mantido atualizado, não sendo derivado novamente a cada consulta."
Artigos, transcrições, dados brutos. Fonte de verdade permanente.
raw/articles, transcripts, notes, assets
Resumos, entidades, conceitos, comparações e síntese. O LLM cria, atualiza e mantém consistência.
wiki/clients, segments, sources, entities, concepts, benchmarks, campaigns, analyses
Documento que descreve estrutura, convenções e fluxos de trabalho para o LLM.
CLAUDE.mdidentidade, formatos, fluxos, regras, comandos
A analogia central — aplicada de forma literal
"Deixo o agente do LLM aberto numa janela e o Obsidian na outra. O LLM edita com base na nossa conversa, e eu navego pelos resultados em tempo real. O Obsidian é a IDE; o LLM é o programador; a wiki é a base de código."
A filosofia antes das pastas
Toda agência acumula conhecimento todo dia — em calls, testes, relatórios, erros que não deveriam se repetir. O problema é que esse conhecimento some: fica na cabeça de uma pessoa, num doc solto, num relatório que ninguém mais abre.
Conhecimento persistente
Cada reunião, cada teste, cada insight vai pro wiki — não pra um doc solto, pra um grafo que nunca some entre sessões.
Conhecimento interligado
Um insight de um cliente pode valer pra três outros do mesmo segmento. Links internos tornam isso possível.
Consultável por IA
O Claude lê o wiki como contexto antes de qualquer tarefa — como briefar um analista que já sabe o histórico todo.
Obsidian é o container ideal
Obsidian não é só editor de notas — é uma engine de links bidirecionais sobre arquivos .md locais. Perfeito como camada de visualização: enquanto o Claude escreve, o Obsidian conecta.
📄 Tudo em Markdown
Arquivos .md são texto puro, sem lock-in, legíveis por qualquer ferramenta e processáveis nativamente por LLMs.
- Legível sem software especial
- Versionável via git se necessário
- Frontmatter YAML pra metadados estruturados
🔗 Links bidirecionais [[page]]
Ao escrever [[cliente-x]] em qualquer página, o Obsidian cria referência bidirecional automática — você vê quem aponta pra onde.
[[benchmarks/home-service-usa]] → [[clients/cliente-a]]
[[sources/pesquisa-meta-ads]] → [[concepts/framework-trafego]]
🗺️ Graph View
Todos os links viram um grafo visual interativo — dá pra ver em segundos quais clientes têm mais conexão, quais conceitos são hub.
- Detecta páginas órfãs (sem link nenhum)
- Mostra clusters por segmento
- Identifica hubs de conhecimento
💾 Arquivos locais
O vault é uma pasta local comum. Sem servidor, sem conta — sincronizável via OneDrive, Dropbox ou git como qualquer pasta.
- Zero dependência de nuvem proprietária
- Claude Code acessa direto no sistema de arquivos
Cada pasta tem uma função precisa
A estrutura não é arbitrária — cada nível resolve um problema específico de organização de conhecimento.
Não é documentação pra humano — é o sistema operacional do Claude. Define identidade, formatos de página, fluxos de trabalho e regras de qualidade. Lido no início de toda sessão.
Lista plana de todas as páginas com uma linha de descrição — o sumário do segundo cérebro.
Registro cronológico append-only: fontes ingeridas, clientes criados, análises geradas. Nunca se apaga, só cresce.
Artigos copiados, transcrições, notas cruas, PDFs. Nunca editados — matéria-prima que o Claude lê, processa e escreve em wiki/.
Tudo que o Claude escreve e mantém, dividido por tipo de conhecimento.
perfil, reunioes, acoes, resultados.Relatórios HTML, planos, apresentações — tudo gerado a partir do wiki, nunca o contrário.
Scripts e configuração que coletam dados via Meta Graph API e Google Ads API e alimentam resultados.md e campaigns/ automaticamente.
Da fonte bruta ao insight cruzado
Cada informação percorre um caminho fixo: fonte bruta vira raw/, processamento vira wiki/, produto vira outputs/. Sem atalho.
🎙️ Transcrição de call
Gravação ou notas de reunião com cliente
📰 Artigo / pesquisa
Conteúdo externo, estudos de caso
📊 Dados de API
Meta Ads, Google Ads, outras plataformas
Arquivamento da fonte original — nunca editar
Vai pra raw/transcripts/, raw/articles/ ou raw/notes/ exatamente como chegou. Se precisar reverificar, o original está ali intacto.
Ingestão e síntese
Identifica cliente(s) e segmento afetado, extrai insights e próximos passos, cria links pras páginas relacionadas.
📄 Página da fonte
Resumo, insights e conexões com o grafo
📁 Workspace do cliente
Reuniões, ações e resultados atualizados
🔗 Segmento atualizado
Padrões cruzados entre clientes do nicho
Produto final gerado a partir do wiki
Relatórios, planos e apresentações são gerados consultando o wiki — o histórico já está lá, o output é só a renderização pra fora.
O que nunca muda
Seis regras garantem a integridade do sistema. Quebrar qualquer uma degrada a confiabilidade do wiki inteiro.
🔒 Raw é sagrado
Nenhum arquivo em raw/ é editado pelo Claude, jamais. Se o dado mudar, cria versão nova — nunca sobrescreve.
✅ criar raw/transcript-v2.md
📋 index.md + log.md sempre atualizados
Toda operação termina com index catalogado e log registrado — senão o mapa fica desatualizado.
🔗 Links no formato Obsidian
Toda referência usa [[Nome da Página]] — nunca caminho relativo. É o único formato que o graph view processa.
❌ ../clients/x/acoes.md
⚠️ Contradições são explicitadas
Informação nova que contradiz o wiki: anota as duas versões com data. A antiga não se apaga.
📐 Padrão de segmento exige 2+ clientes
Observação de um único cliente é hipótese. Só vira padrão de segmento confirmada em 2 ou mais.
🚫 Nunca criar página redundante
Verificar o index antes de criar página nova. Informação fragmentada em dois lugares fica desatualizada nos dois.
Duas linhas nunca se tocam direto
Dois clientes nunca se ligam entre si. Eles se ligam porque os dois apontam pro mesmo hub — um nó intermediário com propósito semântico: segmento, campanha, fonte ou conceito.
"Como você faz todas as relações de similaridade entre dois clientes? Cada conexão precisa ser criada com um propósito. As linhas que conectam no Obsidian me deixaram doido em como você estrutura."
Hub de segmento
O mais poderoso. Todos os clientes do mesmo nicho apontam pra cá — agrega o que funciona e o que não funciona, validado em 2+ clientes.
Hub de campanha
Um criativo ou estratégia testada. Guarda resultados por cliente — se outro cliente usar o mesmo formato, o benchmark já está aqui.
Hub de fonte
Artigo ou benchmark externo relevante pra múltiplos clientes. Uma ingestão pode conectar 3 clientes diferentes.
Hub de conceito
Estratégia ou metodologia usada em vários clientes — inclusive de segmentos diferentes que usam o mesmo framework.
Como o Claude usa isso na prática
Você pede um briefing de cliente
Ex.: /prep-reuniao cliente-b
Lê o workspace do cliente
Abre perfil.md, reunioes.md, acoes.md — histórico completo deste cliente.
Segue o link pro segmento
Encontra [[segments/medicina-integrativa]] e lê a página — que já tem padrões validados nos outros clientes do nicho.
Segue links secundários
Fontes, benchmarks e campanhas linkadas no segmento — tudo já processado e pronto.
Gera o briefing com contexto cruzado
Inclui o histórico do cliente + o que funcionou nos outros do mesmo segmento — porque os links já apontavam pra lá.
[[segmento]] em acoes.md/segmentoUma linha por pasta
Referência rápida: o que cada componente é, quem escreve e pra que serve.
| Caminho | Quem escreve | Para que serve |
|---|---|---|
| CLAUDE.md | Você (uma vez) | Define comportamento do Claude em toda sessão |
| index.md | Claude (automático) | Mapa de todas as páginas — pré-requisito de consulta |
| log.md | Claude (append) | Linha do tempo de todas as operações realizadas |
| raw/ | Você (cola/salva) | Fontes originais — nunca editada |
| wiki/clients/ | Claude (atualiza) | Histórico completo por cliente |
| wiki/segments/ | Claude (sintetiza) | Padrões validados em 2+ clientes do mesmo segmento |
| wiki/sources/ | Claude (ingestão) | Resumo de cada fonte externa — conecta raw ao wiki |
| outputs/ | Claude (gera) | Entregáveis finais: relatórios, planos, apresentações |
| automacao-ads/ | Scripts (API) | Coleta dados das plataformas de ads e alimenta o wiki |
Automação de campanhas Google + Meta Ads
O mesmo wiki que guarda histórico de cliente também guarda credenciais e regras de automação. Isso é o que separa "o Claude sabe editar uma campanha" de "o Claude sabe editar a campanha certa, com a permissão certa, sem quebrar nada".
Um arquivo de referência, nunca um raw/, com token/conta por cliente — o Claude cruza pelo nome do cliente antes de qualquer chamada e nunca pede uma credencial que já está na tabela.
| Cliente | Ad Account | Moeda |
| Cliente A | act_XXXXXXXXXX | BRL |
Google Ads — MCC: XXXXXXXXXX
| Cliente | Google Ads ID | Moeda |
| Cliente A | XXXXXXXXXX | BRL |
🧭 Fluxo obrigatório
Toda campanha nova segue: discutir hipótese → escrever plano → executar. Nunca pular direto pra execução.
⏸️ Sempre rascunho ou pausada
Nenhuma campanha sobe ativa sozinha. O Claude cria pausada e pede aprovação explícita antes de ativar.
✅ Checklist técnico pré-ativação
Orçamento, geo, negativos, tracking/pixel e conformidade de política revisados antes do "ON".
🔐 Verificar autenticação antes de escrever
Toda chamada de API confirma que o token/credencial ainda é válido antes de criar ou editar algo.
🔁 Fallback de permissão
Se a credencial de leitura não tiver permissão de escrita numa conta específica, usar a credencial de fallback documentada — nunca improvisar.
📝 Log obrigatório
Toda mudança de orçamento, pausa ou ativação é registrada em log.md com cliente, data e motivo.
- Headline tem limite de 30 caracteres, descrição de 90 — o Claude precisa validar antes de enviar, a API rejeita silenciosamente em alguns casos.
- Número de telefone no texto do anúncio viola política — use call assets, não copy.
- Orçamento compartilhado entre campanhas exige um recurso de "shared budget" próprio antes de vincular a campanha.
- Enums de região/idioma variam por mercado — o mesmo código pode não existir fora de certas áreas.
- Acesso de escrita via API muitas vezes exige aceitar os Termos de Serviço numa call com o suporte do Google antes de liberar.
- Sempre validar o token com
GET /me?access_token=TOKENantes de qualquer operação de escrita. - Um Business Manager pode ter token com leitura mas escrita limitada em contas específicas — documentar exceção por conta, não assumir que vale pra todas.
- Erros de permissão (ex.: código 4841020 ou 2490591) indicam trocar pro token de fallback, não repetir a chamada.
Do zero ao primeiro cliente cadastrado
Sequência real de instalação — siga na ordem, cada passo depende do anterior.
Instalar o Obsidian
Baixar em obsidian.md, abrir e escolher "Abrir pasta como vault" — pode ser uma pasta vazia nova.
Instalar e logar o Claude Code
Instalar o CLI, rodar claude dentro da mesma pasta escolhida como vault, e autenticar com sua conta.
Abrir a pasta no VS Code (opcional, recomendado)
Facilita ver a estrutura de arquivos crescendo em tempo real enquanto o Claude escreve.
Colar o prompt inicial
Copiar o prompt da seção 10 — O prompt inicial direto no terminal do Claude Code.
Responder as perguntas guiadas
Nome da agência, segmentos, clientes atuais, plataformas de anúncio, sua função — o Claude entrevista antes de criar qualquer arquivo.
Revisar a estrutura gerada no Obsidian
Voltar pro Obsidian, abrir o Graph View e conferir se as pastas e os primeiros links aparecem certos.
Preencher as credenciais reais
Substituir os placeholders de wiki/references/credenciais-apis.md pelos tokens e IDs reais das suas contas.
Primeiro comando real
Rodar /status pra confirmar que tudo foi criado, ou /novo-cliente pra cadastrar o próximo.
Rotina de manutenção
Ingerir fontes conforme chegam, registrar reunião logo após cada call, rodar /lint mensalmente pra achar página órfã ou cliente sem contato há 30 dias.
Cole isso no Claude Code pra começar
Versão robusta — funde o artigo original de Wiki LLM (a ideia, a arquitetura em 3 camadas, as operações de ingestão/consulta/manutenção) com o fluxo prático de setup pra agência (entrevista guiada, fases de execução, regras de automação de campanha). Autocontido: cole inteiro num agente novo, mesmo que ele nunca tenha visto esta página.
## [YYYY-MM-DD] tipo | título. Assim eu consigo rodar algo como grep "^## \[" log.md | tail -5 e ver as últimas 5 operações sem te perguntar nada.
Ferramentas opcionais — não construir agora, só ter em mente pro futuro
- Motor de busca local quando a wiki passar de ~100 fontes e o index.md sozinho não bastar mais (ex.: qmd — busca híbrida BM25/vetorial com CLI e servidor MCP, tudo local).
- Obsidian Web Clipper pra transformar artigo da web em Markdown direto na pasta raw/articles/.
- Download local de imagem (Configurações do Obsidian → Arquivos e Links → pasta de anexo fixa em raw/assets/) pra você conseguir visualizar imagem referenciada, já que não lê Markdown com imagem embutida numa passagem só.
- Graph View do Obsidian pra eu enxergar hub e página órfã de relance.
- Marp pra gerar apresentação de slide direto de conteúdo da wiki, quando eu pedir.
- Plugin Dataview se você adicionar frontmatter YAML consistente (tags, data, contagem de fonte) — daí dá pra gerar tabela e lista dinâmica.
- A wiki inteira é só uma pasta de Markdown — posso versionar com git se eu quiser histórico e branch, isso não muda nada do seu funcionamento.
Agora, construa a minha versão
Antes de criar qualquer arquivo, me faça estas perguntas, uma de cada vez, esperando minha resposta antes de seguir pra próxima:
1. Nome da minha agência.
2. Quais segmentos de cliente eu atendo — de 1 a 5, cada um com nome e slug kebab-case (ex.: "medicina-integrativa").
3. Quais clientes eu já tenho hoje — nome de cada um e a qual segmento pertence.
4. Quais plataformas de anúncio eu opero — Google Ads, Meta Ads, ambas ou outra. Preciso disso pra montar o arquivo de credenciais e as regras de automação certas.
5. Meu nome e minha função na agência.
6. Se já existe uma pasta de Obsidian/vault ou se é tudo do zero.
7. Se eu já quero configurar um motor de busca local (ex.: qmd) desde já, ou se começamos só com index.md e adicionamos busca depois, quando a wiki crescer.
Depois que eu responder tudo, execute nesta ordem, sem pular etapa e sem pedir confirmação extra entre elas:
FASE 1 — Estrutura de pastas
Criar, na pasta atual:
CLAUDE.md
index.md
log.md
raw/articles/ raw/transcripts/ raw/notes/ raw/assets/
wiki/clients/
wiki/segments/
wiki/entities/clients/ wiki/entities/contacts/ wiki/entities/competitors/
wiki/concepts/
wiki/sources/
wiki/benchmarks/
wiki/campaigns/
wiki/analyses/
wiki/references/
outputs/
automacao-ads/
Para cada cliente da pergunta 3: criar wiki/clients/[slug]/ com perfil.md, reunioes.md, acoes.md, resultados.md, e wiki/entities/clients/[slug].md.
FASE 2 — CLAUDE.md
Gerar o CLAUDE.md completo com: identidade e missão do agente (nome da agência, papel de escritor/mantenedor do wiki — nunca decide sozinho, sempre escreve e propõe), a lista de segmentos com slugs, os formatos de página com frontmatter YAML para perfil de cliente, log de reuniões, plano de ações, resultados, entidade de cliente, análise de segmento, benchmark, campanha e fonte — todos linkados via [[Nome da Página]] no padrão Obsidian. Incluir as 3 operações (ingestão, consulta, verificação periódica) como fluxos de trabalho com comando: /ingerir, /novo-cliente, /reuniao [cliente], /consultar [pergunta], /segmento [nome], /lint, /status. Incluir as convenções (kebab-case sem acento nos arquivos, datas YYYY-MM-DD, links Obsidian, prefixo padronizado no log.md) e as regras de qualidade abaixo. Deixar explícito no próprio arquivo que ele é um documento vivo, pra revisarmos juntos conforme o uso real da agência mostrar o que falta.
FASE 3 — Regras de negócio: automação de campanhas
Criar wiki/references/credenciais-apis.md como template, sem token real, com placeholders SEU_TOKEN_AQUI, contendo: tokens Meta por Business Manager, tabela cliente ↔ ad account ↔ moeda, MCC do Google Ads, tabela cliente ↔ ID Google Ads, regra de qual credencial usar pra leitura vs escrita, e o comando de verificação curl "https://graph.facebook.com/v20.0/me?access_token=TOKEN".
Criar wiki/references/regras-automacao-campanhas.md com estas regras fixas:
- Toda campanha nova segue o fluxo: discutir hipótese → escrever plano → executar. Nunca pular direto pra execução.
- Toda campanha é criada como rascunho ou pausada. Nunca ativa sozinha — sempre pede minha aprovação explícita antes de ativar.
- Checklist obrigatório antes de qualquer ativação: orçamento correto, geo correto, palavras negativas, tracking/pixel instalado, conformidade de política da plataforma.
- Toda chamada de API verifica autenticação antes de escrever.
- Toda mudança de orçamento, pausa ou ativação é registrada no log.md com cliente, data e motivo.
FASE 4 — index.md e log.md
Popular o index.md com a lista de todas as páginas criadas, organizada por categoria. Criar a primeira entrada no log.md já no formato padronizado: "## [data de hoje] setup | Wiki LLM inicializado | agência: [nome]".
FASE 5 — Confirmação
No final, me mostrar a árvore de pastas criada, quantos arquivos, e perguntar qual vai ser minha primeira tarefa: ingerir uma fonte, cadastrar um cliente novo, ou preencher as credenciais reais de API.
Regras permanentes — valem pra toda sessão futura nesta pasta, não só pra hoje
- Nunca editar nada dentro de raw/.
- Sempre atualizar index.md e log.md depois de qualquer operação, com o log.md usando o prefixo padronizado.
- Preferir atualizar uma página existente a criar uma nova redundante.
- Links internos sempre no formato [[Nome da Página]].
- Contradições nunca são apagadas — anotar as duas versões com data.
- Um padrão de segmento só vira afirmação com evidência em 2 ou mais clientes.
- Toda ação de campanha nova é sempre rascunho ou pausada até eu aprovar.
- Boa resposta de consulta vira página nova no wiki quando eu confirmar que vale a pena — não fica presa só no chat.
- De tempos em tempos, sem eu precisar pedir, sugira rodar uma verificação de saúde no wiki se perceber sinal de contradição ou página abandonada.
# Nota: isto é um ponto de partida, não uma especificação fechada. Estrutura exata, formato de página e ferramenta vão depender do meu domínio — desenvolva os detalhes em colaboração comigo ao longo do tempo, não tudo de uma vez agora.Antes de chamar de pronto
Confirme cada item antes de considerar o setup concluído.
raw/, wiki/, outputs/, automacao-ads/)wiki/references/credenciais-apis.md, sem placeholder esquecido/novo-cliente/ingerir/lint, quando revisar index.md