코딩 에이전트가 최신 웹 표준을 따라 쓰도록 이끄는 가이드라인
코딩 에이전트가 낡은 패턴 대신 최신 웹 플랫폼 기능을 자연스럽게 활용하게 됩니다. 에이전트의 컨텍스트에 전문가가 큐레이션한 가이드를 직접 주입하는 도구입니다. 브라우저 호환성과 모던한 구현 방식을 코드 생성 과정에 반영합니다.
에이전트의 낡은 습관 교정
대형 언어 모델은 학습 데이터에 포함된 레거시 코드 때문에 구식 패턴을 선호하는 경향이 있습니다. 이로 인해 최신 웹 플랫폼이 제공하는 네이티브 기능을 무시하고 불필요하게 부피가 큰 자바스크립트를 생성하기도 합니다. 이 도구는 에이전트가 최신 API를 올바르게 구조화하도록 돕습니다. 브라우저가 최적화할 수 있는 플랫폼 레벨 API를 우선시하도록 유도합니다. 무거운 폴리필 대신 가볍고 합리적인 폴백을 사용하도록 지시합니다.
커버하는 웹 플랫폼 영역
최근 수년간 웹 플랫폼에 추가된 기능부터 최첨단 기술까지 폭넓게 다루고 있습니다.
- CSS 및 레이아웃 컨테이너 쿼리, 서브그리드, oklch 색상 공간, 텍스트 랩 조정 등 140여 가지의 최신 CSS 기능을 다룹니다.
- HTML 및 DOM 팝오버 API, 다이얼로그, 앵커 포지셔닝, 커스텀 엘리먼트 등 36가지의 네이티브 컴포넌트와 DOM 기능을 포함합니다.
- JavaScript 및 API 스케줄러 API, 인터섹션 옵저버, 웹 크립토그래피, 내장 AI API 등 74가지의 최신 JavaScript 기능을 설명합니다.
- 접근성 및 성능 스크린 리더 호환성, 키보드 조작, INP 진단, 이미지 최적화 등 접근성과 성능 향상을 위한 구체적 가이드를 제공합니다.
설치 및 사용 방법
터미널에서 npx modern-web-guidance@latest install 명령을 실행하면 인터랙티브 위저드가 설치 과정을 안내합니다. 설치 없이 바로 사용해 보고 싶다면 search 명령으로 관련 가이드를 검색하거나 retrieve 명령으로 특정 가이드를 가져올 수 있습니다. legacy-scan 명령을 사용하면 현재 프로젝트의 레거시 패턴을 스캔할 수 있습니다. 이 도구는 TypeScript로 작성되어 있으며, 코딩 에이전트의 컨텍스트 윈도우에 직접 가이드를 반환하는 CLI 도구로 동작합니다.
브라우저 팀이 함께 관리하는 신뢰성
이 프로젝트는 구글 크롬, 마이크로소프트 엣지, 모질라 파이어폭스, MDN 팀이 함께 관리합니다. 웹 개발 커뮤니티와 함께 프로젝트의 방향성과 코드베이스를 유지보수합니다. 각 브라우저 벤더의 전문가가 참여하여 가이드의 정확성과 최신성을 보장합니다. 코딩 에이전트를 사용하는 개발자라면, 에이전트가 생성하는 코드의 품질과 현대성을 높이고 싶을 때 이 도구를 고려해 볼 만합니다. 설치 전에는 자신의 에이전트 환경이 CLI 기반 가이드 주입을 지원하는지 확인하는 것이 좋습니다.