[Task] GRC-05/GRC-06/GRC-07 frontend verification contract와 AGENTS bootstrap 정리

[alexization]

1) 요약

• frontend verification contract를 repo-local docs/script/CI surface로 정규화했습니다.
• root AGENTS.md를 추가하고 README.md를 overview-only로 줄여 workflow handoff 뒤 concrete entrypoint를 repo 안으로 옮겼습니다.

2) 연관 이슈

• Closes [Task] GRC-05/GRC-06/GRC-07 frontend verification contract와 AGENTS bootstrap 정렬 #8
• 관련 backend 이슈/PR: 없음

3) 사용자 관점 결과

• 해결하려는 문제: lint/typecheck/build baseline과 bootstrap entrypoint가 workflow 문서에 기대지 않고 frontend repo-local surface에서 읽혀야 했습니다.
• 사용자에게 달라지는 점: npm run typecheck가 정식 script가 되고, docs/verification-contract.md와 AGENTS.md 기준으로 verification/bootstrap을 바로 따라갈 수 있습니다.
• 비목표: frontend route/UI behavior 변경

4) 영향 범위

• 변경된 route / page / component: 없음
• 상태 관리 / 데이터 로딩 영향: 없음
• API 계약 영향: 없음
• 접근성 / 반응형 영향: 없음

5) 스크린샷 또는 영상

• before: 없음(문서/CI/bootstrap 정리)
• after: 없음(문서/CI/bootstrap 정리)

6) 검증 증거

유형	명령어 / 증거	결과
Lint	npm run lint	성공
Build	NEXT_PUBLIC_BASE_URL=http://localhost:3000 NEXT_PUBLIC_API_URL=http://localhost:8080 npm run build	성공
Automated Test	npm run typecheck	성공
Playwright	미구축(현재 repo-local baseline 비포함)	미실행
Browser QA	문서/CI/bootstrap slice라 미실행	미실행

7) API / 백엔드 연동 확인

• 필요한 API 응답: 없음
• Mock 여부: 없음
• 관련 backend 변경: 없음

8) 리스크 및 롤백

• 리스크: 없음. command/CI/documentation baseline alignment만 다룹니다.
• 롤백 계획: 이 PR을 되돌리면 typecheck script, CI order, AGENTS/bootstrap 문서가 이전 상태로 복원됩니다.

9) 체크리스트

• 연관 이슈가 연결되어 있음
• 스크린샷 또는 영상이 포함되었거나 불필요 사유를 적음
• Lint / Build 결과가 기입되어 있음
• 브라우저 QA 또는 Playwright 결과가 기입되어 있음
• API 계약 영향이 반영되었거나 없음을 명시함

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5af4c7fc-9e4c-4bf4-a2dd-de2710959c37

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• ✅ Review completed - (🔄 Check again to review again)

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/grc-05-grc-06-grc-07-frontend-contract-bootstrap

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}