AI에게 맡기기 좋은 프론트엔드 일, 아닌 일
AI 코드 생성이 가장 잘 맞는 곳은 반복이 많고 정답의 모양이 뚜렷한 일이다. 이미 있는 디자인 시스템 위에서 같은 모양의 카드·폼·표를 하나 더 만드는 일, 정해진 API 응답을 화면 상태(로딩·오류·빈 목록)로 나누는 일, 기존 컴포넌트에 테스트를 붙이는 일, 오래된 클래스 컴포넌트를 함수 컴포넌트로 옮기는 일이 그렇다. 이런 일은 «무엇이 맞는지»를 사람이 쉽게 판단할 수 있어서, 생성 속도가 그대로 이득이 된다.
반대로 정답이 프로젝트 밖에 있는 일은 AI가 그럴듯하게 틀린다. 어떤 상태를 전역에 둘지, 어떤 화면을 서버에서 그릴지, 디자인이 비어 있는 오류 상황에서 무엇을 보여 줄지는 제품과 팀의 결정이다. 이런 결정을 AI에게 넘기면, 매번 다른 답을 받거나 이미 정한 구조와 어긋나는 코드가 섞인다. 그래서 순서는 «사람이 정하고 → AI가 만들고 → 사람이 확인한다»가 된다.
| 구분 | 예 | 맡기는 방식 |
|---|---|---|
| 맡기기 좋음 | 같은 틀의 컴포넌트 추가, 상태별 화면 분기, 테스트 초안, 타입 정의 옮기기, 반복 리팩터링 | 기존 파일 한두 개를 본보기로 주고 «이것과 같은 방식으로» |
| 같이 하기 | 폼 검증 규칙, 목록 가상화, 이미지 최적화 | 사람이 기준(규칙·숫자)을 적어 주고 AI가 구현 |
| 사람이 정함 | 상태 관리 구조, 렌더링 방식(서버·클라이언트), 디자인에 없는 오류 화면 | 결정을 규칙 파일에 적어 두고 AI는 따르기만 |
먼저 규칙 파일 — 도구가 매번 읽는 프로젝트 약속
AI 코딩 도구는 대화마다 프로젝트를 처음 보는 상태로 시작한다. 그래서 «우리 팀은 CSS 모듈을 쓴다», «서버 상태는 이 라이브러리로만», «컴포넌트는 이 폴더 구조로» 같은 약속을 매번 말해 주지 않으면 그때그때 다른 코드가 나온다. 주요 도구는 이 약속을 저장소 안 파일로 적어 두면 작업할 때마다 읽는다. 2026년 10월 29일 각 공식 문서에서 확인한 위치는 다음과 같다.
| 도구 | 저장소 전체 규칙 | 파일 종류별 규칙 |
|---|---|---|
| Claude Code | ./CLAUDE.md 또는 ./.claude/CLAUDE.md (/init으로 초안 생성) | .claude/rules/ 안 마크다운 파일 · paths 머리말로 적용 경로 지정 |
| GitHub Copilot | .github/copilot-instructions.md · AGENTS.md도 읽음 | .github/instructions/이름.instructions.md · applyTo 글롭 |
| Cursor | AGENTS.md(루트·하위 폴더) | .cursor/rules/ 안 .mdc 파일(항상 · 특정 파일 · 필요할 때 · 수동 네 가지) |
표에서 보듯 AGENTS.md는 여러 도구가 함께 읽는 쪽으로 모이고 있다. 팀에서 도구를 섞어 쓴다면 공통 약속은 한 파일에 두고, 도구별 파일에는 그 도구에만 필요한 것만 적는 편이 관리가 쉽다. 프론트엔드라면 적어 둘 만한 것은 이렇다.
- 스택과 판 — 프레임워크·라우터·스타일 방식·상태 관리 라이브러리와 그 판. 판을 적지 않으면 예전 문법이 섞여 나온다.
- 폴더와 이름 규칙 — 컴포넌트·훅·테스트 파일을 어디에 어떤 이름으로 두는지.
- 금지 목록 — 쓰지 않기로 한 라이브러리, 직접 DOM 조작, 인라인 스타일 같은 것.
- 확인 명령 — 타입 검사·린트·테스트를 돌리는 명령. 도구가 작업 뒤 스스로 돌려 보게 할 수 있다.
Claude Code 문서는 이런 파일을 «강제 설정이 아니라 맥락»으로 다룬다고 적고, 짧고 구체적일수록 더 꾸준히 따른다고 안내한다. 길게 쓰기보다 자주 틀리는 것부터 한 줄씩 늘리는 편이 효과가 있다. CLAUDE.md를 어떻게 나눠 쓰는지는 클로드 코드 CLAUDE.md 쓰는 법에 따로 정리해 두었다.
컴포넌트 요청을 쓰는 법
«사용자 프로필 카드 만들어 줘»처럼 한 줄로 요청하면, AI는 프로젝트에 없는 스타일과 데이터 구조를 지어낸다. 결과를 고치는 시간이 처음부터 짜는 시간과 비슷해진다. 요청에 아래 네 가지를 넣으면 첫 결과가 확실히 프로젝트 쪽으로 붙는다.
본보기 파일
비슷한 기존 컴포넌트 하나를 가리킨다. «components/OrderCard.tsx와 같은 구조로»라는 한 문장이 스타일 규칙 열 줄보다 정확하다.
데이터 모양
props 타입이나 API 응답 타입을 붙인다. 타입이 있으면 AI가 필드 이름을 지어내지 않는다.
상태 목록
로딩·오류·빈 목록·권한 없음처럼 화면이 가져야 할 상태를 나열한다. 적지 않은 상태는 대개 빠진다.
완료 조건
«타입 검사와 이 테스트 파일이 통과할 것», «키보드만으로 모든 버튼을 누를 수 있을 것»처럼 확인할 수 있는 조건을 준다.
components/OrderCard.tsx 와 같은 구조로 UserProfileCard 를 만들어 줘.
- props: { userId: string } · 데이터는 hooks/useUser.ts 의 useUser(userId)
- 상태: 로딩(Skeleton 컴포넌트) · 오류(ErrorMessage) · 사용자 없음 · 정상
- 스타일: 같은 폴더의 *.module.css 방식, 새 라이브러리 추가 금지
- 완료 조건: tsc 통과, UserProfileCard.test.tsx 의 네 상태 테스트 통과,
버튼은 <button> 요소로 키보드 Tab·Enter 로 동작Vue나 Angular도 원리는 같다. Vue라면 Composition API를 쓸지 Options API를 쓸지, Angular라면 Standalone 컴포넌트와 Signals를 쓸지처럼 프레임워크 안에서 갈리는 선택을 규칙 파일이나 요청에 적어 둔다. 프레임워크 판에 따라 문법이 크게 달라지는 부분이라, 적지 않으면 예전 판 문법이 섞이기 쉽다. 타입을 엄격하게 잡아 두는 것도 같은 효과가 있다. 자주 쓰는 타입 패턴은 TypeScript 5 실무 필수 패턴 총정리를 참고하면 된다.
받은 코드 검증 순서
생성이 빨라질수록 «확인 단계»를 건너뛰기 쉬워진다. 아래 순서는 싼 확인부터 비싼 확인으로 간다. 앞 단계에서 걸리면 뒤로 가지 않는다.
- 읽기 — 바뀐 파일 목록부터 본다. 요청하지 않은 파일(설정·패키지 목록·다른 컴포넌트)이 바뀌었으면 그 부분은 일단 되돌린다.
- 타입 검사·린트 — 규칙 파일에 적어 둔 명령을 돌린다. 여기서 걸리는 것은 대개 지어낸 필드 이름과 쓰지 않는 import다.
- 테스트 — 기존 테스트를 먼저 돌리고, 새로 생긴 테스트는 «무엇을 확인하는지» 읽는다. AI가 만든 테스트는 구현을 그대로 베껴 항상 통과하는 경우가 있다. 일부러 구현을 한 줄 망가뜨려 테스트가 실패하는지 보면 금방 드러난다.
- 실제 화면 — 개발 서버에서 상태별 화면(로딩·오류·빈 목록)을 직접 띄운다. 느린 네트워크 흉내와 좁은 화면 폭도 한 번씩.
- 접근성·성능 — 아래 두 절의 확인. 눈으로 보이지 않는 결함이 여기서 나온다.
«이 컴포넌트에 테스트를 써 줘»보다 «로딩·오류·빈 목록·정상 네 상태에서 화면에 무엇이 보여야 하는지 테스트로 써 줘»가 낫다. 확인할 행동을 사람이 정해 주면, 구현을 베낀 테스트 대신 요구 사항을 확인하는 테스트가 나온다.
접근성 — 눈으로 안 보이는 결함
AI가 만든 UI에서 가장 자주 빠지는 것이 접근성이다. 클릭되는 div, 레이블 없는 입력 칸, 포커스가 안 보이는 버튼은 마우스로 볼 때는 멀쩡하다. 웹 접근성 기준인 W3C의 WCAG는 2.2판이 W3C 권고안이고(현재 판 2024년 12월 12일), 2.1에 비해 새 성공 기준 9개가 더해졌다. 그 가운데 생성된 UI에서 특히 확인할 만한 것은 이렇다.
- 2.4.11 Focus Not Obscured (Minimum) — 키보드 포커스를 받은 요소가 고정 머리말·쿠키 띠 같은 것에 완전히 가려지지 않아야 한다.
- 2.5.7 Dragging Movements — 끌어서 놓기로만 되는 기능에는 끌지 않고도 할 수 있는 방법이 있어야 한다.
- 2.5.8 Target Size (Minimum) — 누르는 대상이 너무 작거나 다닥다닥 붙지 않아야 한다.
- 3.3.7 Redundant Entry · 3.3.8 Accessible Authentication (Minimum) — 이미 입력한 정보를 다시 치게 하거나, 기억력 퍼즐 같은 로그인만 두지 않아야 한다.
실무에서 가장 빠른 확인은 마우스를 놓고 키보드로만 새 화면을 끝까지 써 보는 것이다. Tab으로 모든 버튼에 닿는지, 포커스가 보이는지, Enter·Space로 눌리는지만 봐도 생성 코드의 결함 상당수가 드러난다. 그다음 요청 단계에서 «버튼은 button 요소로, 입력 칸에는 label 연결»을 완료 조건에 넣어 두면 같은 결함이 줄어든다. 항목별 확인 방법은 웹 접근성(a11y) 체크리스트 2026 — WCAG 2.2 점검 순서와 도구에 모아 두었다.
성능 — 숫자로 확인하기
«AI가 최적화해 줬다»는 말은 숫자로 확인하기 전까지 아무 뜻이 없다. 기준은 구글 web.dev가 안내하는 Core Web Vitals 세 가지다. 2026년 10월 29일 확인한 «좋음» 기준은 아래와 같고, 모바일과 데스크톱을 나눠 실제 방문의 75번째 백분위에서 세 지표를 모두 넘어야 통과로 본다. INP는 2024년에 FID를 대신해 정식 지표가 됐다.
| 지표 | 보는 것 | 좋음 기준 |
|---|---|---|
| LCP (Largest Contentful Paint) | 가장 큰 내용이 보이기까지 | 2.5초 이내 |
| INP (Interaction to Next Paint) | 누른 뒤 화면이 반응하기까지 | 200밀리초 이하 |
| CLS (Cumulative Layout Shift) | 화면이 밀리는 정도 | 0.1 이하 |
생성 코드에서 이 숫자를 나쁘게 만드는 흔한 원인은 정해져 있다. 큰 라이브러리를 통째로 import하는 코드(번들이 커져 LCP·INP가 나빠짐), 크기를 적지 않은 이미지(CLS), 입력마다 무거운 계산을 다시 하는 컴포넌트(INP)다. 확인 순서는 바꾸기 전 숫자를 먼저 재고 → AI 코드를 넣고 → 같은 조건에서 다시 재는 것이다. 전후 숫자 없이 «빨라졌다»고 적힌 결과는 받아들이지 않는다. AI에게 최적화를 맡길 때도 «LCP가 2.5초 안에 들어오게, 이미지에는 width·height를 적고, 이 화면 밖 컴포넌트는 나중에 불러오게»처럼 기준과 방법을 함께 주면 결과를 확인하기 쉽다.
자주 묻는 것
AI가 만든 프론트엔드 코드를 그대로 써도 되나요?
바뀐 파일 확인, 타입 검사·린트, 테스트, 실제 화면, 접근성·성능 확인을 거친 뒤에 씁니다. 특히 요청하지 않은 파일이 바뀌었는지와 키보드만으로 조작되는지는 매번 확인하는 편이 안전합니다.
도구마다 규칙 파일을 따로 만들어야 하나요?
2026년 10월 29일 확인한 공식 문서 기준으로 GitHub Copilot과 Cursor는 AGENTS.md를 읽고, Claude Code는 CLAUDE.md를 쓰되 저장소의 AGENTS.md도 읽을 수 있습니다. 공통 약속은 한 파일에 두고 도구별 파일에는 그 도구에만 필요한 것만 적으면 관리가 쉽습니다.
AI가 쓴 테스트가 다 통과하는데 믿어도 되나요?
구현을 그대로 베낀 테스트는 항상 통과합니다. 구현을 일부러 한 줄 망가뜨렸을 때 테스트가 실패하는지 보면 그 테스트가 실제로 무언가를 확인하는지 알 수 있습니다.
성능이 좋아졌는지는 무엇으로 판단하나요?
web.dev의 Core Web Vitals 기준을 씁니다. LCP 2.5초 이내, INP 200밀리초 이하, CLS 0.1 이하이며, 바꾸기 전과 후를 같은 조건에서 재서 비교합니다.
정리
AI 기반 코드 생성으로 프론트엔드 속도를 얻으려면 생성보다 앞뒤가 중요하다. 앞에서는 규칙 파일과 구체적인 요청(본보기·데이터 모양·상태 목록·완료 조건)으로 프로젝트에 맞는 코드를 받고, 뒤에서는 싼 확인부터 비싼 확인까지 순서대로 걸러 낸다. 접근성은 키보드로, 성능은 전후 숫자로 확인한다. 도구는 계속 바뀌지만 이 순서는 어느 도구를 쓰든 그대로 쓸 수 있다.
참고 자료
- web.dev. Web Vitals — LCP 2.5초·INP 200밀리초·CLS 0.1, 75번째 백분위, INP가 2024년 FID 대체(2026-10-29 확인). web.dev
- W3C. Web Content Accessibility Guidelines (WCAG) 2.2 — W3C 권고안 2024-12-12 판, 2.2에서 새로 생긴 성공 기준 9개, 4.1.1 Parsing 삭제(2026-10-29 확인). w3.org
- Anthropic. Claude Code — How Claude remembers your project: ./CLAUDE.md·./.claude/CLAUDE.md, /init, .claude/rules/ 와 paths, AGENTS.md(2026-10-29 확인). code.claude.com
- GitHub Docs. Adding repository custom instructions for GitHub Copilot — .github/copilot-instructions.md, .github/instructions/*.instructions.md 와 applyTo, AGENTS.md(2026-10-29 확인). docs.github.com
- Cursor Docs. Rules — .cursor/rules 의 .mdc 파일, 적용 방식 네 가지, AGENTS.md(2026-10-29 확인). cursor.com


