본문 바로가기
이지티켓

Modern Web Guidance, AI 코딩의 낡은 자바스크립트 고치기

이지티켓
발행일:
Contents

클로드 코드에게 「모달 창 하나 만들어 줘」라고 하면, 화면을 덮는 div와 열고 닫는 자바스크립트를 한 무더기 짜 오는 경우가 많아요. 브라우저에는 이미 <dialog> 태그와 Popover API가 있는데도요. Modern Web Guidance는 구글 크롬 팀이 2026년 5월 Google I/O에서 미리보기로 처음 내놓고 11월 10일 1.0을 낸 오픈소스 스킬 모음으로, 클로드 코드·코덱스·커서 같은 코딩 에이전트가 오래된 패턴 대신 최신 브라우저 기능을 쓰도록 웹 플랫폼 지식과 브라우저 호환성 데이터를 넣어 줘요.

이번에는 직접 설치해 돌리지 않고, 저장소와 공식 문서, 가이드 본문을 열어 보며 판단했어요. 결론부터 말하면 화면 만드는 일을 AI에게 맡기는 사람에게는 깔아 둘 이유가 충분한 도구예요.

크롬·엣지·파이어폭스가 함께 쓴 가이드 묶음

README가 내세우는 문제의식은 단순해요. AI가 배운 코드 중에는 낡은 코드가 많아서, 에이전트가 필요 이상으로 큰 자바스크립트를 만든다는 거죠. 해커뉴스에 올라온 소개 글 제목도 「코딩 에이전트를 2019년 무렵 자바스크립트에서 벗어나게」였어요.

그래서 이 도구는 에이전트가 작업 중에 꺼내 읽을 수 있는 가이드를 묶어 둡니다. 2026년 11월 12일 README 기준으로 웹 기능 약 250개, 사용 사례 203개를 다뤄요. 관리 주체로는 구글 크롬, 마이크로소프트 엣지, 모질라 파이어폭스, MDN 팀이 적혀 있고, 엣지와 파이어폭스는 1.0부터 합류했어요. 라이선스는 둘로 나뉩니다. 프로그램 코드는 Apache 2.0, 가이드 문서는 CC-BY 4.0이에요.

GoogleChrome/modern-web-guidance GitHub 저장소 첫 화면. 별 5.5k, v1.0.0 릴리스, Apache-2.0 표시
저장소 첫 화면. 클로드·코덱스·커서·그록용 플러그인 폴더가 따로 있어요.

2026년 11월 12일 기준 GitHub 별은 5.5k, 릴리스는 13개(최신 v1.0.0)예요. 미리보기 기간에 0.0.x 버전을 여러 번 내 온 셈이라, 1.0이 갑자기 튀어나온 프로젝트는 아니에요.

가이드를 쓰면 무엇이 달라지나

README에는 같은 과제를 가이드 없이, 그리고 가이드를 쓰고 돌린 평가 결과가 실려 있어요. 11월 8일 스냅샷에서 클로드 코드는 57%에서 88%로, 코덱스는 54%에서 82%로, 안티그래비티는 58%에서 94%로 올랐어요. 열 문제 중 대여섯 개만 최신 방식으로 풀던 에이전트가 여덟아홉 개를 맞히게 된 셈이죠.

에이전트별로 가이드를 쓴 때의 통과율 막대 그래프. Antigravity 94%, Claude Code 88%, Codex 82%
README 평가 스냅샷에서 가이드를 쓴 때의 에이전트별 통과율이에요. 가이드 없이 돌렸을 때는 셋 다 50%대였어요.

다만 숫자는 출처마다 조금씩 달라요. 해커뉴스 소개 글은 약 1,700개 테스트 항목에서 55%에서 92%로, Search Engine Journal은 11월 8일 야간 자동 검사에서 56%에서 88%로 전했어요. 측정 조건이 다르니 「30%포인트 안팎 오른다」 정도로 받아들이면 무리가 없어요.

만든 쪽 밖의 사례도 1.0 발표 글에 있어요. 일본 블로그 플랫폼 note는 180회 평가에서 통과율이 61%에서 94%로 올랐고, 암호화폐 지갑 MetaMask는 리뷰 봇에 붙여 PR 약 480개 중 64개에 지적을 달았어요. 엔지니어들이 그중 43건을 고쳤고, 고치는 데 걸린 시간의 중앙값은 15분이었어요.

Modern Web Guidance는 언제 쓰면 좋나요

가이드 목록을 열어 보면 어디에 강한지 보여요. 시각 디자인, UI 구성요소(아코디언·대화상자·탭·토스트), 폼, CSS, 성능, 접근성, 보안(패스키·Trusted Types), PWA, 내장 AI까지 분야별로 나뉘어 있거든요.

