Claude

Claude é o assistente de engenharia padrão da AEX — usado dentro do Cursor, no Claude Code e via chat. É a principal IA que escreve e revisa seguindo nossos padrões.

Documentação oficial: docs.claude.com. Aqui está apenas como usamos na AEX.

---

Papel na AEX

• Escrever código, documentação e planos no padrão da engenharia.
• Ler o contexto oficial via CLAUDE.md (deste repositório e de cada projeto).
• Executar os prompts padronizados de templates/prompts/.

---

Como o contexto funciona

• O CLAUDE.md é carregado automaticamente no início de cada sessão. Mantenha-o abaixo de ~200 linhas e objetivo.
• Não faça inline de documentos grandes no CLAUDE.md: referencie o arquivo e deixe o Claude ler sob demanda.
• Em conflito de regras, prevalece o padrão oficial da AEX Engineering; na dúvida, o Claude pergunta antes de assumir.
• Referência: CLAUDE.md da engenharia e CLAUDE_TEMPLATE para projetos.

---

Boas práticas

• Contexto antes de tarefa: aponte os arquivos e padrões relevantes.
• Peça plano em mudanças grandes antes de gerar código.
• Revise a saída: passa pelo code review como qualquer código.
• Use os prompts padrão para as tarefas comuns (novo projeto, feature, breakdown, reviews).

---

Evite

• Colar segredos, credenciais ou dados sensíveis em prompts.
• Aceitar decisões de arquitetura sem registrá-las em docs/DECISIONS.md.
• Tratar a resposta da IA como final sem validação humana.