SOUL.md 활용
기준일: 2026-07-26
난이도: 중급
공식 기준: Use SOUL.md with Hermes
개요
SOUL.md로 Hermes 기본 목소리·정체성을 만드는 실전 가이드입니다. AGENTS.md(프로젝트 규칙) 및 /personality(프리셋 전환)과 역할을 구분합니다.
핵심 개념
| 파일/기능 | 역할 |
|---|---|
SOUL.md |
전역 기본 정체성·어조 |
AGENTS.md |
프로젝트 작업 규칙 |
/personality |
세션 중 페르소나 전환 |
| Prompt assembly | SOUL이 시스템 레이어로 주입 |
상세
What SOUL is for
- 말투, 가치, 기본 행동 원칙
- “어떤 동료인가” 정의
What it is not for
- 특정 레포 빌드 명령 (→ AGENTS.md)
- API 키·시크릿
- 장황한 회고 로그
Where it lives
- 글로벌 Hermes home 하위 (공식 경로 준수)
- 첫 실행 시 템플릿 생성 가능
How Hermes uses it
Prompt Assembly의 identity 레이어. 캐시 안정성을 위해 너무 자주 바꾸지 않는 것이 좋습니다.
Good first edit
# Identity
# Style
# Avoid
# Defaults
Example styles
- Pragmatic engineer — 간결, 패치 우선
- Research partner — 가설·출처
- Teacher — 단계·비유
- Tough reviewer — 리스크 먼저
Strong SOUL.md
- 짧고 검증 가능
- 금지 사항을 명확히
- 모델이 지킬 수 있는 수준 (모순 없는 규칙)
SOUL vs /personality vs AGENTS
| SOUL | /personality | AGENTS | |
|---|---|---|---|
| 범위 | 전역 기본 | 세션 전환 | 프로젝트 |
| 변경 빈도 | 낮음 | 중간 | 레포와 함께 |
| 내용 | 정체성 | 톤 프리셋 | 빌드/테스트/컨벤션 |
체크리스트
- 공식 원문과 명령·설정 키를 대조했다
- 로컬/
config.yaml/.env에서 재현 경로를 확인했다 - 권한·allowlist·시크릿 노출을 점검했다
- 실패 시 롤백·비활성화 방법을 알고 있다
다음 단계
기준일: 2026-07-26 — 공식 문서 동기화 코퍼스