Criação de Pasta CLAUDE.md

Quando Usar

• Use quando o usuário pedir instruções de agente específicas da pasta ou arquivos de contexto local.
• Use quando um subdiretório precisar de um CLAUDE.md e AGENTS.md para entrega a agentes futuros.

Gere um CLAUDE.md focado dentro de uma pasta de destino, mais um link simbólico AGENTS.md apontando para ele. O arquivo fornece a qualquer agente futuro (Claude Code, Codex, etc.) o contexto específico da pasta que o CLAUDE.md global não cobre.

Referência de fundo: library/claude-code/claude-and-agents-md.md.

Processo

Etapa 1: Confirmar a pasta de destino + verificar se ela merece um arquivo

Pergunte ao usuário qual pasta. Use o caminho absoluto sob ~/Documents/code/workspace/.

Crie um arquivo apenas se a pasta tiver contexto necessário em várias sessões — trabalho ativo em evolução, convenções específicas, decisões em andamento. Uma pasta de arquivos de referência estáticos NÃO precisa de um (agentes podem ler sob demanda). Em caso de dúvida, pergunte ao usuário.

Etapa 2: Ler cada arquivo na pasta NA ÍNTEGRA

• Use ls -la primeiro para listar arquivos e subpastas.
• Leia todos os arquivos markdown, de configuração e de origem principais.
• Para subprojetos grandes de tldraw/Vite: leia package.json, src/App.tsx, um arquivo de módulo representativo e os arquivos no estilo module-details.md da própria pasta.
• NÃO passe os olhos. NÃO pule. As edições posteriores do usuário dependem de você ter o contexto completo.

Etapa 3: Rascunhar uma lista com marcadores de conteúdo candidato

Antes de escrever o arquivo, forneça ao usuário uma lista com marcadores agrupada por seção — deixe-os reagir primeiro. Seções candidatas (pule qualquer uma que não se aplique):

• Produto / Propósito — o que esta pasta/projeto é, estado atual, métricas chave
• Avatar / Público — para quem é (se aplicável)
• Arquivos Essenciais — função de uma linha para cada arquivo importante, incluindo referências entre pastas (use a sintaxe de importação @path/file.md)
• Restrições (NÃO DEVE) — negativos explícitos e rígidos. Conteúdo de maior ROI no arquivo.
• Convenções — a linguagem do usuário, emojis de status (✅ 🟡), padrões de nomenclatura, padrões de "geralmente fazer"
• Decisões Travadas — coisas acordadas + datadas, não devem ser re-litigadas
• Contexto — histórico, autoridade, credibilidade que enquadra o trabalho
• Como trabalhar com o usuário — estilo de colaboração para esta pasta específica
• Ângulos de Marketing / Posicionamento — se voltado para o público
• Principais Insights — 3-5 sinais mais gritantes da pesquisa (se houver pesquisa)

Etapa 4: Iterar com o usuário

• Mantenha as respostas curtas. O usuário editará diretamente no IDE.
• Quando eles editarem o arquivo, RELEIA-O e sinalize: contradições, erros de digitação, regras ausentes, categorização incorreta.
• Não reverta as edições deles, a menos que solicitado.

Etapa 5: Escrever o arquivo

• Caminho: <folder>/CLAUDE.md
• Comece com um cabeçalho de uma linha explicando o propósito do arquivo.
• Marcador de arquivo de subdiretório: se este for um arquivo de subdiretório (a pasta pai já tem seu próprio CLAUDE.md), abra com Apply root CLAUDE.md first, then this file.
• Use cabeçalhos de seção ## correspondentes às seções que o usuário aprovou.
• Marcadores em vez de prosa. Marcadores curtos.
• Referências entre pastas: use a sintaxe de importação @relative/path/file.md, não menções em prosa.
• Documentos de referência pesados: anote com gatilhos **Read when:** (por exemplo, "Ler quando: escrevendo cópia de oferta"). Evita carregar a cada sessão.

Etapa 6: Criar o link simbólico AGENTS.md

cd <folder> && ln -s CLAUDE.md AGENTS.md

Verifique com ls -la CLAUDE.md AGENTS.md.

Etapa 7: Fazer commit apenas quando solicitado

NÃO prepare ou envie, a menos que o usuário diga para fazer. Quando eles o fizerem: git add -A, faça o commit com uma mensagem no estilo Day N:, envie.

Regras

• Nunca invente conteúdo. Cada marcador deve rastrear algo que você leu na pasta ou algo que o usuário disse. Sem boilerplate genérico.
• Brevidade vence. O usuário edita agressivamente para encurtar as coisas. Comece conciso.
• Apenas com escopo de pasta. Não duplique o CLAUDE.md global (personalidade, datas, portas, etc.). Inclua apenas o que é específico para esta pasta.
• Sem árvores de arquivos, sem despejos de diretório, sem detalhes de pilha que o código já mostra. Qualquer coisa que um agente possa derivar de ls ou grep apodrece rapidamente e desperdiça tokens. Fixe decisões, regras e contexto — não estrutura.
• Restrições vs. Convenções. Regras rígidas de "NÃO DEVE" vão em Restrições (negativos explícitos). Padrões de "geralmente fazer X" vão em Convenções. Dividir isso melhora a adesão.
• Sem SEMPRE/NUNCA absolutos sem exceções explícitas. Casos extremos fazem com que regras absolutas sejam ignoradas. "Nunca cometer segredos EXCETO .env.example" é melhor do que "nunca cometer segredos".

…