convez.ai
SkillDesenvolvimento WebIntermediário
CauanDZN

Legacy PHP Maintainer

CauanDZN/legacy-php-maintainer

Especialista em manutenção segura de PHP legado (5.6+) para Claude Code

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude Code que transforma a IA em um desenvolvedor sênior especializado em manutenção de sistemas PHP legados. Fornece diretrizes, skills reutilizáveis e padrões para evoluir código antigo com segurança, preservando compatibilidade e padrões existentes.

Instalação

$npx convez-ai CauanDZN/legacy-php-maintainer

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
57%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Investigar padrões de código antes de implementar mudanças
  • Corrigir bugs em sistemas PHP antigos sem quebrar compatibilidade
  • Modernizar gradualmente código legado mantendo estabilidade
  • Implementar novos módulos seguindo padrões já existentes
  • Avaliar risco e planejar rollback para cada mudança

Veredito

Skill bem pensada que endereça um problema real: usar IA em legado PHP sem quebrar produção. A abordagem de investigação-antes-de-codificação e preservação de padrões é sólida e pragmática para equipes que mantêm sistemas antigos.

README

A tradução para o português deste README ainda está na fila.

Legacy PHP Maintainer

🔧 Especialista em manutenção e evolução de sistemas PHP legados para Claude Code.

Um conjunto completo de Skills, configurações e diretrizes para trabalhar com código PHP antigo (5.6+) de forma segura e compatível.

📋 O que é Isso?

Se você mantém sistemas PHP antigos em produção, sabe que usar IA generativa é perigoso:

  • ❌ A IA tenta "modernizar" seu código
  • ❌ Refatora sem razão
  • ❌ Introduz padrões que não existem no projeto
  • ❌ Quebra compatibilidade
  • ❌ Não entende regras de negócio implícitas

Legacy PHP Maintainer transforma Claude em um desenvolvedor sênior especializado em legado, não em um arquiteto tentando modernizar tudo.

🎯 Recursos

✅ Incluso

  • CLAUDE.md — Configuração automática do comportamento do Claude
  • Skills Reutilizáveis:
    • legacy-php-maintainer — Para implementar mudanças seguras
    • legacy-php-investigator — Para investigar código antes de tocar
  • Exemplos de Uso — Casos reais resolvidos
  • Detecção Automática — Detecta PHP 5.6, 7.x, 8.x e gera código compatível
  • Padrão de Resposta — Claude sempre responde com análise, não código precipitado

🛡️ Garantido

  • Preservação de compatibilidade
  • Investigação antes de codificação
  • Reutilização de padrões existentes
  • Avaliação de risco explícita
  • Plano de rollback para cada mudança

🚀 Início Rápido

1. Clone/Copie para seu Projeto

# Se você já tem um projeto PHP legado
cd seu-projeto-legado

# Copie os arquivos deste repositório
git clone https://github.com/CauanDZN/legacy-php-maintainer.git
cp -r legacy-php-maintainer/CLAUDE.md ./
cp -r legacy-php-maintainer/.claude ./

2. Configure Claude Code

Se você usa Claude Code:

# O CLAUDE.md é lido automaticamente
# As Skills estão em .claude/skills/
# Tudo pronto para usar

3. Use as Skills

Para Investigar Antes de Codificar

/legacy-php-investigator

Preciso adicionar um novo sistema de cupons. 
Investigue padrões similares antes de implementar.

Para Implementar Mudanças Seguras

/legacy-php-maintainer

Corrigir bug em processarPagamento() sem quebrar 
código existente. Como faço?

📚 Estrutura

legacy-php-maintainer/
├── CLAUDE.md                           # Configuração automática
├── README.md                           # Este arquivo
├── .claude/
│   └── skills/
│       ├── legacy-php-maintainer/
│       │   ├── SKILL.md               # Skill de implementação
│       │   └── examples/
│       │       └── exemplo_corrigir_bug.md
│       └── legacy-php-investigator/
│           ├── SKILL.md               # Skill de investigação
│           └── examples/
│               └── exemplo_novo_modulo.md
└── CONTRIBUTING.md                    # Como contribuir

💡 Exemplos de Uso

Cenário 1: Investigar Novo Módulo

Pergunta:

/legacy-php-investigator

