São checklists que servem como guias de verificação para garantir que alterações realizadas pela inteligência artificial (IA) no código respeitem os padrões definidos e workflows do projeto, reduzindo erros e mantendo a consistência.
Garantir que o trabalho comece com entendimento e planejamento corretos.
- "Revisou as convenções" — lê os padrões do projeto antes de começar
- "Identificou as camadas afetadas" — define quais camadas serão afetadas para escolher o fluxo (Quick/Task)
- "Declarou/atualizou os gateways e DTOs necessários" — declara interfaces (ports) primeiro, não depois
- Evita violações de dependências
- Define contratos antes de implementar
- Escolhe o fluxo de trabalho adequado
Manter a qualidade e os princípios durante o desenvolvimento.
- "As dependências fluem apenas para dentro" — garante que dependências fluam para dentro
- "Os adaptadores permanecem enxutos" — evita lógica de negócio nos adapters.
- "Valores configuráveis lidos pela camada de configuração" — evita valores hardcoded
Obs.: Adapters devem ser responsáveis apenas pela tradução, orquestração e pelo input/output. A lógica de negócio deve residir nas entidades e nos serviços de domínio.
- Mantém a arquitetura limpa durante o trabalho
- Preserva a testabilidade
- Facilita a manutenção futura
Garantir que tudo está completo e documentado antes de pedir revisão.
- "Testes atualizados/aprovados" — garante testes para as camadas afetadas
- "Documentação ajustada" — atualiza a documentação relevante
- "Contexto do Memory Bank + alterações rápidas registradas" — registra mudanças no sistema de memória
- Evita revisões com trabalho incompleto
- Mantém a documentação atualizada
- Preserva o histórico de mudanças
Pontos fortes:
- ✅ Cobre o ciclo completo (antes, durante e depois)
- ✅ Foco em Clean Architecture (dependências, camadas)
- ✅ Prático e acionável
- ✅ Útil para IAs (checkpoints claros)
- ✅ Integra com o sistema de memória do projeto
Valor:
- Para humanos: checklists mentais
- Para IAs: guias programáticos
- Para o projeto: consistência e qualidade
- Adicionar exemplos breves do que “não fazer”
- Especificar onde registrar mudanças no Memory Bank
- Incluir validação automática quando possível (por exemplo, verificação de imports)
As checklists funcionam como:
- 🎯 guias de qualidade para manter padrões de projeto
- 🛡️ prevenção de erros comuns (dependências, lógica no lugar errado)
- 📋 padrão consistente de trabalho
- 🤖 instruções claras para IAs