도구

Chrome이 Coding Agent에 Contemporary Web 방식을 가르하다

Chrome 팀이 공개한 modern-web-guidance는 Coding Agent가 JavaScript와 추가 의존성 대신 CSS.highlights, <dialog>, field-sizing 등 브라우저 기본 기능을 우선 활용하도록 안내한다. 플랫폼 규칙을 통해 생성 코드의 상태 관리와 번들 크기를 줄이는 접근이다.

글자 크기

Chrome이 Coding Agent에 Contemporary Web 방식을 가르하다

Chrome 팀이 modern-web-guidance를 공개했다. 이 프로젝트는 브라우저 플랫폼 규칙을 Coding Agent에 전달해 JavaScript 코드와 외부 의존성을 덜 쓰도록 유도한다. Agent가 프런트엔드 코드를 생성할 때 레거시 팝업, 하이라이트, 폼 로직을 그대로 복사하는 일이 줄어들 수 있다는 점에서 개발자에게 직접적인 영향을 준다.

모델은 CSS.highlights, <dialog>, showModal() 같은 API 이름을 알고 있다.

하지만 텍스트 하이라이트나 팝업, 높이가 자동으로 늘어나는 입력 필드를 수정하라고 하면 여전히 긴 JavaScript 코드를 작성하고, 필요하다고 판단한 의존성까지 추가할 수 있다.

문제는 API를 모르는 것이 아니다.

훈련 데이터에 오래된 패턴이 너무 많이 남아 있는 데에 가깝다.

Google Chrome 팀은 modern-web-guidance를 오픈소스로 공개하며 Coding Agent에 현대 Web 플랫폼 지식을 보충하는 것을 목표로 삼았다. 프로젝트 소개는 다음과 같이 명시한다.

“We started an effort in Chrome to supplement coding agents with this key domain knowledge.”

새 프레임워크나 런타임을 제공하는 프로젝트는 아니다. Agent를 위한 도메인 규칙에 가깝다. 먼저 브라우저가 이미 처리할 수 있는 일을 알려 준 뒤, 그 기준으로 코드를 생성하도록 유도한다.

API를 아는데 사용하지 않는 이유

Coding Agent의 일반적인 문제는 API를 모르는 것이 아니라 알고도 사용하지 않는 데 있다.

프로젝트 팀은 최신 API 이름을 알고 있는 모델도 플랫폼의 기본 방식을 선택하기보다 기존 JavaScript 패턴을 고르는 경우가 많다고 observes했다.

이는 개발자의 보수적인 습관과도 닮았다.

2019년에는 텍스트 선택 스타일을 처리할 때 selectionchange 이벤트를 감시하고 DOM 노드를 순회하며 하이라이트 상태를 직접 관리하는 방식이 흔했다. 2026년에도 브라우저는 CSS.highlights를 지원하지만, 구형 코드가 훈련 데이터의 대부분을 차지한다.

모델이 코드를 자동 완성할 때 가장 쉽게 이어가는 것은 ‘최선의 사례’보다 ‘가장 자주 등장한 패턴’이다.

그래서 다음과 같은 구체적인 낭비가 반복된다.

  • 텍스트 하이라이트 로직이 여러 JavaScript 콜백에 흩어져 있다.
  • 모달이 오버레이, 닫기 버튼, 포커스를 직접 관리한다.
  • textarea의 높이를 input 이벤트로 감시한 뒤 scrollHeight를 읽어 style.height에 다시 기록한다.
  • 이러한 작은 기능을 위해 Popper, Headless UI 같은 의존성을 추가한다.

생성된 코드는 동작한다.

하지만 코드가 더 무거워지고, 관리할 상태가 늘며, 브라우저 호환성 경계도 복잡해진다.

Chrome이 보충하는 도메인 지식

modern-web-guidance의 목적은 간결하다. Agent를 대신 애플리케이션을 작성하지 않고, 브라우저 플랫폼에 관한 도메인 지식을 보충한다.

이 구분이 중요하다.

범용 모델은 React, Vue, Node.js를 사용할 수 있고 많은 JavaScript 관용구도 알고 있다. 하지만 플랫폼 규칙이 충분히 명확하지 않으면 ‘API를 호출할 수 있다’와 ‘API를 우선 사용해야 한다’를 혼동하기 쉽다.

