Conteúdo detalhado
📄 O que é o arquivo-alma
A camada de Identidade mora num único arquivo: o CLAUDE.md. O autor o chama de "o arquivo da alma" porque é o primeiro que o harness lê, antes de qualquer tarefa. Ele define o tom de tudo: quem o OS é, quem é o negócio e o que ele nunca deve recusar.
🌱 Novo aqui?
O CLAUDE.md é um arquivo de texto comum em formato Markdown (texto puro com alguns símbolos de formatação). O harness é o programa de terminal que dá mãos à IA — o Claude Code lê o CLAUDE.md; o Codex lê um arquivo equivalente (ex.: AGENTS.md). A ideia é a mesma: um texto de abertura que ensina a IA a ser aquele OS, e não um assistente genérico.
Como ler: o CLAUDE.md (à esquerda) é só um texto curto em quatro blocos. O harness o lê primeiro (seta ciano) e, a partir dele, deixa de ser genérico para agir como o OS daquele domínio.
Por que aprender
Porque é a peça que mais muda o comportamento por menos esforço. Um CLAUDE.md bem escrito faz a IA acertar o tom de primeira; um ausente ou inchado faz você reexplicar contexto em toda conversa. É a primeira camada da base — e a base sustenta tudo que vem depois.
Conceitos-chave
🧾 O que entra no CLAUDE.md
O conteúdo é sempre o mesmo punhado de blocos, adaptados ao domínio: você, o negócio, o mercado em que opera, os eventos atuais relevantes, suas preferências e o que você quer sempre ou nunca ver. O que NÃO entra é igualmente importante: conhecimento bruto e documentos vão para o Substrato (Módulo 2.2), não aqui.
🧩 O que é
Um retrato curto e estável do contexto que vale para toda conversa daquele domínio — não a tarefa de hoje, mas o pano de fundo permanente.
- •Você & negócio: nome, papel, o objetivo do domínio em uma frase.
- •Mercado & eventos atuais: onde você opera e o que mudou recentemente.
- •Preferências: formato de saída, tom, o que sempre/nunca incluir.
✓ Entra na Identidade
- ✓Quem você é e a quem o OS serve.
- ✓O mercado, a jurisdição, os eventos atuais.
- ✓Preferências de formato e o que nunca recusar.
✗ NÃO entra (vai pro Substrato)
- ✗Documentos brutos, transcrições, leis inteiras.
- ✗Históricos longos e tabelas de dados.
- ✗Passo a passo de tarefas (isso vira Skill).
Por que aprender
Porque misturar identidade com substrato é o erro mais comum: as pessoas despejam tudo no CLAUDE.md e ele incha. Saber o que entra (contexto estável) e o que sai (material de referência) mantém a alma curta e o OS rápido.
Conceitos-chave
✂️ Enxuto < 30 linhas — cortar até doer
A regra prática é dura: mantenha o CLAUDE.md enxuto, abaixo de ~30 linhas, e corte até doer. Uma identidade inchada confunde o OS: o modelo gasta atenção lendo coisa que não importa e dilui o que importa. Curto é uma decisão de design, não de preguiça.
💡 O teste do corte
Para cada linha, pergunte: "se eu apagar isto, o OS vai errar?". Se a resposta for "não", apague. Se for "talvez", é material de referência — mande para o Substrato. Só fica o que muda o comportamento toda vez.
✓ Identidade enxuta
- ✓Cabe numa tela; lê-se em 20 segundos.
- ✓Cada linha muda o comportamento.
- ✓Aponta para o Substrato em vez de copiá-lo.
✗ Identidade inchada
- ✗Rola por páginas com tudo "por garantia".
- ✗Cola leis, históricos e tabelas inteiras.
- ✗Dilui o essencial no meio do ruído.
Por que aprender
Porque a tentação de "guardar tudo aqui" é o jeito mais rápido de degradar o OS. Tratar a identidade como um editorial curto — e não um depósito — é o que separa um OS que responde com precisão de um que se perde. Esse hábito de cortar também protege a sua janela de contexto.
Conceitos-chave
👥 A quem serve: você vs um time
A pergunta seguinte é "a quem este OS serve?". Se é só para você, a identidade é simples. Se é para um time, você precisa embutir os papéis e responsabilidades — quem faz o quê, e como o trabalho se divide — para o OS responder de forma coerente a pessoas diferentes.
Um dono, uma voz. A identidade fala "comigo": minhas preferências, meus limites. Mais curta e direta.
Vários papéis. A identidade descreve responsabilidades por função e o que cada papel pode pedir ou ver.
🔎 O detalhe que muda tudo
Num OS de time, "a quem serve" inclui limites por papel: um estagiário júnior, por exemplo, talvez só possa ler dados, nunca escrever. Esse contorno começa na identidade e vira regra/gancho concreto no Módulo 2.3.
Por que aprender
Porque o mesmo domínio gera identidades diferentes conforme o público. Definir cedo "você ou um time" evita um OS que serve mal a todos. E já planta a semente das cercas: quem pode o quê.
Conceitos-chave
🛡️ Quando o Claude deve suprimir recusas
Modelos modernos ficaram mais "julgadores" — às vezes recusam ou pedem confirmação em coisas legítimas do seu domínio. A identidade é o lugar certo para um cheat sheet de recusas: dizer explicitamente quando o OS deve dar o benefício da dúvida e seguir, em vez de travar.
🌱 Novo aqui?
"Suprimir uma recusa" não é burlar segurança — é evitar que a IA trave em tarefas legítimas e suas. Ex.: ler a sua própria certidão de nascimento no seu Freedom OS, ou categorizar seus próprios extratos no Tax OS. Você descreve o contexto ("são meus dados, neste domínio, com este objetivo") para o modelo não pedir confirmação a cada passo.
💡 Por que isso piora com modelos melhores
Quanto mais "esperto" o modelo, mais ele opina. O autor observa que cada geração tende a ficar mais cautelosa e cheia de ressalvas. Um CLAUDE.md que antecipa isso — "neste domínio, com meus dados, prossiga" — economiza fricção em toda sessão.
⚠️ A linha que não se cruza
Cheat sheet de recusas vale para tarefas suas e legítimas. Não use a identidade para tentar contornar limites reais de segurança ou para mexer em dados de terceiros — isso é abuso, não engenharia de OS.
Por que aprender
Porque a fricção de recusas repetidas é o que faz as pessoas abandonarem o OS. Um cheat sheet bem escrito mantém o fluxo: o OS ajuda sem ladainha, dentro do que é seu e legítimo.
Conceitos-chave
🌐 Padrão multi-OS: apontar pra um arquivo global
Quando você tem vários OS (Freedom, Tax, Skool…), eles compartilham coisas: seu nome, suas preferências de escrita, fatos sobre você. Em vez de repetir isso em cada CLAUDE.md, use o padrão multi-OS: um arquivo global com o que é comum, e cada OS aponta para ele ("sempre consulte X").
Como ler: cada OS (à esquerda) tem um CLAUDE.md curto que aponta (setas ciano) para um arquivo de identidade global (centro). Mudou uma preferência sua? Edita num lugar só — todos os OS herdam.
Por que aprender
Porque conforme você cresce de 1 para 5 OS, repetir identidade vira pesadelo de manutenção. Centralizar o comum num arquivo global é o padrão que mantém todos coerentes e atualizáveis num só ponto — e ainda ajuda a manter cada CLAUDE.md enxuto.
Conceitos-chave
🧪 Done-check: o teste do estranho
Como saber se a identidade está boa? Use o teste do estranho: dê o CLAUDE.md para alguém que não conhece o projeto. Se essa pessoa consegue descrever para que serve o OS e citar 1 coisa que ele recusa, a identidade passou. Se ela fica confusa, falta clareza — ou sobra ruído.
✅ O done-check em 3 passos
Entregue o arquivo a um estranho (ou a um chat sem o seu contexto).
Pergunte: "para que serve este OS e o que ele nunca faz?".
Acertou os dois? Pronto. Errou? Corte ruído e deixe o propósito explícito.
💡 Truque sem cobaia humana
Sem um estranho à mão, cole o CLAUDE.md num chat novo, sem nenhum outro contexto, e peça o resumo. O modelo "frio" faz o papel do estranho muito bem.
Por que aprender
Porque "está bom" é vago; o teste do estranho é um critério objetivo de pronto. Ele força a identidade a ser clara e auto-suficiente — exatamente o que o /os-coach exige antes de avançar para a próxima camada na Trilha 4.
Conceitos-chave
⚡ Prático: gerar um CLAUDE.md enxuto
Hora de pôr a mão na massa. Abaixo está um prompt copy-run pronto para colar no Claude Code (ou Codex) — ele entrevista você em 3 perguntas e escreve um CLAUDE.md enxuto, abaixo de 30 linhas, com cheat sheet de recusas. Troque só os trechos entre <colchetes>.
🎯 Objetivo
Sair desta seção com um arquivo CLAUDE.md real para um domínio seu, curto e que passa no teste do estranho.
Cole no Claude Code — prompt copy-run
promptVocê é meu engenheiro de OS. Crie o arquivo CLAUDE.md da camada de Identidade para o meu <domínio: ex. Tax OS>. Contexto: - Quem sou eu: <seu nome + papel, 1 linha> - Objetivo do domínio: <o que eu quero poder perguntar/mandar fazer> - Mercado / jurisdição: <onde opero, ex. Ontário/Canadá> - Serve a: <só a mim | um time com papéis X, Y> - Sempre ver: <formato/tom preferido> - Nunca ver: <o que me irrita> Regras de escrita (obrigatórias): 1. Máximo de 30 linhas. Corte tudo que não muda o comportamento. 2. NÃO cole documentos, leis ou dados brutos — isso é Substrato, não Identidade. 3. Inclua um bloco "Não recusar" com 2-3 itens: tarefas minhas e legítimas neste domínio em que você deve prosseguir sem pedir confirmação (nunca para burlar segurança nem mexer em dados de terceiros). 4. Antes de escrever, faça no máximo 3 perguntas se algo essencial faltar. 5. Ao final, rode o "teste do estranho": resuma, em 2 frases, para que serve este OS e 1 coisa que ele recusa. Se não couber, encurte o arquivo. Escreva o arquivo em ./CLAUDE.md e me mostre o conteúdo.
✔️ Como verificar
- 1.Abra o CLAUDE.md gerado e conte as linhas: deve ter ≤ 30.
- 2.Confirme que existe um bloco "Não recusar" com tarefas suas e legítimas.
- 3.Cole o arquivo num chat novo e peça o resumo — ele deve acertar o propósito e 1 recusa (teste do estranho).
- 4.Nenhum documento, lei ou tabela colado dentro? Se houver, peça para mover ao Substrato.
Por que aprender
Porque ler sobre identidade não substitui escrever uma. Este prompt transforma os 7 tópicos anteriores num artefato real em minutos — e o mesmo padrão (entrevistar → escrever → done-check) é o que o /os-coach automatiza na Trilha 4.
Conceitos-chave
✅ Resumo do módulo
Próximo módulo:
2.2 — Substrato & Contexto: o caminhão de lixo em chamas 🗑️🔥