Em algum momento você começa a perceber que a qualidade das respostas do Claude varia dependendo de como os arquivos de contexto estão escritos. Um CLAUDE.md com cabeçalhos ## e listas com traços é diferente de um CLAUDE.md com XML Tags. O Claude responde melhor ao segundo.
Esse artigo explica por quê — e como aplicar.
Dois argumentos para XML
Semântica explícita. Quando você usa um cabeçalho ## Objetivo, o Claude sabe que aquilo é importante pelo contexto. Quando você usa <objetivo>, o Claude sabe o que aquilo significa — é a seção que define o resultado esperado. O nome da tag carrega significado que vai além da hierarquia.
Com tags como <processo>, <gatilho>, <aprendizado>, você não está só organizando o texto — está descrevendo a estrutura do trabalho. O Claude navega essa estrutura de forma mais direta e produz respostas mais precisas.
Qualidade observada na prática. Comparei a diferença em trabalhos reais com alunos. O mesmo processo documentado com headers e listas versus com XML Tags gerou resultados notavelmente diferentes. O Claude com XML Tags cometia menos suposições, seguia a estrutura do processo com mais fidelidade, e identificava as seções corretas sem ambiguidade.
A distinção que resolve tudo
Existe uma regra que elimina qualquer dúvida sobre quando usar XML:
Claude lê primeiro → XML Tags. Humano lê primeiro → Markdown normal.
Arquivos que vivem no ambiente do trabalho — CLAUDE.md, processos, specs, documentação de marca, design tokens — são lidos pelo Claude antes de chegarem ao humano. Esses arquivos usam XML Tags, sem cabeçalhos, sem listas, sem tabelas.
Conteúdo publicado — artigos do site, posts do LinkedIn, apresentações para clientes — é lido por humanos. Esses usam Markdown normal, com toda a formatação que melhora a leitura humana.
O critério é simples e não tem caso a caso.
As quatro armadilhas do iniciante
Tag não fechada. A tag abre e não fecha. O Claude tenta inferir o que pertence a ela, com resultados imprevisíveis.
<processo>
Algo importante aqui.O correto:
<processo>
Algo importante aqui.
</processo>Aninhamento errado. Uma tag fecha antes da tag pai fechar.
<processo>
<objetivo>
</processo>
</objetivo>O correto é: a tag filha sempre fecha antes da tag pai.
Nome inconsistente entre arquivos. <processo> em um arquivo e <process> em outro. Para o Claude, são tags diferentes. Defina nomes e mantenha.
kebab-case quebrado. <criterioInicial> em vez de <criterio-inicial>. Tags compostas usam hífen, não camelCase.
Dicionário das tags do método
Ao longo dessa série, apareceram tags com significados específicos. Esta lista é referência para consulta quando precisar:
<processo> — wrapper raiz da documentação de um processo no CLAUDE.md da tarefa.
<gatilho> — o que aciona o processo. Quando ele começa.
<etapas> — sequência interna do processo. Pode ficar como placeholder no dia 1, preenchida na execução.
<objetivo> — o resultado esperado. Quando o processo termina.
<aprendizado> — decisões e melhorias capturadas das notas integradas a cada execução.
<nota> — anotação inline em qualquer arquivo, sempre referente ao trecho imediatamente anterior. Integrada e removida depois.
Essa lista vai crescer conforme o método evolui. O dicionário fica nesse artigo — você volta aqui quando precisar consultar.
Estou ministrando mentorias para profissionais de diversas áreas que estão começando nessa ideia. Se não quer percorrer esse caminho sozinho, é só me chamar.