Luijaa/web-template

Execute a verificação completa da checklist pré-PR (make check, varredura de segredos, documentação, revisão de diff) antes de abrir ou atualizar um pull request. Use antes de criar um PR ou quando perguntarem se o trabalho está pronto.

O que é web-template?

Esta skill automatiza a verificação de qualidade antes de abrir pull requests em repositórios que seguem o template web. Ela executa uma checklist abrangente de 12 itens, incluindo execução de `make check`, análise de segredos no diff, verificação de documentação e validação de mensagens de commit. Suporta plataformas como Claude Code (subagente `reviewer`) e outros agentes que leem o arquivo SKILL.md. É útil para garantir que nenhum PR seja aberto com problemas, evitando retrabalho e mantendo a consistência do projeto. A skill funciona analisando o diff contra a branch `main`, executando comandos definidos na Makefile e verificando arquivos de configuração e documentação.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Luijaa/web-template/tree/HEAD/.agents/skills/pre-pr-check

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Verificação Pré-PR

Faça todos os itens e reporte em uma tabela: Aprovado / Reprovado, com evidências (comandos e resultados resumidos).

  1. make check deve passar completamente (docs-check, lint + SAST, test, build, license) — exceto 2 casos:

    • PR somente de documentação (docs(design): …, ADR, docs): make docs-check passar é suficiente.
    • Repositório que ainda não escolheu stack (target exibe not configured — ADR-0001 ainda não aceito): reporte esse target como N/A (ainda não configurado), não como aprovado, e não é motivo para impedir — não modifique a recipe para exit 0 a fim de forçar aprovação.

    E make e2e se alterar o que o usuário vê (adicione/modifique e2e também) e make dast se mexer em middleware, header, cookie, página de erro ou nova rota.

  2. git diff origin/main...HEAD --stat — verifique se mexeu apenas nos arquivos relacionados ao trabalho, sem arquivos extras (build output, .env, arquivos pessoais).

  3. Logs temporários esquecidos: git diff origin/main...HEAD | grep -n '\[DBG-' não deve encontrar (tópico fix-bug item 3).

  4. Procure por segredos no diff: git diff origin/main...HEAD | grep -nEi '(api[_-]?key|secret|token|password|BEGIN .*PRIVATE KEY)' — se encontrar, pare e avise.

  5. Novas variáveis de ambiente estão presentes em .env.example.

  6. Dependências adicionadas/atualizadas (veja diff de lockfile, go.mod, Dockerfile FROM): versão e licença conforme docs/dependencies.md e especifique na descrição do PR.

  7. Migrações novas (se houver) devem ser executáveis e reversíveis.

  8. Documentação: README/docs/ADR (docs/adr/) atualizada conforme as mudanças; novos termos de domínio em CONTEXT.md e nomes no código consistentes com CONTEXT.md.

  9. Revise conforme a skill review (Claude Code: subagente reviewer; outros agentes: leia .agents/skills/review/SKILL.md e revise seu próprio diff) e corrija os itens "deve corrigir" antes.

  10. Mensagem de commit seguindo Conventional Commits e branch não sendo main.

  11. Descrição do PR contém Closes #<issue> (se não houver issue, crie uma antes) e seção ## CHANGELOG (categoria + 1 linha em português na perspectiva do usuário ou -) — não edite CHANGELOG.md diretamente (docs/release.md).

  12. Se mexer na UI: sem textos hardcoded, chaves completas para todos os idiomas, sem valores de cor diretos, visual consistente em th/en × light/dark (docs/ui.md).

Se algum item não passar, não abra o PR. Corrija antes ou reporte o que está travando.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas