Evolutionary Naming

Guida identificatori scadenti attraverso il processo di denominazione in 7 passi di Arlo Belshee, un commit proposto alla volta.

di kawasima · kawasima/evolutionary-naming

Promosso ★ 9.6/10

Evolutionary Naming — Guida identificatori scadenti attraverso il processo di denominazione in 7 passi di Arlo Belshee, un commit proposto alla volta.

Cosa fa

Diagnostica classi, metodi e variabili mal denominati (suffissi -Manager/-Util, variabili a singola lettera, verbi process/handle, metodi god) e propone ridenominazioni attraverso 7 passi progressivi raggruppati in 3 fasi, mettendo in pausa per il permesso prima di qualsiasi cambiamento strutturale. Solo consultivo — legge il codice tramite Read/Grep/Glob e propone ridenominazioni più messaggi di commit; non modifica mai file né esegue git. Si attiva su richieste di refactoring/denominazione, offrendo una modalità di audit per scansioni ampie e una modalità di miglioramento per guidare un identificatore attraverso il processo.

Rapporto di test

Gli ho fornito un metodo `DataManager.process(self, d)`: invece di una ridenominazione una tantum ha prodotto la catena completa Missing→applesauce→Honest→Honest-and-Complete con un messaggio di commit distinto per ogni passo, quindi si è correttamente messo in pausa prima di proporre la divisione del metodo di Fase 2 invece di farlo e basta.

Testato il: 2026-07-14 · Claude Code 2.x (agent harness)

Installazione

git clone https://github.com/kawasima/evolutionary-naming
cd evolutionary-naming
mkdir -p ~/.claude/skills
cp -r skills/evolutionary-naming ~/.claude/skills/evolutionary-naming

Comandi e prompt di esempio

  • /evolutionary-namingGuida identificatori scadenti attraverso il processo di denominazione in 7 passi di Arlo Belshee, un commit proposto alla volta.

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • This method name process(d) is terrible, help me improve it.
  • Audit this file for bad variable names like tmp, x, and d.
  • Help me rename this DataManager class to something meaningful.