laravel-verification

Visão geral da skill laravel-verification

O que a laravel-verification faz

A skill laravel-verification é um fluxo de verificação pré-PR e pré-deploy para projetos Laravel. Ela ajuda você a executar as checagens certas na ordem certa — ambiente, Composer, lint, análise estática, testes, segurança e prontidão para release — para identificar quebras antes que elas cheguem ao staging ou à produção.

Para quem ela é indicada

Use a skill laravel-verification se você trabalha em uma aplicação Laravel e precisa de uma passada de verificação repetível para refatorações, upgrades de dependências, falhas de CI ou preparação de release. Ela é especialmente útil para agentes e desenvolvedores que querem um laravel-verification guide estruturado, em vez de improvisar um prompt genérico.

O que a torna útil

O principal valor está no encadeamento. A skill não apenas lista verificações; ela bloqueia as etapas seguintes até que as anteriores estejam ok, o que reduz trabalho desperdiçado e facilita entender a origem das falhas. Isso faz diferença quando você precisa de laravel-verification for Workflow Automation, porque um ambiente quebrado, um problema de autoload ou uma inconsistência de configuração devem interromper a execução cedo.

Como usar a skill laravel-verification

Instale a skill laravel-verification

Use o fluxo de instalação do diretório para adicionar a skill e depois carregue-a no workspace em que você quer que o comportamento de verificação se aplique. Neste repositório, o comando base de instalação é:

npx skills add affaan-m/everything-claude-code --skill laravel-verification

Depois da instalação, confirme que a skill está disponível no contexto atual do projeto antes de pedir uma passada de verificação.

Leia primeiro os arquivos certos

Comece por SKILL.md, porque é nele que está o fluxo real de trabalho, e depois inspecione a pasta da skill ao redor para qualquer contexto vinculado, se houver. Neste repositório, SKILL.md é a fonte principal e não há scripts auxiliares nem pastas de referência, então o próprio arquivo é a primeira coisa em que você deve confiar.

Foque em:

• When to Use
• How It Works
• Phase 1: Environment Checks
• Phase 1.5: Composer and Autoload

Essas seções mostram onde realmente estão os limites de laravel-verification install e de uso.

Formule um pedido forte

A skill funciona melhor quando você dá um alvo concreto, e não um vago “verifique meu app”. Inclua o ambiente, o tipo de mudança e o risco para o release. Por exemplo:

• “Execute a skill laravel-verification neste app Laravel após um upgrade de PHP.”
• “Use laravel-verification para verificar a prontidão de staging desta branch.”
• “Aplique o laravel-verification guide a um candidato de deploy em produção e reporte apenas os bloqueios.”

Adicione as ferramentas que você realmente usa, como Sail, PHPUnit/Pest, PHPStan, Pint ou sua pipeline de deploy, para que a saída corresponda à sua stack.

Siga a ordem do fluxo

Uma boa execução começa com checagens de ambiente e validação do Composer, depois passa para lint/análise estática, em seguida testes, e por fim segurança e prontidão para deploy. Não peça para o modelo ir direto ao resultado dos testes ou ao aconselhamento de deploy se o ambiente base talvez já esteja quebrado. Esse encadeamento é o núcleo do padrão de uso de laravel-verification e é o que torna a skill mais acionável do que um prompt solto.

FAQ da skill laravel-verification

A laravel-verification é só para apps Laravel?

Sim. A skill foi desenhada em torno de checagens específicas do Laravel, como php artisan, autoload do Composer e prontidão de deploy para convenções do Laravel. Se o seu projeto não for baseado em Laravel, um prompt genérico de verificação vai se encaixar melhor.

Em que ela difere de um prompt normal?

Um prompt normal costuma gerar uma checklist sem estrutura. A skill laravel-verification dá a você uma ordem disciplinada de operações: verificar o ambiente, confirmar o autoload, rodar lint, analisar, testar e então revisar segurança e gates de release. Isso aumenta a confiabilidade quando você precisa de resultados consistentes entre branches ou agentes.

Quem está começando precisa entender todas as ferramentas antes?

Não, mas precisa saber em que ambiente está e o que mudou. A skill continua útil mesmo se você ainda não entende totalmente PHPStan ou prontidão de deploy, porque transforma a tarefa de verificação em uma sequência que você consegue seguir e inspecionar.

Quando não devo usar esta skill?

Não use laravel-verification para coding exploratório, brainstorming de UI ou ideação de features. Ela é uma skill de verificação, não de construção de funcionalidades. Ela também agrega menos valor se você só precisa de uma checagem isolada, como uma execução rápida de lint, em vez de um gate completo de release.

Como melhorar a skill laravel-verification

Dê um contexto inicial melhor à skill

O maior ganho de qualidade vem de dizer à skill o que mudou e qual risco importa para você. Compare:

• Fraco: “Verifique meu projeto Laravel.”
• Forte: “Verifique este app Laravel após alterar workers de fila, valores de env e uma migration de banco; mostre tudo que bloquearia o deploy.”

A segunda versão ajuda a skill laravel-verification a priorizar as checagens certas e a explicar as falhas em termos de deploy.

Combine as checagens com a sua stack

Se você usa Sail localmente, diga isso. Se usa Pest em vez de PHPUnit, ou PHPStan em um nível específico, inclua esse detalhe. Entradas fortes reduzem suposições erradas e fazem a saída de laravel-verification usage refletir seu repositório real, e não um padrão imaginário de Laravel.

Peça bloqueios, não ruído

Para tomada de decisão, peça apenas os problemas que realmente impedem merge ou deploy. Essa skill é mais útil quando distingue falhas críticas de limpeza opcional. Se quiser um resultado mais enxuto, solicite:

• apenas os problemas bloqueadores
• próximos testes sugeridos, em ordem
• veredito de prontidão para deploy
• chaves de ambiente ou de configuração ausentes

Isso mantém o laravel-verification guide focado em ação, não em narrativa.

Itere depois da primeira passada

Se a primeira execução encontrar uma falha, rode de novo com o comando exato que falhou, o ambiente em que você está e o objetivo da branch. Por exemplo, envie a saída do composer validate que falhou ou a suíte de testes específica que regrediu. Quanto mais preciso for o seu follow-up, melhor a próxima passada de verificação vai isolar a causa raiz e os próximos passos.