목차(클릭하세요)
Hermes Agent가 Obsidian vault를 파일시스템 레이어로 직접 읽고 쓰는 구조.
대화 기록·스킬·메모리가 마크다운으로 쌓이면서 시간이 지날수록 더 강력해지는 지식 시스템을 만듦
수정&생성해야 할 파일2가지
1. AGENTS.md : ~~AppData\Local\hermes 폴더에 생성
2. obsidian 스킬 생성: ~\AppData\Local\hermes\skills에 폴더째로 넣기
[참고자료]
1. 왜 Hermes와 Obsidian을 연계하는가?
1-1. 연계의 목적
Obsidian을 단순한 노트 폴더가 아니라 AI 에이전트의 메모리 시스템으로 활용함
•
일반적인 AI 사용 방식의 한계:
일반 AI 채팅
└── 대화가 끝나면 모든 맥락 사라짐
→ 매번 처음부터 설명해야 함
→ 쌓이는 지식 없음
Plain Text
복사
Hermes + Obsidian 연계 방식:
Hermes Agent
└── Obsidian vault를 파일시스템으로 직접 접근
├── 대화 요약 → Daily Notes에 자동 저장
├── 반복 작업 → Skills로 자동 생성
├── 중요 사실 → 메모리로 누적
└── 프로젝트 컨텍스트 → 마크다운으로 보관
Plain Text
복사
쓸수록 더 강해지는 복리형 자동화 시스템
•
vault란?
◦
Obsidian이 관리하는 폴더의 한 종류, 정확히는 Obsidian의 홈 폴더
일반 폴더:
└── 그냥 파일들이 모여있는 곳
Obsidian Vault:
└── 폴더인데 Obsidian이 "이 폴더를 내 노트 공간으로 쓸게"
라고 선언한 것
→ 폴더 안에 .obsidian/ 숨김 폴더 생성
→ 백링크, 그래프, 플러그인 등 모든 기능이 이 폴더 기준으로 작동
YAML
복사
1-2. Hermes가 Obsidian과 연동하는 방식
•
Hermes는 Obsidian을 파일시스템 기반 노트 레이어로 활용함. 별도 플러그인 설치 없이 vault 폴더를 직접 읽고 쓰는 방식:
역할 | 위치 | 설명 |
Vault 노트 | Obsidian 폴더 | 사람이 읽는 프로젝트 컨텍스트·연구 자료 |
Durable 메모리 | Hermes 내부 | 안정적인 사용자/프로젝트 사실 |
Skills | Hermes 내부 | 반복 절차 자동화 |
Sessions | Hermes 내부 | 임시 대화 기록 (요약 시 vault로 이동) |
4가지를 명확히 분리해야 vault가 지저분해지지 않음
2. Hermes와 Obsidian 연결의 실제
2-1. Vault 경로 설정
•
예시 위치
옵시디언 폴다//내가 설정한 보관함
Plain Text
복사
•
Hermes가 접근할 스코프 폴더 생성 (vault 전체 노출 방지)
all_phago/
└── Hermes/ ← Hermes 전용 폴더 (신규 생성)
├── Daily/ ← 날짜별 대화 요약
├── Memory/ ← 메모리 검토용
└── Skills/ ← 생성된 스킬 목록
Plain Text
복사
◦
vault 전체가 아닌 /Hermes 폴더만 스코프로 지정하는 것이 안전함
2-2. Hermes 설정 파일 수정
1.
메모리 활성화 여부 확인:hermes\config.yaml 열어서
# 메모리 활성화 (이미 설정됨 확인)
memory:
memory_enabled: true
user_profile_enabled: true
YAML
복사
2.
terminal 부분추가 :hermes\config.yaml 열어서
terminal:
backend: local
cwd: 옵시디언의 베이스 폴더 경로적기
YAML
복사
•
주의: 경로를 적을때 따옴표 포함하여 적는 것을 권장
•
경로에 공백이 있을 경우 에러발생
# Obsidian vault 경로 설정
terminal:
cwd: "Z:\\5.obsidian\\all_phago"
YAML
복사
3.
슬랙에서 vault 경로 알려주고 작업물 결과 저장요청하기
@hermes-bot 내 Obsidian vault 경로는 Z:\5.obsidian\all_phago 야.
Hermes 폴더 안에 작업 결과를 저장해줘.
Plain Text
복사
•
실제 작동결과
2-3. 저장위치&경로를 고정하고 싶을때
해결 방법: AGENTS.md
Hermes는 시작할 때 자동으로 이 파일을 읽기때문
•
작업 중인 옵시디언 폴더안에 AGENTS.md 를 생성하고 다음 내용 넣기
## 절대 규칙: 파일 저장 위치
### 기본 저장 경로 (반드시 준수)
모든 파일은 OOOOOOO 하위에만 저장.
OOOOOOO 직접 저장 절대 금지.
### 하위 폴더 규칙
- 날짜별 기록 →OOOOOOO\all_phago\Hermes\Daily\
- 창작물 → OOOOOOO\all_phago\Hermes\Creative\
- 기술 문서 → OOOOOOO\all_phago\Hermes\Docs\
- 메모리 → OOOOOOO\all_phago\Hermes\Memory\
- 스킬 → OOOOOOO\all_phago\Hermes\Skills\
### 절대 금지
- OOOOOOO 루트에 직접 저장 금지
- C:\Users\ 경로 저장 금지
- Hermes 설치 폴더 저장 금지
### 파일 형식
- 반드시 .md (마크다운)
- 저장 후 read-after-write 확인 필수
YAML
복사
•
실제로 ‘Hermes’폴더안의 하위폴더에 잘 저장되는지 확인하기
•
저장경로에서 에러가 계속 발생할 경우 직접 지침을 알려줄수도 있음
3. 기존 Vault 구조와 연결 및 자동화
3-1. 00_Raw 폴더 연동
•
기존 00_Raw/ 폴더 활용 하여 Hermes와의 대화내용을 저장하기
전기차 배터리에 대한 내용을 3단락으로 정리 후 마크다운으로 Z:\5.obsidian\all_phago\00_Raw\2026-05-24 폴더에 저장해
Plain Text
복사
3-2. MOC변경-> Home.md 변경 자동화
•
Hermes가 파일을 생성할 때마다, MOC변경-> Home.md 변경이 유기적으로 자동화되어야 함!
[1단계] Hermes에게 MOC 파일 구조인식시키기
•
조금 복잡한 작업일때는 gemma4:e2b 모델보다는 보다 고급모델을 사용권장
@hermes-bot OOOOOOO\MOC\ 폴더 파일 목록 알려줘
YAML
복사
[2단계] AGENTS.md 수정
•
AGENTS.md에 MOC 자동화 규칙 추가하기
## 파일 생성 후 자동화 규칙
### 새 파일 생성 시 반드시 수행할 것:
1. 해당 파일의 카테고리 파악
- Daily/ → 날짜 기록
- Docs/ → 기술 문서
- Creative/ → 창작물
- Skills/ → 스킬
2. 관련 MOC 파일 업데이트
- AI 코딩·에이전트 관련 → OOOOOOO\MOC\AI 코딩 도구 MOC.md 에 링크 추가
- 스킬·MCP 관련 → OOOOOOO\MOC\Mcp&skills MOC.md 에 링크 추가
- 옵시디언 관련 → OOOOOOO\MOC\옵시디언 지식관리 MOC.md 에 링크 추가
- 이미지 생성 관련 → OOOOOOO\MOC\AI 이미지 생성 MOC.md 에 링크 추가
- 테슬라 관련 → OOOOOOO\MOC\테슬라 MOC.md 에 링크 추가
3. HOME.md 업데이트
- Z:\5.obsidian\all_phago\HOME.md 의 관련 섹션에 링크 추가
4. 모든 수정 후 read-after-write 확인
YAML
복사
•
예시작업
@hermes-bot 전기차로 3행시 지어서 Hermes/Creative 폴더에 저장한뒤 MOC자동화, HOME.md 업데이트진행해
YAML
복사
[3단계] obsidian 스킬 생성
# Obsidian 양파고 지식 관리 스킬 v3.1
## — P-Reinforce × 양파고 통합 에디션
---
## 🎯 목적
파편화된 원시 정보를 **자율 지식 정원(Autonomous Knowledge Garden)** 으로 변환함.
- **P-Reinforce 엔진:** RL 기반 자동 분류·폴더 설계
- **양파고 엔진:** 인라인 위키링크 의무화·MOC 계층·역방향 기대
## When to Use
아래 키워드 중 하나라도 포함되면 자동 적용:
- 한국어: 옵시디언, 지식연결, 지식 연결, 지식 체계화, 노트 저장, 백링크, MOC, 위키링크
- 영어: obsidian, vault, knowledge graph, backlink, second brain, PKM
---
## 📂 Vault 구조
```
Z:\5.obsidian\all_phago\
├── HOME.md ← 전체 지식 진입점
├── 00_Raw/YYYY-MM-DD/ ← 원본 보존 (절대 수정 금지)
├── 10_Wiki/
│ ├── Projects/
│ ├── Topics/
│ ├── Decisions/
│ └── Skills/
├── 20_Meta/
│ ├── Graph.json
│ ├── Policy.md
│ └── Index.md
├── MOC/
│ ├── AI 코딩 도구 MOC.md
│ ├── AI 이미지 생성 MOC.md
│ ├── Mcp&skills MOC.md
│ ├── 옵시디언 지식관리 MOC.md
│ ├── 테슬라 MOC.md
│ └── 외부특강_청취목록_MOC.md
├── Hermes/ ← Hermes 전용 폴더
│ ├── Daily/ ← 날짜별 작업 요약
│ ├── Docs/ ← 기술 문서
│ ├── Creative/ ← 창작물
│ ├── Memory/ ← 메모리 검토용
│ └── Skills/ ← 생성된 스킬 목록
└── assets/
```
---
## 📏 파일 저장 규칙
### 기본 저장 경로
- Hermes 작업 결과: `Z:\5.obsidian\all_phago\Hermes\` 하위에만 저장
- 지식화된 노트: `Z:\5.obsidian\all_phago\10_Wiki\` 적절한 하위 폴더
- 원본 보존: `Z:\5.obsidian\all_phago\00_Raw\YYYY-MM-DD\`
### 하위 폴더 규칙
- 날짜별 기록 → `Hermes\Daily\`
- 창작물 → `Hermes\Creative\`
- 기술 문서 → `Hermes\Docs\`
- 메모리 → `Hermes\Memory\`
- 스킬 → `Hermes\Skills\`
### 절대 금지
- `Z:\5.obsidian\all_phago\` 루트에 직접 저장 금지
- `C:\Users\` 경로 저장 금지
- Hermes 설치 폴더 저장 금지
---
## 📐 노트 출력 템플릿
```markdown
---
id: {{UUID}}
tags: [태그1, 태그2]
aliases: [별칭1]
created: YYYY-MM-DD
last_reinforced: YYYY-MM-DD
confidence_score: 0.0
category: "[[10_Wiki/Topics/카테고리명]]"
links:
# 상위
- "[[MOC명]]"
# 같은레벨
- "[[비슷한-노트]]"
# 하위
- "[[세부-개념]]"
raw_source: "[[00_Raw/YYYY-MM-DD/원본파일명]]"
---
# {노트 제목}
> 한 줄 통찰: (15단어 이내)
## 📌 Brief Summary
(1~2문장. **핵심 개념은 모두 [[위키링크]]로 처리**)
## 🗺️ 이 노트의 위치
- 상위 개념: [[MOC명]] · [[상위개념]]
- 같은 레벨: [[비슷한-노트-A]] · [[비슷한-노트-B]]
- 하위 개념: [[세부-개념-A]] (있을 경우만)
---
## 📖 Core Content
(본문 전체에서 개념 첫 등장마다 [[위키링크]] 삽입)
---
## 🔗 Knowledge Connections
### 직접 연결
- [[개념-A]] — 연결 이유
### 역방향 기대
- [[노트명-A]]: 연결해야 하는 이유
*Last reinforced: YYYY-MM-DD*
```
---
## 📋 파일 생성 후 자동화 규칙
새 파일 생성 시 반드시 수행:
1. 카테고리 파악 (Daily/Docs/Creative/Skills/10_Wiki)
2. 관련 MOC 업데이트:
- AI 코딩·에이전트 관련 → `Z:\5.obsidian\all_phago\MOC\AI 코딩 도구 MOC.md`
- 스킬·MCP 관련 → `Z:\5.obsidian\all_phago\MOC\Mcp&skills MOC.md`
- 옵시디언 관련 → `Z:\5.obsidian\all_phago\MOC\옵시디언 지식관리 MOC.md`
- 이미지 생성 관련 → `Z:\5.obsidian\all_phago\MOC\AI 이미지 생성 MOC.md`
- 테슬라 관련 → `Z:\5.obsidian\all_phago\MOC\테슬라 MOC.md`
3. HOME.md 업데이트: `Z:\5.obsidian\all_phago\HOME.md` 관련 섹션에 링크 추가
4. 저장 후 read-after-write 확인 필수
---
## ✅ 품질 체크리스트
- [ ] `00_Raw/` 원본 보존 경로 명시
- [ ] Frontmatter 전체 속성 포함
- [ ] `links` flat 리스트 구조 (중첩 키 금지)
- [ ] 한 줄 통찰 15단어 이내
- [ ] 인라인 위키링크 5개 이상
- [ ] `이 노트의 위치` 섹션 존재
- [ ] `역방향 기대` 섹션 존재
- [ ] 관련 MOC 업데이트
- [ ] HOME.md 업데이트
---
## ⚠️ 주의사항
1. `00_Raw/` 원본 절대 수정·삭제 금지
2. `links` 중첩 키 사용 금지 (옵시디언 JSON 오파싱 버그)
3. 구분자 `·` 만 사용 (`,` 혼용 금지)
4. 상위 개념 없는 노트 출력 금지 → MOC 먼저 생성
YAML
복사
[4단계]Hermes skills 폴더에 obsidian 스킬 등록
•
정확히는 ‘C:\Users\ysj\AppData\Local\hermes\skills\스킬폴더명’에 해당 skill.md파일 저장
[5단계] Hermes에게 MOC 파일들 읽게 하기
•
슬랙에서 스킬 관련 명령어 확인후, 사용가능한지 확인
@hermes-bot 현재 로드된 스킬 목록 알려줘
YAML
복사
@hermes-bot obsidian-yangphago 스킬 사용가능하니?
YAML
복사
[6단계] Hermes가 MOC 자동 업데이트 및 HOME.md 업데이트
•
아래과 같이 보다 명확한 요청이 필요
[나쁜 예시]
[좋은 예시]
옵시디언 스킬 사용해서 전기차_3행시.md관련 MOC 파일과 home.md 업데이트
YAML
복사
@hermes-bot obsidian-yangphago 스킬 사용해서
Hermes/Creative/전기차_3행시.md 파일을 생성하고
테슬라 MOC와 HOME.md도 함께 업데이트해줘
YAML
복사
[7단계] 최종 결과















