Hermes 에이전트가 서브디렉터리를 불러오지 않는다 AGENTS.md, 실제로 서브디렉터리에 접근했는지 확인하세요. 공식 컨텍스트 파일 메커니즘은 시작 시 프로젝트 루트 컨텍스트를 로드하고, 도구 호출이 경로를 포함하면 디렉터리 내 하위 디렉터리 규칙도 조회합니다. 경로를 건드리지 않으면 미리 로드되지 않을 수 있습니다.
모노레포에 적합하다
루트 AGENTS.md 패키지 관리자, 커밋 명세, 금지 동작과 같은 전역 규칙을 작성합니다; frontend/AGENTS.md 프론트엔드 규칙을 작성합니다; backend/AGENTS.md 백엔드 규칙을 작성하세요. 이렇게 하면 Hermes가 특정 경로를 처리할 때 현재 디렉터리에 더 가까운 명령어를 볼 수 있습니다.
문제 해결 단계
- Hermes가 "프론트엔드/src/app에서 구현을 확인하라"와 같이 목표 경로를 명시적으로 읽게 하세요.
- 서브디렉터리 파일 이름이 AGENTS.md, CLAUDE.md, 또는 .cursorrules와 같이 지원되는 규칙 파일인지 확인하세요.
- 너무 긴 문서는 잘라버릴 수 있으니, 최대한 짧게 작성하세요.
- 보안 스캔으로 차단된다면 먼저 의심스러운 콘텐츠를 정리하세요.
모든 세부사항을 근 AGENTS.md 에 쑤셔 넣지 마세요. 대규모 저장소는 토큰 수를 줄일 뿐만 아니라 에이전트가 올바른 범위 내에서 올바른 명세를 준수할 수 있도록 하는 "루트 룰 + 서브디렉터리 규칙"에 더 적합합니다.
