mcpField
S
specsfy-specialist-laravel

specsfy-specialist-laravel

github.com/promovawebDevelopment87242 installsUpdated 1w ago
Repository

About specsfy-specialist-laravel

A Laravel development skill for inspecting an existing project and implementing changes within its conventions. It emphasizes authorization, data handling, focused tests, and operational checks.

Key features

  1. 01Inspect project instructions and active specs
  2. 02Trace requests through domain and persistence
  3. 03Plan authorization, validation, and transactions
  4. 04Build jobs with retries and failure handling
  5. 05Validate with tests and static analysis

Use cases

  1. 01Add a feature following existing Laravel conventions
  2. 02Review migration safety during deployment
  3. 03Diagnose queue, scheduler, or query concerns

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/promovaweb/specsfy --skill specsfy-specialist-laravel

After installing, type/specsfy-specialist-laravelin Claude Code to confirm it loaded.

Bundled filesagents/openai.yamlreferences/standards.md

Details

From the project README

Laravel

Fluxo

  1. Ler as instruções, a spec ativa e os manifests do projeto consumidor.
  2. Descobrir versões e extensões em composer.json e composer.lock.
  3. Mapear a requisição até domínio, persistência, efeitos assíncronos e resposta.
  4. Localizar convenções em arquivos irmãos e testes existentes.
  5. Definir autorização, validação, transação, idempotência e falhas antes do código.
  6. Materializar o teste focal, implementar a menor fatia e refatorar.
  7. Executar testes, análise estática, formatter e verificação operacional disponíveis.

Padrões

  • Manter controllers finos e regras de negócio no boundary já adotado.
  • Usar Form Requests, policies, resources e bindings quando forem contratos locais.
  • Tratar Eloquent como acesso a dados, sem esconder consultas caras ou N+1.
  • Projetar jobs idempotentes, com timeout, tentativas, backoff e tratamento de falha.
  • Preparar migrations compatíveis com o volume, lock esperado, rollback e deploy misto.
  • Nunca confiar em validação do cliente nem autorizar somente na interface.
  • Não criar abstração, pacote ou evento sem consumidor e benefício verificável.

Validação

  • Cobrir caminho feliz, autorização, validação, efeitos e falhas relevantes.
  • Inspecionar queries quando cardinalidade ou latência importar.
  • Verificar queues, scheduler, cache, config e variáveis no ambiente alvo.
  • Registrar riscos de dados e comandos operacionais sem executá-los sem autorização.

Leia references/standards.md para padrões detalhados e fontes oficiais conforme a área alterada.

Comments

Markdown supported