Modern Web Guidance 가이드 목록 페이지와 카테고리 목차
가이드 목록. 시각 디자인부터 보안·접근성·내장 AI까지 분야별로 나뉘어 있어요.

잘 맞는 경우는 이래요.

  • 모달·툴팁·탭·드롭다운을 자주 만드는 경우. 공식 문서가 꼽는 예가 모달을 <dialog>로, 툴팁을 Popover API로 옮기는 일이에요. 라이브러리 하나 더 까는 대신 브라우저 기능으로 끝나요.
  • 이미 만든 사이트를 손볼 때. 1.0에 들어간 현대화 기능(legacy-scan)이 HTML·CSS·JS·package.json을 훑어 안전하게 바꿀 곳을 찾아 줘요.
  • 로그인·보안을 붙일 때. 패스키(WebAuthn) 로그인, 기본 CSP 설정 같은 가이드가 있어요.
  • 페이지가 느리다는 말을 들을 때. INP·LCP 개선, 링크에 마우스를 올리면 다음 페이지를 미리 불러오는 가이드가 들어 있어요.

가이드 본문은 사람이 아니라 에이전트가 읽도록 쓰여 있어요. 모달 애니메이션 가이드를 열어 보면 구현 단계, 예시 코드, 제약과 접근성, 대체 전략 순으로 딱딱하게 이어지는데, 코드에 「움직임 줄이기」 설정 대응까지 기본으로 들어가 있는 점이 눈에 띄었어요.

dialog와 popover 애니메이션을 @starting-style로 구현한 CSS 코드 예시
모달 애니메이션 가이드의 CSS 예시. 움직임 줄이기 설정 대응까지 들어 있어요.

반대로 맞지 않는 경우도 있어요. 화면보다 서버·데이터 처리가 대부분인 프로젝트라면 꺼내 쓸 가이드가 많지 않아요. 토큰을 아껴야 하는 상황도 따져 봐야 해요. 해커뉴스의 한 이용자는 실행 한 번에 토큰 값이 5달러쯤 들었다고 남겼고, 또 다른 이용자는 자기 코드에서 legacy-scan이 찾은 문제가 적었다고 했어요. 유지관리자들은 스캔을 일부러 보수적으로 만들었고 범위를 넓혀 가겠다고 답했어요.

설치와 쓰는 법: 준비물, 명령, AI에게 할 말

준비물은 코딩 에이전트 하나와 npx를 돌릴 수 있는 Node.js 환경이에요. README에 따르면 API 키나 추가 의존성 없이 오프라인으로 돌아가요. 필요한 Node 최소 버전은 공식 페이지에 적혀 있지 않았어요.

시작하기 문서가 권하는 방법은 설치 마법사예요. 이 방식이어야 자동 업데이트가 켜지고, 다른 설치 방법은 대부분 자동 업데이트를 지원하지 않는다고 해요.

npx modern-web-guidance@latest install

에이전트 플러그인으로 바로 넣고 싶다면 문서에 적힌 명령은 이래요.

# Claude Code
claude plugin install modern-web-guidance@claude-plugins-official

# Codex
codex plugin marketplace add GoogleChrome/modern-web-guidance
codex plugin add modern-web-guidance@googlechrome

에이전트별 설치 명령 블록: gh skill install, npx skills add, claude plugin install
시작하기 문서의 에이전트별 설치 명령. 복사 버튼으로 바로 가져갈 수 있어요.

깔기 전에 어떤 가이드가 나오는지 먼저 보고 싶으면 설치 없이 검색만 해 볼 수도 있어요. 결과는 가이드 id, 설명, 쓰는 웹 기능, 토큰 수가 담긴 JSON으로 나와요.

npx modern-web-guidance@latest search "animate a dialog modal backdrop"

설치한 뒤에 할 일은 두 가지예요. 하나는 지원할 브라우저 범위를 정하는 것이죠. AGENTS.md나 CLAUDE.md에 Baseline 목표를 한 줄 적으면 되고, 적지 않으면 「Baseline Widely available」(모든 주요 브라우저에서 30개월 넘게 함께 돌아간 기능)이 기본값이에요.

다른 하나는 에이전트에게 일을 시키는 문장이에요. 첫 요청으로는 modern-web-guidance 스킬로 프로젝트를 legacy-scan 해서 바꿀 만한 곳을 목록으로 먼저 보여 달라고 하고, 고른 것만 고치되 모달은 dialog 요소로 바꾸라고 덧붙이면 돼요. 두 번째 요청에서는 CLAUDE.md에 Baseline 목표(예: Baseline 2024)를 적게 한 뒤, 앞으로 UI를 만들 때 그 범위를 벗어나는 기능에는 대체 구현을 함께 붙이라고 일러 두면 되고요.

첫 요청에서 「목록 먼저」를 붙이는 게 요령이에요. 스캔 결과를 보고 고를 기회가 생기거든요.

