Hermes와 AKM 금융지식창고 연결

1. 소개

Hermes가 금융 관련 요청을 처리할 때, 대화 내용에만 의존하지 않고 별도의 AKM 금융지식창고에 축적된 원본 자료, 해석 지식, 분석 절차와 검증 결과를 활용하도록 연결했습니다.

* 적용 이유

Hermes가 금융 관련 요청을 처리할 때 대화 내용에만 의존하지 않고, 별도의 AKM 금융지식창고에 축적된 원본 자료·해석 지식·분석 절차·검증 결과를 활용하도록 연결했습니다.

두 시스템의 역할은 다음과 같이 구분했습니다.

Hermes
→ 사용자 요청 해석
→ 금융지식창고 선택
→ 필요한 자료 조회·저장
→ 답변 작성

AKM 금융지식창고
→ 금융 원본·지식·절차·검증 결과 보관
→ 자료 분류·보안·검증 기준 제공

연결된 금융지식창고의 위치는 다음과 같습니다.

/home/beast/akm_main/jarvis_finance_akm

2. README.md 기반 설정 방법

설정 기준은 금융지식창고의 다음 문서입니다.

adapters/hermes/README.md

별도의 플러그인·MCP·RAG·데이터베이스를 설치하지 않고, Hermes가 새 세션마다 읽는 프로필 지침 파일에 AKM 경로와 운영규칙을 추가했습니다.

2.1 핵심 연결 설정

수정한 파일은 다음과 같습니다.

/home/beast/.hermes/SOUL.md
/home/beast/.hermes/memories/MEMORY.md

수정 전 복구를 위해 다음 백업을 생성했습니다.

/home/beast/.hermes/backups/
SOUL.md.before-akm-adapter.20260731_191957

SOUL.md에는 다음 규칙을 등록했습니다.

markdown

• 금융 요청이면 금융지식창고를 선택한다.

• INDEX를 따라 필요한 정본만 조회한다.

• 저장 전 SECURITY와 ROUTER를 적용한다.

• 변경 후 구조·링크·비밀정보를 검사한다.

• 중요 결과는 VERIFICATION 기준으로 검증한다.

• 반복 오류와 사용자 수정은 LOOP에 따라 개선한다.

2.2 핵심 운영방식: 조건부 로딩

전체 금융지식창고를 모든 Hermes 세션에서 읽지 않습니다. 금융 관련 요청이 들어왔을 때만 금융지식창고를 선택하고, 해당 작업에 필요한 인덱스와 정본을 조건부로 읽습니다.

일반 대화
→ SOUL.md만 로드
→ 금융지식창고를 읽지 않음

금융 관련 요청
→ 금융지식창고 선택
→ INDEX.md
→ INDEX.local.md
→ 40-memory 포인터
→ 작업에 필요한 정본만 조회

이 방식을 적용한 이유는 다음과 같습니다.

• 일반 대화에서 불필요한 금융자료 로딩 방지

• 컨텍스트와 토큰 사용량 절감

• 금융·학습·업무 지식창고 간 불필요한 혼합 방지

• 현재 작업에 필요한 정본만 선택적으로 조회

README는 세션 시작 시 INDEX.md와 40-memory를 읽는 기본 모델을 제안하지만, 현재는 여러 목적별 AKM을 연결하고 있으므로 모든 세션 선행 로딩 대신 지식 작업 진입 시 선택적 로딩을 적용한 확장 방식입니다.

3. README.md 주요 설정 적용 현황

두 번째 첨부 화면의 전체 19개 설정 중, 연결 구조를 이해하는 데 중요한 항목만 정리했습니다.

특히 L22와 L27은 구분해서 봐야 합니다.

L22 — 동일 본문의 중복 방지
→ 현재 충족

L27 — 사용자 모델 정본의 AKM 이전
→ 아직 미수행

