Legacy PHP Maintainer
CauanDZN/legacy-php-maintainer
Especialista em manutenção segura de PHP legado (5.6+) para Claude Code
Ver no GitHubSkill 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-maintainer1 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
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 seguraslegacy-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.
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:
- Detectar os padrões
- Documentar o que encontrou
- Avisar se acha estranho
- 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
📄 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