Conteúdo detalhado
Este é o módulo de referência da Trilha 1. Você não precisa decorar tudo: leia uma vez para reconhecer os termos e volte aqui sempre que uma palavra aparecer "do nada" numa trilha técnica. A regra de cada verbete é simples — uma frase concreta + uma analogia do dia a dia.
🪪 Identidade & CLAUDE.md
📖 O que é Identidade?
Em uma frase: é quem o OS é, a quem ele serve e o que ele nunca deve recusar.
Analogia: a descrição de cargo que você entrega a um assistente novo no primeiro dia — sem ela, ele é competente mas perdido.
A Identidade vive num arquivo concreto: o CLAUDE.md. É um arquivo de texto comum (formato Markdown — só texto com alguns símbolos) que o harness — o programa de terminal que dá mãos à IA, como o Claude Code — lê primeiro, antes de qualquer outra coisa. Por isso o autor chama o CLAUDE.md de "o arquivo da alma".
📖 O que é o CLAUDE.md?
Em uma frase: o arquivo-alma da Identidade, lido antes de tudo, onde mora quem o OS é.
Analogia: a primeira página do manual da casa — quem mora aqui, as regras da casa, o que nunca fazer.
| Entra no CLAUDE.md | Exemplo concreto |
|---|---|
| Quem você é | "Sou fotógrafo de casamento, trabalho sozinho." |
| A quem serve | "Este OS serve a mim; clientes nunca o veem." |
| O que nunca recusar | "Nunca recuse ajudar a redigir contratos." |
Por que aprender
Porque a Identidade é a primeira camada de tudo (Trilha 2, Módulo 2.1, é dedicada a ela). Se você reconhece o termo agora, não trava depois quando o curso disser "escreva seu CLAUDE.md enxuto".
Conceitos-chave
🗃️ Substrato vs Contexto
📖 O que é Substrato & Contexto?
Em uma frase: é todo o conhecimento do domínio — o material bruto, histórico, documentos e dados em que o OS se apoia.
Analogia: os bastidores da cozinha — a despensa, as receitas anotadas, o estoque que o cliente nunca vê, mas sem o qual o prato não sai.
Vale separar dois sentidos que costumam se confundir. O Substrato é tudo que está guardado no disco — a base inteira de conhecimento do domínio. O Contexto é a fatia desse material que efetivamente entra na "janela" do modelo numa conversa. Como a janela é limitada, você guarda muito (substrato) e injeta pouco e bem-escolhido (contexto).
| Substrato | Contexto | |
|---|---|---|
| O que é | tudo que está no disco | o que entra na conversa |
| Tamanho | grande, cresce sempre | pequeno, limitado pela janela |
| Analogia | a despensa inteira | os ingredientes na bancada agora |
💡 Por que a distinção importa
"O caminhão de lixo em chamas" (Módulo 2.2) é justamente o substrato bagunçado. Organizá-lo antes de ligar a IA é o que permite injetar no contexto só o que importa — sem desperdiçar a janela com ruído.
Por que aprender
Porque essa camada é, em muitos domínios, a maior fatia da pizza. Quem confunde "guardar tudo" com "injetar tudo" entope o contexto e piora as respostas. A distinção te ensina a separar o arquivo (substrato) do que você serve (contexto).
Conceitos-chave
🚧 Regra vs Gancho
Este é o par mais importante de não confundir. Os dois servem para impor limites, mas têm forças diferentes: uma regra pede, um gancho obriga.
📖 O que é uma Regra?
Em uma frase: uma sugestão forte ao modelo — ele quase sempre obedece, mas não é garantido.
Analogia: uma placa "não entre". Convence quase todo mundo, mas não impede fisicamente.
📖 O que é um Gancho?
Em uma frase: uma ação determinística que sempre (ou nunca) acontece — não é opinião do modelo, é código.
Analogia: uma porta trancada. Não importa o que você queira: ela não abre.
| Regra (rule) | Gancho (hook) | |
|---|---|---|
| Força | probabilística (quase sempre) | determinística (sempre/nunca) |
| Onde vive | texto em rules/ | código (ex.: settings.json, pre-commit) |
| Use para | tom, preferências, boas práticas | o que NÃO pode falhar (PII, dinheiro, escrita em banco) |
💡 A regra de bolso
Determinístico onde dói. Se um erro custa caro — vazar um dado pessoal, apagar uma tabela, mandar dinheiro errado — não confie numa regra "mole": use um gancho. Para o resto (estilo, tom, ordem de preferência), a regra basta.
Por que aprender
Porque a Trilha 2 (Módulo 2.3) é inteira sobre graduar regras e instalar ganchos. Confundir os dois leva a confiar numa placa quando você precisava de uma porta trancada — e é assim que acontecem os acidentes caros.
Conceitos-chave
🧩 Skill (habilidade)
📖 O que é uma Skill?
Em uma frase: uma tarefa repetível, empacotada para rodar igual toda vez — um único "verbo" que o OS sabe executar.
Analogia: um cartão de receita. Os mesmos passos, na mesma ordem, dando o mesmo prato sempre que você o segue.
No Claude Code, uma skill costuma aparecer como um slash command — um comando que começa com barra, tipo /resumo. Você dispara o verbo pelo nome e ele executa o processo que você empacotou. O autor reforça uma ideia central: comece manual (faça à mão primeiro), capture os passos depois, e nunca pare de refinar.
✓ Boa candidata a skill
- ✓Algo que você já faz à mão e repete muito.
- ✓Passos estáveis, com um resultado previsível.
- ✓Vale empacotar porque economiza tempo real.
✗ Skill ruim
- ✗Algo que você nunca fez à mão (não sabe os passos).
- ✗Escrever 10 de uma vez, sem usar nenhuma.
- ✗Tratar como "pronta" — skill nunca se termina.
Por que aprender
Porque skills são a primeira camada de "ação" (Trilha 3, Módulo 3.1). Saber que é um verbo repetível — e que começa manual — evita o erro clássico de tentar automatizar algo que você nem entende ainda.
Conceitos-chave
🤖 Agente
📖 O que é um Agente?
Em uma frase: um papel com julgamento que escolhe quais skills usar, em que ordem, normalmente com um portão de revisão antes de algo sair.
Analogia: o chef que escolhe a ferramenta certa, monta o prato e o prova antes de mandar pra mesa — diferente do cartão de receita (skill), que só executa um passo.
A diferença com skill é a chave: a skill é um verbo (faz uma coisa); o agente é um trabalhador (decide quais verbos usar). Por isso o agente é a última camada — ele precisa de skills para orquestrar. E só vale promover a agente uma rotina que você já faz à mão hoje.
| Skill | Agente | |
|---|---|---|
| É um… | verbo (1 tarefa) | papel (decide tarefas) |
| Julgamento | nenhum — só executa | escolhe e ordena |
| Analogia | cartão de receita | o chef |
Por que aprender
Porque "agente" é a palavra que mais empolga e mais confunde. Fixar que agente = chef (julgamento) e skill = receita (execução) te imuniza contra o erro nº 1 do Módulo 1.2 — pular pra agentes antes de ter skills.
Conceitos-chave
🔌 Skill vs CLI vs MCP vs API
Estas são as quatro formas de o OS "tocar o mundo" — e saber quando usar cada uma é uma das perguntas centrais do curso (Módulo 3.2). Vão do mais "seu" (uma skill que você mesmo empacota) ao mais externo (a API crua de um serviço).
Como ler: da esquerda pra direita, você sai do que é "muito seu" (uma Skill que empacota o seu jeito) para o que é "puramente externo" (a API crua do serviço). A CLI fica no meio: você a constrói sobre uma API para ter um controle enxuto — e segura.
| Termo | Em uma frase | Analogia | Quando usar |
|---|---|---|---|
| Skill | verbo repetível que você empacota | o jeito da casa | processo seu, sem precisar de serviço externo |
| CLI | programa de linha de comando p/ um serviço | controle remoto enxuto | quando quer controle (e segurança read-only) |
| MCP | protocolo que conecta a IA a uma ferramenta | adaptador de tomada | conexão rápida e padrão (menos relevante com o tempo) |
| API | a porta de dados de um serviço | a entrada de serviço do prédio | a base — você costuma envolvê-la numa CLI |
🌱 Novo aqui?
CLI = "command-line interface", um programa que você opera digitando comandos. MCP = "Model Context Protocol", um jeito padrão de plugar ferramentas na IA. API = "application programming interface", a porta por onde programas pedem dados a um serviço. Você não precisa saber programar nenhum deles agora — só reconhecer o que cada sigla significa.
Por que aprender
Porque a pergunta "skill, CLI, MCP ou API?" reaparece toda vez que o OS precisa tocar algo externo. Com este quadro na cabeça, você escolhe com intenção — e entende por que o autor prefere CLIs read-only para o que é perigoso.
Conceitos-chave
💎 Nugget · context rot · reverse meta-prompting
Três termos que o autor diz que "a maioria das pessoas ignora" — e que separam um OS amador de um OS que se mantém vivo. Cada um vem com a sua frase e a sua analogia.
Nugget
Um resumo super-destilado (tipo 10 bullets) do material bruto, pronto pra injetar no contexto.
Analogia: o caldo reduzido — concentrado, sem a água.
Context rot
A deterioração do contexto: o ponto em que a informação envelhece e precisa ser atualizada.
Analogia: comida com data de validade — em algum momento estraga.
Reverse meta-prompting
Pedir à IA, ao fim de uma sessão, que destile a própria conversa numa skill reutilizável.
Analogia: escrever a receita depois de já ter cozinhado.
💡 Como os três se conectam
Você destila o material em nuggets, monitora o context rot para saber quando atualizá-los, e usa reverse meta-prompting para transformar o que aprendeu numa skill — em vez de reescrever tudo do zero na próxima vez.
Por que aprender
Porque são os conceitos que mantêm o OS "cultivado" (Módulo 1.1) em vez de apodrecido. Eles aparecem de novo na Trilha 5 (produção): crons de síntese, pontos de corte por domínio e resumos pós-sessão saem todos daqui.
Conceitos-chave
📦 raw vs sintetizado
📖 O que é raw vs sintetizado?
Em uma frase: você guarda o material cru numa pasta raw/ (por garantia) e injeta no OS só a versão destilada — os nuggets — de uma pasta synthesized/.
Analogia: despensa (cru, guardado) vs. prato pronto (destilado, servido). Você cozinha a partir da despensa, mas serve só o prato.
A regra de ouro do autor é uma frase só: "injete apenas os nuggets". O material bruto (transcrições inteiras, PDFs longos) fica guardado, mas nunca vai direto pro contexto — porque entupiria a janela com ruído. Um modelo barato (um "workhorse", tipo Gemini Flash) faz o trabalho de resumir o bruto em nuggets, em loop.
Como ler: o bruto entra à esquerda e fica guardado; o modelo workhorse o reduz a nuggets; e só os nuggets cruzam a última seta para o contexto. A pasta raw/ nunca alimenta o modelo diretamente — ela é o seguro, não o ingrediente do prato.
Por que aprender
Porque "raw → sintetizado → injetado" é o padrão de dados que se repete em TODO domínio do curso. Fixá-lo agora faz a Trilha 2 (Substrato) e a Trilha 5 (produção) parecerem óbvias — você já sabe que guarda muito e injeta pouco.
Conceitos-chave
✅ Resumo do módulo
Próxima trilha:
Trilha 2 · Técnica I — começa pela Identidade (2.1), a primeira camada de verdade. 🪪