Nível 2 — Ferramenta de trabalho · Módulo 2.3 — CLAUDE.md que o Claude realmente segue
2.3.5 · O arquivo sob revisão permanente
5 min de vídeoTODOS
Objetivo: ao final, o consultor trata todo erro do Claude como um bug report contra o próprio CLAUDE.md, e distingue o que é padrão da Wayon do que cada squad acrescenta.
O que você precisa levar desta aula
Trate cada erro do Claude como um bug report contra o próprio CLAUDE.md: erro → identificar o que faltava nas instruções → escrever a regra → não se repete.
Regra prática de poda: se você não consegue justificar por que uma linha está ali, apague-a — é o mesmo princípio da aula 2.3.1, aplicado como hábito contínuo.
Existe um CLAUDE.md padrão da Wayon, com o que já vem pronto de fábrica para toda squad (convenção de nomenclatura, política básica de dados), e cada squad específica acrescenta por cima as regras do próprio projeto (no caso de vocês, o Meridiano).
O loop de melhoria contínua
Erro do Claude
→ O que faltava nas instruções (ou o que estava ambíguo)?
→ Escrever a regra nova, específica e verificável (aula 2.3.4)
→ O erro não se repete
Esse é o mesmo princípio que você já viu no Nível 1 a respeito de memória: cada erro é uma linha que faltava nas suas instruções. Aqui ele fica explícito, aplicado ao CLAUDE.md especificamente.
A regra da poda
Uma vez por sprint (ou sempre que o arquivo passar de uma tela de rolagem), leia o CLAUDE.md do projeto linha por linha e pergunte, para cada uma: "por que essa linha está aqui, e quem ainda depende dela?" Se não há resposta clara, apague. É mais barato reescrever uma linha necessária depois do que carregar dezenas de linhas mortas em toda sessão.
CLAUDE.md padrão da Wayon — esqueleto ilustrativo
O exemplo abaixo é ilustrativo — o objetivo é mostrar a divisão entre o que é padrão da casa e o que é específico de projeto, não prescrever o conteúdo exato:
# CLAUDE.md — Padrão Wayon
## Convenção de nomenclatura
- Commits: prefixo com o número do RICEFW ou chamado, ex: [MRD-1042] ...
- Branches: tipo/descrição-curta, ex: fix/validacao-alcada
## Política básica de dados
- Nenhum CPF, CNPJ ou dado pessoal real entra em sessão sem anonimização prévia
- Print de sistema produtivo com dado de usuário real precisa ser mascarado antes de anexar
---
# Regras específicas do projeto (cada squad acrescenta abaixo desta linha)
Camada do arquivo
Quem escreve
O que entra
Padrão Wayon (topo)
Wayon, central
Convenção de nomenclatura, política básica de dados — igual em todo projeto
Específico do projeto (abaixo)
A squad do projeto (ex: Meridiano)
Template de FS do cliente, exceções de ambiente, regras de negócio do rollout
Regra Wayon
Todo projeto novo começa a partir do CLAUDE.md padrão da Wayon, nunca de um arquivo em branco. A squad acrescenta as regras específicas do cliente abaixo da linha de corte — nunca reescreve ou remove o bloco padrão sem aprovação.
1.O Claude comete um erro que já havia acontecido antes, de forma parecida. A atitude mais alinhada com esta aula é:
a)Reclamar da resposta e refazer o pedido manualmente, sem alterar nada no CLAUDE.md
Resolve o caso pontual, mas não impede que o mesmo erro se repita na próxima sessão.
b)Trocar de modelo, assumindo que a versão atual tem uma limitação nova
O problema descrito é de instrução ausente ou ambígua, não de capacidade do modelo.
c)Tratar o erro como um bug report contra o CLAUDE.md: identificar o que faltava nas instruções e escrever a regra
Correto. É o loop de melhoria contínua descrito na aula.
Ver resposta e por quê
❌a) Resolve o caso pontual, mas não impede que o mesmo erro se repita na próxima sessão.
❌b) O problema descrito é de instrução ausente ou ambígua, não de capacidade do modelo.
✅c) Correto. É o loop de melhoria contínua descrito na aula.
2.Ao revisar o CLAUDE.md do projeto, você encontra uma linha antiga e não consegue lembrar por que ela foi escrita nem quem ainda depende dela. O que fazer?
a)Apagar — se você não consegue justificar por que a linha está ali, ela não deveria estar
Correto. É a regra prática de poda desta aula.
b)Manter, por precaução — pode ser importante mesmo sem justificativa clara
É exatamente o comportamento que faz o arquivo inchar sem controle, como visto na aula 2.3.1.
c)Perguntar ao Claude se a linha é importante, e seguir a resposta dele sem checar mais nada
O Claude não tem como saber a origem ou necessidade real de uma regra específica do seu contexto de negócio — a decisão de poda é do consultor.
Ver resposta e por quê
✅a) Correto. É a regra prática de poda desta aula.
❌b) É exatamente o comportamento que faz o arquivo inchar sem controle, como visto na aula 2.3.1.
❌c) O Claude não tem como saber a origem ou necessidade real de uma regra específica do seu contexto de negócio — a decisão de poda é do consultor.
3.O CLAUDE.md padrão da Wayon traz convenção de nomenclatura e política básica de dados. Uma squad de um projeto específico precisa de uma regra sobre o template de FS daquele cliente. Onde essa regra deveria entrar?
a)Abaixo da linha de corte, como regra específica do projeto, acrescentada pela squad
Correto. É exatamente a divisão descrita: padrão em cima, projeto embaixo.
b)Reescrevendo o bloco padrão da Wayon, para deixá-lo mais completo
O bloco padrão é comum a toda squad da Wayon; reescrevê-lo por projeto quebra a padronização entre clientes.
c)Em um CLAUDE.md totalmente separado, sem relação com o padrão da Wayon
Perderia a base comum da Wayon; o padrão deveria ser o ponto de partida, não algo ignorado.
Ver resposta e por quê
✅a) Correto. É exatamente a divisão descrita: padrão em cima, projeto embaixo.
❌b) O bloco padrão é comum a toda squad da Wayon; reescrevê-lo por projeto quebra a padronização entre clientes.
❌c) Perderia a base comum da Wayon; o padrão deveria ser o ponto de partida, não algo ignorado.
4.Qual afirmação descreve corretamente a relação entre o CLAUDE.md padrão da Wayon e o CLAUDE.md de um projeto específico como o Meridiano? ---
a)O projeto começa a partir do padrão da Wayon e acrescenta por cima as regras específicas daquele cliente
Correto.
b)São documentos independentes, sem relação entre si
O projeto parte do padrão da Wayon e acrescenta regras próprias — não são independentes.
c)O padrão da Wayon é opcional, e cada squad decide se usa ou não
Segundo a Regra Wayon desta aula, todo projeto novo parte do padrão — não é uma escolha opcional da squad.
Ver resposta e por quê
✅a) Correto.
❌b) O projeto parte do padrão da Wayon e acrescenta regras próprias — não são independentes.
❌c) Segundo a Regra Wayon desta aula, todo projeto novo parte do padrão — não é uma escolha opcional da squad.