Conteúdo detalhado
🧪 O Teste do Context
Existe um teste simples e brutal para saber se o seu Context funciona: abra uma sessão Claude completamente fresca e pergunte "o que esse negócio faz e quem trabalha aqui?". Se o Claude responde sem navegar em nenhum arquivo externo, você tem Context. Se não responde, não tem — independente de quantos docs existam em outros lugares.
Abrir sessão fresca
Sem histórico. Sem arquivos abertos manualmente. O Claude Code lê só o que está no projeto automaticamente via CLAUDE.md e context/.
Perguntar sem dicas
Frase exata do teste:
Avaliar a resposta
Resposta com nomes, serviços e papéis reais = Context funcional. Resposta vaga ("é uma empresa de tecnologia...") = Context insuficiente ou ausente.
💡 Por que "sessão fresca" importa
Numa sessão existente, o Claude já tem contexto acumulado na janela. O teste só vale em sessão nova porque replica o estado real de uma automação, um agente ou um colaborador novo entrando no seu AIOS pela primeira vez. É o litmus test honesto.
📁 A Pasta context/
A pasta context/ é o coração do seu AIOS. Ela contém os três arquivos que definem quem você é, o que vende e onde está focado. Não é um dump de documentos — são fatos interpretados, escritos na voz de quem conhece o negócio.
✓ Fatos interpretados
- ✓"Vendemos consultoria de produto para scale-ups B2B SaaS"
- ✓"Meu top_pain é ciclo de vendas longo (média 45 dias)"
- ✓"Q3 2026: fechar 3 clientes novos enterprise"
- ✓Escrito como um briefing para alguém que não te conhece
✗ Dump de documentos
- ✗Colar o deck de pitch completo (50 slides)
- ✗Contratos de clientes ou NDA como "context"
- ✗Histórico completo de emails de vendas
- ✗Notes/misc/inbox como "arquivos de contexto"
⚡ Regra de ouro
Se você não consegue escrever o arquivo about-business.md em menos de 30 minutos, o problema não é falta de informação — é falta de clareza sobre o próprio negócio. O processo de escrever é o diagnóstico.
📋 CLAUDE.md — Manual de Operação
O CLAUDE.md fica na raiz do projeto e é canônico — é o único arquivo que o Claude Code lê automaticamente em toda sessão. Funciona como um manual de operação: quem você é, como pensa (3 Ms), onde as coisas moram e como trabalhar com você. É preenchido pelo /onboard.
📊 Por que só um CLAUDE.md
- Canonicidade — sem conflito de versões entre pastas
- Carga garantida — Claude Code lê automaticamente
- Manutenção simples — um lugar pra atualizar
- Revisão trimestral — cadência natural e previsível
🚫 O que NÃO colocar
- Credenciais ou chaves de API
- Conteúdo sensível de clientes
- CLAUDE.md aninhado em subpastas
- Informação duplicada de context/
💡 Dica prática
Rode /onboard para gerar o primeiro CLAUDE.md — o skill conduz 7 perguntas e monta tudo automaticamente. Para atualizações futuras, edite diretamente ou rode de novo (idempotente). Revisão recomendada: a cada trimestre ou quando mudar de foco estratégico.
🎙️ references/voice.md — A Regra da Voz
O references/voice.md guarda amostras reais da sua escrita, coladas verbatim — nunca digitadas durante uma conversa. É o arquivo que impede o Claude de inventar um "tom profissional genérico" quando gera conteúdo no seu nome.
⚠️ A única regra que não dobra
Amostras de voz precisam ser coladas verbatim de algo que você escreveu de verdade — um email real, um post publicado, uma mensagem de Slack. Nunca digitadas no chat durante a conversa com o Claude.
✓ Boas amostras de voz
- ✓Email de acompanhamento de vendas enviado
- ✓Post publicado no LinkedIn sem edição pesada
- ✓Mensagem de Slack para o time (tom informal)
- ✓Trecho de proposta comercial escrita por você
✗ Amostras que não valem
- ✗Texto gerado por IA e revisado por você
- ✗Descrição de como você escreve ("sou direto...")
- ✗Texto escrito durante a conversa com o Claude
- ✗Post editado extensamente por redator externo
📌 Instrução padrão no voice.md
Sempre que gerar conteúdo externo, inclua no final do arquivo:
Isso protege sua reputação quando o Claude gerar rascunhos autônomos via Cadence.
📝 decisions/log.md — Registro de Decisões
O decisions/log.md é o registro append-only de decisões e seus porquês. Não é um to-do list nem um diário — é a memória institucional do raciocínio que sustentou cada escolha relevante do seu AIOS e do seu negócio.
🔑 O litmus test do AIS-OS
"Enquanto você não está na mesa, seu AIS-OS observa um evento real e produz um output mais rápido e mais preciso do que você produziria."
O decisions/log.md é o que garante que o AIOS reproduz seu raciocínio, não só suas tarefas. Sem o porquê registrado, cada nova sessão recomeça do zero.
Append-only — nunca deletar
O valor do log aumenta com o tempo. Decisões antigas explicam por que o sistema está configurado de certo jeito. Deletar é perder contexto histórico que você vai precisar quando algo quebrar.
Gerado pelo /level-up também
O skill /level-up cria uma entrada no decisions/log.md toda vez que você scopa uma nova automação — data, decisão, por quê, alternativas e owner. Você não precisa escrever manualmente toda vez.
⚡ Quando registrar uma decisão
Toda decisão que não é óbvia ou que você vai querer explicar para alguém (incluindo você mesmo daqui 3 meses). Regra prática: se você hesitou entre duas opções por mais de 30 segundos, registre. Se você mudou de abordagem no meio, registre com o porquê da mudança.
📚 references/ — Conhecimento Interpretado
A pasta references/ guarda conhecimento que o Claude precisa para trabalhar com você — frameworks que você usa, guias de API de ferramentas conectadas, SOPs do seu processo. É o wiki operacional, não um depósito de documentos brutos.
✓ O que vai em references/
- ✓Guia de API que você pesquisou uma vez (researched-once-saved-forever)
- ✓SOP de um processo recorrente que outros replicam
- ✓Framework externo que você aplica (ex.: ICE scoring)
- ✓Glossário de termos internos do seu negócio
✗ O que NÃO vai em references/
- ✗Dump de emails ou threads do Slack
- ✗Documentos legais ou contratuais de clientes
- ✗Notas pessoais não-processadas (misc, inbox)
- ✗Pastas de pastas sem razão (pasta-de-pasta-de-pasta)
🔁 Princípio: Researched-once, saved-forever
Ao conectar uma nova ferramenta, dedique 30 minutos para criar references/{tool}-api.md com endpoints, auth e 3 queries exemplo. O /audit premia isso; skills futuras não re-pesquisam o que você já descobriu.
references/notion-api.md
references/hubspot-api.md
🧭 Context é não-pulável — por design
No grafo de dependência dos 4 Cs: Context vem primeiro, sempre. Connections + Capabilities podem ser desenvolvidos em paralelo, mas Cadence (automações recorrentes) só faz sentido depois que o Context está sólido.
Se o Context está vazio, o AIOS está voando às cegas. Uma automação de Cadence sem Context produz outputs genéricos — às vezes piores que nada.
✅ Resumo do Módulo
Próximo Módulo: 2.2 — Connections
Com o Context no lugar, o AIOS sabe quem você é. Agora é hora de ensinar o que você tem e onde está — conectando as ferramentas que fazem parte do seu dia.