mirror of https://github.com/affaan-m/everything-claude-code.git synced 2026-06-11 02:33:10 +08:00

Files

Santiago González Siordia ac0f11c640 docs: add Spanish (es) translation (#2095 )

Adds a complete Spanish translation of the ECC documentation under
docs/es/, mirroring the Turkish (docs/tr/) translation in scope.
141 files covering agents, commands, rules, skills, contexts, examples,
and core docs. Updates root README.md with the Spanish language link.

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-06-07 13:26:42 +08:00

3.3 KiB

Raw Blame History

description

description
Identificar y eliminar de forma segura código muerto con verificación después de cada cambio.

Refactor Clean

Identificar y eliminar de forma segura código muerto con verificación de pruebas en cada paso.

Paso 1: Detectar Código Muerto

Ejecutar herramientas de análisis según el tipo de proyecto:

Herramienta	Qué Encuentra	Comando
knip	Exportaciones, archivos, dependencias no usadas	`npx knip`
depcheck	Dependencias npm no usadas	`npx depcheck`
ts-prune	Exportaciones TypeScript no usadas	`npx ts-prune`
vulture	Código Python no usado	`vulture src/`
deadcode	Código Go no usado	`deadcode ./...`
cargo-udeps	Dependencias Rust no usadas	`cargo +nightly udeps`

Si no hay ninguna herramienta disponible, usar Grep para encontrar exportaciones con cero imports.

Paso 2: Categorizar Hallazgos

Ordenar los hallazgos en niveles de seguridad:

Nivel	Ejemplos	Acción
SEGURO	Utilidades no usadas, helpers de prueba, funciones internas	Eliminar con confianza
PRECAUCIÓN	Componentes, rutas de API, middleware	Verificar que no haya imports dinámicos ni consumidores externos
PELIGRO	Archivos de config, puntos de entrada, definiciones de tipos	Investigar antes de tocar

Paso 3: Bucle de Eliminación Segura

Para cada elemento SEGURO:

Ejecutar la suite de pruebas completa — Establecer línea base (todo verde)
Eliminar el código muerto — Usar la herramienta Edit para eliminación quirúrgica
Re-ejecutar la suite de pruebas — Verificar que nada se rompió
Si las pruebas fallan — Revertir inmediatamente con git checkout -- <archivo> y omitir este elemento
Si las pruebas pasan — Continuar con el siguiente elemento

Paso 4: Manejar Elementos de PRECAUCIÓN

Antes de eliminar elementos de PRECAUCIÓN:

Buscar imports dinámicos: import(), require(), __import__
Buscar referencias de string: nombres de rutas, nombres de componentes en configs
Verificar si se exporta desde una API pública de paquete
Verificar que no haya consumidores externos (revisar dependientes si está publicado)

Paso 5: Consolidar Duplicados

Después de eliminar código muerto, buscar:

Funciones casi duplicadas (>80% similares) — fusionar en una
Definiciones de tipo redundantes — consolidar
Funciones wrapper que no añaden valor — inline
Re-exports que no tienen propósito — eliminar la indirección

Paso 6: Resumen

Reportar resultados:

Limpieza de Código Muerto
──────────────────────────────
Eliminado:  12 funciones no usadas
            3 archivos no usados
            5 dependencias no usadas
Omitido:    2 elementos (pruebas fallaron)
Guardado:   ~450 líneas eliminadas
──────────────────────────────
Todas las pruebas pasando ✓

Reglas

Nunca eliminar sin ejecutar las pruebas primero
Una eliminación a la vez — Los cambios atómicos facilitan el rollback
Omitir si hay incertidumbre — Mejor conservar código muerto que romper producción
No refactorizar mientras se limpia — Separar las preocupaciones (limpiar primero, refactorizar después)

3.3 KiB Raw Blame History