사용자 모델이 30-context/users/<user>.md에 등록될 경우, 같은 작업에서 해당 Hermes 프로필의 USER.md를 정본 경로 한 줄로 전환해야 합니다. AKM이 파일 생성을 감지해 자동으로 포인터를 만드는 별도 후크는 현재 없습니다.

4. Hermes와 AKM 실제 연결 메커니즘

ALT

화면에 한국어가 표시됩니다

그림 1. Hermes와 AKM 금융지식창고의 실제 연결 메커니즘 README는 연결 구조와 운영원칙을 설명하고, SOUL.md는 금융 요청에서 AKM을 선택하도록 트리거를 제공하며, Hermes가 파일 도구로 실제 조회·저장·검증을 수행합니다.

① SESSION — SOUL.md 로드

새 Hermes 세션이 시작되면 default 프로필의 SOUL.md가 로드됩니다.

SOUL.md
→ 금융지식창고 경로
→ 요청별 지식창고 선택 기준
→ 조회·저장·검증 규칙

이 단계에서 AKM 전체 문서가 메모리에 적재되는 것은 아닙니다. 연결 경로와 선택 규칙만 인식합니다.

② TRIGGER — 금융 요청 판별

사용자가 금융지식창고를 명시하거나 요청 내용이 금융 목적이면 Hermes가 금융지식창고를 선택합니다.

주식·ETF·채권·예금
환율·금리·유가
재무계획·연금·세금
부동산·금융 의사결정

③ RETRIEVE — 필요한 자료만 조회

금융지식창고가 선택된 후에만 다음 순서로 필요한 자료를 찾습니다.

INDEX.md
→ INDEX.local.md
→ 40-memory 포인터
→ 관련 지식·맥락·절차
→ 필요 시 10-sources 원본

이 단계가 현재 설정의 핵심입니다. 모든 세션에서 AKM 전체를 읽는 것이 아니라, 금융 요청이 발생한 경우에만 필요한 문서를 조건부로 조회합니다.

④ EXECUTE — Hermes가 파일 도구 실행

README나 ROUTER가 직접 파일을 읽고 생성하는 것은 아닙니다. Hermes가 실제 도구를 실행합니다.

text read_file search_files write_file patch terminal

저장 요청에서는 보안검사와 분류기준을 적용한 후 Hermes가 적절한 AKM 계층에 Markdown 파일을 생성합니다.

⑤ VERIFY — 재읽기와 검증

작업 후에는 생성·수정된 파일을 다시 읽고 다음 검사를 수행합니다.

text node scripts/lint.mjs --akm node scripts/lint.mjs --links node scripts/lint.mjs --secrets

중요한 결과에는 VERIFICATION.md의 Tier 0~3 기준을 적용하고, 실패나 반복 오류는 LOOP.md에 따라 원인 계층에 환류합니다.

5. 배운 점

Hermes 와 AKM의 구성 이해

• 현재 구성은 AKM이 백그라운드에서 독립적으로 파일을 생성하는 방식이 아니라, Herms가 요청을 해석하고 AKM 규칙에 따라 실행하는 방식입니다.

나만의 사용에 맞는 적용

• 금융지식창고를 읽을 수 있다고 해서 모든 세션 시작 시 무조건 읽는 것은 아닙니다. 현재는 연결 기능을 유지하면서 불필요한 컨텍스트 사용을 줄이기 위해 조건부 로딩을 적용했습니다.

6. 앞으로의 계획

1. 사용자 승인 후 사용자 모델을 30-context/users로 이전하고 USER.md를 포인터로 전환

2. 금융 분석 절차를 호출하는 전용 Hermes 스킬 제작

3. 자료 증가 시 qmd 의미검색 도입 검토

이번 연결을 통해 Hermes는 단순히 금융정보를 답변하는 것을 넘어, 금융지식창고에서 근거를 선택적으로 조회하고 필요한 지식을 분류·검증·축적하는 실행형 에이전트로 확장됐습니다