| name | refactor |
| description | Refactoriza código existente para mejorar legibilidad, reducir duplicación y alinear con las convenciones del proyecto, sin cambiar comportamiento. |
| risk | unknown |
| source | community |
| date_added | 2026-06-26 |
Skill: refactor
Qué hace
Refactoriza código existente para mejorar legibilidad, reducir duplicación y alinear con las convenciones del proyecto, sin cambiar comportamiento.
Cuándo usarlo
- Después de un pr-review con observaciones de código
- Cuando hay duplicación evidente entre Server Actions o componentes
- Antes de extender una feature que tiene deuda técnica
Proceso
- Leer
.knowledge/conventions.md para entender los patrones del proyecto
- Identificar: duplicación, funciones largas, nombres poco claros, imports muertos
- Refactorizar en commits atómicos — un cambio por commit
- Nunca cambiar comportamiento observable — si algo puede cambiar, preguntar primero
- Correr
tsc --noEmit antes y después para confirmar que no hay regresiones de tipos
Patterns a aplicar
- Extraer lógica repetida a helpers en
/lib/utils/
- Dividir componentes > 150 líneas en sub-componentes
- Unificar manejo de errores en Server Actions
- Reemplazar
any por tipos explícitos
Output esperado
Commits atómicos con mensaje refactor: <descripción concisa del cambio>
Warnings
- No refactorizar y agregar features en el mismo commit
- Si el refactor requiere cambios en tests, actualizarlos en el mismo commit
- No cambiar nombres de exports públicos sin revisar todos los imports primero
