컨텍스트 파일

anchor alias

컨텍스트 파일

Hermes Agent는 동작 방식을 정하는 컨텍스트 파일을 자동으로 발견하고 로드합니다. 일부는 프로젝트 로컬 파일이며 작업 디렉터리 기준으로 찾습니다. SOUL.md는 Hermes 인스턴스 전체에 적용되는 글로벌 파일이며 HERMES_HOME에서만 로드됩니다.

지원된 컨텍스트 파일

파일	용도	발견 방식
.hermes.md / HERMES.md	프로젝트 지침(최우선)	git root까지 위로 탐색
AGENTS.md	프로젝트 지침, 컨벤션, 아키텍처	시작 시 CWD + 하위 디렉터리에서 점진적으로 발견
CLAUDE.md	Claude Code 컨텍스트 파일(감지 대상)	시작 시 CWD + 하위 디렉터리에서 점진적으로 발견
SOUL.md	이 Hermes 인스턴스의 글로벌 성격과 톤	`HERMES_HOME/SOUL.md`만
.cursorrules	Cursor IDE 코딩 컨벤션	CWD만
*.cursor/rules/.mdc**	Cursor IDE rule module	CWD만

Priority system

session당 프로젝트 context type은 하나만 로드됩니다(처음 일치한 항목 승리): .hermes.md → AGENTS.md → CLAUDE.md → .cursorrules. SOUL.md는 항상 agent identity(slot #1)로 별도 로드됩니다.

AGENTS.md

AGENTS.md는 기본 프로젝트 컨텍스트 파일입니다. 프로젝트 구조, 따라야 할 규칙, 특별 지침을 에이전트에게 알려줍니다.

하위 디렉터리 점진 발견

세션 시작 시 Hermes는 작업 디렉터리의 AGENTS.md를 시스템 프롬프트에 로드합니다. 세션 중 에이전트가 read_file, terminal, search_files 등을 통해 하위 디렉터리로 이동하면, 해당 디렉터리의 컨텍스트 파일을 점진적으로 발견하고 관련이 생기는 순간 대화에 주입합니다.

my-project/
├── AGENTS.md              ← Loaded at startup (system prompt)
├── frontend/
│   └── AGENTS.md          ← Discovered when agent reads frontend/ files
├── backend/
│   └── AGENTS.md          ← Discovered when agent reads backend/ files
└── shared/
    └── AGENTS.md          ← Discovered when agent reads shared/ files

이 접근 방식은 시작 시 모든 것을 한꺼번에 로드하는 방식보다 두 가지 이점이 있습니다.

System prompt bloat 방지 - 하위 directory hint는 필요할 때만 나타납니다.
Prompt cache 보존 - system prompt가 turn마다 안정적으로 유지됩니다.

각 하위 directory는 session당 최대 한 번만 확인됩니다. discovery는 parent directory도 walk하므로, backend/src/main.py를 읽으면 backend/src/ 자체에 context file이 없더라도 backend/AGENTS.md를 찾을 수 있습니다.

정보

Subdirectory context file도 startup context file과 같은 security scan을 거칩니다. 악성 file은 차단됩니다.

AGENTS.md 예제

# Project Context

This is a Next.js 14 web application with a Python FastAPI backend.

## Architecture
- Frontend: Next.js 14 with App Router in `/frontend`
- Backend: FastAPI in `/backend`, uses SQLAlchemy ORM
- Database: PostgreSQL 16
- Deployment: Docker Compose on a Hetzner VPS

## Conventions
- Use TypeScript strict mode for all frontend code
- Python code follows PEP 8, use type hints everywhere
- All API endpoints return JSON with `{data, error, meta}` shape
- Tests go in `__tests__/` directories (frontend) or `tests/` (backend)

## Important Notes
- Never modify migration files directly — use Alembic commands
- The `.env.local` file has real API keys, don't commit it
- Frontend port is 3000, backend is 8000, DB is 5432

다운로드

SOUL.md 에이전트의 개성, 음색, 통신 스타일을 제어합니다. Personality 페이지에 전체 세부 정보를 참조하세요.

위치:

~/.hermes/SOUL.md
또는 $HERMES_HOME/SOUL.md 사용자 정의 홈 디렉토리에 Hermes를 실행하면

중요한 세부사항:

Hermes 씨는 기본적으로 SOUL.md 자동적으로 하나가 존재하지 않는 경우에
Hermes 부하 SOUL.md만 HERMES_HOME
Hermes는 SOUL.md에 대한 작업 디렉토리를 조사하지 않습니다
파일이 비어있는 경우, SOUL.md에서 아무것도 프롬프트에 추가됩니다
파일이 내용이있는 경우, 내용은 스캔 및 truncation 후 verbatim을 주사합니다

##.cursorrules에 {#cursorrules}

Hermes는 Cursor IDE의 .cursorrules file과 .cursor/rules/*.mdc rule module과 호환됩니다. 이 file이 project root에 있고 우선순위가 더 높은 context file(.hermes.md, AGENTS.md, CLAUDE.md)이 발견되지 않으면 project context로 로드됩니다.

따라서 Hermes를 사용할 때 기존 Cursor convention이 자동으로 적용됩니다.