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

2.3.6 · Regras por caminho, e o que o Claude anota sozinho

5 min de vídeo TODOS

Objetivo: ao final, o consultor move uma regra que só interessa a um tipo de arquivo para .claude/rules/ com paths:, e sabe que existe um arquivo de instruções que o Claude escreve por conta própria.

O que você precisa levar desta aula

  1. .claude/rules/ com paths: no frontmatter é o mecanismo que de fato economiza contexto: a regra só carrega quando o Claude lê um arquivo que casa com o padrão. Import (aula 2.3.3) não faz isso.
  2. Regra sem paths: carrega em toda sessão, com a mesma prioridade do CLAUDE.md — organiza, mas não economiza.
  3. Auto memory existe, vem ligada por padrão, e é o Claude escrevendo instruções para si mesmo em MEMORY.md. Fica na máquina do consultor, é auditável com /memory, e tem implicação de política de dados de cliente.

.claude/rules/ — como monta

Cada arquivo cobre um assunto, com nome descritivo. A descoberta é recursiva, então subpasta funciona:

projeto-meridiano/
├── CLAUDE.md                    # o essencial, que vale sempre
└── .claude/
    └── rules/
        ├── convencoes-gerais.md # sem paths: → carrega sempre
        ├── abap.md              # paths: abap/**/*.abap
        ├── specs.md             # paths: specs/**/*.md
        └── ambiente-mrd.md      # paths: config/**/*

Uma regra com escopo por caminho:

---
paths:
  - "abap/**/*.abap"
  - "abap/**/*.abap.txt"
---

# Convenções de ABAP — Meridiano

- Toda tabela Z citada precisa da nota de aprovação do arquiteto anexada
- Programa Z novo inclui cabeçalho com objetivo, tabelas afetadas e responsável

Padrões de paths: aceitos:

Padrão Casa com
**/*.abap Todo arquivo .abap, em qualquer pasta
specs/**/* Todo arquivo dentro de specs/
*.md Markdown na raiz do projeto
specs/**/*.{md,docx} Duas extensões no mesmo padrão (expansão de chaves)

Os quatro mecanismos, e quando cada um entra no contexto

Esta é a régua que fecha o módulo 2.3. Se você levar uma tabela desta aula, leve esta:

Mecanismo Quando carrega Economiza contexto?
Import (@arquivo.md no CLAUDE.md) Sempre, expandido inline no início da sessão Não
Rule sem paths: Sempre, com a mesma prioridade do .claude/CLAUDE.md Não
Rule com paths: Quando o Claude lê um arquivo que casa com o padrão Sim
Skill (módulo 2.4) Quando o assunto da conversa aciona a skill Sim

A diferença entre as duas últimas: a rule reage ao arquivo que o Claude abriu; a skill reage ao assunto do que você pediu.

Duas pegadinhas que custam tempo

Regras pessoais, em todos os projetos

~/.claude/rules/ funciona igual, mas vale para todo projeto da sua máquina — é a camada user da aula 2.3.2, agora organizada em arquivos. Carrega antes das regras de projeto.

Auto memory — o arquivo de instruções que você não escreveu

CLAUDE.md Auto memory (MEMORY.md)
Quem escreve Você O Claude, por conta própria
O que contém Regra, convenção, contexto de projeto Aprendizado e preferência que ele percebeu nas suas correções
Onde fica No projeto (versionado) ou no seu perfil ~/.claude/projects/<projeto>/memory/ — só na sua máquina
Carrega quando Toda sessão Toda sessão (o índice MEMORY.md; arquivos de detalhe entram sob demanda)
Como auditar Você abre o arquivo /memory lista e abre para edição

Quando você vê "Saved 2 memories" ou "Recalled 2 memories" na sessão, é isso acontecendo. Vem ligada por padrão. É markdown comum: dá para ler, editar e apagar.

Regra Wayon Auto memory grava aprendizados na máquina do consultor, sem passar por decisão de ninguém. Ao encerrar uma frente de trabalho de cliente, rode /memory e revise o que ficou registrado — detalhe de processo, nome de sistema ou regra de negócio do cliente não deveria permanecer ali depois do fim do engajamento. Esta checagem entra no checklist de encerramento, ao lado da Decisão 1 (política de dados) do Nível 1.

📖 Regras com escopo por caminho · Auto memory

Quiz — 4 questões

