Treinamento ClickMav Machine

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.

Obsidian como motor de links
Claude Code como escritor
Raw → Wiki → Output
Automação Google + Meta Ads

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.

Ideia central — Wiki LLM
"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."
Não é RAG. É um segundo cérebro que cresce e se mantém entre sessões — o histórico de raciocínio nunca se perde quando o chat acaba.
O que a maioria faz — RAG
Documentos brutos → busca vetorial → resposta gerada na hora
O LLM redescobre o conhecimento do zero a cada pergunta
Nada se acumula — o raciocínio se perde quando o chat fecha
ChatGPT, NotebookLM e upload de arquivo funcionam assim
O que este sistema faz — Wiki LLM
Fontes brutas → processamento → wiki persistente interligado
Síntese compilada uma vez — consultada infinitas vezes
Cada ingestão enriquece o wiki — conhecimento acumula
Referências cruzadas já existem — contradições já ficam sinalizadas
As 3 camadas do artigo → como viram pastas reais
Camada
Descrição original
Implementação
1. Fontes originais
Imutáveis — o LLM lê, nunca modifica

Artigos, transcrições, dados brutos. Fonte de verdade permanente.

raw/

articles, transcripts, notes, assets

2. O wiki
Markdown gerado e mantido só pelo LLM

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

3. O esquema
Configura o LLM como mantenedor disciplinado

Documento que descreve estrutura, convenções e fluxos de trabalho para o LLM.

CLAUDE.md

identidade, 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."
IDE: Obsidian — você lê, navega no grafo, segue links
Programador: Claude Code — escreve e mantém consistência
Base de código: wiki/ — cresce a cada sessão

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.

memória volátilwiki permanente
🔗

Conhecimento interligado

Um insight de um cliente pode valer pra três outros do mesmo segmento. Links internos tornam isso possível.

docs isoladosgrafo de links

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.

reexplicar tudocontexto imediato

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.

🗺️ 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.

📁minha-agencia/
├─CLAUDE.mdcérebro
├─index.mdmapa
├─log.mdtimeline
├─📁raw/imutável
├─📁articles/
├─📁transcripts/
├─📁notes/
└─📁assets/
├─📁wiki/processado
├─📁clients/
└─📁[slug-cliente]/
├─perfil.md
├─reunioes.md
├─acoes.md
└─resultados.md
├─📁segments/
├─📁entities/
├─📁sources/
├─📁concepts/
├─📁benchmarks/
├─📁campaigns/
├─📁analyses/
└─📁references/
├─📁outputs/entregável
└─📁automacao-ads/automação
🧠
/ CLAUDE.md
Esquema do agente

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.

Por que existe: sem ele, o Claude começa cada sessão do zero, sem saber cliente, convenção ou regra. Com ele, toda sessão começa orientada.
leitura obrigatórianunca deletar
🗂️
/ index.md
Catálogo do wiki

Lista plana de todas as páginas com uma linha de descrição — o sumário do segundo cérebro.

Por que existe: sem index, o Claude varreria toda pasta pra saber o que existe. Com ele, mapeia o território em segundos.
atualizado após cada operação
📋
/ log.md
Linha do tempo de operações

Registro cronológico append-only: fontes ingeridas, clientes criados, análises geradas. Nunca se apaga, só cresce.

Por que existe: auditabilidade total — quando cada informação entrou, quem foi afetado, sem depender de memória.
append-only
🗃️
/ raw/
Fontes brutas — zona imutável

Artigos copiados, transcrições, notas cruas, PDFs. Nunca editados — matéria-prima que o Claude lê, processa e escreve em wiki/.

Por que existe: separa fonte de interpretação. Se uma conclusão errar, volta pro raw e relê o original sem contaminação.
nunca editarnunca deletar
📚
/ wiki/
Conhecimento processado — o núcleo

Tudo que o Claude escreve e mantém, dividido por tipo de conhecimento.

