컨텍스트 파일과 참조
기준일: 2026-06-06
난이도: 중급
공식 기준: Context Files, Context References
Hermes는 프로젝트 파일과 사용자가 직접 붙인 참조를 함께 사용합니다. 이 둘을 구분해야 불필요한 장문 지침과 누락된 근거를 줄일 수 있습니다.
핵심 개념
| 항목 | 역할 |
|---|---|
.hermes.md |
프로젝트별 Hermes 지침 |
AGENTS.md / CLAUDE.md |
다른 에이전트 도구와 공유 가능한 프로젝트 규칙 |
SOUL.md |
기본 말투와 성향 같은 개인화 정보 |
@ 참조 |
특정 파일, 폴더, diff, URL을 현재 요청에 직접 첨부 |
선택 기준
- 반복 적용되는 규칙은 컨텍스트 파일에 둡니다.
- 이번 작업에만 필요한 근거는
@참조로 붙입니다. - 보안 규칙, 테스트 명령, 금지 행동은 자동 로드되는 지침에 둡니다.
- 너무 긴 배경 설명은 스킬이나 별도 문서로 분리합니다.
실습
이 프로젝트의 컨텍스트 파일을 감사해줘.
영구 규칙, 작업별 참조, 개인화 문구가 섞여 있는지 확인하고
각 항목을 어디에 두면 좋을지 표로 정리해줘.
작업 요청 예시:
@src/app/sitemap.ts @src/constants/guideNavigation.ts
Hermes 가이드 라우팅이 누락 없이 sitemap과 navigation에 반영됐는지 확인해줘.
Hermes에 입력할 프롬프트
내 요청을 수행하기 전에 필요한 컨텍스트를 먼저 식별해줘.
자동으로 읽은 지침, 내가 @로 붙여야 할 파일, 공식 문서 URL을 구분해서 알려줘.
체크리스트
- 영구 규칙과 일회성 근거를 분리했다.
- 민감한 토큰이나 개인 정보가 컨텍스트 파일에 들어가지 않는다.
-
@참조는 작업에 필요한 최소 파일로 제한한다. - 긴 지식은 스킬이나 문서로 분리한다.