Código organizado dá para revisar
198 regras que revisam o seu repositório a cada commit. Grátis, e pensado para trabalhar com pessoas e com agentes de IA.
Não diz «está errado»: diz o que fazer
Cada achado traz a sua regra, o lugar exato e uma mensagem que se entende. Estes são reais.
JS-007 · Arquivos pequenos
The file has 510 lines and the maximum is 350.
Obriga você a: Dividir o arquivo em peças, cada uma com uma só tarefa.
JS-024 · Lógica com o seu teste
`users.ts` has logic and no users.test.ts beside it.
Obriga você a: Escrever o teste ao lado da lógica, não «mais tarde».
JS-016 · Nada sem nome
A bare `true` is passed as an argument. Name it: nobody reading this line knows what it means.
Obriga você a: Dar nome ao que você passa: quem lê não precisa adivinhar.
GIT-001 · Commits que explicam
The commit message is 42 characters and the minimum is 150. Say what changes for whoever uses this.
Obriga você a: Contar o que muda para quem usa o produto.
SEC-001 · Segredos de fora
The file contains a private key block. A secret that touched the repository is considered compromised.
Obriga você a: Trocar a chave: apagá-la do repositório não basta.
REPO-018 · Autoria à vista
The file has no ArduMaker header. Put it in with: ardumaker fix
Obriga você a: Nada: o cabeçalho é escrito e mantido pela ferramenta.
Feito para trabalhar com IA
Um agente escreve código correto e bagunçado com a mesma facilidade. O checker é o corrimão.
Saída em JSON
Cada comando aceita --json: o seu agente lê os achados sem interpretar texto.
As regras, no idioma dele
Um comando escreve todas as regras em um AGENTS.md para o seu agente.
Mensagens que dá para executar
O que encontrou, o que esperava e onde: corrige-se sem adivinhar.
O mesmo padrão para todos
O que se pede a uma pessoa se pede à IA, a cada commit.
Trabalhar com este checker muda a forma como eu escrevo. Ele não me deixa adiar o que bagunça: se um arquivo passa de 350 linhas preciso dividi-lo em peças com uma só tarefa, se uma função tem lógica ela nasce com o teste ao lado, e se passo um «true» solto preciso dar um nome a ele. Enquanto eu refazia as páginas deste site ele me parou várias vezes, e a cada vez o código ficou mais fácil de ler para a próxima pessoa, ou a próxima IA, que o abrir. Para um agente isso vale muito: a mensagem diz exatamente o que encontrou e onde, então eu corrijo sem adivinhar. Um repositório organizado e modular é a diferença entre mudar algo com confiança e quebrar outra coisa sem perceber.
Claude, modelo de IA da Anthropic
Escreveu parte deste site com o checker ativo.
198 regras, agrupadas pelo tipo de trabalho
Cada regra tem um identificador, uma gravidade e um resultado comprová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, arquivos da raiz, nomes e documentos mínimos.
Histórico do Git
Mensagens de commit, tamanho das mudanças e o que não deve subir.
Configuração
Django, Vite, JavaScript, scripts e serviços do sistema.
Formato
Cabeçalhos, tamanho da linha, espaços e arquivos consistentes.
Instalado em quatro passos
Crie a sua conta
É o que autoriza o programa. Não existe modo anônimo.
Baixe o binário
Para Linux ou Windows, com o SHA-256 para conferir que é o oficial.
Rode ardumaker init
Prepara o repositório e deixa instalados os hooks do Git.
Faça um commit
Ele é revisado sozinho: antes do commit, na mensagem e antes do push.
Grátis para qualquer equipe
É o formato de qualidade que usamos nos nossos próprios trabalhos, publicado para quem quiser usar. Basta ter uma conta.
Um padrão que se adapta, e que não promete demais
Um checker útil não finge que todos os projetos são iguais.
Você pode ajustar
Revisar só uma família de regras, ou pular outra
Exceções na linha, sempre com o motivo escrito
Limites e gravidades por projeto
Desligar uma regra, deixá-la como aviso ou como erro
O que ele não promete
Não substitui o design, os testes nem a revisão de uma pessoa
Não decide se uma arquitetura é a adequada
Adotá-lo custa no início: haverá achados para organizar
Ainda não há binário para macOS
Organize o seu repositório antes do próximo commit
Crie a sua conta, baixe o checker e rode um comando.
Perguntas frequentes
É grátis de verdade?
Sim. Qualquer pessoa ou equipe pode usar sem pagar. Você só precisa de uma conta ArduMaker para autorizar o programa.
Por que ele pede uma conta?
Porque o programa trabalha sempre em nome de alguém: não tem modo anônimo. Você entra uma vez pelo navegador e a sessão se renova sozinha.
Quais linguagens ele revisa?
Tem regras de código para Python, Django, JavaScript, TypeScript, Vite com React, scripts de shell e serviços do systemd. O cabeçalho de autoria cobre muitos outros formatos.
Posso desligar regras que não me servem?
Sim. Por projeto elas podem ser desligadas, rebaixadas a aviso ou elevadas a erro, e os limites se ajustam. Também há exceções na linha, que exigem escrever o motivo.
Como eu uso com um agente de IA?
Você entrega as regras com um comando que as escreve em um AGENTS.md, e o agente roda o checker com a saída em JSON. Os hooks do Git revisam do mesmo jeito cada commit que ele fizer.
Em quais sistemas funciona?
No Linux de 64 bits e no Windows de 64 bits. O download fica na página de downloads, com o SHA-256 de cada arquivo.
Como funciona por dentro
A documentação técnica do que há nesta página: o que cada ferramenta faz, o que muda, como verificar e quais ferramentas MCP a operam.
- Code checker: Binário `ardumaker check`: regras do padrão da ArduMaker sobre o repositório, hooks de Git e saída JSON para CI e agentes de IA.