Prelint

O Prelint fica ao lado da sua revisão de código atual e olha para uma camada que a maioria das ferramentas ignora: se o código bate com o que o time de fato combinou construir. Ele lê especificações em markdown, registros de decisões de arquitetura e documentos de requisitos de produto guardados no seu repositório, e transforma tudo isso em critérios de revisão. Quando um PR contradiz uma dessas decisões, o Prelint avisa.

O problema que ele ataca é específico. Agentes de programação com IA escrevem código limpo, que passa nos testes e está bem estruturado, mas que ainda assim quebra as regras do seu produto. Uma página de preços que cita prazos de 60 dias quando a política de cobrança diz 30, ou um fluxo de cadastro que adiciona uma etapa de consentimento da LGPD para clientes só dos EUA. O seu linter não pega isso. O seu revisor humano talvez pegue, se tiver tempo e lembrar da política. Então o que cobre a lacuna quando nenhum dos dois cobre?

O maior limite é o escopo por design. O Prelint não substitui o seu linter, o seu verificador de tipos nem o seu scanner de segurança, e não vai corrigir o código para você. Ele lê contexto dentro de um limite de caracteres e depende da qualidade dos documentos que você fornece. Se entra lixo, sai lixo.

Primeiros passos

1. Instale o GitHub App e escolha quais repositórios o Prelint deve revisar. Não são necessárias mudanças no CI nem arquivos YAML.
2. Adicione contexto ao repositório colocando dentro dele especificações de produto, registros de decisões ou documentos de arquitetura. Os arquivos markdown são indexados automaticamente.
3. Abra um pull request. O Prelint o revisa em segundos e publica achados como comentários em linha fixados nas linhas que os provocaram.
4. Leia o registro de decisões para ver quem decidiu o quê, quando e se a decisão veio de uma pessoa ou de uma IA. As decisões aprovadas viram contexto que os seus agentes reaproveitam na próxima vez.