📂 clients/ — workspace por cliente
4 arquivos fixos: perfil, reunioes, acoes, resultados.
📂 segments/ — cruzamento de padrões
Padrões validados em 2+ clientes do mesmo nicho.
📂 sources/ — ponte do raw pro wiki
Resumo de cada fonte ingerida, com conexões e path pro arquivo original.
📂 entities/ — páginas-hub
Resumos de clientes, contatos, concorrentes — nós centrais do grafo.
📂 concepts/ 📂 benchmarks/ 📂 campaigns/ 📂 analyses/
Conhecimento horizontal: frameworks, benchmarks de mercado, performance de criativos, consultas salvas.
editável pelo Claudeinterligado
📤
/ outputs/
Produtos finais

Relatórios HTML, planos, apresentações — tudo gerado a partir do wiki, nunca o contrário.

Por que existe: separa produto final de base de conhecimento. Permite regenerar relatório quando dado muda sem reescrever raciocínio.
entregável
🤖
/ automacao-ads/
Motor de coleta e automação

Scripts e configuração que coletam dados via Meta Graph API e Google Ads API e alimentam resultados.md e campaigns/ automaticamente.

Por que existe: performance muda todo dia — o agente coleta, processa e escreve direto no wiki, sem exportação manual.
Meta Graph APIGoogle Ads API

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.

Entrada A

🎙️ Transcrição de call

Gravação ou notas de reunião com cliente

Entrada B

📰 Artigo / pesquisa

Conteúdo externo, estudos de caso

Entrada C

📊 Dados de API

Meta Ads, Google Ads, outras plataformas

↓ ↓ ↓
raw/

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.

🤖 Claude processa

Ingestão e síntese

Identifica cliente(s) e segmento afetado, extrai insights e próximos passos, cria links pras páginas relacionadas.

wiki/sources/

📄 Página da fonte

Resumo, insights e conexões com o grafo

wiki/clients/

📁 Workspace do cliente

Reuniões, ações e resultados atualizados

wiki/segments/

🔗 Segmento atualizado

Padrões cruzados entre clientes do nicho

outputs/

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.

REGRA 01

🔒 Raw é sagrado

Nenhum arquivo em raw/ é editado pelo Claude, jamais. Se o dado mudar, cria versão nova — nunca sobrescreve.

❌ editar raw/transcript.md
✅ criar raw/transcript-v2.md
REGRA 02

📋 index.md + log.md sempre atualizados

Toda operação termina com index catalogado e log registrado — senão o mapa fica desatualizado.

toda sessão → 1 entrada no log.md
REGRA 03

🔗 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]]
❌ ../clients/x/acoes.md
REGRA 04

⚠️ 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.

⚠️ versão A (jan) vs versão B (abr)
REGRA 05

📐 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.

1 cliente = hipótese → 2+ = padrão
REGRA 06

🚫 Nunca criar página redundante

Verificar o index antes de criar página nova. Informação fragmentada em dois lugares fica desatualizada nos dois.

checar index.md antes de criar → sempre

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.

Pergunta que originou esta regra
"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."
A regra que resolve isso: um link direto entre dois clientes não tem sentido semântico — o que os une é o que compartilham, não o fato de serem clientes.
segments/ medicina-integrativa Cliente A Cliente B Cliente C sources/ pesquisa-cpls segments/food-delivery-eua Cliente D campaigns/ esfiha-domingo
Cliente (nó de dados)
Hub de segmento
Hub de fonte
Hub de campanha
Link indireto (via hub)
🗂️

Hub de segmento

