Hermes Agent를 사용하기 시작한 여러분, 이런 경험 없으신가요?

• 어제 가르쳐준 것을 오늘 잊어버린다…
• 서브 에이전트(Sub-agent)에게 태스크를 던졌는데, 아무것도 이해하지 못한다…
• 설정 파일이 너무 많아서 어디에 무엇을 써야 할지 혼란스럽다…

사실 이것은 모두 3가지 사고방식을 이해하면 해결됩니다. 이 기사에서는 필자가 실제로 겪었던 시행착오와 그로부터 얻은 「제로에서 바로 사용할 수 있는 실전 지식」을 정리했습니다.

• Hermes Agent를 막 설치한 분
• 「기억시키는」 방법을 잘 모르겠는 분
• 멀티 에이전트(Multi-agent) 사용법에서 막혀 있는 분
• 어쨌든 최단 거리로 마스터하고 싶은 분

"어, 말한 거 전부 다 기억하고 있는 거 아니었어?"

→ 아닙니다. Hermes는 에이전트 책정형 기억(Agent-determined memory) 방식을 채택하고 있습니다. 즉, 에이전트 스스로가 「이것은 중요하다」라고 판단한 것만을 장기 기억(Long-term memory)에 기록합니다.

이것은 버그가 아니라 **설계 사상(Design philosophy)**입니다:

토큰 절약 (Token saving): 전체 내용을 기록하면 추론 비용(Inference cost)이 급증함 -
노이즈 방지 (Noise prevention): 시행착오나 중간 단계의 생각은 장기 보존할 가치가 없음

중요한 것은 명시적으로 지시하는 것입니다:

내 취향을 기억해줘: 모든 코드는 Python 3.11을 사용할 것.

현재 진척 상황을 저장해줘: 데이터 클렌징(Data cleansing)과 특징량 엔지니어링(Feature engineering) 완료. 다음은 모델 학습.

🔴

철칙: 절대로 SOUL.md에 써야 할 고정 규칙을 MEMORY.md에 넣지 말 것. MEMORY.md는 에이전트가 자동으로 정리·압축할 가능성이 있습니다.

용량 관리 기준:

• MEMORY.md: 상한 2,200자 → 1,800자 이내가 쾌적
• USER.md: 상한 1,375자 → 1,100자 이내가 쾌적

코드가 아니라 플러그인도 아닙니다. 「재사용 가능한 표준 작업 절차서 (SOP, Standard Operating Procedure)」입니다.

훌륭한 스킬(Skill)에 필요한 4요소:

① 신규 생성:

이 데이터 처리 플로우를 skill로서 저장해줘. 이름은 data-pipeline.
트리거 조건, 절차, 검증 방법, 주의점을 포함해서.

② 기억으로부터 승화:

배포 절차를 기억하고 있지. 그걸 deploy-workflow라는 skill로 만들어줘.

③ 핀포인트 수정 (전체를 다시 쓰지 않음):

stock-daily-report 스킬을 업데이트해줘. 주의점에 다음을 추가해:
「금요일 장 마감 후 데이터는 토요일 아침까지 지연될 가능성 있음」

④ 정기 감사:

모든 스킬을 리뷰해줘. 중복은 통합, 불분명한 것은 다시 작성, 오래된 것은 업데이트. 
먼저 리포트를 내고, 확인 후에 실행해줘.

SKILL.md 안에 기억 확인 단계를 심어두세요:

## 절차
1. MEMORY.md에 이 API에 관한 특이 사항이 있는지 확인
2. 있다면 우선적으로 따름
...

2개부터 시작해서 최대 3개까지. 전문가의 명언입니다.

• 이론상의 최대 병렬 수를 쫓기보다, 비용과 품질 관리가 중요
• API 제한·IP 차단 방지 관점에서도 2~3개가 안전권

서브 에이전트는 메인 에이전트의 대화 내용을 전혀 모릅니다.

서브 에이전트는 **완전히 깨끗한 대화 컨텍스트(Conversation context)**에서 기동합니다.

❌ 잘못된 예:

「아까 그 TypeError, 고쳐놔」

✅ 올바른 예:

delegate_task(
goal="api/handlers.py의 TypeError를 수정",
context="""
...

SOUL.md 또는 AGENTS.md에 명기:

## 멀티 에이전트 협업 규칙
- Planner Agent: 태스크 분해와 진척 관리만 수행. 실행하지 않음
- Executor Agent: 데이터 취득·처리만 수행. 의사결정하지 않음
...

프로파일은 완전히 격리된 (completely isolated) Hermes 환경입니다. 설정, 기억, 세션, 스킬이 모두 독립되어 있습니다.

활용 예시:

# 터미널 1: 코딩 어시스턴트 (Coding Assistant)
coder chat
# 터미널 2: 리서치 어시스턴트 (Research Assistant) (기억과 스킬도 완전 독립)
...

hermes doctor 실행 시 에러 없음 -
API 키는 .env에 기술 (config.yaml에는 작성하지 않음) -
GATEWAY_HEARTBEAT=true 설정 완료 -
사용자 화이트리스트 설정 완료 (TELEGRAM_ALLOWED_USERS) -
승인 모드 (Approval Mode) 설정 완료 (smart / manual) -
서버 타임존 확인 완료 (timedatectl로 확인 필요) - Cron 작업은 운영 환경 투입 전 수동 검증 완료

hermes doctor # 종합 진단 — 우선 이것을 실행
hermes memory status # 기억 시스템 상태 확인
hermes mcp status # MCP 연결 상태 확인
...

Hermes Agent는 마법이 아닙니다. 본질은 단 3가지입니다:

• 기억 (Memory): "잊어버렸다"를 해결함 → 하지만 중요한 내용은 스스로 명시할 것
• 스킬 (Skill): "이거 어떻게 하더라"를 해결함 → 반복되는 패턴을 SOP(표준 운영 절차)화
• 서브 에이전트 (Sub-agent): "혼자서는 무리"를 해결함 → 단, 완전한 컨텍스트 (Context)가 필수

초보자의 80%는 "기억은 자동이라고 믿는 것"과 "서브 에이전트에게 배경을 전달하지 않는 것"에서 좌절합니다. 이 두 가지만 파악해도 고통의 80%는 사라집니다.

우선은 **"장기 기억에 저장해줘"**와 "context에 전부 적어줘", 이 두 가지부터 시작해 보세요.