코딩 에이전트를 2019년식 JavaScript에서 꺼내는 Modern Web Guidance
Show HN: Get your coding agent off ~2019 JavaScript, onto modern web primitives
TL;DR Highlight
에이전트에 최신 웹 표준 가이드 스킬을 붙여 레거시 코드 생성을 줄인다
Who Should Read
AI 코딩 에이전트가 낡은 JS·CSS 패턴이나 무거운 폴리필을 쓰는 게 불만인 프론트엔드 개발자
Core Mechanics
- LLM은 옛날 코드를 너무 많이 배웠다
- LLM 학습 데이터에 레거시 코드가 많아서 에이전트가 낡은 패턴을 기본값으로 쓴다.
- 네이티브 기능으로 되는 일에도 불필요하게 큰 JavaScript를 만든다.
- API를 안다고 잘 쓰는 건 아니다
- 모델이 API 존재를 알아도 실서비스 수준의 최신 구현 패턴은 부족하다고 한다.
- 이 도구는 검증된 가이드를 에이전트 컨텍스트에 직접 넣어 준다.
- CLI로 가이드를 검색해 주입한다
- search로 관련 가이드를 찾고 retrieve로 ID별 가이드를 가져온다.
- legacy-scan으로 코드베이스의 현대화 대상 패턴을 훑는다.
- 토큰을 아끼려고 모델이 아는 내용은 뺐다
- eval을 돌려 모델이 이미 아는 평범한 내용은 가이드에서 잘라낸다.
- 가이드는 토큰 효율을 목표로 설계됐다.
- 커버 범위는 웹 기능 250개다
- CSS·레이아웃 140개, HTML·DOM 36개, JavaScript·API 74개를 다룬다.
- 실사용 사례 203개 가이드(접근성, 폼, 웹 컴포넌트, 내장 AI 등)가 있다.
- 폴리필 대신 가벼운 폴백을 권한다
- 무거운 폴리필이나 레거시 라이브러리 대신 가벼운 폴백을 쓰도록 유도한다.
- Chrome·Edge·Firefox·MDN 팀과 웹 개발 커뮤니티가 관리한다고 밝혔다.
Community Reactions
- Chrome에서만 안정인 기능이 많다는 지적
- 스킬이 권하는 기능 중 Firefox·Safari 미지원인 @function, calc-size(), focusgroup 등의 목록을 댓글이 공유했다.
- 반대로 Chrome 자체도 미지원인 기능이 약 11개 권장된다는 언급도 있었다.
- Chrome 독점을 키운다는 우려
- 에이전트가 Chrome 팀 가이드를 따르면 Chrome 단일화가 심해진다는 의견이 여러 개 나왔다.
- 호환성이 중요한데 오히려 덜 호환되는 코드를 권한다는 반론도 있었다.
- PR 리뷰에서 겪은 문제를 해결해 준다는 경험
- 2줄 최신 기능으로 바꿀 수 있는 지저분한 코드를 리뷰하다 비슷한 도구를 직접 만들었다는 경험이 있었다.
- legacy-scan을 돌려 보니 문제가 2건뿐이어서, 스킬보다 학습이 낫지만 약한 모델에는 쓸모 있겠다는 의견도 있었다.
- 호환성은 직접 걸러서 쓴다는 방법
- 에이전트에게 목록 중 Chrome, Firefox, iOS Safari, macOS Safari에서 되는 것만 적용하라고 시켜 좋은 목록을 얻었다는 경험이 있었다.
- 마크다운 인덱스를 GitHub Pages로 공개하면 설치 없이 쓰겠다는 제안도 있었다.
How to Apply
- 오늘 legacy-scan 한 번 돌려 보기
- 프로젝트 루트에서 npx modern-web-guidance@latest legacy-scan . 을 실행한다.
- 나온 항목 중 브라우저 지원이 되는 것만 골라 PR 후보로 정리한다.
- 에이전트에 지원 브라우저 제약 걸기
- 에이전트 지시문에 Chrome·Firefox·Safari 모두 지원되는 기능만 쓰라고 명시한다.
- Baseline 기준 미지원 기능은 폴백과 함께 쓰게 한다.
- UI 작업 전에 search로 가이드 먼저 확인하기
- 모달, 툴팁, 폼 검증 같은 작업 전에 search 명령으로 관련 가이드를 찾는다.
- retrieve로 받은 가이드를 에이전트 컨텍스트에 붙이고 구현시킨다.
Try It
# 터미널에서 실행 (설치 없이 체험)
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 .
# 에이전트에 스킬로 설치하려면 (대화형 마법사)
npx modern-web-guidance@latest installTerminology
관련 논문
LLM으로 리버스 엔지니어링 속도 올리기: 에이전트+Ghidra MCP+가설 디버깅
바이너리를 에이전트에 맡기고 스킬·MD 기록을 붙였더니 수년 걸릴 해킹이 가능해졌다
Metrics-in-the-Loop: 복잡도 피드백이 에이전트가 짜는 코드 구조를 바꾼다
코딩 에이전트에 복잡도 리포트를 매 턴 넣었더니 코드 erosion이 줄고 정확도는 그대로
Gemini 4 Carbon은 왜 이렇게 느린가: 에이전트 트레이스 분석
버그 수정에 Carbon은 1시간, Astra·Opus는 몇 분 걸렸고 원인은 불필요한 작업이었다
Claude Code 팀이 에이전트 작업을 검증하는 방법
E2E·property·differential 테스트와 검증 규칙으로 Claude를 병렬로 돌린다
코딩 에이전트에 자격 증명을 넘기지 않고 돌리기: lend
자격 증명은 노트북에 두고 명령만 Touch ID 승인으로 실행하게 했다
Windows 11이 어떤 코딩 에이전트·개발 도구를 쓰는지 수집한다
Windows 11 DLL 분석 결과, codex·claude 등 사용 여부가 진단 데이터로 올라간다
LLM 추론에서 대화 히스토리가 몰래 치르는 비용
대화 히스토리를 통째로 넣으면 정확도가 20턴 안에 0.6→0.1로 붕괴하고, 검증된 상태 요약은 이를 막았다
Claude Code Projects 개편: 코디네이터가 병렬 스레드를 지휘한다
Claude Code Projects가 코디네이터가 병렬 스레드에 작업을 나눠 PR까지 올리는 구조로 바뀌었다