← Voltar ao curso
Nível 2 — Ferramenta de trabalho · Módulo 2.3 — CLAUDE.md que o Claude realmente segue

2.3.4 · Frases que colam

5 min de vídeo TODOS

Objetivo: ao final, o consultor reescreve uma regra vaga do CLAUDE.md como uma regra específica, verificável, e com o substituto nomeado — e sabe dosar ênfase.

O que você precisa levar desta aula

  1. Específico e verificável: não "siga boas práticas", mas algo como "toda spec funcional usa o template em templates/FS.md, uma seção por gap identificado" — você consegue checar se foi seguida.
  2. Nomeie o substituto, não só a proibição: não "não use tabela Z sem justificar", mas "toda tabela Z citada precisa da nota de aprovação do arquiteto anexada".
  3. Ênfase é orçamento: IMPORTANT e YOU MUST em maiúsculas só funcionam se forem raros — gaste nas 2-3 regras que realmente doem quando quebradas, não em toda linha.

Os três princípios, lado a lado

Princípio Regra vaga Regra reescrita
Específico e verificável "Siga boas práticas de documentação." "Toda spec funcional usa o template em templates/FS.md, uma seção por gap identificado."
Nomeie o substituto "Não use tabela Z sem justificar." "Toda tabela Z citada precisa da nota de aprovação do arquiteto anexada."
Ênfase é orçamento Oito de quinze linhas em "IMPORTANT" Duas linhas em "IMPORTANT" — só as que doem de verdade quando quebradas

Como testar se uma regra está bem escrita

Pergunte: "se eu olhasse o resultado, sem saber o que o consultor pediu, eu conseguiria dizer se essa regra foi seguida?" Se a resposta exige interpretação ("parece que seguiu boas práticas..."), a regra ainda está vaga demais.

📖 Escrevendo instruções eficazes

Quiz — 3 questões

1.(Exercício aberto) Reescreva as três regras abaixo, tornando cada uma específica e verificável: - "Siga boas práticas de teste." - "Tenha cuidado com desempenho de consulta." - "Documente direito as mudanças no código." Gabarito de exemplo — compare pela lógica (específico, verificável, com substituto nomeado), não pelo texto exato: - ✅ "Todo caso de teste gerado inclui pré-condição, passo a passo e resultado esperado, na mesma estrutura da matriz de testes do módulo 2.8.F2." - ✅ "Toda consulta a uma tabela com mais de 1 milhão de registros usa um índice já existente, ou anexa a justificativa de novo índice na FS." - ✅ "Todo programa Z novo inclui um cabeçalho de comentário com objetivo, tabelas afetadas e responsável, antes do primeiro commit."

1. (Exercício aberto) Reescreva as três regras abaixo, tornando cada uma específica e verificável:

  • "Siga boas práticas de teste."
  • "Tenha cuidado com desempenho de consulta."
  • "Documente direito as mudanças no código."

Gabarito de exemplo — compare pela lógica (específico, verificável, com substituto nomeado), não pelo texto exato:

  • ✅ "Todo caso de teste gerado inclui pré-condição, passo a passo e resultado esperado, na mesma estrutura da matriz de testes do módulo 2.8.F2."
  • ✅ "Toda consulta a uma tabela com mais de 1 milhão de registros usa um índice já existente, ou anexa a justificativa de novo índice na FS."
  • ✅ "Todo programa Z novo inclui um cabeçalho de comentário com objetivo, tabelas afetadas e responsável, antes do primeiro commit."
2.Uma regra do CLAUDE.md diz "não use tabela Z sem justificar". O problema central dessa redação é:
  • a)Ela nomeia a proibição, mas não o substituto — não fica claro o que conta como "justificar"

    Correto. Falta nomear o que precisa existir no lugar da proibição.

  • b)Ela proíbe algo que na verdade deveria ser permitido sem restrição

    A restrição em si é razoável; o problema é como ela foi escrita, não a existência dela.

  • c)Ela é longa demais para caber no orçamento de atenção do modelo

    O problema não é o tamanho da frase — é a falta de especificidade sobre o que "justificar" significa na prática.

Ver resposta e por quê
✅a) Correto. Falta nomear o que precisa existir no lugar da proibição.
❌b) A restrição em si é razoável; o problema é como ela foi escrita, não a existência dela.
❌c) O problema não é o tamanho da frase — é a falta de especificidade sobre o que "justificar" significa na prática.
3.Um CLAUDE.md tem oito de quinze linhas marcadas com "IMPORTANT" em maiúsculas. O efeito mais provável disso é: ---
  • a)O modelo prioriza corretamente todas as oito, na ordem em que aparecem no arquivo

    Ênfase espalhada demais tende a perder efeito, não a reforçar prioridade em ordem.

  • b)O arquivo passa a ser tratado como configuração, não como guia

    Isso não muda a natureza do arquivo (aula 2.3.1) — CLAUDE.md continua sendo guia, só que com ênfase mal distribuída.

  • c)A ênfase perde força — se quase tudo é "importante", nada se destaca de verdade

    Correto. Ênfase é orçamento; usada em excesso, vira ruído uniforme.

Ver resposta e por quê
❌a) Ênfase espalhada demais tende a perder efeito, não a reforçar prioridade em ordem.
❌b) Isso não muda a natureza do arquivo (aula 2.3.1) — CLAUDE.md continua sendo guia, só que com ênfase mal distribuída.
✅c) Correto. Ênfase é orçamento; usada em excesso, vira ruído uniforme.