Modern Web Guidance: guía para que tus agentes de código usen la web moderna
Si estás construyendo una aplicación web con Claude Code o Codex, es probable que tu agente esté recurriendo a soluciones que los navegadores actuales ya incorporan de serie.
Google ha desarrollado una colección de recursos llamada Modern Web Guidance, pensada precisamente para que los agentes de programación saquen partido a las funcionalidades reales de HTML, CSS y JavaScript hoy en día. El proyecto cuenta con el respaldo de los equipos de Chrome, Firefox, Edge y MDN, y su versión 1.0 ya incluye más de 200 guías técnicas.
Entre las cosas que puede hacer por ti:
→ Identificar patrones anticuados susceptibles de simplificarse.
→ Sustituir JavaScript innecesario por APIs nativas del navegador.
→ Mejorar el rendimiento y la accesibilidad del proyecto.
→ Adoptar funcionalidades modernas sin perder de vista la compatibilidad entre navegadores.
Un ejemplo concreto: un textarea cuya altura se ajusta dinámicamente mediante JavaScript y scrollHeight puede reemplazarse, donde haya soporte, por una simple regla CSS con field-sizing: content.
Y una de las opciones más interesantes es que puedes analizar un proyecto que ya tengas en marcha. Para instalar la herramienta basta con ejecutar npx modern-web-guidance@latest install, y para revisar tu código, npx modern-web-guidance@latest legacy-scan .
El escáner detecta patrones concretos que podrían actualizarse y te señala las guías relacionadas. Eso sí, antes de tocar nada conviene pedirle al agente que revise los resultados, verifique la compatibilidad con los navegadores que necesitas y proponga los cambios de forma razonada.
Ten en cuenta que el escáner todavía no cubre la totalidad de las guías disponibles, así que lo más sensato es emplearlo como apoyo complementario, no como una auditoría exhaustiva.
En definitiva, una forma bastante cómoda de aprovechar lo que la web ofrece hoy sin tener que rastrear manualmente cada nueva API. Puedes consultar el repositorio en GitHub de Modern Web Guidance.
Resumen técnico
Google ha publicado Modern Web Guidance v1.0, una colección de más de 200 guías técnicas orientadas a coding agents como Claude Code o Codex. El proyecto está respaldado por los equipos de Chrome, Firefox, Edge y MDN. Se instala vía npx modern-web-guidance@latest install y permite escanear proyectos existentes con el comando legacy-scan. Detecta patrones obsoletos de HTML, CSS y JavaScript susceptibles de sustituirse por capacidades nativas del navegador. El escáner no cubre la totalidad de las guías disponibles en esta versión inicial.
Análisis de implicaciones
Los agentes de codificación tienden a reproducir patrones históricos por saturación de ejemplos en sus datos de entrenamiento, generando dependencias de JavaScript innecesarias donde hoy existen soluciones nativas. Modern Web Guidance actúa como capa de conocimiento actualizado que corrige ese sesgo. El flujo de trabajo cambia: el agente no solo genera código, sino que primero audita el proyecto contra un conjunto de guías mantenidas activamente. La limitación clave es que el escáner es parcial, por lo que no reemplaza una auditoría manual completa de compatibilidad.
Aplicación práctica
Instalación en un paso: npx modern-web-guidance@latest install. Escaneo del proyecto: npx modern-web-guidance@latest legacy-scan .. El escáner identifica, por ejemplo, implementaciones de textarea autoexpandible mediante JavaScript scrollHeight que pueden sustituirse por la propiedad CSS field-sizing: content. El flujo recomendado es pasar los resultados al agente, solicitarle que verifique la compatibilidad en Can I Use para los navegadores objetivo y que proponga los cambios antes de aplicar ninguna modificación automática.
Contexto del sector
La proliferación de coding agents ha reactivado un problema clásico: código generado con referencias desfasadas. Modern Web Guidance es una respuesta directa a ese vector, con respaldo institucional de los principales fabricantes de navegadores. Se diferencia de herramientas como ESLint o Lighthouse en que está diseñada específicamente como skill consumible por agentes de IA, no como linter de uso humano directo.

