Your Codebase, Your Rules: Beyond Standard Linters

Uma sessão prática de duas horas sobre como transformar expectativas de qualidade de código e convenções de equipe em verificações automatizadas, para que desenvolvedores e agentes de codificação recebam feedback sobre o que pertence à sua base de código, e não apenas sobre o que compila.

O código pode ser executado corretamente e ainda assim violar as regras da sua equipe: muitas ramificações em uma única função, lógica de negócios no diretório errado ou chamadas que ignoram uma API aprovada. Por meio de pequenas demonstrações práticas, tornaremos essas violações visíveis, ajustaremos limites de complexidade e implementaremos convenções que nenhum linter padrão conhece.

A ênfase está em tornar suas expectativas executáveis. Em vez de repetir uma convenção em cada prompt ou revisão de código, nós a expressaremos como uma verificação que identifica violações e fornece feedback concreto para corrigi-las. Também distinguiremos prováveis bugs de preferências da equipe e exploraremos por que passar em todas as verificações não significa automaticamente um bom design.

Público-alvo: desenvolvedores, líderes técnicos e arquitetos interessados em manter a consistência das bases de código à medida que as contribuições humanas e geradas por IA aumentam. Não é necessária experiência prévia na criação de verificações personalizadas.

Resultados:

• Distinguir verificações de correção, medições de complexidade e convenções definidas pela equipe
• Configurar um limite de complexidade e observar seu efeito em códigos que, de outra forma, permaneceriam inalterados
• Implementar regras personalizadas sobre onde funções e dependências específicas pertencem
• Aplicar convenções de nomenclatura específicas da aplicação além dos padrões integrados de uma ferramenta
• Entender quando a inspeção de sintaxe é suficiente e quando uma análise mais profunda é necessária
• Fornecer aos desenvolvedores e agentes de codificação feedback acionável em vez de lembretes repetidos
• Reconhecer o que as verificações automatizadas podem aplicar — e o que ainda requer julgamento

Formato: duas horas com uma breve introdução, pequenas demonstrações práticas, violações deliberadas de regras, discussão de compensações (tradeoffs) e perguntas e respostas.