Gepubliceerd: 10 november 2026
Achtergrond: De frontend-architectuur moderniseren met webstandaarden
note inc. is een van de grootste creator- en mediaplatforms van Japan, met meer dan 90 miljoen maandelijks actieve gebruikers. Als onderdeel van een doorlopende inspanning om de frontend te moderniseren, zijn de web-apps van note gebouwd met Next.js en React.
Het frontend-engineeringteam heeft AI-programmeerassistenten opgenomen in hun ontwikkelingsworkflow. Om deze tools te helpen moderne, aan de normen voldoende code te genereren, heeft Google de Modern Web Guidance geïntroduceerd, een reeks vaardigheden die expertise over webplatforms, best practices en gegevens over browsercompatibiliteit rechtstreeks in je programmeeragents inbedden.
Om te evalueren hoe Modern Web Guidance de gegenereerde code in hun Next.js-codebase beïnvloedt en te bepalen hoe ze deze kunnen integreren met hun interne componentenbibliotheek (note-ui), heeft note een gestructureerde vergelijkende evaluatie uitgevoerd voor 6 praktijkscenario's voor UI.
De uitdaging: interne componenten coördineren met webstandaarden
note maintains note-ui, an internal React component library providing
brand-consistent, accessible elements such as dialogs, tooltips, accordions, and
form fields. Teamrichtlijnen schrijven het gebruik van note-ui voor om visuele consistentie en toegankelijkheidsbaselines op het platform te behouden.
Het frontendteam van note wilde bepalen waar Modern Web Guidance het grootste architectonische voordeel oplevert en hoe ze webstandaarden het beste kunnen afstemmen op hun bestaande componentenbibliotheek.
De evaluatie-instellingen
note heeft een vergelijkend onderzoek uitgevoerd naar klonen van hun productie Next.js-codebase voor 6 echte UI-taken, waarbij 3 voorwaarden werden vergeleken:
- Zonder begeleiding: AI-tools die werken zonder Modern Web Guidance.
- Met expliciete begeleiding: AI-tools die zijn uitgerust met Modern Web Guidance en die worden gevraagd deze te raadplegen.
- Met impliciete begeleiding: Modern Web Guidance is beschikbaar in de repository zonder expliciete vermelding van de prompt.
De 6 taken zijn gecategoriseerd op basis van hun relatie met de interne componentenbibliotheek van NotebookLM:
- Taken die worden gedekt door
note-ui: Bevestigingsvenster verwijderen. - Taken die buiten het bereik van
note-uivallen: Koptekst die kleiner wordt bij scrollen, optimalisatie van de paginasnelheid van artikelpagina's. - Taken die gedeeltelijk worden gedekt door
note-ui: Veelgestelde vragen (vereist dat er maar één tegelijk kan worden geopend en dat ze vindbaar zijn via zoeken op de pagina), tooltips voor uitgebreide gebruikersprofielen, aanmeldingsformulieren voor leden.
Implementaties zijn niet alleen geverifieerd via statische codeanalyse, maar ook door gerenderde DOM- en CSS-eigenschappen te inspecteren in geautomatiseerde Chromium- en WebKit-browsertests.
Hieronder staan de 6 UI-scenario's en de functionele criteria die worden geëvalueerd.
Belangrijkste bevindingen: waar Modern Web Guidance de grootste impact heeft
Om de impact van Modern Web Guidance in de praktijk te meten, voerde note een gestructureerde evaluatie uit van 180 uitvoeringen op klonen van hun Next.js-productierepository. Ze evalueerden 2 commerciële frontier-coderingsagents in 6 UI-scenario's onder 3 omstandigheden: zonder begeleiding, met ongevraagde begeleiding (vaardigheid op repositoryniveau beschikbaar) en met expliciete prompts.
Geautomatiseerde testpakketten hebben de gerenderde DOM, de indeling en de berekende CSS-eigenschappen geverifieerd in headless Chromium- en WebKit-browserruntimes op basis van 19 criteria die zijn gedefinieerd in moderne webstandaarden.
Naleving van webstandaarden per evaluatievoorwaarde
1. Architectuur- en prestatieverbeteringen
Modern Web Guidance bleek een krachtige aanvulling op de bestaande architectuur van note. De componentenbibliotheek van note-ui zorgde voor merkconsistentie voor standaard UI-elementen, maar Modern Web Guidance rustte AI-tools uit om complex interactief gedrag en prestatieoptimalisaties te verwerken met systeemeigen browser-API's.
Zonder begeleiding genereerden AI-tools vaak aangepaste JavaScript-gebeurtenislisteners, handmatig statusbeheer en ad-hoc laden van componenten. Met Modern Web Guidance hebben tools consequent declaratieve native functies overgenomen en essentiële best practices voor prestaties versterkt.
Impact van de overstap naar moderne webstandaarden versus niet-begeleide implementatie
De impact van Modern Web Guidance op je codebase varieert afhankelijk van de prompts en de gebruikte functies. Hier is een concreet voorbeeld van hoe de imperatieve JavaScript-scroll-listeners voor de kop zijn vervangen door native CSS Scroll-Driven Animations.
/* With Modern Web Guidance: CSS scroll-driven animation (excerpt, CSS Modules) */
.header {
--shrink-progress: 0;
--shrink-distance: calc(var(--header-max-height) - var(--header-min-height));
position: fixed;
inset: 0 0 auto;
/* Without support, a JS fallback updates --shrink-progress */
height: calc(var(--header-max-height) - var(--shrink-distance) * var(--shrink-progress));
}
/* The shadow fades in through opacity only */
.header::after {
content: "";
position: absolute;
inset: 0;
pointer-events: none;
box-shadow: var(--elevation-4);
opacity: var(--shrink-progress);
}
@supports ((animation-timeline: scroll()) and (animation-range: 0% 100%)) {
.header,
.header::after,
.logo {
animation-duration: auto;
animation-timing-function: linear;
animation-fill-mode: both;
animation-timeline: scroll(block root);
animation-range: 0px var(--shrink-distance);
}
.header { animation-name: header-shrink; }
.header::after { animation-name: header-shadow; }
.logo { animation-name: logo-shrink; }
}
@media (prefers-reduced-motion: reduce) {
.header,
.header::after,
.logo {
animation-timing-function: steps(1, end);
}
}
@keyframes header-shrink { to { height: var(--header-min-height); } }
@keyframes header-shadow { to { opacity: 1; } }
@keyframes logo-shrink { to { transform: scale(0.5); } }
2. De juiste operationele grens bepalen voor interne ontwerpsystemen
De evaluatie benadrukte ook hoe AI-coderingstools instructies interpreteren. Als tools een expliciete, onvoorwaardelijke instructie kregen om webrichtlijnen te volgen, selecteerden ze vanzelf native HTML-elementen (zoals native <dialog> of <input>), zelfs als er een bestaande note-ui-component beschikbaar was.
vond dat de oplossing eenvoudig is: in plaats van webbegeleiding te behandelen als een alles-of-niets-schakelaar, bereiken teams het beste resultaat door een duidelijke regelhiërarchie vast te stellen in repository-instructies (zoals AGENTS.md).
De beslissing: een hiërarchische regelstructuur in AGENTS.md
Op basis van de evaluatiebevindingen heeft note een systematische regel opgesteld in de richtlijnen voor de repository (AGENTS.md) om ontwikkelaars en AI-tools te begeleiden:
## UI Components and Modern Web Guidance
When building UI, follow this order of precedence. This applies even though the `modern-web-guidance` skill describes itself as mandatory for all HTML/CSS and client-side JavaScript tasks.
1. **Prioritize noteui**: For UI elements already provided by noteui (dialogs, toasts, buttons, form fields, popovers, etc.), use those components and follow existing conventions (such as `useDialogState` and react-hook-form). In apps, import them through `@/ui/noteui`. Do not replace an available component with a native HTML element (such as `<dialog>` or a plain `<input>`) simply because Modern Web Guidance recommends it.
2. **Use Modern Web Guidance where noteui falls short**: For capabilities that noteui does not cover or requirements it cannot meet, consult the `modern-web-guidance` skill before writing HTML, CSS, or client-side JavaScript. For example:
- Scroll-linked effects: Use CSS scroll-driven animations instead of scroll event listeners.
- Exclusive or page-searchable disclosure: Use `<details name="...">` and `hidden="until-found"`.
- Core Web Vitals: Use `fetchpriority` for LCP images and `content-visibility` for off-screen content.
- Form attributes: Pass attributes such as `autocomplete` and input `type` through the field component's props.
3. **Prioritize existing components when guidance conflicts**: Apply Modern Web Guidance only through the props and attributes supported by the component. For noteui form fields, display validation errors using the component's built-in mechanisms (`validationState` / `errorMessage`, or `HelpText` with `aria-describedby`) rather than custom alert elements.
Door deze hiërarchie te definiëren:
- De consistentie van de bestaande UI blijft behouden: Standaarddialoogvensters en -formulieren blijven
note-uigebruiken. - Aangepaste JavaScript is geëlimineerd: Nieuwe interactieve gedragingen en animaties maken gebruik van systeemeigen browsermogelijkheden.
- De codekwaliteit is gestandaardiseerd: Tools voor ontwikkelaars volgen automatisch moderne webstandaarden waar die het belangrijkst zijn.
Belangrijke punten voor technische teams
- Gebruik moderne platformfuncties waar ontwerpsystemen eindigen: Componentbibliotheken zijn uitstekend voor UI-elementen van merken, maar moderne browsers bieden krachtige native mogelijkheden voor scrollen, pop-overs en laadprioriteiten. Modern Web Guidance helpt tools voor ontwikkelaars om deze systeemeigen mogelijkheden te gebruiken in plaats van aangepaste JavaScript te schrijven.
- Definieer een duidelijke prioriteitshiërarchie: In codebases met een bestaande componentenbibliotheek zorgt de toevoeging van een beknopte prioriteitsvolgorde in repositorybestanden (zoals AGENTS.md) ervoor dat tools je ontwerpsysteem respecteren terwijl ze moderne webstandaarden overnemen.
- Verifiëren in echte browserruntimes: Als je de gerenderde uitvoer test in geautomatiseerde browsers, krijg je onmiddellijk feedback over hoe moderne CSS en HTML werken met specifieke bundlers en frameworkomgevingen.
"Onze missie bij note is 'Start, and Keep on Creating' (Begin en blijf creëren). Daarom moet ons platform snel en toegankelijk blijven voor elke creator en lezer. Omdat steeds meer van onze code wordt geschreven met AI-programmeeragents, helpt Modern Web Guidance ze om moderne, op standaarden gebaseerde oplossingen te gebruiken in plaats van terug te vallen op oudere JavaScript-patronen. De tool wijst ook op details die je makkelijk over het hoofd ziet, zoals de prioriteit voor het laden van afbeeldingen en de toegankelijkheid van formulieren. In combinatie met ons ontwerpsysteem kunnen we Notities blijven verbeteren terwijl onze UI consistent blijft.'