Modern Web Guidance
- 추천0
- GitHub 별21K
- 개발라이선스Apache-2.0
Chrome 팀이 만든 웹 모범 사례 스킬. 코딩 에이전트가 낡은 패턴 대신 최신 웹 표준(CSS·HTML·JS API)을 쓰도록 안내해요
요약
Chrome 팀이 만든 웹 모범 사례 스킬. 코딩 에이전트가 낡은 패턴 대신 최신 웹 표준(CSS·HTML·JS API)을 쓰도록 안내해요
설명
Modern Web Guidance
Modern Web Guidance는 웹 플랫폼 전문 지식, 모범 사례, 브라우저 호환성 데이터를 코딩 에이전트에 직접 넣어 주는 스킬 모음입니다. 에이전트가 낡은 패턴 대신 최신 웹 플랫폼의 기능을 활용한 해법으로 가도록 이끌어요.
Google Chrome, Microsoft Edge, Mozilla Firefox, MDN 팀이 웹 개발 커뮤니티와 함께 관리합니다.
빠른 시작
npx modern-web-guidance@latest install
이 명령은 대화형 마법사를 실행해 Modern Web Guidance를 설치합니다. 다른 설치 방법은 「설치」 탭을 보세요.
설치 없이 써 보기
# 관련 가이드 검색
npx modern-web-guidance@latest search "animate a dialog modal backdrop"
# ID로 가이드 가져오기
npx modern-web-guidance@latest retrieve "animate-to-from-top-layer"
# 코드베이스에서 낡은 패턴을 찾아 현대화할 곳 점검
npx modern-web-guidance@latest legacy-scan .
왜 필요한가요?
코딩 에이전트는 학습 데이터에 오래된 코드가 아주 많아 낡은 패턴을 기본값으로 쓰는 경우가 많습니다. 그래서 지금은 브라우저가 기본으로 제공하는 고성능 해법이 있는 작업에도 군더더기 많은 JavaScript를 만들어 내곤 해요.
모델이 어떤 API가 있다는 것을 알더라도, 실제 서비스에 쓸 만한 최신 구현 패턴은 충분히 알지 못하는 경우가 많습니다.
Modern Web Guidance는 이 틈을 메웁니다. 스킬의 CLI가 전문가가 다듬은 지침을 에이전트의 컨텍스트에 바로 넣어 주며, 다음에 집중해요.
- 최신 브라우저 API: 모델이 자주 잘못 쓰는 API를 올바르게 구성하도록 돕습니다.
- 성능과 접근성: 브라우저가 최적화할 수 있고 접근성 기능이 내장된 플랫폼 수준 API를 우선합니다.
- 책임 있는 대체 수단(폴백): 무거운 폴리필이나 낡은 라이브러리 대신 가볍고 알맞은 폴백을 쓰도록 이끕니다.
무엇이 들어 있나요?
지난 몇 년간 새로 나온 웹 플랫폼 기능부터 최신 기능까지 다룹니다. 가이드는 토큰을 아끼도록 설계했어요. 평가(eval)를 돌려 모델이 이미 아는 평범한 내용은 걷어 냅니다.
핵심 분야
| 분야 | 내용 |
|---|---|
| 🎨 사용자 경험 | 매끄러운 시각 상태(View Transitions, 진입·퇴장 애니메이션, 패럴랙스 스크롤, CSS scrollbar-color) |
| 📐 CSS 레이아웃 | 현대적인 레이아웃(컨테이너 쿼리, subgrid, oklch 같은 색 공간, text-wrap 조정, line-height 트리밍) |
| ⚡ 성능 | 속도 최적화(즉시 프리로드, INP 진단, scheduler.yield로 작업 나누기) |
| 📝 폼과 UI | 기본 제공 컴포넌트(툴팁용 Anchor Positioning, Popover API, 다이얼로그, :user-invalid 검증, 자동 크기 조절 입력란) |
| ♿ 접근성 | 스크린 리더 · 키보드 조작, 콘텐츠 탐색 · 발견성 |
| 🤖 내장 AI | 로컬 클라이언트 모델(번역, 요약, 언어 감지 API) |
전체 목록
최신 웹 기능 262개
| 분류 | 기능 수 | 예시 |
|---|---|---|
| CSS와 레이아웃 | 140 | :has(), @scope, @starting-style, Anchor positioning, Container queries, Cascade layers, Nesting, Subgrid, Scroll-driven animations, View transitions, color-mix(), light-dark(), text-wrap: balance, field-sizing |
| HTML과 DOM | 37 | <dialog>, Popover, Invoker commands, inert, Customizable <select>, Declarative shadow DOM, moveBefore(), hidden="until-found", Form-associated custom elements |
| JavaScript와 API | 85 | Navigation API, Temporal, Scheduler API, Speculation rules, Sanitizer API, Trusted types, Web authentication, Web Cryptography, WebAssembly, Translator · Summarizer · LanguageModel |
실제 개발 사례(유스케이스) 204개
| 분류 | 가이드 예시 |
|---|---|
| 접근성 | accessible-error-announcement, respect-os-text-scale |
| 내장 AI | language-detection, language-model, summarizer, translator |
| CSS | animate-to-intrinsic-sizes, fluid-scaling, size-aware-styling, responsive-design, design-token-reactivity |
| 폼 | autofill-sign-in-form, autofill-payment-form, ime-safe-enter-submit, required-field-feedback, slider, switch, sms-otp-form |
| HTML | custom-elements, shadow-dom, form-associated-custom-elements, styling-web-components, web-components |
| JS | capture-location-agnostic-data, coordinate-global-events, calculate-event-differentials, sort-high-precision-timestamps |
| 성능 | break-up-long-tasks, identify-inp-causes, optimize-image-priority, defer-rendering-heavy-content, improve-next-page-load-performance, schedule-tasks-by-priority |
| 개인정보 | privacy |
| PWA | install-web-app, migrate-web-app-origin |
| 보안 | passkey-authentication, passkey-registration, client-side-encryption, digital-signatures, sanitize-untrusted-html, trusted-types, restrict-outbound-connections, verify-email-ownership |
| UI 원자 요소 | position-aware-tooltips, responsive-table, scroll-progress-indicator, shrinking-header-on-scroll, state-aware-sticky-headers, viewport-aware-dropdowns |
| UI 동작 | animate-element-entry-exit, animate-to-from-top-layer, cross-document-transitions, drag-and-drop, same-document-transitions, scrollytelling, swipe-to-remove, light-dismiss-a-dialog |
| UI 컴포넌트 | accordion, breadcrumbs, card, carousel, checkbox, copy-button, dark-mode-toggle, dialog, hovercard, menu, navbar 등 |
이렇게 동작해요
스킬은 HTML/CSS와 클라이언트 JS 작업을 시작할 때 먼저 실행되도록 만들어져 있습니다.
- 검색: 2~5단어짜리 영어 질의로 가이드를 찾습니다(
search). - 가져오기: 알맞은 가이드의 ID로 전체 지침을 컨텍스트에 불러옵니다(
retrieve). 분야 전체 가이드(css,html,forms,accessibility,performance,security등)도 함께 가져올 수 있어요. - 검증: 코드를 만들거나 고칠 때 가이드의 최신 패턴과 필요한 폴백이 반영됐는지 확인합니다.
- 사용 공개: 가이드를 참고했다면 응답 끝에
Modern Web Guidance절로 어떤 가이드를 어떻게 적용했는지 밝힙니다.
백엔드(SQL, API 라우트), 인프라 · 스크립트(CI/CD, Docker), 빌드 도구 설정 같은 작업에는 쓰이지 않습니다.
기존 코드 현대화
특정 기능을 지정하지 않고 코드베이스 전체를 현대화해 달라고 할 때는 legacy-scan으로 낡은 패턴을 찾고, 오탐을 걸러 낸 뒤, 해당 가이드를 가져와 바꿉니다. legacy-scan은 전체 가이드의 약 20%(규칙으로 판별 가능한 것)만 점검합니다.
브라우저 지원과 폴백
- 기본적으로 Baseline Widely available 기능은 폴백 없이 써도 안전하다고 봅니다.
- 그보다 새로운 기능은 가이드의 폴백 권장안을 따릅니다.
- 지원 브라우저 정책(예:
Safari 17.4+,폴리필은 쓰지 않기)이 있다면AGENTS.md나CLAUDE.md에 적어 두면 그 기준에 맞춰 판단합니다.
더 알아보기
저장소 README 뒷부분에는 다른 설치 방법, 프로젝트 설정, CLI 사용법 등이 있습니다. 자세한 내용은 공식 문서와 저장소 README를 보세요.
라이선스: Apache-2.0
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0