o manual que sua ia lê antes de tudo

sua ia é um gênio com amnésia: esquece tudo entre conversas. reexplicar o projeto toda vez é jogar tempo fora. o claude.md é o manual que ela lê primeiro, com 6 seções e ~200 palavras, sempre que abre aquela pasta.

seções sugeridas

o suficiente pra orientar

palavras, mais ou menos

não precisa ser longo

repetição

explica uma vez, vale sempre

arquivo na raiz

é só isso que importa existir

role para ver o modelo completo

01 · o problema que o claude.md resolve

o gênio que esquece tudo

sem memória entre conversas, toda sessão nova começa do zero. o claude.md é a memória permanente do projeto.

cartão de vidro flutuante organizado em seções de linhas, com fragmentos de luz dispersos e desconectados ao fundo simbolizando memória perdida

o que é o claude.md

o claude.md é um arquivo de texto simples, na raiz do projeto, que funciona como um manual: o que é o projeto, o objetivo, as decisões já tomadas, as referências importantes. toda vez que uma conversa é aberta naquela pasta, a ia lê o manual primeiro, antes de qualquer pergunta. não precisa ser longo: o que importa é existir.

02 · template pronto pra copiar

as 6 seções do seu manual

copie a estrutura abaixo pro seu claude.md e preencha cada seção com uma ou duas frases.

# identidade do projeto

## o que é
uma frase direta descrevendo o projeto.

## objetivo
o que esse projeto precisa entregar.

## decisões já tomadas
escolhas que não precisam ser repensadas toda sessão.

## referências
links, arquivos ou pastas que a ia deve consultar.

## convenções e restrições
regras de nomenclatura, o que nunca fazer, o que sempre seguir.

03 · como as ~200 palavras se distribuem

nada precisa ser um tratado

distribuição ilustrativa: cada seção pede só o essencial, não um ensaio.

seções no total