segments/[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.

Propósito: cruzar o que já funcionou em clientes do mesmo nicho antes de testar num novo.
📈

Hub de campanha

campaigns/[nome-do-teste]

Um criativo ou estratégia testada. Guarda resultados por cliente — se outro cliente usar o mesmo formato, o benchmark já está aqui.

Propósito: evitar refazer o que já foi testado.
📖

Hub de fonte

sources/[nome-da-fonte]

Artigo ou benchmark externo relevante pra múltiplos clientes. Uma ingestão pode conectar 3 clientes diferentes.

Propósito: uma fonte vira contexto pra todos que ela é relevante, sem duplicar.
🧩

Hub de conceito

concepts/[framework]

Estratégia ou metodologia usada em vários clientes — inclusive de segmentos diferentes que usam o mesmo framework.

Propósito: o conhecimento de método vira patrimônio da agência, não do cliente.

Como o Claude usa isso na prática

1

Você pede um briefing de cliente

Ex.: /prep-reuniao cliente-b

2

Lê o workspace do cliente

Abre perfil.md, reunioes.md, acoes.md — histórico completo deste cliente.

3

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.

4

Segue links secundários

Fontes, benchmarks e campanhas linkadas no segmento — tudo já processado e pronto.

5

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á.

🤖 Claude cria automaticamente
Ao registrar reunião, adiciona [[segmento]] em acoes.md
Ao ingerir fonte, conecta nos clientes afetados
Ao criar ação com sucesso, pergunta "aplicável a segmento?"
Ao criar entidade, linka ao segmento
👤 Você define com intenção
Qual segmento cada cliente pertence, no onboarding
Quais fontes são relevantes pra quais clientes
Se um padrão vira benchmark ou fica só no cliente
Quando forçar o cruzamento com /segmento

Uma linha por pasta

Referência rápida: o que cada componente é, quem escreve e pra que serve.

CaminhoQuem escrevePara que serve
CLAUDE.mdVocê (uma vez)Define comportamento do Claude em toda sessão
index.mdClaude (automático)Mapa de todas as páginas — pré-requisito de consulta
log.mdClaude (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".

🔑
wiki/references/credenciais-apis.md
Arquivo único de credenciais

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.

1 fonte de verdadecruzar por nome do cliente
REGRA A

🧭 Fluxo obrigatório

Toda campanha nova segue: discutir hipótese → escrever plano → executar. Nunca pular direto pra execução.

REGRA B

⏸️ Sempre rascunho ou pausada

Nenhuma campanha sobe ativa sozinha. O Claude cria pausada e pede aprovação explícita antes de ativar.

REGRA C

✅ Checklist técnico pré-ativação

Orçamento, geo, negativos, tracking/pixel e conformidade de política revisados antes do "ON".

REGRA D

🔐 Verificar autenticação antes de escrever

Toda chamada de API confirma que o token/credencial ainda é válido antes de criar ou editar algo.

REGRA E

🔁 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.

REGRA F

📝 Log obrigatório

Toda mudança de orçamento, pausa ou ativação é registrada em log.md com cliente, data e motivo.

Armadilhas comuns — Google Ads API
  • 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.
Armadilhas comuns — Meta Ads API
  • Sempre validar o token com GET /me?access_token=TOKEN antes 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.

1

Instalar o Obsidian

Baixar em obsidian.md, abrir e escolher "Abrir pasta como vault" — pode ser uma pasta vazia nova.

2

Instalar e logar o Claude Code

Instalar o CLI, rodar claude dentro da mesma pasta escolhida como vault, e autenticar com sua conta.

3

Abrir a pasta no VS Code (opcional, recomendado)

Facilita ver a estrutura de arquivos crescendo em tempo real enquanto o Claude escreve.

4

Colar o prompt inicial

Copiar o prompt da seção 10 — O prompt inicial direto no terminal do Claude Code.

5

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.

6

Revisar a estrutura gerada no Obsidian

Voltar pro Obsidian, abrir o Graph View e conferir se as pastas e os primeiros links aparecem certos.

7

Preencher as credenciais reais

Substituir os placeholders de wiki/references/credenciais-apis.md pelos tokens e IDs reais das suas contas.

8

Primeiro comando real

Rodar /status pra confirmar que tudo foi criado, ou /novo-cliente pra cadastrar o próximo.

9

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.

prompt-inicial.txt
# Cole tudo abaixo na primeira mensagem do seu agente de LLM (Claude Code, Codex, OpenCode etc.), dentro da pasta vazia escolhida como vault Você vai me ajudar a construir um Wiki LLM pessoal para minha agência. Antes de qualquer coisa, internalize a ideia — ela muda como você deve se comportar em toda sessão futura nesta pasta, não só na de hoje. O problema que isso resolve A experiência comum com LLM e documentos é RAG: carrego arquivos, você recupera trechos relevantes na hora da pergunta e gera resposta. Funciona, mas você redescobre o conhecimento do zero a cada pergunta — nada se acumula. Se eu perguntar algo que exige sintetizar cinco fontes, você vai juntar os fragmentos de novo toda vez. A ideia central — Wiki LLM Em vez de só recuperar informação bruta no momento da consulta, você constrói e mantém incrementalmente um wiki persistente — uma coleção estruturada e interligada de arquivos Markdown entre mim e as fontes originais. Quando eu trouxer uma fonte nova, você não a indexa e esquece: você lê, extrai o que importa, e integra ao wiki existente — atualiza página de entidade, revisa resumo de tópico, sinaliza onde o dado novo contradiz uma afirmação antiga. O conhecimento é compilado uma vez e mantido atualizado, não derivado de novo a cada pergunta. Referências cruzadas já existem. Contradições já estão sinalizadas. A síntese já reflete tudo que foi processado. Eu quase nunca escrevo o wiki — você escreve e mantém tudo. Meu trabalho é buscar fonte, direcionar a análise e fazer a pergunta certa. Analogia: o Obsidian é a IDE, você é o programador, o wiki é a base de código. Eu abro os dois lado a lado — você edita com base na nossa conversa, eu navego o resultado em tempo real, sigo link, olho o graph view. Arquitetura em 3 camadas 1. Fontes originais (raw/) — artigos, transcrições, dados brutos. Imutáveis: você lê, nunca modifica. É a fonte de verdade. 2. O wiki (wiki/) — Markdown gerado e mantido só por você. Resumos, páginas de entidade, páginas de conceito, comparações, síntese. Você cria, atualiza e garante consistência entre tudo. 3. O esquema (CLAUDE.md) — o documento que te diz como o wiki está estruturado, quais as convenções e quais fluxos seguir. É o que te torna mantenedor disciplinado, não chatbot genérico. Nós dois desenvolvemos esse arquivo juntos ao longo do tempo, à medida que descobrimos o que funciona pro meu domínio — trate-o como vivo, não como especificação fechada. As 3 operações que você vai repetir em toda sessão futura - Ingestão: eu trago uma fonte nova. Você lê, discute os pontos principais comigo, escreve página de resumo em wiki/sources/, atualiza index.md, atualiza entidades e conceitos afetados em toda a wiki, adiciona entrada no log.md. Uma fonte só pode tocar de 10 a 15 páginas. Prefiro ingerir fonte por fonte e ficar envolvido — mas isso é ajustável, documente no CLAUDE.md o fluxo que a gente decidir. - Consulta: eu pergunto algo. Você lê o index.md primeiro pra saber onde olhar, abre as páginas relevantes, sintetiza resposta com citação [[página]]. Boas respostas — uma comparação, uma análise, uma conexão nova — não morrem no histórico do chat: você me pergunta se deve arquivar de volta no wiki como página nova em wiki/analyses/. - Verificação periódica (função de Gerente de Conteúdo): de tempos em tempos eu vou pedir uma checagem de saúde do wiki. Procure contradição entre páginas, afirmação desatualizada que uma fonte mais nova já invalidou, página órfã sem link nenhum, conceito importante citado mas sem página própria, referência cruzada faltando, e lacuna de dado que pesquisa na web resolveria. Sugira pergunta nova a investigar e fonte nova a buscar. Convenções de índice e registro - index.md é orientado a conteúdo: catálogo de tudo que existe na wiki, cada página com link + resumo de uma linha + metadado opcional, organizado por categoria. Atualizado a cada ingestão. Você lê ele primeiro, antes de qualquer busca — evita ter que varrer pasta por pasta, e dispensa infraestrutura de embedding em escala moderada (até uns 100 fontes, centenas de página). - log.md é cronológico, append-only. Cada entrada começa com um prefixo fixo pra virar pesquisável por ferramenta simples — formato ## [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.

Obsidian instalado e vault aberto na pasta certa
Claude Code instalado, logado e rodando dentro da mesma pasta
Estrutura de pastas completa criada (raw/, wiki/, outputs/, automacao-ads/)
CLAUDE.md gerado e revisado — reflete o vocabulário real da sua agência, não genérico
Credenciais reais preenchidas em wiki/references/credenciais-apis.md, sem placeholder esquecido
Pelo menos um cliente cadastrado com /novo-cliente
Pelo menos uma fonte ingerida com /ingerir
Regra de rascunho/pausado confirmada antes de qualquer teste de automação real
Rotina de manutenção combinada — quando rodar /lint, quando revisar index.md