📐 Visão Geral da Arquitetura
O sistema do Segundo Cérebro funciona em três camadas distintas: entrada bruta de dados, compilação pelo LLM e wiki estruturada. Cada camada tem uma responsabilidade clara e separada.
🏗️ As 3 Camadas do Sistema
📥 Camada 1: raw/ — Captura Bruta
O diretório raw/ é a caixa de entrada sem julgamento. Capture tudo sem se preocupar com estrutura, links ou formatação. A regra é simples: se pensou, capture.
O que vai em raw/
2024-03-15-reuniao-produto.md
Anotações brutas, ação items sem formatar
article-attention-mechanism.md
URL + destaque copiado + comentário seu
shower-thought-2024-03.md
Ideas, hipóteses, conexões espontâneas
building-pkm-highlights.md
Trechos copiados + suas anotações
O raw/ nunca é editado pelo LLM — é só lido. É a fonte da verdade imutável. O LLM compila a partir dele, mas nunca modifica os originais.
📚 Camada 2: wiki/ — Conhecimento Compilado
O diretório wiki/ contém o conhecimento processado, estruturado e interligado. São as notas que o LLM vai ler para responder perguntas — precisas, com links e metadata.
📁 Estrutura do wiki/
⚙️ CLAUDE.md — O Schema do Sistema
O CLAUDE.md é o arquivo mais importante do sistema. É o contrato entre você e o LLM: define como o sistema funciona, quais são as regras e como o LLM deve se comportar.
Estrutura do CLAUDE.md
# CLAUDE.md — Instruções do Sistema
## Propósito
Este vault é o segundo cérebro de [seu-nome].
O LLM deve ler wiki/ para responder perguntas
e raw/ para compilar novo conhecimento.
## Estrutura
- raw/ → capturas brutas (não edite)
- wiki/ → conhecimento processado
- wiki/index.md → mapa do vault
- wiki/log.md → log de atualizações
## Regras de Compilação
Ao processar raw/:
1. Identifique o conceito central
2. Crie ou atualize a nota wiki/
3. Adicione [[links]] para notas relacionadas
4. Registre no log.md
## Categorias
fundamentos/ | projetos/ | pessoas/ | referências/Define como processar raw/, que links criar, quais categorias existem.
Documenta o sistema para que você entenda o que o LLM está fazendo.
O agente de atualização lê CLAUDE.md para saber como executar cada ciclo.
📋 index.md e log.md — Navegação e Auditoria
Dois arquivos especiais controlam a saúde do sistema: index.md é o mapa de navegação e log.md registra todas as compilações.
# Índice do Vault
## Fundamentos
- [[python-llm]] — Python para LLMs
- [[machine-learning]] — ML básico
- [[transformers]] — Atenção e BERT
## Projetos Ativos
- [[projeto-alpha]] — Status: 70%
- [[agente-update]] — Prod ✅
## Pessoas
- [[equipe-ia]] — time interno# Log de Atualizações
## 2024-03-20
- Compilou: meeting-notes.md
→ Atualizou [[projeto-alpha]]
→ Criou [[decisao-arquitetura]]
→ Links: [[python-llm]], [[aws]]
## 2024-03-15
- Compilou: article-transformers.md
→ Criou [[transformers]]
→ Atualizou [[machine-learning]]Sem auditoria, você não sabe o que o LLM fez. O log.md permite revisar cada compilação, desfazer erros e entender como o grafo evoluiu ao longo do tempo.
🔄 Fluxo Completo: do Raw ao Insight
O ciclo completo do sistema: você captura → o LLM compila → o grafo cresce → você consulta com contexto preciso. Um sistema que aprende e melhora com o tempo.