# Validation Checklist

> Skill de validação pré-entrega para projetos de desenvolvimento (backend/frontend: tests, lint, tsc, docs, QA).

- Skill: `majiayu000/validation-checklist` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/validation-checklist`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/validation-checklist/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/validation-checklist

---


---
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.