Next.js 정적 AGENTS.md 만들기
Next.js 프로젝트는 일반 저장소 템플릿보다 더 날카로운 제약이 필요합니다. App Router 기능이 조용히 server-only 영역으로 흘러가기 쉽기 때문입니다.
이 템플릿은 static export, 로컬 데이터 처리, SEO 메타데이터, 결정적이고 브라우저 안전한 로직에만 집중하도록 가이드를 묶어 둡니다.
에이전트가 API routes, server actions, runtime fetch를 실수로 도입하지 않게 하면서도 빠르게 작업시키고 싶을 때 적합합니다.
대표 명령
- 설치:
npm install - 개발:
npm run dev - 린트:
npm run lint - 타입체크:
npm run typecheck - 빌드:
npm run build - 테스트:
npm run test
대표 금지 사항
- API routes, server actions, middleware를 추가하지 않습니다.
- 원격 AI 호출이나 저장소 자동 스캔을 추가하지 않습니다.
- 편의 기능 때문에 static export 제약을 완화하지 않습니다.
왜 이 프리셋에는 맞춤 가이드가 필요한가
정적 Next.js 프로젝트는 export 제약, 라우트 소유권, server-only drift를 조기에 잡는 검증 명령을 명시적으로 적어 둘 때 효과가 큽니다.