이 프로젝트는 구조화된 가이드를 제공한다. 목차는 도메인과 세부 기능별로 구성되어 있어 Agent가 코드를 작성하기 전에 필요한 규칙만 읽을 수 있다. API 문서 전체를 컨텍스트에 넣지 않아도 된다.

이 프로젝트가 해결하려는 문제는 컨텍스트 길이가 아니다.

오히려 컨텍스트의 내용과 우선순위를 바꾸려는 시도다.

예전에는 Agent에 API 문서를 추가하면 사용할 수 있는 선택지가 늘었다. Chrome 팀은 이제 기본 선택을 분명히 정의한다. 텍스트 범위 하이라이트에는 CSS.highlights를 우선 확인하고, 모달 대화상자에는 <dialog>와 showModal()를, 입력 필드 자동 높이에는 field-sizing을 먼저 살펴보도록 안내한다.

예제보다 규칙이 제약에 가깝다.

예제는 ‘이렇게 작성할 수 있다’라고 말하고, 규칙은 ‘이렇게 작성하는 것을 우선한다’라고 말한다.

세 가지 기능, 세 가지 코드

아래 예제는 프로젝트가 제시한 기능 방향을 보여 준다. 완전한 프레임워크 코드는 아니지만, 브라우저에 맡기는 방식과 상태를 직접 관리하는 방식의 차이를 설명하기에 충분하다.

1. 텍스트 범위 하이라이트

기존 방식에서는 선택 변경을 감시하고 범위를 계산한 뒤 스타일을 적용하고, 해제까지 직접 처리해야 한다.

현대적인 방법은 CSS.highlights를 사용하고 Highlight로 텍스트 범위를 등록한다.

const highlight = new Highlight();
CSS.highlights.set('search-results', highlight);

const range = document.createRange();
range.selectNodeContents(document.querySelector('#result'));
highlight.add(range);

프로젝트는 이 기능을 CSS.highlights를 이용한 텍스트 범위 하이라이트로 설명한다. 동일한 로직을 여러 JavaScript 코드에 분산시키지 않아도 된다.

브라우저가 하이라이트 집합을 관리한다. JavaScript는 범위만 제공하면 되고 스타일은 CSS에 둘 수 있다.

::highlight(search-results) {
  background-color: #fde68a;
  color: #111827;
}

Coding Agent에 적용하면 의미가 분명한 기본 선택이 바뀐다. 기존 상태 관리를 더 깔끔하게 다시 작성하는 것이 아니라, 상태 관리 자체를 최대한 제거한다.

2. 모달 대화상자

팝업을 직접 구현하면 오버레이, 스크롤 잠금, 포커스 이동, 닫힌 뒤 포커스 복구가 프로젝트의 보이지 않는 기반 코드가 되기 쉽다.

HTML의 기본 방식은 <dialog>와 showModal()을 결합하는 것이다.

<dialog id="settings-dialog">
  <form method="dialog">
    <h2>Settings</h2>
    <button value="close">Close</button>
  </form>
</dialog>
const dialog = document.querySelector('#settings-dialog');

openButton.addEventListener('click', () => {
  dialog.showModal();
});

프로젝트가 제시한 이점에는 기본 backdrop과 더 나은 포커스 관리가 포함된다.

즉, 오버레이를 위한 별도의 div가 필요 없고, 포커스가 팝업 안으로 이동하며 모달 컨텍스트에 제한되고, 닫힌 뒤 이전 위치로 복구되는 과정도 브라우저의 의미론을 따를 수 있다.

Agent가 ‘모달’ 기능을 구현할 때 <dialog>를 기본값으로 선택한다면 작은 인터랙션 컴포넌트가 수십 줄의 JavaScript에서 몇 줄의 호출로 줄어들 수 있다.

3. 높이가 자동으로 늘어나는 textarea

구형 코드는 익숙하다. input을 감시하고 scrollHeight를 읽은 다음 높이를 설정한다.

현대 Web 플랫폼은 field-sizing을 제공한다.

<textarea rows="3" field-sizing="content"></textarea>

사용자가 입력하면 textarea의 높이가 자동으로 증가한다.

