Next.js 팀을 위한 작고 간결한 AGENTS.md 베이스라인

가벼운 베이스라인은 모든 코딩 에이전트가 자신만의 워크플로우를 고안하는 것을 방지합니다.

AGENTS.md에 포함할 내용

리포지토리 전반에서 안정적인 규칙부터 시작하세요:

• 의존성을 설치하고 테스트를 실행하는 방법
• 예상되는 Node.js 버전 및 패키지 매니저
• 애플리케이션 코드, 테스트, 생성된 파일이 위치할 곳
• 풀 리퀘스트를 열기 전에 통과해야 하는 명령어들
• 시크릿(secrets), 마이그레이션(migrations), 프로덕션 변경에 대한 경계

도구별 지침은 해당 네이티브 파일에 유지하세요. 예를 들어, 에디터 동작을 위해 스코프된 Cursor 규칙을 사용하고 Claude Code가 추가 컨텍스트가 필요할 때 짧은 CLAUDE.md 포인터를 사용하는 식입니다. 이렇게 하면 공유 베이스라인의 가독성을 유지하고 규칙 검토를 쉽게 만듭니다.

실용적인 리뷰 루프

1. 에이전트에게 편집하기 전에 관련 규칙을 요약하도록 요청합니다.
2. 작업을 만족시키는 가장 작은 변경을 합니다.
3. AGENTS.md에 나열된 리포지토리 검사를 실행합니다.
4. 생성된 파일 및 의존성 변경 사항을 포함하여 diff를 검토합니다.
5. 워크플로우가 실제로 변경되었을 때만 규칙을 업데이트합니다.

Vildanden의 무료 Agent Config 샘플에는 즉시 적용 가능한 Next.js 베이스라인, Cursor 규칙, 그리고 CLAUDE.md 포인터가 포함되어 있습니다:

https://fairly-charlie-907.rehost.page/

목표는 더 많은 프롬프트 텍스트를 만드는 것이 아닙니다. 에이전트의 작업 범위를 리포지토리에 한정하는 작고 명시적인 계약입니다.