validation-checklist

开发项目交付前验证技能(后端/前端:测试、代码检查、TypeScript编译、文档、质量保证)。

📖 中文导读:开发项目交付前验证技能(后端/前端:测试、代码检查、TypeScript编译、文档、质量保证)。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

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):

  1. Testes: executar npm run test (unit + integration) sem falhas; cobrir fluxo principal e um alternativo por caso de uso.
  2. Qualidade: npm run lint, npm run format (se existir), npm run tsc --noEmit.
  3. Execução manual: subir aplicação (npm run start, npm run dev, ou comando do projeto) e validar funcionamento.
  4. Documentação: atualizar tasks.md com status; criar <numero-task>_testes_para_QA.md no diretório da task (cenários, passos, dados, esperado).
  5. 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.