Preciso criar um sistema de notificações por email.
Antes de codificar, investigue se existe código similar.

Resposta Claude:

  • Mapeia onde estão as notificações existentes
  • Identifica padrão de codificação
  • Aponta quais arquivos copiar como template
  • Recomenda onde adicionar o novo código

Cenário 2: Corrigir Bug com Segurança

Pergunta:

/legacy-php-maintainer

A função calcularDesconto() tem um bug. Ela retorna 
apenas o desconto, não o valor final. Como corrijo 
sem quebrar código que a usa?

Resposta Claude:

  • Mostra todos os lugares que chamam a função
  • Propõe 2+ opções (nova função, parâmetro, etc)
  • Avalia risco de cada opção
  • Apresenta plano de rollback

Cenário 3: Entender Fluxo Completo

Pergunta:

/legacy-php-maintainer

Qual é o fluxo completo de uma venda?
Do carrinho até o pedido ser criado?

Resposta Claude:

  • Mapeia controllers e models envolvidos
  • Mostra queries SQL relacionadas
  • Identifica validações
  • Lista telas do fluxo

⚙️ Configuração Automática (CLAUDE.md)

O arquivo CLAUDE.md na raiz configura automaticamente:

[Veja CLAUDE.md para detalhes]

- Detecção de versão PHP (5.6, 7.x, 8.x)
- Investigação obrigatória antes de codificação
- Aversão a abstrações desnecessárias
- Reutilização de código como regra
- Preservação de compatibilidade como lei
- Estrutura de resposta com análise de risco

Uma vez que CLAUDE.md está no projeto, o Claude automaticamente:

  • ✅ Não refatora sem solicitação
  • ✅ Investiga padrões existentes
  • ✅ Preserva compatibilidade
  • ✅ Evita abstrações desnecessárias
  • ✅ Sempre documenta riscos

📋 Compatibilidade

Testado com:

  • PHP 5.6 — Syntax/features compatibility
  • PHP 7.0–7.4 — Modern features with caution
  • PHP 8.0+ — All features available
  • MySQL/MariaDB — Queries adapted
  • PostgreSQL — Queries adapted
  • SVN/Git — VCS agnostic

🤔 FAQ

Posso usar isso em qualquer projeto PHP?

Sim, mas:

  • Melhor em projetos legados (5+ anos, baixo teste)
  • Funciona em qualquer tamanho
  • Melhor resultado se o código tiver padrões estabelecidos
  • Menos útil em código totalmente caótico (sem padrões detectáveis)

Preciso ter Claude Code instalado?

Sim. Este é um conjunto de Skills e configuração para Claude Code.

Instale Claude Code aqui

Como atualizar?

# Se você clonou
cd legacy-php-maintainer
git pull origin main

# Se você copiou
# Baixe novamente e copie arquivos atualizados

Posso usar com meu prompt pessoal?

Sim. CLAUDE.md é apenas configuração. Você pode:

  • Adicionar seu próprio CLAUDE.md em cima
  • Usar as Skills junto com outras skills
  • Combinar com seus prompts pessoais

E se meu projeto tem padrões bizarros?

Claude vai:

  1. Detectar os padrões
  2. Documentar o que encontrou
  3. Avisar se acha estranho
  4. Propor alternativa

Você decide se segue o padrão ou muda.

🛠️ Como Contribuir

Contribuições são bem-vindas!

  • Encontrou um bug? Abra uma Issue
  • Tem um exemplo novo? Submeta uma PR
  • Conhece PHP legado? Ajude a melhorar as Skills
  • Fala outra língua? Ajude a traduzir

Veja CONTRIBUTING.md

📄 Licença

MIT — Use livremente em seus projetos

🤝 Comunidade

  • GitHub Issues — Perguntas e sugestões
  • GitHub Discussions — Compartilhe experiências
  • Claude Code Discord — Discussões em tempo real

🔗 Recursos Relacionados

⭐ Reconhecimentos

Feito para a comunidade de mantenedores de sistemas legados.

Se isso ajudou você, deixe uma ⭐ no GitHub!


Mantido com ❤️ para quem faz código legado funcionar.

Versão: 1.0.0
Última atualização: 2026-06-08

Ver o original no GitHub

Bom para

Relacionados