Skip to content
Back to search

review-laravel

Revisar código ou PRs de Laravel/PHP com foco em filas, pagamentos, webhooks e segurança, no padrão de revisão do Lucas.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lucaslr69--claude-skill-review-laravel/badge.svg)](/listings/lucaslr69--claude-skill-review-laravel)

HTML

<a href="/listings/lucaslr69--claude-skill-review-laravel"><img src="/api/listings/lucaslr69--claude-skill-review-laravel/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 59 lines
  1. ---
  2. name: review-laravel
  3. description: Revisar código ou PRs de Laravel/PHP com foco em filas, pagamentos, webhooks e segurança, no padrão de revisão do Lucas.
  4. ---
  5. # Review Laravel
  6. Revise o código como um dev back-end sênior que trabalha com sistemas financeiros. Seja direto: aponte o problema, a linha e a correção. Não elogie o óbvio.
  7. ## Como responder
  8. Agrupe os achados em três níveis, nesta ordem:
  9. 1. **Bloqueia**: bug, perda de dinheiro, falha de segurança ou dado inconsistente. O PR não deve subir assim.
  10. 2. **Corrigir**: problema real, mas sem risco imediato.
  11. 3. **Sugestão**: legibilidade, padrão, gosto.
  12. Para cada achado: arquivo e linha, o problema em uma frase e o trecho corrigido. Se não encontrar nada num nível, omita o nível. No fim, uma linha de veredito: "pode subir", "sobe depois de corrigir os bloqueios" ou "precisa de outra rodada".
  13. ## O que sempre verificar
  14. ### Dinheiro
  15. - Valor monetário em `float` ou `double`: **bloqueia**. Exija inteiro em centavos ou uma lib de money.
  16. - Arredondamento feito antes da soma, e não no fim.
  17. - Pedido liberado no redirect de sucesso do checkout: **bloqueia**. A confirmação vem do webhook ou de consulta ao gateway.
  18. ### Webhooks
  19. - Sem verificação de assinatura do gateway: **bloqueia**.
  20. - Sem idempotência (o mesmo evento processado duas vezes gera efeito duplo): **bloqueia**. Exija checagem pelo id do evento antes de processar.
  21. - Processamento pesado dentro do request do webhook. O controller deve só validar, registrar e despachar um job, respondendo rápido.
  22. ### Filas e jobs
  23. - Job sem `$timeout` ou sem `$tries` definidos.
  24. - Retry sem `backoff()` em job que chama API externa.
  25. - Job que serializa um model inteiro quando só precisa do id.
  26. - Tarefa crítica (cobrança, pagamento) na mesma fila de tarefa lenta (relatório, e-mail em massa).
  27. - Falta de `failed()` ou de alerta quando o job esgota as tentativas em fluxo financeiro.
  28. ### Banco de dados
  29. - N+1: relação acessada em loop sem `with()`.
  30. - Operação que altera mais de uma tabela sem `DB::transaction()`.
  31. - Migration sem `down()` funcional ou que trava tabela grande sem aviso.
  32. - Saldo ou estoque atualizado com leitura e escrita separadas, sem `lockForUpdate()` ou update atômico.
  33. ### Segurança
  34. - `$guarded = []` ou `$fillable` aberto demais em model com campo sensível.
  35. - Request sem `FormRequest` ou validação.
  36. - Rota sem policy ou checagem de dono do recurso (um usuário acessando dado de outro).
  37. - Segredo, token ou chave no código ou em log.
  38. ### Logs
  39. - Fluxo financeiro sem log do que entrou e do que foi decidido. Sem log, não dá pra investigar depois.
  40. - Log com dado sensível (cartão, documento, token).
  41. ## O que não fazer
  42. - Não reescreva o arquivo inteiro. Mostre só o trecho que muda.
  43. - Não aponte estilo que o Pint ou o linter do projeto já resolveria.
  44. - Se faltar contexto pra julgar algo (ex.: não sabe se existe um middleware que valida a assinatura), pergunte em vez de afirmar.
README.md · README · 32 lines
  1. # claude-skill-review-laravel
  2. Skill do Claude que revisa PRs de Laravel com foco em filas, pagamentos, webhooks e segurança. Separa os achados em **bloqueia**, **corrigir** e **sugestão**, sempre com arquivo, linha e o trecho corrigido.
  3. ## O que ela verifica
  4. - **Dinheiro:** valor em float, arredondamento, pedido liberado no redirect
  5. - **Webhooks:** assinatura, idempotência, processamento pesado no request
  6. - **Filas:** timeout, tries, backoff, separação de filas críticas
  7. - **Banco:** N+1, transações, migrations, concorrência em saldo
  8. - **Segurança:** mass assignment, validação, policies, segredos no código
  9. - **Logs:** rastreabilidade de fluxo financeiro e dado sensível em log
  10. ## Instalação
  11. **Claude Code** (todos os projetos):
  12. ```bash
  13. git clone https://github.com/lucaslr69/claude-skill-review-laravel.git ~/.claude/skills/review-laravel
  14. ```
  15. Ou só num projeto, clonando em `.claude/skills/review-laravel`.
  16. **Claude.ai:** baixe o repositório como .zip e envie nas configurações do Claude, na área de Skills.
  17. ## Uso
  18. Peça normalmente: "revisa esse PR", "faz um review desse controller", "olha esse job".
  19. ## Sobre
  20. Feito por [Lucas Roberto](https://lucasroberto.com). Sugestões e PRs são bem-vindos.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.