Kurzfassung
Modern Web Guidance gibt Coding-Agenten über 200 nachschlagbare Anleitungen zu HTML, CSS, Browser-APIs und passenden Fallbacks. Das von Google Chrome gestartete Projekt soll verhindern, dass Agenten unnötig Funktionen mit JavaScript nachbauen oder neue APIs ohne Browserprüfung einsetzen. Unser begrenzter A/B-Pilot zeigt unterschiedliche Implementierungen: Mit Guidance entstand weniger JavaScript, aber kein eindeutig besseres Gesamtergebnis. Die Empfehlung ist deshalb: gezielt nachschlagen lassen, Browseranforderungen vorgeben und die fertige Oberfläche tatsächlich testen. Weder eine Installation noch ein leerer Scannerbericht garantieren barrierefreie Websites, bessere Ladezeiten oder SEO-Erfolge.
Was ist Modern Web Guidance und welches Problem löst es?
Ein Coding-Agent soll einen Bestätigungsdialog ergänzen. Dafür kann er eine vorhandene Projektkomponente verwenden, einen eigenen Overlay bauen oder die native Dialogfunktion des Browsers nutzen. Welche Lösung passt, hängt nicht nur davon ab, ob sie im ersten Screenshot funktioniert: Browserziele, Fokusführung und bestehende Architektur gehören zur Entscheidung.
Modern Web Guidance, kurz MWG, liefert dafür nachschlagbares Webplattformwissen. Der Skill erklärt dem Agenten, wann und wie er suchen soll. Die Kommandozeile findet passende Guides und liefert Implementierungshinweise samt Kompatibilitätsdaten. Den Code schreibt weiterhin der Agent; MWG ist weder Sprachmodell noch Webframework.
Google Chrome hat den stabilen Start von Version 1.0 am 10. November 2026 angekündigt. Beteiligt sind außerdem Microsoft Edge, Firefox/MDN und die Webentwickler-Community. Das bedeutet nicht, dass alle Browserhersteller jede Empfehlung gemeinsam freigeben.
| Aspekt | Einordnung |
|---|---|
| Inhalt | Über 200 Anleitungen; eigener CLI-Katalogcheck im geprüften Paket |
| Geprüfter Paketstand | 1.0.1, Node mindestens 22.0.0 |
| Integration | Skill-fähiger Coding-Agent oder direkter CLI-Abruf |
| Softwarelizenz | Apache 2.0 |
| Guide-Inhalte | CC BY 4.0, soweit nicht anders gekennzeichnet |
Versions- und Laufzeitangaben stehen in der festgehaltenen Paketdefinition, die Lizenztrennung im Source-README. Entwicklung und Evals liegen im Repository mit dem Suffix -src; installiert wird die Distribution ohne dieses Suffix.
MWG ist auch kein Ersatz für Designsysteme. Hallmark beschreibt Designregeln; Astryx und shadcn liefern Komponenten beziehungsweise Komponentenstrukturen. MWG hilft bei Webplattformentscheidungen innerhalb solcher Projekte. Warum eine Komponentenwahl eine andere Frage ist, zeigt der Vergleich von Astryx und shadcn.
Wie installierst und nutzt du Modern Web Guidance?
Voraussetzungen und Datenschutzoption setzen
Du brauchst Node, npm und für die Agentenintegration einen bereits eingerichteten Skill-fähigen Coding-Agenten. Die MWG-Installation richtet keinen Modellproviderzugang ein und übernimmt nicht dessen Kosten.
Öffne dein Projektverzeichnis. Die folgenden Befehle gelten für Bash oder Zsh. Schalte vor dem ersten Aufruf bewusst die standardmäßig aktive Telemetrie ab und prüfe deine Laufzeit:
export DISABLE_TELEMETRY=1
node --version
npm --version
Die Variable gilt für die aktuelle Shell und daraus gestartete Prozesse. Läuft dein Agent bereits anderswo, muss auch dessen Prozessumgebung den Opt-out enthalten. Die Abschaltmöglichkeit und der aktive Standard sind im Telemetrie-Logger nachvollziehbar.
Erst nachschlagen, dann integrieren
Du kannst die Bibliothek ausprobieren, bevor du Skills installierst. Diese Leseproben wurden für die Recherche mit dem oben verlinkten Paketstand tatsächlich ausgeführt:
npx -y modern-web-guidance@1.0.1 search "animate dialog backdrop"
npx -y modern-web-guidance@1.0.1 retrieve "animate-to-from-top-layer"
search liefert Guide-IDs und Beschreibungen. Wähle nach der Beschreibung, nicht nur nach dem ersten Treffer. retrieve ruft den passenden Text ab. Der offizielle Einstiegsleitfaden beschreibt diesen Ablauf.
Wichtig: Große Antworten kann die CLI in eine Datei auslagern. Der Agent muss dann den vollständigen Dateiinhalt lesen. Eine Meldung mit einem Dateipfad ist noch kein gelesener Guide. Genau dieser Unterschied war für unseren später beschriebenen Pilot entscheidend.
Für brauchbare Suchtreffer empfiehlt die ausgelieferte Skill-Anweisung zwei bis fünf englische Aktionswörter zu einer einzelnen Fähigkeit. Framework-, Produkt- und Dateinamen gehören nicht in jede Query. Teile einen Auftrag mit Dialog, Formular und Animation in getrennte Suchen auf. Dein Gespräch mit dem Agenten kann trotzdem deutsch bleiben.
Die offizielle Installation startest du anschließend aus dem Projektverzeichnis:
npx modern-web-guidance@latest install
Wähle im interaktiven Assistenten deinen Agenten und ein projektlokales Installationsziel. Dieser Installationsweg ist dokumentiert und im Code geprüft; den Assistenten haben wir in der Recherche nicht ausgeführt. Die erfolgreichen CLI-Leseproben sind deshalb kein Nachweis einer vollständig getesteten Agentenintegration.
@latest ist für den Alltag dynamisch. Für Experimente musst du die tatsächlich verwendeten Fassungen festhalten: Ein Pin der äußeren CLI friert weder das delegierte Skills-Installationswerkzeug noch dessen GitHub-Stand automatisch ein. Die Delegation steht in der CLI-Implementierung.
Einen begrenzten Auftrag geben
Ein sinnvoller Leserprompt wäre dieser, nicht der Wortlaut unseres Testauftrags:
Ergänze einen Bestätigungsdialog. Nutze Modern Web Guidance, suche die passenden Anleitungen und lies sie vollständig. Halte unsere Browserpolicy ein. Ändere keine anderen Komponenten und ergänze keine ungefragten Bibliotheken. Prüfe Fokus, Esc, Tastaturbedienung und nötige Fallbacks. Nenne die verwendeten Guide-IDs.
Lass dir nicht nur bestätigen, dass MWG verwendet wurde. Frage nach der konkreten Entscheidung: Welche native Funktion passt? Welche Projektkomponente bleibt? Welcher Fallback ist für die Zielbrowser erforderlich? So wird aus einem Skill-Hinweis ein überprüfbarer Arbeitsauftrag.
Wie legst du Browserziele und Fallbacks fest?
Ohne abweichende Projektanforderungen orientiert sich MWG an Baseline Widely available. Das heißt: Die Funktion ist seit mindestens 30 Monaten im definierten Kernbrowserkreis interoperabel. Newly available und Limited availability sind andere Status, keine pauschalen Verbote. Die Dokumentation zu Baseline und Fallbacks erklärt die Unterscheidung.
Schreibe deine Policy in die bestehende Agentendatei, etwa AGENTS.md. Dieses Beispiel ist Dateiinhalt, kein Shellbefehl:
Browser Support: Baseline Widely available.
Für neuere Funktionen nur Progressive Enhancement oder einen geprüften Fallback.
Bestehende Projektkomponenten und Browseranforderungen haben Vorrang.
Keine neuen Abhängigkeiten ohne Begründung.
Konkrete Mindestbrowser deines Projekts gehen vor. Vermeide widersprüchliche Angaben in Prompt, Agentendatei und zusätzlicher MWG-Konfiguration. Die Policy bleibt eine Anweisung an das Modell, keine technische Konformitätsgarantie.
Nicht jede neuere Funktion braucht eine Bibliothek als Ersatz. Eine optionale typografische Verbesserung darf in einem nicht unterstützenden Browser entfallen. Ein für die Bedienung notwendiger Dialog braucht dagegen einen funktionierenden Pfad. Prüfe daher sowohl die native Funktion als auch den tatsächlich benötigten Fallback.
Der praktische Vorteil liegt in besseren Entscheidungsgrundlagen: Der Agent kann passende native APIs finden, statt reflexhaft zusätzliche Logik zu schreiben. Bestehende, geprüfte Komponenten allein wegen einer neueren API auszutauschen, wäre trotzdem die falsche Regel.
Was zeigt unser begrenzter A/B-Praxispilot?
Dieselbe Aufgabe, zusätzlicher Guide-Kontext
Unsere eigene Messung verglich eine statische deutsche Serviceübersicht: Leistungskarten, ein modales Pflichtfeldformular und tastaturbedienbare Akkordeoneinträge. Frameworks, externe Assets und Datenübertragung waren ausgeschlossen.
Beide Arme erhielten denselben Kernauftrag und Systemprompt. Je Arm gab es einen frischen, toolfreien Modellrequest mit angefordertem openai-codex/gpt-6.1-sol und Reasoning medium. B bekam zusätzlich die vollständigen MWG-Guides dialog, forms, accordion und form-factor-adaptation. Der tatsächlich gesendete Kontext wurde gegen die vorab festgehaltenen Eingaben geprüft.
Das war manuell eingespeister Retrieval-Kontext, kein Vergleich automatischer Skill-Installation oder zuverlässigen Autoloadings. Ein früherer Methodenversuch wurde verworfen: Bei B war nur der Verweis auf eine ausgelagerte Datei angekommen. Er zählt weder als positive noch als negative MWG-Evidenz. Nach der korrigierten Generierung wurden die Outputs nicht nachgebessert oder zur Ergebnisoptimierung erneut erzeugt.
Weniger JavaScript, aber nicht alle Prüfungen bestanden
Die folgende Tabelle enthält eigene Artefaktmessungen und Browserprüfungen. Die vollständigen Protokolle liegen intern vor, nicht als öffentlich verlinkter Datensatz. Getestet wurde mit Playwright 1.65.1 und Chromium 149.0.7827.55 bei Desktop-Viewportbreiten von 375, 402, 440 und 1280 Pixeln. Pro Breite liefen dieselben 18 primären Assertions.
| A: ohne Guides | B: mit Guides |
|---|---|
| 72/72 primäre Assertions bestanden | 68/72 primäre Assertions bestanden |
| 4.166 Byte ausführbares Inline-JavaScript, unkomprimiert | 2.181 Byte ausführbares Inline-JavaScript, unkomprimiert |
| Nativer Dialog | Nativer Dialog |
| Keine nativen Details-Akkordeons | Drei native Details-Akkordeons |
| Keine externen Skripte oder Stylesheets | Keine externen Skripte oder Stylesheets |
Beide Outputs bestanden die übrigen Funktionsprüfungen: Formularvalidierung, lokale Bestätigung, Tastatur-Submit, Escape mit Fokusrückgabe, Akkordeonbedienung und Überlaufchecks. B verwendete native Akkordeons und enthielt weniger JavaScript. Das ist eine Beobachtung dieser Artefakte, keine Messung von Ladegeschwindigkeit, Core Web Vitals oder Kosten.
Die Fehlassertion in B war bei jeder Breite dieselbe: Unser strenger Test verlangte, dass document.activeElement bei jedem Tab-Schritt innerhalb des Dialogs bleibt. Zeitweise wurde jedoch BODY gemeldet, während document.hasFocus() falsch war. Der Dialog blieb modal; kein Hintergrundbedienelement bekam Fokus.
Eine minimale native Dialog-Testseite zeigte dasselbe Muster. A ergänzte einen eigenen Tab-Zyklus und vermied diese Transition. Das begrenzt die Interpretation: B erfüllte die vorab gesetzte DOM-Bedingung nicht, daraus folgt aber kein nachgewiesener allgemeiner Barrierefreiheitsdefekt. Die Rohwertung bleibt ausdrücklich bei 68/72.
Was der Vergleich nicht kontrolliert
Es bleibt eine Modellstichprobe je Arm. Mehrere Breiten desselben Outputs sind keine unabhängigen Generierungen. Firefox, WebKit, echte Mobilgeräte, Screenreader und Performance wurden nicht geprüft; weder Randomisierung noch Verblindung fanden statt.
Auch die Ausführung war nicht vollständig vorgabenkonform: Die Runtime-Vorbereitung installierte entgegen einer internen No-new-installs-Vorgabe lokale Abhängigkeiten im neuen Pilotordner. Die eigentlichen Generierungen nutzten danach die vorbereitete Umgebung ohne weitere Bootstrapinstallation; globale oder produktive Systeme wurden nicht verändert. Gleiche Runtime-Budgets belegen außerdem weder ein hartes serverseitiges Tokenlimit noch eine unabhängig bestätigte Modellidentität.
Der Pilot liefert deshalb keinen allgemeinen Sieger. Er zeigt, warum Quellcodeumfang, native APIs und tatsächliche Bedienung getrennte Prüfkriterien sein müssen.
Wann hilft legacy-scan bei vorhandenem Code?
Für eine konkrete Komponente ist gezieltes Nachschlagen der Hauptweg. Bei einer breiteren Bestandsmodernisierung bietet MWG zusätzlich einen lokalen, deterministischen Kandidatenscan:
npx -y modern-web-guidance@1.0.1 legacy-scan ./src --json
./src muss in deinem Projekt existieren; andernfalls ersetze den Beispielpfad. Der Scan selbst braucht keinen eigenen LLM-Aufruf. Anschließend prüft der Coding-Agent die Fundstellen im Kontext. keepWhen bedeutet dabei: Meldung behalten, nicht alten Code behalten. dropWhen beschreibt Gründe, eine Meldung zu verwerfen.
Lass zuerst berichten, bevor du Änderungen beauftragst. Laut Modernisierungsdokumentation gibt es bewusst keine automatische --fix-Funktion. Die Regeln decken nur einen kuratierten Ausschnitt ab; keine Funde sind kein Qualitätssiegel.
Eine externe Einzelbeobachtung illustriert das: Christian Ott berichtete am 12. November 2026, dass sein Scanner ein Problem mit geschlossenen FAQ-Antworten bei Textfragment-Links nicht meldete, obwohl eine passende Anleitung existierte. Das ist sein Praxistest, kein von uns reproduzierter Fehler und kein Rankingnachweis.
Was belegen die Projekt-Evals und wo liegen die Grenzen?
Das Projekt veröffentlicht automatisierte Vergleiche. Ein klar gebundenes Beispiel aus dem gepinnten README-Snapshot: Für Codex CLI mit gpt-6.1-sol nennt die Zeile vom 8. November 215 Aufgaben mit 1.795 Checks pro Arm, gerundet 54 Prozent ohne und 82 Prozent mit Guidance. Die ausgewiesene Differenz beträgt 28 Prozentpunkte.
Der Nenner sind automatisierte Checks, nicht vollständig gelöste Aufgaben oder fehlerfreie Websites. Laut Eval-Methodik fallen Infrastrukturfehler beziehungsweise Timeouts vor der Bewertung samt gepaartem Gegenstück aus dem Nenner. Aufgaben mit mehr Checks haben entsprechend mehr Gewicht. Das sind Projektmessungen, keine unabhängige Replikation durch diesen Artikel.
Weder diese Quoten noch unser Kleinpilot belegen allgemein schnellere Entwicklung, geringere Modellkosten oder bessere Rankings. Wissen im Kontext erzwingt keine korrekte Umsetzung. Genau deshalb gehört hinter die Anleitung eine echte Prüfung, beispielsweise über Playwright und Browserautomatisierung.
Welche Daten werden verarbeitet?
Der oben verlinkte Telemetrie-Code erfasst standardmäßig unter anderem Suchqueries, Ergebnis- und Abruf-Guide-IDs sowie Tool-, Agenten-, Betriebssystem- und Versionsmetadaten. Im gelesenen Nutzlastschema stehen keine vollständigen Projektdateien oder kompletten Nutzerprompts. Suchqueries sind trotzdem Freitext und können sensible Angaben enthalten.
Opt-out bedeutet nicht vollständig offline: Paketdownload und Installation benötigen Netz. Suche und Guideabruf verwenden lokale Paketdaten; ein Cloud-Coding-Agent verarbeitet seinen Projektkontext separat. Seine Datenwege musst du unabhängig bewerten.
Chrome DevTools kann die Laufzeitprüfung ergänzen, ist für die gezeigten Suchproben aber keine Voraussetzung. Ein Chromium-Test ist außerdem kein Safari-, Firefox- oder Screenreaderbeleg. Accessibility- und Sicherheitsreviews bleiben ebenso nötig wie Tests auf den tatsächlich unterstützten Browsern.
FAQ
Ist Modern Web Guidance ein neues Coding-Modell?
Nein. Es liefert einem vorhandenen Coding-Agenten nachschlagbare Anleitungen. Modellzugang, Ausführungsumgebung und Tests bleiben separate Bausteine.
Kann ich MWG mit React oder Vue verwenden?
Ja. Die Guides zeigen überwiegend HTML, CSS und JavaScript, die der Agent auf dein Framework übertragen muss. Bestehende Komponenten, Renderingregeln und Browseranforderungen bleiben maßgeblich.
Muss ich vor jeder Änderung legacy-scan ausführen?
Nein. Für eine konkrete UI-Aufgabe suchst du passende Guides. Der Scanner ist ein zusätzlicher Weg für breitere Modernisierungsaufträge an vorhandenem Code.
Macht native Browsertechnik zusätzliche Tests überflüssig?
Nein. Fokusführung, Formularverhalten, Tastaturbedienung und erforderliche Fallbacks müssen in deiner tatsächlichen Anwendung funktionieren. Ein natives Element allein belegt das nicht.
Spart Modern Web Guidance JavaScript und Modellkosten?
Es kann passende native Alternativen nahelegen. Unser Pilot zeigte weniger JavaScript in einem einzelnen Output, aber keine allgemeine Kosten- oder Geschwindigkeitsersparnis. Zusätzlicher Guide-Kontext ist ebenfalls Modellinput.
Verbessert Modern Web Guidance SEO oder Barrierefreiheit garantiert?
Nein. Anleitungen können relevante technische Entscheidungen unterstützen, ersetzen aber keine Messung oder Prüfung. Eine garantierte Rankingwirkung oder vollständige WCAG-Konformität ist nicht belegt.


