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.