Template inicial de CLAUDE.md para Claude Code

Um CLAUDE.md fraco faz cada sessão começar fria

Se você precisa repetir as mesmas regras do projeto para Claude Code, o problema não é só o prompt. O projeto precisa de um pequeno arquivo operacional com comandos, limites, caminhos de risco e critérios de pronto.

Este template serve para código existente e combina com First Task Runbook.

O que colocar no template inicial

Você não precisa de um documento enorme. Comece por stack, comandos, caminhos arriscados, preferências de saída e definição de pronto.

# CLAUDE.md

## Project snapshot
- stack: Astro + TypeScript
- package manager: npm
- main app: site/

## Commands
- dev: cd site && npm.cmd run dev
- build: cd site && npm.cmd run build

## Guardrails
- do not touch: .env, dist, generated exports
- ask before: destructive git commands, production deploys, secret rotation

## Definition of done
- code change is applied
- verification command has run
- remaining risks are stated

Isso já torna a próxima sessão mais estável.

Exemplo para site de conteúdo

Em um site Astro multilíngue, adicione regras para mesmo slug, pubDate, updatedDate, heroImage e verificação pública de h1, canonical, idioma do corpo e links CTA.

O erro clássico é ter arquivos em todos os idiomas, mas deixar o corpo em inglês nas páginas não inglesas. Frontmatter certo não basta.

Quando adicionar regras

CLAUDE.md não deve crescer sem motivo. Adicione uma regra quando a mesma falha se repetir: comandos de build, regras multilíngues, critérios de review ou verificação de deploy.

Próximo passo

Para lembrar comandos, comece pelo cheatsheet gratuito. Para permissões, hooks, MCP ou CLAUDE.md, use o Setup Guide. Para regras de equipe, veja a consultoria.