문서 / AGENTS.md

This is NOT the Next.js you know

에이전트가 이 저장소에서 지켜야 할 작업 규칙.

For additional context about technologies to be used, project structure, shell commands, and other important information, read the current plan at specs/002-site-typography-scale/plan.md

브라우저 검증 규칙

헌법 원칙 III와 개발 워크플로 7항이 요구하는 브라우저 검사의 실행 규칙이다.

  1. 브라우저 검사는 npm run test:browser 하나로 실행한다. 대상은 tests/browser/뿐이다.
  2. 앞에 npm run dev를 따로 띄우지 않는다. Playwright가 자체 webServer로 개발 서버를 올리고 내린다. 문서에 npm run dev 다음 줄로 브라우저 명령을 적으면 npm run verify:manual이 blocking browser sequence로 빌드를 실패시킨다.
  3. 이미 떠 있는 서버나 배포 후보·공개 URL을 검사할 때만 PLAYWRIGHT_BASE_URL을 지정한다. 이때는 webServer가 비활성이므로 서버 기동은 실행자 책임이다.
  4. 화면 동작·레이아웃·타이포그래피를 바꾸면 375/768/1024/1440px 매트릭스와 axe(WCAG 2.1 A/AA) 검사를 함께 돌린다. heading-order는 A/AA 밖의 best-practice 규칙이므로 별도 검사로 유지한다.
  5. npm run verify에는 브라우저 검사가 들어 있지 않다. 완료 판정 전에 따로 실행하고 결과를 docs/verification-report.md에 건수와 함께 남긴다.
  6. 빠른 RED/GREEN은 특정 스펙 파일만 좁혀 돌려도 되지만, 완료 판정은 production build 뒤 전체 브라우저 검사로 한다.

This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in node_modules/next/dist/docs/ (resolved from this file's directory; in monorepos the next package may not be visible from the repo root) before writing any code. Heed deprecation notices.

This block is written and re-added by next dev — verify at node_modules/next/dist/server/lib/generate-agent-files.js. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.

맨 위로