Hoewel Modern Web Guidance ernaar streeft je ontwikkeling te verschuiven naar een aanpak die standaard correct is, kun je af en toe problemen tegenkomen met de activering van de agent, de nauwkeurigheid van de implementatie of de ontdekking van functies. In dit gedeelte vind je diagnostische stappen om veelvoorkomende problemen op te lossen, zoals zorgen dat de Modern Web-vaardigheid correct wordt geactiveerd door je prompts of nagaan of code-fallbacks overeenkomen met de vastgestelde Baseline-status van je project. Als je aanhoudende technische problemen tegenkomt of verouderde richtlijnen vindt, raden we je aan een probleem te melden, zodat we deze bronnen nauwkeurig en effectief kunnen houden.
Diagnose: Modern Web Guidance wordt niet gebruikt door je agent
Als Modern Web Guidance is geïnstalleerd, krijgen agents de instructie om deze te gebruiken voor webontwikkelingstaken. Soms negeren agents deze instructies.
Je kunt de agent expliciet de opdracht geven om Modern Web Guidance te gebruiken door een zin zoals 'gebruik modern-web-guidance' toe te voegen aan het einde van je prompt.
Sommige agents ondersteunen ook de directe aanroep van een vaardigheid met een specifieke syntaxis, zoals /modern-web-guidance of $modern-web-guidance, afhankelijk van de agent.
Raadpleeg de documentatie van je agent of vraag je agent hoe je de modern-web-guidance-vaardigheid rechtstreeks aanroept als je het niet zeker weet.
'Gehallucineerde' code of geraden implementaties diagnosticeren
Dit komt vaak voor wanneer het LLM zonder waarschuwing kennislacunes opvult. We hebben gemerkt dat het helpt om de volgende instructie aan je prompts toe te voegen om te voorkomen dat de agent informatie verzint:
Bring up knowledge gaps and don't attempt to guess implementation. List them as open questions.
Diagnose van fout om specifieke richtlijnen te activeren
Als je een specifieke use case voor een functie target en deze niet wordt ontdekt door de agent, zorg je dat je prompts specifieke zoekwoorden en ankervereisten bevatten voor een goede vindbaarheid. Zo kan de agent het relevante begeleidingstraject bepalen (bijvoorbeeld 'overgangen bekijken', 'LCP-optimalisatie').
Het denkproces van de agent volgen:
- Check de uitvoer om te zien of de vaardigheid
modern-web-guidanceis aangeroepen. - Zoek de zoekaanroep, bijvoorbeeld
npx -y modern-web-guidance@latest search "carousel scroll snap", en ga na of de zoekwoorden en de resulterende gidsen de gidsen zijn die je verwachtte. - Controleer of de ophaalaanroep de relevante gids heeft opgevraagd, bijvoorbeeld:
npx -y modern-web-guidance@latest retrieve "carousel-snap-highlights,carousel-slide-effects,scroll-snap-state-sync".
Create a new folder and create a carousel web app for me that implements scroll-snap.
...
● Bash(npx -y modern-web-guidance@latest search "carousel scroll snap" --skill-version 2026_05_16-c5e7870)
⎿ [{"id":"carousel-snap-highlights","description":"Visually highlight the currently snapped non-interactive item in scroll-snapping carousels, galleries, or full-page swipe experiences. For example, expanding a card when snapped, or revealing hidden
content.","category":"user-experience","featuresUsed":["Container scroll-state queries"],"tokenCount":1442,"similarity":0.7783},
{"id":"carousel-slide-effects","description":"Create a carousel of slides with images or other visual elements, where each slide animates as they enter/center/exit their scroller. For example, the slides may fade-in/fade-out, rotate, get bigger or smaller,
etc.","category":"user-experience","featuresUsed":["Scroll-driven animations","Scroll snap"],"tokenCount":2105,"similarity":0.6625},
{"id":"scroll-snap-state-sync","description":"Synchronize navigation indicators, linked content panels, and analytics tracking with the actively snapped item in a scrollable container.","category":"user-experience","featuresUsed":["Scroll snap events","Scroll
snap"],"tokenCount":1053,"similarity":0.6166},
{"id":"scroll-snap-realtime-feedback","description":"Provide real-time visual feedback in linked UI elements while a user scrolls through snap-aligned content, before the scroll gesture completes.","category":"user-experience","featuresUsed":["Scroll snap events","Scroll
snap"],"tokenCount":1886,"similarity":0.5664},
{"id":"navigation-drawer","description":"Create a navigation drawer component that, when triggered from a menu button, slides in from the side overlayed on top of existing page content, and slides out when dismissed (by swiping away, tapping outside, or pressing
escape).","category":"user-experience","featuresUsed":["inert","Intersection observer","Popover","Registered custom properties","Scroll-driven animations","scroll-initial-target","Scroll snap"],"tokenCount":4317,"similarity":0.5099}]
● Bash(npx -y modern-web-guidance@latest retrieve "carousel-snap-highlights,carousel-slide-effects,scroll-snap-state-sync")
⎿ <output +158 lines>
}, undefined);
if (topEntry) setSelectedParagraph(topEntry.id);
},
{ root: main, threshold: 0.9 // Adjust based on your use case },
);
// Observe all snap targets (e.g., section headers)
document.querySelectorAll('h2').forEach(header => observer.observe(header));
}
- Je kunt de zoekopdrachten ook zelf uitvoeren in de terminal om te zien welke handleidingen overeenkomen met je zoekopdracht.
# Search for relevant guides
npx modern-web-guidance@latest search "carousel scroll snap"
Feedback
Als u aanvullende vragen of feedback over deze nieuwe functies heeft, leest u eerst hoe u kunt bijdragen aan Modern Web Guidance voordat u een probleem indient in onze GitHub-repository. Geef bij het maken van het probleem de eerste agentprompts, screenshots en logboeken van het denkproces van de agent en de uiteindelijke codewijziging die op basis van dat denkproces wordt aanbevolen.