모범 사례
규칙을 둘 위치
규칙을 둘 위치는 규칙의 목적과 누가 변경할 수 있어야 하는지에 따라 선택하세요.
위치 선택하기
| HeyDeer에 알려 줄 내용 | 둘 곳 | HeyDeer가 읽는 위치 |
|---|---|---|
| 팀 컨벤션과 프로젝트 맥락: 구조, 이름 규칙, 사용할 헬퍼 | AGENTS.md | 풀 리퀘스트. 중첩된 파일은 해당 디렉터리에 적용됩니다. |
| 특정 파일을 변경하는 모든 풀 리퀘스트가 지켜야 하는 규칙 | .agents/checks/ | 베이스 브랜치 |
| 여러 검사가 공유하는 방법이나 도메인 지식 | .agents/skills/ | 풀 리퀘스트 |
| 모든 저장소에 대한 검토 우선순위, 건드리지 않을 것, 어조 | 조직 지침 | 조직 설정 → 검토 지침 |
| 저장소 하나에 대한 같은 내용 | 저장소 지침 | 저장소 → (저장소) → 검토 지침 |
| 티켓이나 내부 문서처럼 저장소 밖의 맥락 | MCP 서버 | 조직 설정 → MCP 서버, 또는 저장소의 MCP 서버 |
| 자동으로 검토할 풀 리퀘스트 | 자동 리뷰 필터 | 검토 규칙 |
| 게시할 발견 사항의 양 | 피드백 범위 | 검토 규칙 |
| HeyDeer가 작성하는 언어 | 검토 언어 | 검토 규칙 |
검토 지침과 AGENTS.md가 충돌하면 검토 지침이 우선합니다.
베이스 브랜치 또는 풀 리퀘스트
검사는 베이스 브랜치에서 가져오므로, 풀 리퀘스트가 자신의 변경으로 인해 어기게 될 검사를 약화할 수 없습니다. 새 검사는 병합된 후에 검토되는 풀 리퀘스트부터 적용됩니다.
AGENTS.md와 스킬은 풀 리퀘스트에서 가져오므로 항상 검토 대상 코드와 일치하며, 풀 리퀘스트를 여는 누구나 수정할 수 있습니다. 풀 리퀘스트 내용과 관계없이 지켜야 하는 규칙은 검사나 검토 지침에 두세요.