비슷한 도구와 무엇이 다른가

코딩 에이전트에 지식을 넣어 주는 도구는 이미 몇 개 있어요. 셋은 겹치기보다 맡는 영역이 달라요.

Modern Web GuidanceVercel agent-skillsContext7
알려 주는 것브라우저 자체 기능(HTML·CSS·웹 API)과 호환성UI 검토 규칙 100개 이상, React·Next.js 규칙 40개 이상라이브러리별 버전에 맞는 최신 문서·예제
만든 곳구글 크롬(엣지·파이어폭스·MDN 공동 관리)VercelUpstash
라이선스Apache 2.0 / 문서 CC-BY 4.0MITMIT
로그인·키필요 없음, 오프라인설치 명령 한 줄OAuth 로그인, API 키 권장
GitHub 별(2026.11.12)5.5k33.9k64.6k

React로 만드는 사람이라면 Vercel 스킬과 Modern Web Guidance를 같이 까는 게 맞아요. 하나는 프레임워크 습관을, 다른 하나는 그 아래 브라우저 기능을 챙기니까요. 1.0 발표 글은 가이드가 코드를 이끌 뿐 실제 동작은 시험하지 못한다며, 화면을 직접 띄워 확인하는 Chrome DevTools for agents와 함께 쓰라고 권해요.

깔기 전에 따져 볼 것

크롬 쏠림 우려. 해커뉴스에서 가장 많이 나온 비판이에요. 크롬 전용 API가 굳어질 수 있고, 파이어폭스·사파리에 없는 기능도 들어 있다는 지적이죠. Search Engine Journal 보도에 따르면 운영 자리 6개는 크롬 2, 엣지 1, 모질라 1, 독립 전문가 2로 나뉘고 애플 자리는 없어요. 대신 기본값이 오래 검증된 기능으로 잡혀 있고 가이드마다 대체 전략 절이 따로 있어서, 이 점을 합리적으로 본 반응도 있었어요.

토큰 비용. 문서의 검색 예시를 보면 가이드 한 편이 1천~2천7백 토큰 정도예요. 작업마다 몇 편씩 읽으면 그만큼 비용이 붙어요.

사용 정보 수집. 긱뉴스 요약에 따르면 익명 사용 정보를 모으고, 환경 변수 DISABLE_TELEMETRY=1로 끌 수 있어요. 회사 코드에 쓴다면 이 설정부터 정해 두는 편이 안전해요.

아직 이른 부분. 1.0 글 스스로 현대화 스캔이 정해진 일부 패턴만 보는 정적 분석이라고 밝혀요. 1.0이 나온 지 며칠 안 된 만큼, 큰 코드를 한 번에 맡기기보다 화면 하나씩 바꿔 보는 쪽이 낫습니다.

다음에 AI에게 모달이나 툴팁을 맡길 일이 생기면, 그 전에 설치 명령 한 줄부터 넣어 두세요.

자주 묻는 질문

Modern Web Guidance는 무료인가요?

네. 코드는 Apache 2.0, 가이드는 CC-BY 4.0으로 공개돼 있고 API 키도 필요 없어요. 다만 에이전트가 가이드를 읽는 만큼 쓰는 AI 도구의 토큰 비용은 늘어요.

커서나 코파일럿에서도 쓸 수 있나요?

1.0 발표 글 기준으로 클로드 코드, 코덱스, 커서, 안티그래비티, 코파일럿, 웹스톰, Kimi Code, Grok Build의 플러그인 마켓에서 받을 수 있어요. 제미나이 CLI와 Goose용 설치법도 시작하기 문서에 있어요.

가이드를 사람이 직접 읽어도 되나요?

크롬 개발자 사이트에 가이드 목록과 본문이 공개돼 있어서 누구나 볼 수 있어요. 다만 에이전트가 읽도록 쓴 글이라 문장이 딱딱하고, 사람용 설명서라기보다 체크리스트에 가까워요.

참고한 자료 8
  1. GoogleChrome/modern-web-guidance (GitHub)
  2. Get started with Modern Web Guidance – Chrome for Developers
  3. Modern Web Guidance 1.0 – Chrome for Developers Blog
  4. 15 updates from Google I/O 2026 – Chrome for Developers Blog
  5. Google Releases Modern Web Guidance 1.0 For AI Coding Agents – Search Engine Journal
  6. Show HN: Get your coding agent off ~2019 JavaScript, onto modern web primitives – Hacker News
  7. vercel-labs/agent-skills (GitHub)
  8. upstash/context7 (GitHub)

이 글은 AI가 자료 조사와 초안 작성을 돕고, 운영자가 직접 써 보고 확인해 고친 뒤 발행했어요. 틀린 내용을 발견하면 알려 주세요.