🧱 Técnica I — a base do OS
As três camadas de fundação, o "back of house" do seu OS: Identidade (o arquivo-alma), Substrato & Contexto (o caminhão de lixo em chamas) e Regras & Ganchos (as cercas). Sem essa base estática, os agentes não têm em que se apoiar.
Como ler: a base se constrói de cima para baixo no entendimento, mas se empilha como alicerce: Identidade, Substrato e Regras formam o chão estável (em azul) sobre o qual as camadas de ação (em ciano, esmaecidas — Trilha 3) vão se apoiar. Esta trilha cobre só a fundação.
Mapa da trilha
Conteúdo detalhado
🪪 Identidade — o arquivo-alma (CLAUDE.md)
O primeiro arquivo que o OS lê. Quem ele é, a quem serve, o que nunca recusa — enxuto abaixo de 30 linhas, com prático de geração no final.
A camada de Identidade mora no CLAUDE.md — o primeiro arquivo que o harness lê, antes de qualquer tarefa.
É a peça que mais muda o comportamento por menos esforço; um bom arquivo acerta o tom de primeira.
Arquivo-alma · lido 1º · Markdown · define o tom.
Você, o negócio, o mercado, eventos atuais, preferências e o que sempre/nunca ver. Dado bruto NÃO entra.
Misturar identidade com substrato incha o arquivo; saber o limite mantém a alma curta.
Contexto estável · sempre/nunca · identidade ≠ dados.
Manter o arquivo abaixo de ~30 linhas e cortar tudo que não muda o comportamento toda vez.
Identidade inchada dilui o sinal e gasta atenção do modelo; curto é decisão de design.
< 30 linhas · cortar até doer · apontar > colar.
Se o OS serve um time, a identidade embute papéis, responsabilidades e limites por função.
O mesmo domínio gera identidades diferentes conforme o público; define cedo "você ou time".
A quem serve · papéis · limites por papel.
Um cheat sheet dizendo quando o OS deve dar o benefício da dúvida em tarefas suas e legítimas.
Modelos ficam mais julgadores; antecipar recusas evita fricção em toda sessão.
Cheat sheet · benefício da dúvida · só o legítimo.
Um arquivo global com o que é comum a você; cada OS aponta "sempre consulte X" em vez de repetir.
Conforme você cresce de 1 para 5 OS, centralizar o comum evita o pesadelo de manutenção.
Arquivo global · apontar não copiar · 1 ponto de edição.
Um estranho lê o CLAUDE.md e descreve o propósito do OS + 1 coisa que ele recusa.
"Está bom" é vago; o teste do estranho é um critério objetivo de pronto.
Teste do estranho · descreve propósito · chat frio.
Um prompt pronto que entrevista você em 3 perguntas e escreve um CLAUDE.md enxuto com cheat sheet de recusas.
Ler sobre identidade não substitui escrever uma; o prompt vira artefato real em minutos.
Copy-run · entrevista > despejo · done-check embutido.
🗑️🔥 Substrato & Contexto — o caminhão de lixo em chamas
Do caos de 500–5.000 arquivos aos nuggets injetáveis: organizar antes da IA, colher o tácito, destilar com um modelo workhorse.
Você começa com 500–5.000 arquivos caóticos de tipos variados; o Substrato transforma o caos em referência.
A maioria liga a IA em cima do caos e se frustra; aceitar e tratar o caos com método é o diferencial.
Substrato vs contexto · 500–5.000 arquivos · design.
Mini engenharia de dados: separe por tipo de arquivo e depois por idade (recente vs antigo).
A qualidade do OS é limitada pela do Substrato; organizar primeiro multiplica tudo depois.
Mini eng. de dados · por tipo · por idade.
Colher o que falta para criar o especialista dos sonhos — de YouTube, experts, leis, advogados.
O que você já tem raramente basta; harvesting fecha a lacuna de propósito.
Harvesting · especialista dos sonhos · fontes externas.
O saber de prática, raramente escrito: atalhos, exceções, "o que dá errado" — que o modelo genérico não tem.
É o tácito que faz o OS parecer especialista e não chatbot; é o teste do não-genérico.
Tácito vs explícito · exceções · não-genérico.
Agregar fontes num compendium.md (referência destilada) e playbooks (como se faz X).
É o formato em que o conhecimento vira utilizável; um bom playbook é quase uma Skill.
Compêndio · playbook · pergunta-objetivo (done-check).
Pasta raw/ (cru, guardado) vs synthesized/ (nuggets). Injete só os nuggets.
É o padrão que se repete em todo domínio; injetar o cru estoura a janela e encarece.
raw/ · synthesized/ · despensa vs prato pronto.
Um modelo barato (ex.: Gemini Flash) rodando em loop por todos os arquivos para destilar nuggets.
Destilar à mão não escala e usar o topo-de-linha é desperdício; o par barato+loop viabiliza o volume.
Workhorse · em loop · humano no loop.
Prompt que varre raw/ com o workhorse e escreve um nugget por arquivo em synthesized/.
É o coração operacional do Substrato; generalizado, vira a skill "knowledge harvester".
raw/ intacto · 1 nugget/arquivo · compendium.md.
🚧 Regras & Ganchos — as cercas
Regra = sugestão forte; gancho = determinístico. Reflex hooks, settings.json com deny de escrita, pre-commit de PII e o done-check do pior erro.
Uma sugestão forte ao modelo — a placa "não entre". Não-determinística: pode escorregar.
Saber que regra é "mole" calibra a confiança e reserva os ganchos para o que não pode falhar.
Regra · não-determinística · boa p/ preferências.
A porta trancada: sempre faz ou nunca deixa fazer, sem depender do julgamento do modelo.
PII, dinheiro e escrita em banco não podem depender de o modelo "lembrar".
Gancho · sempre/nunca · onde dói.
Mover as linhas "sempre/nunca" do CLAUDE.md inchado para uma pasta rules/.
A base cresce sem virar bagunça: identidade enxuta, regras auditáveis.
Graduar · always/never · mover > duplicar.
Um mecanismo que dispara na hora: subiu PII (SIN, cartão) pro GitHub? Ação bloqueada na hora.
Os erros mais caros são silenciosos; o reflexo torna "espero que não" em "não pode".
Reflex hook · PII · reflexo > memória.
Banir comandos de escrita do Bash (ex.: nunca escrever numa tabela), salvo override explícito.
É onde "nunca escreva aqui" deixa de ser texto e vira regra de máquina — alto retorno.
settings.json · permissions.deny · salvo override.
Um verificador que roda antes de cada commit e barra o envio se achar PII.
Backup sem guarda é porta de vazamento; o pre-commit deixa você versionar tranquilo.
Pre-commit · barra o commit · + .gitignore.
Nomeie o pior erro do domínio, escreva-o como never-rule clara e reforce com 1 reflexo determinístico.
Critério acionável em 5 minutos: a pergunta certa, na dose certa (texto + gancho).
Pior erro · never-rule · cerca dupla.
Um settings.json pronto que nega comandos de escrita e adiciona um PreToolUse hook (exit 2 bloqueia).
Transforma a teoria das cercas em proteção real, em minutos — o "1 reflexo" do done-check.
permissions.deny · PreToolUse · exit 2 · override.