everything-claude-code/docs/pt-BR/rules/patterns.md

Padrões Comuns

Projetos Skeleton

Ao implementar novas funcionalidades:

1. Buscar projetos skeleton bem testados
2. Usar agentes paralelos para avaliar opções:
   • Avaliação de segurança
   • Análise de extensibilidade
   • Pontuação de relevância
   • Planejamento de implementação
3. Clonar a melhor opção como fundação
4. Iterar dentro da estrutura comprovada

Padrões de Design

Padrão Repository

Encapsular acesso a dados atrás de uma interface consistente:

• Definir operações padrão: findAll, findById, create, update, delete
• Implementações concretas lidam com detalhes de armazenamento (banco de dados, API, arquivo, etc.)
• A lógica de negócios depende da interface abstrata, não do mecanismo de armazenamento
• Habilita troca fácil de fontes de dados e simplifica testes com mocks

Formato de Resposta da API

Use um envelope consistente para todas as respostas de API:

• Incluir indicador de sucesso/status
• Incluir o payload de dados (nullable em caso de erro)
• Incluir campo de mensagem de erro (nullable em caso de sucesso)
• Incluir metadados para respostas paginadas (total, página, limite)