Um arquivo que a IA lê sozinha toda vez que começa. Você escreve o contexto do projeto uma vez e para de repetir tudo a cada conversa nova.
Um arquivo CLAUDE.md na pasta do seu projeto, com o que a IA precisa saber: o que é a página, pra quem, o seu jeito, os seus termos e as regras que não mudam. A partir dele, toda conversa nova já começa sabendo de tudo, sem você reexplicar. Reserve uns 15 a 20 minutos.
É o Capítulo 2, e ele resolve direto um dos buracos que o Capítulo 1 deixou de propósito: "a cada conversa nova você reexplica tudo".
O problema. Toda vez que você abre a aba "Code" pra mexer na sua página, a IA começa do zero. Pra ela acertar, você tem que lembrar de contar tudo de novo: que é um guia da Vila de Ilhabela, que é pra família que vai todo ano, que o tom é de quem conhece a ilha (não folheto), que você prefere um visual limpo... Esqueceu um detalhe? Ela chuta, e às vezes erra feio.
A melhor parte: você não escreve esse arquivo do zero. Na mesma conversa em que criou a página, a IA já tem o contexto todo. É só pedir pra ela registrar:
Ela cria o arquivo e te mostra. Por dentro é um texto simples, mais ou menos assim:
# Guia de Ilhabela: a Vila e as praias em volta ## O que é Um guia da Vila (o centro histórico de Ilhabela) e das praias em volta, pra família que vai todo ano e conhece a ilha. Público: família, curte sossego e o jeito local, não balada. Tom: de quem já foi, direto e honesto. ## Estilo visual Clima de mar e ilha, com personalidade. Visual limpo, sem espalhafato. Um arquivo HTML só, sem puxar nada de fora. Funciona bem no celular. ## Meus termos # o que a IA não tem como adivinhar - "a Vila" = o centro histórico de Ilhabela, não uma vila qualquer. - "os píeres" = o da Vila (fim da Rua do Meio) e o do Perequê. ## Regras que não mudam - Manter o aviso do repelente (os borrachudos são famosos). - Cheiro Verde: Rua da Padroeira, 109, na Vila. Não inventar outro endereço.
# no começo da linha vira título; o - vira item de lista. É só isso. Serve pra deixar o texto organizado sem editor especial (qualquer bloco de notas abre). Você quase não vai digitar isso à mão, mas é bom reconhecer quando vir.CLAUDE.md na pasta primeira-pagina, ao lado do index.html.O rascunho que a IA fez cobre o óbvio. O que faz o CLAUDE.md valer de verdade é você acrescentar o que ela não tem como adivinhar. Três coisas em especial:
Todo assunto tem termos e apelidos que só quem está dentro entende, e a IA não tem de onde adivinhar os seus. Um exemplo do próprio guia: pra você, "a Vila" é o centro histórico de Ilhabela; pra IA, pode ser qualquer vila. Uma linha no CLAUDE.md tira essa ambiguidade pra sempre. Vale pra tudo: os nomes internos do seu trabalho, os apelidos da família, os atalhos de um hobby.
Quando existe um lugar certo pra uma informação (um endereço, um número, uma regra), diga qual é, e peça pra ela não inventar quando não tiver certeza. É a diferença entre "acho que é" e "está escrito aqui".
Se tem algo que não pode ser tocado (um trecho que já funciona, um aviso importante, um endereço certo), deixe escrito. Vira uma trava: a IA respeita sem você precisar vigiar a cada mudança. No exemplo lá de cima, o "não inventar outro endereço" do Cheiro Verde é exatamente isso.
O teste de verdade: abra uma sessão nova na aba "Code", apontando a mesma pasta, e peça uma mudança sem dar nenhum contexto:
Repare: você não disse o que é a página, pra quem, nem o tom, e mesmo assim ela acertou o estilo. Ela leu o CLAUDE.md sozinha antes de começar. É a passagem de plantão funcionando.
Este é o Capítulo 2. Dois ganchos pra frente:
CLAUDE.md da pasta do projeto automaticamente no início da sessão (a "memória de projeto" do Claude Code): documentação oficial em code.claude.com/docs.# vira título, o - vira lista): convenção do próprio formato .md.