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

2.3.1 · CLAUDE.md é guia, não configuração

4 min de vídeo TODOS

Objetivo: ao final, o consultor explica por que um CLAUDE.md que cresce demais para de ser seguido, e identifica quando uma regra não pertence ali.

O que você precisa levar desta aula

  1. Cada linha do CLAUDE.md compete com todas as outras pela atenção do modelo — quanto mais enxuto o arquivo, mais cada regra é seguida.
  2. Uma regra dura (algo que nunca pode acontecer, como "nunca commitar em main") não pertence ao CLAUDE.md — pertence a um hook, código que roda de verdade. O módulo 3.2 aprofunda isso.
  3. CLAUDE.md é guia, não configuração: nada ali trava uma ação sozinho — ele influencia decisão, não impõe restrição.

Guia vs Configuração

CLAUDE.md (guia) Hook (configuração)
Natureza Texto que o modelo lê e pesa Código que executa de verdade
Garantia Nenhuma — depende de atenção, que se dilui com o tamanho do arquivo Total — bloqueia ou libera a ação antes dela acontecer
Quando usar Convenção, preferência, contexto de projeto Regra que nunca pode ser violada, sob nenhuma circunstância
Onde aprofundar Este módulo (2.3) Módulo 3.2 (Nível 3)

Sintomas de um CLAUDE.md inchado

Se dois ou mais desses sintomas aparecem, o arquivo já passou do ponto em que "adicionar mais uma regra" ajuda. A aula 2.3.5 volta a este ponto com a prática de poda.

📖 Gerenciar a memória do Claude Code — CLAUDE.md

Quiz — 4 questões

1.Um CLAUDE.md que tinha 20 linhas cresceu para 200 ao longo de seis meses, sempre por adição, nunca por revisão. Uma regra que estava lá desde o início parou de ser seguida. A explicação mais provável é:
  • a)A regra agora compete com muito mais linhas pela atenção do modelo, mesmo sem ter sido alterada

    Correto. É o ponto central da aula: cada linha compete com todas as outras.

  • b)A regra foi editada por engano e perdeu a redação original

    No cenário descrito a regra não muda — o que muda é o volume ao redor dela.

  • c)O modelo tem um limite fixo de regras que consegue processar, e 200 já passa desse limite

    Não é um limite numérico fixo — é competição por atenção, que se degrada gradualmente, não num corte abrupto.

Ver resposta e por quê
✅a) Correto. É o ponto central da aula: cada linha compete com todas as outras.
❌b) No cenário descrito a regra não muda — o que muda é o volume ao redor dela.
❌c) Não é um limite numérico fixo — é competição por atenção, que se degrada gradualmente, não num corte abrupto.
2.A regra "nunca commitar direto em main" precisa ser garantida sob qualquer circunstância, mesmo que o CLAUDE.md esteja grande naquele dia. Onde ela deveria estar?
  • a)No topo do CLAUDE.md, em maiúsculas, para chamar mais atenção

    Ajuda um pouco, mas não garante nada — ainda depende do modelo ler e priorizar entre outras linhas.

  • b)Em um hook — código que bloqueia a ação de verdade, independente do tamanho do CLAUDE.md

    Correto. Regra dura pertence a configuração real, não a texto competindo por atenção.

  • c)Duplicada em três lugares diferentes do CLAUDE.md, para reforçar

    Duplicar aumenta o arquivo e piora a competição por atenção — o oposto do efeito desejado.

Ver resposta e por quê
❌a) Ajuda um pouco, mas não garante nada — ainda depende do modelo ler e priorizar entre outras linhas.
✅b) Correto. Regra dura pertence a configuração real, não a texto competindo por atenção.
❌c) Duplicar aumenta o arquivo e piora a competição por atenção — o oposto do efeito desejado.
3.Qual afirmação descreve corretamente a natureza do CLAUDE.md?
  • a)É um arquivo de configuração: o que está escrito ali é executado, como uma regra de sistema

    Não é configuração — nada nele é executado ou garantido por código.

  • b)É irrelevante para o comportamento do modelo, só serve como documentação para humanos

    Influencia sim o comportamento — só não garante nada, que é diferente de ser irrelevante.

  • c)É um guia: o modelo lê e pesa o conteúdo junto com tudo mais que está competindo por atenção na sessão

    Correto.

Ver resposta e por quê
❌a) Não é configuração — nada nele é executado ou garantido por código.
❌b) Influencia sim o comportamento — só não garante nada, que é diferente de ser irrelevante.
✅c) Correto.
4.Dois sintomas apareceram no CLAUDE.md do seu projeto: seções contraditórias entre si, e ninguém do time sabe de cabeça o que está nas últimas linhas. A conclusão mais adequada é: ---
  • a)É hora de adicionar uma seção nova explicando as contradições

    Adicionar mais texto piora exatamente o problema que os sintomas indicam.

  • b)Isso é normal para qualquer CLAUDE.md com mais de seis meses de uso

    Não é inevitável — é sintoma de que só se adicionou, nunca se revisou, ao longo do tempo.

  • c)O arquivo passou do ponto em que "adicionar mais uma regra" ajuda — precisa de revisão, não de acréscimo

    Correto.

Ver resposta e por quê
❌a) Adicionar mais texto piora exatamente o problema que os sintomas indicam.
❌b) Não é inevitável — é sintoma de que só se adicionou, nunca se revisou, ao longo do tempo.
✅c) Correto.