Evolutionary Naming

Guía identificadores mal nombrados a través del proceso de nombramiento de 7 pasos de Arlo Belshee, un commit propuesto a la vez.

Por kawasima · kawasima/evolutionary-naming

Probado · Funciona ★ 9.6/10

Evolutionary Naming — Guía identificadores mal nombrados a través del proceso de nombramiento de 7 pasos de Arlo Belshee, un commit propuesto a la vez.

Qué hace

Diagnostica clases, métodos y variables mal nombrados (-Manager/-Util suffixes, single-letter vars, process/handle verbs, god methods) y propone renombramientos a través de 7 pasos progresivos agrupados en 3 fases, pausando para pedir permiso antes de cualquier cambio estructural. Solo consultivo — lee código vía Read/Grep/Glob y propone renombramientos más mensajes de commit; nunca edita archivos ni ejecuta git. Se activa con solicitudes de refactorización/nombramiento, ofreciendo un modo de auditoría para escaneos amplios y un modo de mejora para guiar un identificador a través del proceso.

Informe de la prueba

Se le proporcionó un método `DataManager.process(self, d)`: en lugar de un renombramiento único, produjo la cadena completa Missing→applesauce→Honest→Honest-and-Complete con un mensaje de commit distinto por paso, luego pausó correctamente antes de proponer la división del método de la Fase 2 en lugar de simplemente hacerlo.

Probado el: 2026-07-14 · Claude Code 2.x (agent harness)

Instalación

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

Comandos y prompts de ejemplo

  • /evolutionary-namingGuía identificadores mal nombrados a través del proceso de nombramiento de 7 pasos de Arlo Belshee, un commit propuesto a la vez.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • 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.