Checker de qualidade para equipes de software

Veja o resultado

O mesmo código, com um padrão visível

O checker não para em um número vermelho: ele mostra o que estava desorganizado e como fica quando cada decisão tem um lugar. É uma saída útil tanto para uma pessoa quanto para um agente de IA.

src/services/users.ts

cabeçalho mantido pelo ArduMaker Checker

verificação pronta

Ver comparação

Antes · desorganizado

Depois · organizado

4 achados

sem bloqueios

Sem tipos claros, sem contrato documentado e com responsabilidades misturadas.

Contrato explícito, validação na borda e uma saída rápida de revisar.

estrutura

cada coisa no seu lugar

entrega

menos contexto perdido

leitura

10 linhas, uma intenção

A mudança

Pare de depender da memória de alguém.

Antes

• Cada pessoa organiza o código de um jeito.
• Problemas de estrutura aparecem quando já afetam a equipe.
• A revisão depende de memória, critério e tempo disponível.
• Um agente de IA pode produzir mudanças corretas, mas desorganizadas.

Depois

• Os mesmos padrões se aplicam a todos os repositórios.
• Os hooks revisam o trabalho antes do commit.
• Cada achado informa o que encontrou, esperava e onde está.
• A saída JSON permite integrar agentes e automações sem ambiguidade.

O que revisa

198 regras agrupadas por tipo de trabalho

O catálogo vem dos nossos padrões internos e é público para que qualquer equipe adote o mesmo formato de qualidade. Não é uma lista de dicas: cada regra tem identificador, severidade e resultado verificável.

• Código e nomes: estrutura, assinaturas, complexidade e convenções.
• Segurança: segredos, credenciais, logs sensíveis e configurações perigosas.
• Repositório: README, Git, arquivos raiz, nomes e documentos necessários.
• Configuração: Django, Vite, JavaScript, infraestrutura e deploys.
• Trabalho com IA: JSON estável, contexto explícito e saída pronta para agentes.
• Formato: cabeçalhos, linhas, colunas, espaços e arquivos consistentes.

Como trabalha

Controle automático, decisão humana

O checker percorre cada arquivo uma vez, mede valores concretos e retorna códigos úteis para um hook ou deploy. Ele só atualiza os cabeçalhos mantidos pela ferramenta; o restante é corrigido sob demanda.

• Instale por repositório com `ardumaker init` e revise cada commit.
• Os achados distinguem erros, avisos e regras desligadas.
• Ative uma família ou regra específica com `--only` e `--skip`.
• Sua conta ArduMaker autoriza o terminal sem identidade anônima.

Exceções que podem ser entendidas

Um padrão útil não finge que todos os projetos são iguais. A configuração permite ajustar limites, mudar severidades e documentar a decisão da equipe.

• As regras podem ser ativadas por família ou ID.
• As regras desligadas por decisão explicam por que não rodam por padrão.
• Os limites vêm da própria regra para manter documentação e comportamento alinhados.

O que não promete

Um checker não substitui design, testes nem revisão humana. Ele pode apontar estrutura e disciplina, mas não decide se um produto é valioso ou se uma arquitetura é adequada.

Adotá-lo tem um custo inicial: haverá achados para organizar. O benefício aparece quando o repositório deixa de acumular o mesmo problema em cada entrega.