java-quality-gate

name	java-quality-gate
description	Executa e interpreta os quality gates de projetos Java (Spotless, Checkstyle, JaCoCo, PIT mutation testing, ArchUnit). Use antes de fechar tarefa/PR em projetos Java/Spring, ou quando o usuário pedir "rode os gates", "verifique a qualidade".

Skill: Java Quality Gate

Objetivo

Executar os quality gates da stack Java, interpretar as falhas e produzir um veredito GO/NO-GO de qualidade — sem nunca relaxar thresholds para "passar".

Quando usar

Antes de fechar tarefa/PR em projetos Java; ao validar a qualidade de uma mudança.

Quando NÃO usar

Quando só precisa rodar testes unitários (rode ./mvnw test direto) ou quando o projeto não é Java. Para o gate final completo de PR, combine com pre-pr-review.

Inputs esperados

• Branch/diff alvo.
• Escopo (módulo/classe) quando aplicável — PIT em projeto grande é lento; restrinja com -DtargetClasses.

Workflow

1. Rode o orquestrador de gates (detecta build tool e plugins automaticamente):

bash .claude/scripts/quality/verify-all.sh --fast   # loop de desenvolvimento
bash .claude/scripts/quality/verify-all.sh --full   # antes de fechar tarefa/PR

2. Para um gate específico, rode o script correspondente em .claude/scripts/quality/ (format-check.sh, checkstyle.sh, test-unit.sh, jacoco.sh, mutation-test.sh, archunit.sh, package-rules.sh).
3. Leia o resumo gerado em .claude/harness_engineer/results/quality-summary.md.
4. Classifique cada resultado: falha real (bloqueia) × gate ausente (reportar, não é falha) × melhoria (sugestão). Consolide o GO/NO-GO.

Saída esperada

## Quality Gates — <branch>

| Gate | Status | Detalhe |
|---|---|---|
| Spotless | ✅/❌/– | |
| Checkstyle | ✅/❌/– | |
| Testes + JaCoCo | ✅/❌/– | cobertura X% (threshold Y%) |
| PIT | ✅/❌/– | mutation score X% |
| ArchUnit | ✅/❌/– | |

**Veredito: GO | NO-GO** (– = gate não configurado no projeto)

Critérios de qualidade

• Nunca relaxar thresholds (cobertura/mutation) para o build passar.
• Gate ausente ≠ falha — reporte e sugira adotar os configs de config/ desta skill.
• Não esconder falhas: sempre reporte causa + correção sugerida.

Segurança

• Nunca rodar comandos destrutivos (rm -rf, git reset --hard).
• Nunca expor secrets/.env/credenciais nos logs dos gates.

Recursos incluídos (config/)

Configs prontos para adotar em projetos que ainda não têm os gates:

• pom-quality-plugins.example.xml — bloco de plugins Maven (Spotless, Checkstyle, JaCoCo, PIT) para colar no pom.xml.
• checkstyle/checkstyle-java25.xml + suppressions.xml.
• spotless/eclipse-java-formatter.xml + spotless-java25.md.
• pitest/pitest-rules.md — política de mutation testing.
• archunit/architecture-rules.md — regras de arquitetura sugeridas.
• archunit/ArchitectureTest.java — teste ArchUnit pronto para copiar (com allowEmptyShould: passa vacuosamente até os pacotes existirem).
• package-organization.md — padrão de organização de pacotes (hexagonal: web/message/application/domain/infrastructure/core). Ao criar classes novas em projetos Java, siga esta convenção; nunca reestruture pacotes existentes sem aprovação.