프로젝트는 이 기능을 사용자가 입력하는 내용에 따라 textarea가 자동으로 높아지는 기능으로 설명한다.

resize 이벤트를 감시할 필요도, 높이를 캐시할 필요도, 파생 값을 프레임워크 상태에 저장할 필요도 없다.

이 사례는 이러한 가이드의 가치를 가장 잘 보여 준다. Agent에게 새로운 아키텍처를 가르치지는 않더라도 여러 해 동안 사용된 상투적인 코드를 더 이상 복사하지 않게 한다.

Agent의 격차는 컨텍스트가 아니다

Coding Agent가 지나치게 보수적인 코드를 작성할 때 많은 developers가 처음 떠올리는 방법은 ‘최신 JavaScript 튜토리얼을 더 많이 넣자’다.

하지만 대개 충분하지 않다.

API 설명이 부족한 것이 아니라, 기본 선택이 구형 코드에 밀려 있기 때문이다.

모델은 역사적 부담, 호환성 요구, 작성자의 개인적 취향을 가진 GitHub 프로젝트를 대량으로 학습했다. 통계적으로 이러한 코드를 재현하는 것은 자연스러운 일이다.

하지만 작업이 ‘현대적인 Web 인터랙션을 구현하라’라면 가장 좋은 답이 반드시 가장 흔한 구형 구현을 재현하는 것은 아니다.

modern-web-guidance는 코드를 생성하기 전에 브라우저 팀이 관리하는 도메인 제약을 넣으려 한다. 제약 대상은 구문이 아니라 기술 선택이다.

  • 플랫폼에 기본 기능이 있으면 JavaScript로 다시 구현하지 않는 것을 우선한다.
  • 의미를 담는 기본 요소를 사용할 수 있다면 시맨틱 요소를 우선한다.
  • 플랫폼이 포커스, 크기, 하이라이트를 이미 처리한다면 중복 상태를 유지하지 않는다.

이러한 규칙에는 엔지니어링 측면의 장점도 있다. ‘최선의 사례를 따르라’보다 검사하기 쉽다.

생성된 코드에 textarea 크기 조정을 직접 구현했는지, div로 dialog를 흉내 냈는지, 단순한 하이라이트를 위해 의존성을 추가했는지를 확인할 수 있다.

편집자의 생각

이 일이 중요한 이유는 Chrome이 또 하나의 저장소를 공개했기 때문이 아니라, 플랫폼 팀이 ‘Coding Agent를 위한 제약 계층’을 직접 관리하기 시작했기 때문이다. 예전에는 프레임워크 팀이 문서, 예제, lint 규칙을 통해 생성 코드에 영향을 미쳤다. 이제는 브라우저 팀도 자신의 기능 범위를 Agent가 읽을 수 있는 가이드로 표현할 수 있다.

앞으로 효과적인 Agent 규칙은 더 큰 모델보다 실행 플랫폼에 가까운 제약에서primarily 나올 것으로 본다. 모델은 코드를 작성하고, 플랫폼 팀은 무엇을 다시 구현하지 않아야 하는지를 규정한다.

과거와 다른 점은 RAG가 사실을 보충하는 역할을 한다면, 가이드는 기본 동작을 바꿔야 한다는 것이다. 사실은 ‘field-sizing이 무엇인가’를 설명하고, 제약은 ‘언제 반드시 우선 사용해야 하는가’를 규정한다.

다만 효과를 규칙의 표현만으로 판단할 수는 없다. 브라우저 버전 지원, 프로젝트의 호환 범위, 프레임워크의 hydration 동작, 실제 코드베이스에 존재하는 역사적 제약이 모두 결과에 영향을 준다. 특히 dialog, Popover API, field-sizing의 호환성은 새 브라우저에서의 데모로 프로덕션 검증을 대신할 수 없다.

생성 코드의 의존성이 실제로 감소하는지, 가이드가 Agent 워크플로에 들어간 뒤 프로젝트 수준 규칙에 의해 덮어써지지 않는지를 주목할 것이다. 제약이 유용한지는 지식이 늘었는지가 아니라 코드가 줄었는지로 최종 판단할 수 있다.

출처

https://github.com/GoogleChrome/modern-web-guidance

출처: https://github.com/GoogleChrome/modern-web-guidance