majiayu000 name: validation-checklist description: Skill de validação pré-entrega para projetos de desenvolvimento (backend/frontend: tests, lint, tsc, docs, QA).
Quando usar
Após implementação pela equipe/agent de desenvolvimento, antes de entregar a task.
Objetivo
Garantir qualidade mínima e documentação alinhada antes do handoff.
Passos Universais
Aplicáveis a qualquer stack (backend ou frontend):
- Testes: executar
npm run test(unit + integration) sem falhas; cobrir fluxo principal e um alternativo por caso de uso. - Qualidade:
npm run lint,npm run format(se existir),npm run tsc --noEmit. - Execução manual: subir aplicação (
npm run start,npm run dev, ou comando do projeto) e validar funcionamento. - Documentação: atualizar
tasks.mdcom status; criar<numero-task>_testes_para_QA.mdno diretório da task (cenários, passos, dados, esperado). - Logs/Security: logging adequado (Winston, console estruturado); sem dados sensíveis em logs/fixtures.
Validações Específicas por Stack
Para projetos Backend (NestJS/Node.js)
- Validar endpoints tocados via
api.http(auth, payload, status esperado) - Atualizar Swagger com exemplos completos; adicionar requests no
api.http - Verificar DTOs, validações (class-validator) e guards/middlewares se aplicável
Para projetos Frontend (Next.js/React)
- Validar build production (
npm run build) sem erros - Verificar bundle size e performance (lighthouse, bundle analyzer)
- Testar SSR/SSG se aplicável (páginas renderizadas corretamente)
- Validar rotas e páginas funcionais no navegador
- Verificar componentes visuais e responsividade
Procedimento de falha
Se qualquer item falhar, PAUSAR e corrigir antes de entregar; registrar causa.
Saída esperada
- Relatório curto: comandos executados e status (PASS/FAIL), endpoints validados, docs atualizadas, pendências/riscos.