AGENTS.md
팀의 코딩 규칙, 테스트 명령, 리뷰 우선순위를 저장소 루트의 AGENTS.md에 작성하세요. 특정 디렉터리에 더 구체적인 지침이 필요하면 해당 디렉터리에도 AGENTS.md를 추가하세요.
HeyDeer는 최종 검증자를 포함한 모든 리뷰어에게 리뷰의 기준 리비전에 있는 AGENTS.md를 읽고 검토 중인 파일에 적용되는 지침을 따르도록 요청합니다. 더 하위 디렉터리의 지침이 우선합니다. PR에서 수정한 지침은 기준 브랜치에 반영된 후 적용됩니다.
# Review guidance
- Check that every database query is scoped to a workspace.
- Run pnpm test for changes to billing calculations.
- Keep public API responses backward-compatible.공통 지침은 AGENTS.md에 작성하세요. 통과, 실패, 건너뜀 결과가 각각 필요한 특정 규칙에는 저장소 검사를 사용하세요. 저장소 지침은 설정된 리뷰 지침이나 리뷰 안전 규칙을 덮어쓸 수 없습니다.
CLAUDE.md만 사용하고 있나요?
공통 지침을 AGENTS.md로 옮기세요. 파일이 이미 있으면 덮어쓰지 말고 규칙을 병합하세요. 디렉터리 간에 내용을 옮길 때는 상대 링크도 수정하세요.
이전 Claude Code 버전이나 AGENTS.md를 기본 지원하지 않는 세션에서는 같은 디렉터리에 CLAUDE.md를 두고 아래 가져오기 구문을 작성하세요. 규칙은 AGENTS.md에서 관리하세요:
@AGENTS.md로컬에서 Claude Code 사용하기
Claude Code 2.1.277 이상은 현재 디렉터리와 상위 디렉터리에 CLAUDE.md 또는 CLAUDE.local.md가 없으면 기본적으로 AGENTS.md를 읽습니다. claude update로 업데이트한 후 다시 시작하세요. 가져오기 구문만 있는 CLAUDE.md는 삭제할 수 있습니다.
두 형식을 모두 불러오려면 /config → Project instructions에서 claude-md-and-agents-md를 선택하세요. 이 옵션은 사용자 설정에 지정해야 하며 프로젝트 및 로컬 설정에는 지정할 수 없습니다.
기본 지원에는 내장 플러그인과 기능 플래그가 필요합니다. hooks나 원격 측정을 비활성화했거나 타사 공급자를 사용하거나 업데이트 후 첫 세션인 경우 지원되지 않을 수 있습니다. 이때는 위의 가져오기 방식을 사용하세요.