Nivel avanzado4 min de lectura · Publicado el

Refactoring Legacy CSS, charla de Carmen Ansio

CSS heredado: un armario que se desborda y deja caer #cabecera, !important y ul li a; al lado, Stylelint cuenta 3 problemas. CSS heredado: mide primerorubentejera.com #cabecera!importantul li a$ npx stylelint✖✖✖3 problems
Cuando todos meten cosas sin ordenar, al abrir la puerta se cae medio armario: ids, !important y selectores largos. Antes de limpiar, Stylelint lo mide con tres reglas: 3 problemas.

De qué va la charla

Así la presenta su descripción en YouTube: al empezar un proyecto encontramos una fórmula que funciona con la metodología del momento, pero a medida que el proyecto crece se vuelve difícil de mantener. La pregunta es cómo enfrentarse a ese «monstruo inmantenible» que se ha ido modificando durante años.

El CSS heredado (legacy) es como un armario en el que todo el mundo mete cosas sin ordenar: al principio cabe todo, pero llega un día en que abres la puerta y se cae medio armario. Nadie se atreve a sacar nada por si acaso.

Quién es Carmen Ansio

Según la misma descripción, es UI y front-end designer, «amante del CSS y los SVG’s», integrante de AdaJS y de la fundación Techdencias, y copresentadora del podcast WeCodeSign.

Para quién es

Encaja si mantienes una web o una aplicación con años de CSS acumulado y cada cambio rompe algo en otra página. No es un tutorial de CSS desde cero: da por sabido cómo funcionan los selectores y la cascada.

Lo que conviene saber: es de 2017, así que no trata herramientas que han llegado después al CSS, como las capas @layer o el selector :where(), que ayudan a controlar la especificidad. El enlace a las diapositivas que aparece en la descripción del vídeo ya no funciona.

Ideas para empezar a limpiar tu CSS

Estas pautas no salen de la charla: son prácticas habituales de refactoring aplicadas al CSS.

  1. Mira antes de tocar. Con las herramientas del navegador puedes ver qué reglas afectan a un elemento y cuáles se sobrescriben. Tienes una introducción en Chrome DevTools.
  2. Cambia poco cada vez y comprueba las páginas afectadas después de cada paso.
  3. Baja la especificidad: sustituye selectores largos e ids por clases sencillas, por ejemplo con BEM.
  4. Deja cada fichero un poco mejor de como lo encontraste, como propone la regla del boy scout.

Mide antes de limpiar, con Stylelint

Para saber por dónde empezar, un linter (un programa que revisa el código y avisa de lo que incumple unas reglas) te señala los selectores más problemáticos. Con Stylelint y tres reglas basta para una primera foto:

{
  "rules": {
    "selector-max-id": 0,
    "selector-max-specificity": "0,3,0",
    "declaration-no-important": true
  }
}

Guárdalo como .stylelintrc.json y pásalo por tu hoja de estilos, por ejemplo este estilos.css:

#cabecera .menu ul li a { color: #333; }
.boton { color: white !important; }
.tarjeta__titulo { font-size: 1.25rem; }
npm install --save-dev stylelint
npx stylelint "**/*.css"
estilos.css
  1:1   ✖  Too many ID selectors in "#cabecera .menu ul li a", maximum 0       selector-max-id
  1:1   ✖  Too high specificity in "#cabecera .menu ul li a", maximum "0,3,0"  selector-max-specificity
  2:23  ✖  Disallowed !important                                               declaration-no-important

✖ 3 problems (3 errors, 0 warnings)

En un proyecto heredado saldrán cientos de avisos. No hace falta arreglarlos todos: úsalos como mapa y empieza por los ficheros que más cambias.

Alternativas

Un CSS así es una forma de deuda técnica: cuanto más tarda en pagarse, más intereses cobra.

Fuentes

Comprobado el 7 de noviembre de 2026:

  • Ficha del vídeo en YouTube, en el canal Adevinta Spain Engineers: título, duración (41 min), fecha (junio de 2017) y descripción, con la presentación de la charla y de la ponente. El enlace a las diapositivas de la descripción ya no funciona.
  • Documentación de Stylelint: reglas selector-max-id, selector-max-specificity y declaration-no-important. El ejemplo se ha ejecutado con Stylelint 18.0.0 y Node 24.21.0; la salida es la real.
  • Learn CSS, en web.dev.