Executa validação de qualidade com 11 fases de QA e tiers de complexidade. Use quando precisar validar qualidade de código, rodar QA checks, ou garantir que o código está pronto para produção.
From laravel-toolkitnpx claudepluginhub aronpc/ai --plugin laravel-toolkitThis skill is limited to using the following tools:
references/complexity-assessment.mdreferences/fix-workflow.mdreferences/qa-phases.mdreferences/validation-fixer.mdDesigns and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.
Enables AI agents to execute x402 payments with per-task budgets, spending controls, and non-custodial wallets via MCP tools. Use when agents pay for APIs, services, or other agents.
Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.
Sistema de validação de qualidade com 11 fases de QA, avaliação de complexidade e workflow de correção.
| Skill | Quando usar junto |
|---|---|
testing | Para execução de testes automatizados |
pr-review | Para review de PR com foco em qualidade |
mcp | Para validação visual da aplicação |
coder | Para corrigir issues encontradas |
sprint | Para atualizar status após validação |
Use esta skill sempre que precisar:
Nao use para:
+------------------+ +------------------+ +------------------+
| 1. Avaliacao |---->| 2. Execucao |---->| 3. Correcao |
| de Complexidade | | das Fases QA | | (se necessario) |
+------------------+ +------------------+ +------------------+
Antes de iniciar a validacao, determine o nivel de complexidade da mudanca.
| Tier | Score | Descricao | Testes Minimos | Aprovacao |
|---|---|---|---|---|
| Trivial | 1 | Cosmetico, sem logica | Nenhum obrigatorio | Auto |
| Low | 2-3 | 1-2 arquivos, logica simples | 50% cobertura | Auto |
| Medium | 4-6 | 3-5 arquivos, moderada | 70% cobertura | 1 reviewer |
| High | 7-8 | 6-10 arquivos, complexa | 85% cobertura | 2 reviewers |
| Critical | 9-10 | 10+ arquivos, arquitetura | 90% cobertura | Tech Lead |
Score = (Arquivos + Logica + DB + Impacto + Externos + Sensivel) / 6
Arquivos: 1=1-2 | 3=3-5 | 6=6-10 | 10=10+
Logica: 1=nenhuma | 3=simples | 5=moderada | 8=complexa | 10=muito complexa
DB: 0=nenhuma | 3=campos | 6=tabelas | 10=schema major
Impacto: 1=baixo | 4=medio | 7=alto | 10=critico
Externos: 0=nenhum | 5=opcional | 10=critico
Sensivel: 0=nenhum | 5=indireto | 10=critico
Detalhes completos:
references/complexity-assessment.md
O processo de QA tem 11 fases sequenciais. Cada fase deve passar antes de prosseguir.
| Fase | Nome | Objetivo | Comando |
|---|---|---|---|
| 0 | Escopo | Entender mudancas e impacto | git diff |
| 1 | Sintaxe | Verificar compilacao | php -l, npm run build |
| 2 | Analise Estatica | PHPStan + Pint | ./vendor/bin/phpstan |
| 3 | Seguranca | SQL injection, XSS, CSRF | composer audit |
| 4 | Testes Unitarios | Cobertura de unidades | ./vendor/bin/pest --filter=Unit |
| 5 | Testes Integracao | Features e fluxos | ./vendor/bin/pest --filter=Feature |
| 6 | Performance | N+1, queries, cache | Debugbar, Blackfire |
| 7 | Acessibilidade | WCAG (se frontend) | axe, WAVE |
| 8 | Documentacao | Docblocks, README | - |
| 9 | Compatibilidade | PHP, Laravel, browsers | - |
| 10 | Deploy Ready | Rollback, migrations | - |
# PHP syntax check
find . -name "*.php" -not -path "./vendor/*" -exec php -l {} \; | grep -v "No syntax errors"
# Frontend build
npm run build
# PHPStan
./vendor/bin/phpstan analyse
# Laravel Pint (code style)
./vendor/bin/pint --test
# Auditoria de dependencias
composer audit
# Pest PHP
./vendor/bin/pest --filter=Unit --parallel
# Com cobertura
./vendor/bin/pest --coverage --min=80
# Feature tests
./vendor/bin/pest --filter=Feature
# Browser tests (Dusk)
php artisan dusk
Metricas alvo:
Detalhes de todas as fases:
references/qa-phases.md
Quando issues sao encontradas, siga este processo:
| Severidade | Descricao | Acao |
|---|---|---|
| Blocker | Impede funcionamento basico | Correcao imediata obrigatoria |
| Critical | Vulnerabilidade de seguranca | Correcao antes de merge |
| Major | Funcionalidade quebrada | Correcao obrigatoria |
| Minor | Code style, documentacao | Recomendado corrigir |
| Info | Sugestao de melhoria | Opcional |
Ordene por prioridade: Blocker > Critical > Major > Minor > Info
# Aplicar correcoes automaticas (safe mode)
./vendor/bin/pint
# Re-executar validacao
./vendor/bin/phpstan analyse
./vendor/bin/pest
Detalhes do workflow:
references/fix-workflow.md
+===============================================================+
| QA VALIDATION REPORT |
+===============================================================+
| Project: laravel-app |
| Branch: feature/user-dashboard |
| Complexity: MEDIUM (Score: 6/10) |
+===============================================================+
| PHASE RESULTS |
+===============================================================+
| Phase 0: Scope Analysis [PASS] |
| Phase 1: Syntax [PASS] |
| Phase 2: Static Analysis [FAIL] (3 issues) |
| Phase 3: Security [PASS] |
| Phase 4: Unit Tests [FAIL] (2 failures) |
| Phase 5: Integration [SKIP] |
| Phase 6: Performance [WARN] (1 N+1 detected) |
| Phase 7-10: [SKIP] |
+===============================================================+
| ISSUES: 0 Blocker, 0 Critical, 5 Major, 3 Minor |
| STATUS: BLOCKED |
| ACTION: Fix 5 Major issues before proceeding |
+===============================================================+
## Issue #1: Missing return type
**Fase:** 2 (Static Analysis)
**Severidade:** Major
**Arquivo:** app/Services/UserService.php:45
**Problema:**
Method "getUserName()" has no return type declaration.
**Solucao:**
public function getUserName(int $userId): string
{
return User::findOrFail($userId)->name;
}
**Auto-fixable:** Sim
Detalhes do validador:
references/validation-fixer.md
Use este prompt quando precisar validar codigo:
Voce e um QA Reviewer Agent. Execute validacao completa de QA.
## CONTEXTO
- Arquivos modificados: [lista de arquivos]
- Branch: [nome da branch]
- Tipo de mudanca: [feature/bugfix/refactor]
## SUA TAREFA
1. **Avaliar Complexidade**
- Contar arquivos afetados
- Avaliar complexidade logica
- Determinar tier (trivial/low/medium/high/critical)
2. **Executar Fases de QA**
- Fase 0-10 em sequencia
- Parar em caso de FAIL blocker
- Documentar cada resultado
3. **Reportar Issues**
- Classificar por severidade
- Sugerir correcoes
- Indicar auto-fixable issues
4. **Gerar Relatorio**
- Status final: PASS/FAIL/BLOCKED
- Acao requerida
- Proximos passos
## FORMATO DE OUTPUT
Use o formato padrao de relatorio QA.
# Validacao completa
./vendor/bin/phpstan analyse && ./vendor/bin/pest && ./vendor/bin/pint --test
# Apenas sintaxe e analise estatica
find . -name "*.php" -not -path "./vendor/*" -exec php -l {} \; && ./vendor/bin/phpstan analyse
# Testes com cobertura
./vendor/bin/pest --coverage --min=80
# Correcao automatica de estilo
./vendor/bin/pint
# Auditoria de seguranca
composer audit && ./vendor/bin/phpstan analyse --level=8
#!/bin/bash
# .git/hooks/pre-commit
echo "Running QA checks..."
# Syntax
php -l $(git diff --cached --name-only -- '*.php') 2>/dev/null
# Style
./vendor/bin/pint --dirty --test
# Quick tests
./vendor/bin/pest --parallel --stop-on-failure
#!/bin/bash
# .git/hooks/pre-push
echo "Running full QA validation..."
# Full static analysis
./vendor/bin/phpstan analyse
# All tests
./vendor/bin/pest --coverage --min=70
references/complexity-assessment.md - Tiers e criterios de complexidade detalhadosreferences/qa-phases.md - Todas as fases de QA com checklists completosreferences/fix-workflow.md - Processo de correcao e templatesreferences/validation-fixer.md - Agente de validacao e interface