Fazit
Nutze Modern Web Guidance als Fachbibliothek für klar begrenzte Webaufgaben, nicht als Freibrief für ungeprüfte Modernisierung. Gib Browserziele vor, verlange vollständig gelesene Guides und prüfe den resultierenden Code samt Bedienung; unser Pilot rechtfertigt keinen allgemeinen Sieger. Für den ergänzenden Workflow helfen die Einordnung des Agent-Harness, der Astryx-/shadcn-Vergleich und der Einstieg in Playwright-Tests.
Quellen
Originaldokumentation und Projektmessungen
- Chrome for Developers: Stable-Ankündigung, Installation und Einstieg, Browserziele und Fallbacks, Modernisierungsworkflow.
- GoogleChrome: versionsgebundene Skill-Anweisung, Paketdefinition, README mit Eval-Snapshot und Lizenzen.
- GoogleChrome: Telemetrie-Logger und öffentliches Eval-Dashboard mit Methodik. Die Evals sind Projektmessungen.
Externe Einordnung
- Christian Ott, SEO Kreativ: Modern Web Guidance im Praxistest an meiner WordPress-Site. Attribuierter Einzelbericht, nicht unabhängig durch uns reproduziert.
Eigene Methodik und Synthese
Eigene Evidenz: ausgeführte CLI-Leseproben, Katalogprüfung und korrigierter Retrieval-Kleinpilot mit unveränderten Modelloutputs. Aufbau, Messgrößen, Fokusabweichung und Ausführungsgrenzen sind im Praxisabschnitt beschrieben; die internen Run-Protokolle sind nicht öffentlich verlinkt. NotebookLM diente zur Quellensynthese, nicht als Ursprung der Pilotmessungen oder Ersatz für Primärquellen.
Quellenstand: 19. November 2026. Die verwendete Synthese liegt im öffentlichen Recherche-Notebook; zum Öffnen kann ein Google-Login erforderlich sein.