Código Limpio

Cada pieza de conocimiento debe tener una única representación autorizada en el código.

Reconoce la duplicación oculta y elige la abstracción correcta para eliminarla.

Cómo la filosofía 5S de manufactura de Toyota se traduce en artesanía de software profesional.

Entiende lo que hace un framework antes de usarlo — lee el código fuente, no solo la documentación.

Aplica las heurísticas F1–F4 para mantener las funciones mínimas, enfocadas y sin efectos secundarios.

Mantén la política de alto nivel separada del detalle de bajo nivel, y asegura que las clases base nunca dependan de las derivadas.

Aplica el mismo patrón en todas partes, evita el desorden conceptual y nunca acoplas preocupaciones no relacionadas.

Sigue los estándares de codificación del equipo de forma religiosa y reemplaza cada literal mágico con una constante nombrada.

Construye sistemas que compilen en un paso, ejecuten todas las pruebas en un paso, y nunca mientan a través de advertencias suprimidas.

Usa variables explicativas, nombres precisos y un profundo entendimiento del algoritmo para que el código hable por sí mismo.

Un método que pasa la mayor parte de su tiempo leyendo los datos de otra clase pertenece a esa clase.

Haz explícitas todas las dependencias y reemplaza las cadenas if/switch con despacho polimórfico.

Elimina información excesiva, código muerto y distancia vertical para que cada archivo sea fácil de escanear.

Pon cada función en la clase más interesada en ella, y mantén los métodos estáticos como utilidades verdaderamente sin estado.

Los argumentos selectores booleanos y de enumeración oscurecen la intención — divídelos en funciones enfocadas y bien nombradas.

Un catálogo curado de malos olores de código y heurísticas de refactorización extraídas del capítulo 17 de Clean Code.

El código que intenta ser inteligente es código que falla en comunicar — la densidad y brevedad a costa de la claridad no son virtudes.

Que las pruebas pasen no equivale a entender — el código limpio exige que comprendas completamente por qué funciona el algoritmo antes de confirmarlo.

Nunca permitas que un módulo asuma silenciosamente un valor de otro — haz que cada dependencia sea explícita y declarada en el código.

Tres heurísticas enfocadas en Java: evita importaciones con comodines, nunca heredes constantes, y prefiere enumeraciones sobre constantes enteras.

Transforma código legado enredado de forma segura añadiendo pruebas primero y refactorizando en pequeños pasos.

Escribe nombres que revelen la intención, eviten la confusión y hagan el código buscable.

Aplica las heurísticas N1–N7 para escribir nombres precisos, sin ambigüedad y fáciles de buscar.

El código es la única fuente de verdad — los comentarios mienten a medida que el código evoluciona.

Los objetos ocultan datos detrás del comportamiento. Las estructuras exponen datos. Mezclar ambos crea híbridos que nadie quiere.

La calidad es una responsabilidad profesional — no algo que entregas cuando el tiempo lo permite, sino el mínimo no negociable de tu oficio.

Una función pura siempre devuelve el mismo resultado para la misma entrada y no cambia nada fuera de ella misma.

Usa las heurísticas de Responsabilidad Única para detectar y dividir clases y módulos sobrecargados.

Aplica el refinamiento sucesivo a la clase SerialDate — prueba, renombra, extrae y simplifica.

Un caso de estudio para leer código legado de forma crítica — encuentra los malos olores antes de tocar nada.

Las cuatro reglas de Kent Beck, en orden de prioridad, para un diseño siempre listo para evolucionar.

Las funciones deben hacer una sola cosa, hacerla bien y solo eso.

El formato del código es un acto de comunicación — estructura los archivos para que cualquier desarrollador pueda navegar en segundos.

Comienza con código que funciona y luego refactoriza de forma iterativa — nunca escribas código limpio en un solo paso.

El código de terceros pertenece al borde — envuélvelo para que nunca contamine tu lógica de negocio.

Domina el micro-ciclo rojo-verde-refactorizar: escribe primero una prueba que falle, luego solo el código necesario para pasarla.

Aplica las heurísticas T1–T9 para escribir suites de pruebas completas, significativas y mantenibles.