27 convenções afinadas à mão

A filosofia

Começamos pelas formas como o código gerado por IA realmente quebra: tipos `any` silenciosos, erros engolidos, estados ilegais alcançáveis por campos opcionais, panes em runtime por entrada não validada. Cada regra é escrita para afastar o modelo de um desses modos de falha — e fica na biblioteca só se melhora visivelmente o código que os agentes produzem.

Cada regra é curta, opinativa e autocontida. Seu agente lê uma quando vai fazer a alteração correspondente — não todas no início da sessão. O resultado: prompts menores, contas menores e regras que o modelo consegue manter em memória ao escrever.

O que tem na biblioteca

A biblioteca atual conta com 27 convenções nas áreas em que o TypeScript gerado por IA mais erra: rigor de tipos, tratamento de erros, validação em fronteiras de confiança, nomes e estrutura de módulos, controle de fluxo, e padrões específicos de framework (formato de props de componentes React, convenções de modelos Prisma etc.).

As regras específicas estão disponíveis para assinantes via servidor MCP — não publicamos a lista completa aqui. Assine para ter acesso ao corpus.

Atualizações

Adicionamos e refinamos convenções conforme as ferramentas e os modelos evoluem. Atualizações entram em vigor instantaneamente: nada a redepoyar do seu lado. Mudanças relevantes são anunciadas aos assinantes por e-mail.