Guia de Código Claude

Propósito

Fornecer uma referência abrangente para configurar e usar o Claude Code (a ferramenta de codificação agentiva) em todo o seu potencial. Esta habilidade sintetiza as melhores práticas, modelos de configuração e padrões de uso avançado.

Configuração (CLAUDE.md)

Leia as instruções do projeto existentes primeiro. Adicione ou atualize um CLAUDE.md do projeto apenas dentro do escopo solicitado, preservando as convenções do repositório e as instruções existentes. O modelo abaixo ilustra um projeto npm React/TypeScript; substitua seus comandos e regras de pilha por fatos verificados do projeto.

Modelo (Geral)

# Project Guidelines

## Commands

- Run app: `npm run dev`
- Test: `npm test`
- Build: `npm run build`

## Code Style

- Use TypeScript for all new code.
- Functional components with Hooks for React.
- Tailwind CSS for styling.
- Early returns for error handling.

## Workflow

- Read `README.md` first to understand project context.
- Before editing, read the file content.
- After editing, run tests to verify.

Recursos Avançados

Palavras-chave de Pensamento

Declare explicitamente os critérios desejados de investigação e verificação. Essas frases descrevem tarefas; elas não são interruptores garantidos para o esforço de raciocínio do modelo:

• "Pense passo a passo"
• "Analise a causa raiz"
• "Planeje antes de executar"
• "Verifique suas suposições"

Depuração

Se o agente travar ou se comportar inesperadamente:

1. Limpar Contexto: Salve o estado da tarefa e as evidências relevantes antes de iniciar uma nova sessão. Um prompt para esquecer instruções não apaga as regras do projeto carregadas.
2. Instruções Explícitas: Seja extremamente específico sobre caminhos, nomes de arquivos e resultados desejados.
3. Logs: Peça ao agente para "verificar os logs" ou "executar o comando com saída detalhada".

Melhores Práticas

1. Contextos Pequenos: Não despeje todo o codebase no contexto. Use rg ou rg --files para localizar arquivos relevantes primeiro.
2. Desenvolvimento Iterativo: Peça pequenas alterações, verifique e, em seguida, prossiga.
3. Loop de Feedback: Se o agente cometer um erro, corrija-o imediatamente e peça para ele "adicionar uma lição" à sua memória (se suportado) ou CLAUDE.md.

Verificação

Inspecione o diff resultante e confirme se as instruções pretendidas são realmente carregadas no host instalado. As instruções do projeto guiam o comportamento; elas não impõem um limite de segurança. Mantenha segredos fora das instruções rastreadas. Verifique os recursos atuais em relação à documentação oficial de memória.

Referência

Baseado em Claude Code Guide by zebbern.

Quando Usar

Use ao configurar instruções de projeto, diagnosticar orientações conflitantes do Claude Code ou definir fluxos de trabalho de compilação/teste verificados.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.