1.As 40 linhas de convenção de ABAP do CLAUDE.md só interessam a quem abre arquivo .abap, mas hoje carregam para toda a squad, em toda sessão. Qual é a solução que de fato economiza contexto?
  • a)Mover para um arquivo separado e referenciar com @convencoes-abap.md no CLAUDE.md

    Import é expandido inline no carregamento — organiza, mas o conteúdo continua ocupando o mesmo contexto para todo mundo (aula 2.3.3).

  • b)Mover para .claude/rules/abap.md com paths: "abap/**/*.abap" no frontmatter

    Correto. A regra passa a carregar só quando o Claude lê um arquivo que casa com o padrão.

  • c)Mover para .claude/rules/abap.md, sem frontmatter

    Sem paths:, a regra carrega em toda sessão com a mesma prioridade do CLAUDE.md — organiza, mas não economiza.

Ver resposta e por quê
❌a) Import é expandido inline no carregamento — organiza, mas o conteúdo continua ocupando o mesmo contexto para todo mundo (aula 2.3.3).
✅b) Correto. A regra passa a carregar só quando o Claude lê um arquivo que casa com o padrão.
❌c) Sem paths:, a regra carrega em toda sessão com a mesma prioridade do CLAUDE.md — organiza, mas não economiza.
2.Qual é a diferença entre uma rule com paths: e uma skill?
  • a)Não há diferença prática — as duas carregam sob demanda, do mesmo jeito

    As duas carregam sob demanda, mas o gatilho é diferente, e é isso que decide onde a instrução deve morar.

  • b)A rule reage ao arquivo que o Claude abriu; a skill reage ao assunto do que você pediu

    Correto. Convenção de um tipo de arquivo → rule. Procedimento de um tipo de tarefa → skill.

  • c)A rule serve para procedimento de várias etapas; a skill serve para convenção curta

    É o contrário: procedimento multi-etapa é caso de skill; a rule é boa para convenção ligada a um tipo de arquivo.

Ver resposta e por quê
❌a) As duas carregam sob demanda, mas o gatilho é diferente, e é isso que decide onde a instrução deve morar.
✅b) Correto. Convenção de um tipo de arquivo → rule. Procedimento de um tipo de tarefa → skill.
❌c) É o contrário: procedimento multi-etapa é caso de skill; a rule é boa para convenção ligada a um tipo de arquivo.
3.Depois de um /compact numa sessão longa, uma regra com paths: que estava ativa desaparece do contexto. Isso é:
  • a)Comportamento esperado — regra escopada por caminho se perde na compactação e volta quando o Claude ler de novo um arquivo que casa

    Correto. Se a regra precisa sobreviver a qualquer compactação, tire o paths: ou mova para o CLAUDE.md da raiz.

  • b)Um bug da compactação, que deveria preservar todas as regras carregadas

    Não é bug: regra escopada entra no histórico quando o arquivo-gatilho é lido, e a compactação resume esse histórico junto com o resto.

  • c)Sinal de que o frontmatter paths: está mal formado

    Frontmatter mal formado impediria a regra de carregar desde o início — aqui ela carregou normalmente e só se perdeu na compactação.

Ver resposta e por quê
✅a) Correto. Se a regra precisa sobreviver a qualquer compactação, tire o paths: ou mova para o CLAUDE.md da raiz.
❌b) Não é bug: regra escopada entra no histórico quando o arquivo-gatilho é lido, e a compactação resume esse histórico junto com o resto.
❌c) Frontmatter mal formado impediria a regra de carregar desde o início — aqui ela carregou normalmente e só se perdeu na compactação.
4.Você percebe a mensagem "Saved 2 memories" numa sessão de trabalho do Meridiano. O que está acontecendo, e o que isso exige de você?
  • a)O Claude salvou uma cópia de segurança da conversa no servidor da Anthropic

    Não é backup de conversa nem armazenamento remoto — auto memory é arquivo markdown local, na máquina do consultor.

  • b)É o auto memory — o Claude anotando aprendizados para si mesmo, na sua máquina; cabe a você auditar com /memory e limpar o que for dado de cliente

    Correto. Vem ligada por padrão, carrega em toda sessão, e revisar ao encerrar frente de cliente é Regra Wayon.

  • c)Uma skill de memória foi acionada, e é preciso aprovar cada anotação antes de ela ser gravada

    Não há aprovação por anotação: auto memory vem ligada por padrão e o Claude grava por conta própria; o controle é auditar depois, com /memory.

Ver resposta e por quê
❌a) Não é backup de conversa nem armazenamento remoto — auto memory é arquivo markdown local, na máquina do consultor.
✅b) Correto. Vem ligada por padrão, carrega em toda sessão, e revisar ao encerrar frente de cliente é Regra Wayon.
❌c) Não há aprovação por anotação: auto memory vem ligada por padrão e o Claude grava por conta própria; o controle é auditar depois, com /memory.