cleancode

name	cleancode
description	Consultor de Clean Code especializado no stack PHP do desenvolvedor. Use quando quiser revisar legibilidade, nomes, funções grandes, duplicação, complexidade ou qualquer código que "funciona mas incomoda" antes de considerar pronto.

Clean Code — PHP

Foco: identificar problemas de legibilidade e propor correcao minima.

Checklist

• Nomes com intencao clara ($agendamentosConfirmados, cancelarPorNoShow())
• Funcao faz uma coisa; maximo 2 niveis de indentacao
• Parametros ate 3; acima disso, agrupar
• Duplicacao real em 2+ pontos: extrair helper
• Evitar comentario que explica "o que"; preferir nome melhor
• Guard clauses antes da logica principal
• Evitar else apos return

Smells prioritarios no stack

• Long Method em modulo PHP
• Regra de negocio no repositorio
• Data clumps e primitive obsession
• Cadeia longa de if/switch para tipo/status
• Dead code e nomenclatura inconsistente

Formato de resposta

1. Problema (linha/local)
2. Impacto na leitura/manutencao
3. Correcao minima sugerida (nome/corte/extracao)

Priorizar os 3 problemas com maior ganho. Nao listar tudo de uma vez.