Qualidade do código

Qualidade mostra se o código está bem escrito e sem excesso. Código de IA costuma funcionar e ainda assim acumular problemas que só aparecem depois: um erro engolido em silêncio, uma função que ninguém entende, três cópias do mesmo trecho, um pacote instalado para algo que a linguagem já faz.

A checagem nunca trava o agente: os achados vêm para o painel, e o agente recebe um resumo no início da sessão.

Duas camadas

O que a checagem sem IA procura

Código sem uso, trechos repetidos, o ranking dos mais complexos e o tsc/ESLint só entram na checagem completa, a do início da sessão.

Em que linguagens

A checagem sem IA funciona sem instalar nada em JavaScript e TypeScript (com React Native, Vue, Angular, Svelte e Astro), Python, Flutter e Dart, PHP, Go, Java, Kotlin, C#, Rust, C, C++, Dockerfile, HTML e CSS. Ela lê o código por conta própria; o tsc e o ESLint só entram se o projeto já os tem. A tabela completa está em Linguagens suportadas.

O que a revisão com IA procura

Código demais (sempre com o substituto concreto), falhas escondidas, tipos que não protegem, complexidade, comentários que mentem, testes que não protegem nada e regras do CLAUDE.md desobedecidas. O agente só registra o achado quando tem confiança de 80 ou mais, com a prova no código. No fim, ele resume quanto dá para cortar ("−120 linhas, −2 pacotes possíveis") ou diz "Enxuto. Pode seguir."

O card de estado

No topo de todas as abas: quantos problemas estão abertos e quantos são altos, quando foi a última checagem, os contadores (Altos, Abertos, Novos em 7 dias, Corrigidos) e a linha da última revisão com IA, com uma nota de 0 a 4 por tema.

Também é aqui que fica o interruptor Lembrete para a IA não escrever código demais: 6 linhas que vão para o agente no início de cada sessão, lembrando-o de preferir o que a linguagem e o projeto já têm. Vem desligado.

Abas

O detalhe de um achado explica O que é, Por que importa e Como resolver, com o arquivo, a linha e a regra. Os botões:

• Corrigir com a IA: copia /faundr:quality-fix Q-n. O agente corrige sem mudar o que o app faz, pede o seu OK antes de mexer em vários arquivos ou remover pacotes, e só fecha quando a checagem não encontra mais o problema.
• Ignorar, com o motivo: É de propósito, Alarme falso ou Deixar para depois (volta sozinho em 30 dias).

Achados de outras skills

Se você já usa uma skill de revisão de código que não é do Faundr, dá para conectá-la ao painel com /faundr:skills. Toda vez que ela roda, no fim da resposta o agente registra o que ela achou:

• cada problema vira um Q-n aqui, com a etiqueta via /nome, e conta no Lançamento e no Impacto como os outros;
• quando ela roda de novo e o problema sumiu, ele fecha sozinho;
• cada skill só fecha os próprios achados, e só nos arquivos que olhou.

Veja como conectar em Workflows.

Atalhos conscientes

Às vezes vale fazer o simples agora e melhorar depois. Para isso não virar dívida esquecida, marque o atalho no código:

// faundr: busca só pelo nome, melhorar quando passar de 1.000 produtos

O formato é // faundr: <o limite do atalho>, <quando melhorar>. A aba Atalhos lista todos, com o arquivo, quem escreveu e há quanto tempo. Os que não dizem quando melhorar aparecem primeiro.

Regras da casa

Uma regra da casa é algo que o time não quer ver no código, como "nada de fetch direto nas telas". Ela vira um arquivo em .faundr-regras/, que vai para o git com o resto do projeto, e a checagem passa a apontar onde aparece:

!faundr quality-rule "Sem fetch nas telas" --pattern "\bfetch\(" --files "src/components/**" --message "Use o cliente de src/lib/api.ts"

As regras da Memória com padrão proibido funcionam do mesmo jeito. Veja Memória.

Pular um trecho

Na linha de cima de um trecho que quebra uma regra de propósito:

// faundr-ignore <regra>: <motivo>

Para o arquivo inteiro, use faundr-ignore-file <regra>.

Comandos