Na semana passada, a equipe do Chrome lançou o Modern Web Guidance 1.0. É um conjunto de skills para agentes que dá a agentes de codificação orientações atualizadas sobre a plataforma web. As equipes do Firefox, do Edge e do MDN mantêm o projeto junto com o Chrome.
O problema que ele resolve é simples. Os modelos aprendem com anos de código antigo, então muitas vezes escrevem os truques em JavaScript que precisávamos alguns anos atrás, mesmo quando o navegador já faz o trabalho sozinho. Instalei no blog para ver o que ele mudaria.
Como funciona
A skill diz ao agente para consultar um guia antes de escrever HTML, CSS ou JavaScript do lado do cliente. A consulta é feita com uma pequena CLI:
npx modern-web-guidance@latest search "light dismiss modal dialog"
npx modern-web-guidance@latest retrieve "dialog"
O search retorna uma lista de IDs de guias, e o retrieve mostra o guia. Cada guia é curto e específico. Ele diz o que usar, o que evitar e quais navegadores suportam cada recurso. Engenheiros de navegadores revisam todos os guias, e especialistas em acessibilidade também revisam os guias de recursos que o usuário vê.
Há também o legacy-scan, que procura padrões antigos no código existente sem chamar um modelo. Ele só cobre os guias com regras que uma verificação estática consegue encontrar, cerca de 20% deles.
Instalação
npx modern-web-guidance@latest install
Instalei para o Claude Code no repositório do blog. Isso adicionou a skill em .claude/skills/, então qualquer sessão de agente que trabalhe no blog usa a skill. Depois, defini o alvo de suporte a navegadores:
npx modern-web-guidance@latest set-baseline newly
Esse comando cria um arquivo .mwgrc. No Baseline, “Newly available” significa que um recurso funciona na versão mais recente de todos os principais navegadores. Com esse alvo, os guias não pedem código de fallback para esses recursos, o que mantém o código pequeno.
A CLI envia dados de uso anônimos para o Google. Defina DISABLE_TELEMETRY=1 no perfil do seu shell para desativar.
O que a verificação encontrou
Com a skill instalada, a primeira coisa que fiz foi rodar o legacy-scan no código do blog:
npx modern-web-guidance@latest legacy-scan
Ele encontrou três itens, todos na folha de estilos. Dois eram regras ::-webkit-scrollbar, que agora são substituídas pelas propriedades padrão scrollbar-width e scrollbar-color. O terceiro era uma lista de dez regras que atrasavam a animação de cada card de post na página inicial:
.post-card:nth-child(1) { animation-delay: .04s; }
.post-card:nth-child(2) { animation-delay: .08s; }
/* ...mais oito... */
A nova função sibling-index() transforma tudo em uma regra só:
.post-card { animation-delay: calc(sibling-index() * .04s); }
O que os guias mudaram
A verificação foi a parte menor. As mudanças maiores vieram quando pedi ao agente para reescrever componentes específicos usando os guias.
Busca. A caixa de busca era uma sobreposição feita à mão, com código para a tecla Esc, para cliques fora dela e para devolver o foco. Agora é um <dialog> nativo aberto com showModal(). O navegador mantém o foco dentro do diálogo, torna a página atrás dele inerte e devolve o foco quando ele fecha. O atributo closedby="any" fecha o diálogo quando você clica fora. O Safari ainda não suporta closedby, então algumas linhas de código de fallback cuidam desse caso.
Índice. O painel “Conteúdo” agora é um popover. O atributo popovertarget no botão abre e fecha o painel, e o navegador cuida dos cliques fora e da tecla Esc. O posicionamento por âncora do CSS mantém o painel embaixo do botão. O Firefox ainda não suporta posicionamento por âncora, então lá o painel abre no centro da tela.
Barra de progresso de leitura. A barra no topo de cada post usava um listener de scroll. Agora é uma animação CSS guiada pelo scroll, então o navegador a atualiza sem um listener de scroll:
.progress-bar {
animation: grow-progress auto linear both;
animation-timeline: scroll(root block);
}
Menu no celular. Este era um problema real de acessibilidade. Em telas pequenas, o menu fechado ficava fora da tela, mas ainda podia ser alcançado com a tecla Tab. Agora ele fica inert enquanto está fechado, e a página atrás dele fica inert enquanto ele está aberto.
Os guias também pegaram detalhes que eu teria deixado passar. Por exemplo, o guia de diálogos diz para não impedir o scroll da página com overflow: hidden no <body>, porque isso remove a barra de rolagem e desloca o layout. Em vez disso, ele usa overscroll-behavior: contain no diálogo e no seu fundo.
Considerações finais
O JavaScript do site ficou 38 linhas menor, e a busca, o painel de conteúdo e o menu agora se comportam como os controles nativos do navegador. O que mais gostei é que cada guia traz dados de suporte dos navegadores e um plano de fallback, que é a parte que eu normalmente preciso procurar sozinho no MDN. A skill fica no repositório, então na próxima vez que um agente editar este blog, ele começa com as mesmas orientações.