본문으로 건너뛰기

비전공자 LLM Wiki 구축 삽질로그 — 설계 3번 전복, 아직 현재진행형

Blair

2026.06.02

물류 컨설팅과 AI 도구의 융합

물류 컨설턴트 비전공자가 Claude Code와 이틀 만에 "에이전트가 실제로 써먹을 수 있는" LLM Wiki 시스템을 구축했고, 그 과정에서 설계를 3번 갈아엎고, 봇 에러를 파고들고, 온톨로지 개념까지 도전했다.


시작점: 물류 컨설팅에 AI 도구 접목

나는 물류 컨설팅을 하면서 AI 도구들을 업무에 접목하고 싶었다.
문제는 내가 쌓아온 물류 지식, AI 학습 메모, 개인 성장 기록이 Obsidian 볼트 안에 뿔뿔이 흩어져 있다는 것이었다. 그리고 내가 직접 경험하고 정리한 맥락을 에이전트가 쓸 수 없었다.

그래서 목표를 이렇게 잡았다:

"내 삶 전반(업무 + AI 학습 + 개인)의 지식을 에이전트가 실제로 꺼내 쓸 수 있게 정리된 구조로 만들자."


LLM Wiki 시스템 구축 과정

폴더 구조 설계

Open optionsauto

Second Brain/llm-wiki/
├── HERMES.md          ← 모든 에이전트 공통 지침
├── HERMIONE.md        ← wiki 관리 에이전트 전용 스킬 (STEP 1~11)
├── schema.md          ← frontmatter 규칙 정의
├── index.md           ← 지식 지도
├── log.md             ← 변경이력
├── _meta/             ← (계획 중) 도메인별 ontology
├── raw/               ← 원본 보존소 (현재 7개)
├── context/
│   ├── ai/            ← AI 관련 지식 (현재 4개)
│   ├── logistics/     ← 물류 지식
│   └── personal/      ← 개인 성장
└── private/           ← 민감 자료 (git 추적 제외, gitignore)

에이전트 구성과 역할

에이전트

역할

참조 범위

KE

물류 컨설팅 PM

물류 + 승인됨

Brian

물류 시장조사·트렌드

물류 + 승인됨

KE, Brian 외 5 Agents

물류 컨설팅 관련 각 전문영역 역할 수행

물류 + 승인됨

Hermione (신규 생성)

wiki 관리 담당

전체 (미승인 포함)

HERMES

전체 조율

승인됨 전체

✅ 헤르미온느처럼 야무지고 똑부러진 아이가 내 wiki를 관리해주었으면 해서
wiki 관리 담당 봇 이름은 헤르미온느로 지었다.

Hermione의 스킬 목록

STEP

트리거

기능

STEP 1

"스캔해줘"

개인 노트 전체 스캔 → raw/ 후보 선별

STEP 2

"ingest 해줘"

raw/ → context/ 변환 + frontmatter 자동 기입

STEP 4

"위키 보고해줘"

현황 보고 (토큰 절약형)

STEP 5

"lint 해줘"

깨진 링크, stale draft, orphan 파일 점검

STEP 6

"저장해줘"

대화 내용 → wiki 파일 저장

STEP 7

"[URL] 저장해줘"

웹 아티클 → raw/ 저장

STEP 8

"[주제] 리서치해줘"

웹 검색 → raw/ → 통합 요약

STEP 9

"대시보드 보여줘"

파일 현황 통계

STEP 10

"폴드 해줘"

오래된 파일 아카이브

STEP 11

"[주제] 연결 지도 만들어줘"

Obsidian canvas 파일 생성

frontmatter 구조와 품질 관리

Open optionsyaml

---
status: draft          # draft → review → active → legacy/superseded
confidence: low        # low / medium / high
domain: logistics      # logistics / ai / personal
subdomain: shared      # 도메인별 세부 분류 (자동 판단)
approved: false        # 나만 변경 가능
source_raw: llm-wiki/raw/파일명.md
created: 2026-05-28
revisit_date: 2026-09-01        # 선택
revisit_condition: "모델 변경 시" # 선택
---

approved: true인 파일만 에이전트가 참조한다 — 이게 품질 게이트의 핵심이다.


AI 도구와 프롬프트 활용

도구

용도

Claude Code

전체 설계 + 파일 작성 + 디버깅

Obsidian

볼트 내 파일 관리, approved 설정

Hermes Agent

Hermione Discord 봇 운영

Discord

Hermione와 실시간 대화 인터페이스

GitHub

llm-wiki private repo

핵심 프롬프트 방식: "이렇게 만들어줘"가 아니라 "이게 맞아?", "왜 이렇게 하는 거야?", "이거 다시 검토해줘"를 반복했다. 에이전트가 제안하면 내가 판단하고, 내가 놓친 걸 에이전트가 잡아주는 방식이었다.


시행착오와 개선 과정

Day 1: 초기 설계와 문제 발견

처음에는 과제 예시대로 그냥 만들었다. HERMES.md, schema.md, index.md, log.md, GitHub private repo까지 빠르게 완성.

근데 만들고 나서 뭔가 이상했다. 파일은 만들었는데 에이전트한테 실제로 어떻게 지시할지가 없었다.

Day 2: 전면 재설계와 최적화

삽질 1: HERMES.md를 3번 다시 썼다

첫 번째 작성 → 거부.
이유: "domain 정의가 context/ 폴더 구조와 안 맞는다"

두 번째 작성 → 거부.
이유: "logistics sub-folder 규칙이 AI나 personal 에이전트도 읽는 파일에 있는 게 이상하다"

→ 이 시점에서 HERMES.md(공통)와 HERMIONE.md(전용) 분리 결정

세 번째 작성 → 거부.
이유: "에이전트 이름이 K가 아니라 KE야. 그리고 Brian도 물류 전문이야."

이렇게 3번을 갈아엎으면서 결국 이런 구조가 나왔다:

Open optionsauto

HERMES.md   → 모든 에이전트가 읽는 공통 규정집
HERMIONE.md → Hermione만 읽는 스킬 지침서

삽질 2: status 필드 설계 충돌

Day 1에 active, legacy, superseded를 만들었다. (리히토님 사례게시글 참고하였음 👏🏻👏🏻👏🏻)
Day 2에 draft, review, done을 추가하려다 문제가 생겼다.

"done이랑 active가 결국 같은 거 아냐?"

맞았다. done = 작업 완료, active = 현재 유효 — 결국 같은 상태를 두 개 이름으로 부르고 있었다.

→ done을 없애고 active로 통일. lifecycle을 선형 흐름으로 재정의:

Open optionsauto

draft → review → active → legacy
                        ↘ superseded

삽질 3: 폴더 구조 왔다갔다

처음엔 logistics 하위에 shared/, distribution/, manufacturing/ 폴더를 만들려고 했다.

그러다가 생각이 바뀌었다: 폴더로 나누면 나중에 파일 이동이 귀찮아진다. 차라리 subdomain 필드를 frontmatter에 넣고, 파일은 context/logistics/에 모두 flat하게 두는 게 낫다.

→ flat 폴더 + subdomain 태그로 변경

삽질 4: "나중에" 항목이 영구적으로 스킵되는 문제

STEP 1 스캔 설계 중에 깨달았다: 아직 작성 중인 노트를 스캔하면 "나중에"로 미루는데, 이걸 .scan-history.md에 기록하면 다음 스캔 때 안 나온다. 그러면 작성이 완료됐을 때 다시 스캔이 안 된다.

→ "나중에"는 아무것도 기록하지 않는다. 항상 다시 나온다.

이게 토큰 낭비 아니냐고 물었는데, 실제로 수동 트리거이고 파일 수가 많지 않아서 비용이 미미하다는 걸 확인했다.

삽질 5: Hermione Discord 봇 에러

SOUL.md(시스템 프롬프트)를 비워둔 채로 테스트했다.

Open optionsbash

Non-retryable error (HTTP None)
'NoneType' object is not iterable

처음엔 인증 토큰 만료인 줄 알았다. 그래서 재로그인 시켰는데 안 됐다.
토큰 만료일을 확인해보니 아직 유효했다.

→ Hermes가 473 커밋 뒤처져 있었다. hermes update 후 해결.

Open optionsbash

# 확인 명령어
hermes --version   # "Update available: 473 commits behind"
hermes update
hermes -p hermione gateway restart

설계와 운영의 변화

엔진 독립적 설계의 중요성

처음에는 claude-obsidian 플러그인을 써야 스킬을 쓸 수 있는 줄 알았다. 알고 보니 HERMIONE.md가 플레인 텍스트로 쓴 지침서라 어떤 LLM이든 읽고 따를 수 있다.

→ 엔진 독립적(engine-agnostic) 설계가 핵심이었다.
Claude Code로 테스트하고 Hermione(Codex)가 실제 운영하는 구조가 가능한 이유.

도메인 통합의 장점

course에서 llmwiki-scm/llmwiki-build 분리를 언급했다. 고민 끝에 통합을 선택했다.

이유: 나의 가장 큰 자산은 물류 × AI × 개인 성장이 교차하는 인사이트다. 분리하면 이 연결이 사라진다. 도메인 분리는 domain 필드와 폴더로 충분하다. ➡︎ Claude의 의견인데 일단 따라가 보기로 했다.

관계 관리의 자동화

Ontology에 대해 깊이 파고들다가 중요한 걸 깨달았다:

  • 내가 할 일: Entity 타입만 한 번 정의 (methodology, metric, tool...)

  • Hermione가 할 일: 파일 읽고 실제 관계 발견 → canvas, lint 때 사용

관계를 사람이 수동으로 다 관리하는 건 수백 개 파일이 쌓이면 불가능하다.
사람은 기준을 세우고, 에이전트가 적용한다.


성과와 향후 계획

성과

항목

상태

llm-wiki 폴더 구조

✅ 완성

HERMES.md (공통 지침)

✅ 완성

HERMIONE.md (STEP 1~11)

✅ 완성

schema.md

✅ 완성

GitHub private repo

✅ 연결됨

raw/ 파일

✅ 7개 (STEP 1 테스트 완료)

context/ 파일

✅ 4개 (STEP 2 테스트 완료)

Hermione Discord 봇

✅ 작동 중 (#llm-wiki 채널, 멘션 불필요)

index.md 내용 채우기

⏳ 진행 중

나머지 raw 파일 ingest

⏳ 진행 중

배운 점

1. 처음부터 Git — course에서 강조한 그대로다. Day 1에 git init하고 commit 습관 들인 덕분에 3번 갈아엎어도 이력이 남아있다.

2. 에이전트 지침 파일 분리 — 모든 에이전트가 읽는 공통 파일(HERMES.md)과 특정 에이전트만 읽는 전용 파일(HERMIONE.md)을 나누는 게 맞다.

3. "나중에" 처리 방식 — wiki 설계에서 "아직 준비 안 된 것"을 어떻게 다룰지가 생각보다 중요하다. 우리는 .scan-history.md에 영구 스킵만 기록하고, "나중에"는 아무것도 기록하지 않는 방식을 선택했다.

4. 비전공자도 시스템 설계를 할 수 있다 — 코드를 한 줄도 직접 짜지 않았다. 하지만 설계 결정은 전부 내가 했다. 에이전트는 내 질문과 거부에 반응해서 더 나은 방향을 찾았다.

5. 에러 진단 순서 — 봇이 안 될 때: ① 인증 확인 → ② 버전 업데이트 → ③ 설정 확인. 인증이 문제인 줄 알고 헤맸는데 실제로는 버전 문제였다.

다음 계획

  • 아직 허점이 많이 보인다. 또 한 번 구조를 갈아엎어야 할지 모른다. 하지만 일단은 아래를 수행하려고 한다.

    • 남은 raw 6개 ingest → approved 설정 → index.md 채우기

    • Hermione한테 실제로 "위키 보고해줘", "lint 해줘" 돌려보기

    • Ontology v0.1 작성 (_meta/ 폴더)

    • self-eval 루프 만들기: Hermione가 생성한 답변 → 좋은 건 다시 wiki에 저장하는 self-eval 루프

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.06.03

HERMES.md를 세 번 갈아엎은 대목이 오히려 이 글의 핵심처럼 느껴졌어요. 처음에 빨리 만든 구조를 그대로 밀고 간 게 아니라, 공통 지침과 Hermione 전용 지침을 나누고, domain 정의와 폴더 구조가 안 맞는 지점을 계속 거절하면서 다시 설계하신 과정이 좋았습니다.

특히 done과 active가 사실상 같은 상태라는 걸 발견하고 active로 통일한 부분, “나중에” 처리할 노트는 scan-history에 기록하지 않기로 한 부분이 실전적인 판단 같아요. 거창한 온톨로지보다 이런 작은 운영 규칙 하나가 위키를 오래 쓰게 만들거든요. 다음에는 Hermione이 STEP 1 스캔→ingest→lint 중 하나만 실제 샘플로 끝까지 처리한 기록을 남기면, 지금 구조가 훨씬 더 선명하게 검증될 것 같습니다.

리히토 프로필 이미지
리히토2026.06.04

위키가 어떻게 더 진화해나갈지 기대됩니다.

에이전트가 있는 작업폴더마다 읽어오는 HERMES.md도 차이가 있을수있어서, 헤르미온느한테 위키 페이지에 있는 HERMES.md, HERMIONE.md 잘 읽고 있는지 확인 한번 해두시고 시작하면 좋을 것 같습니다. 지금 컨텍스트에 들어온 파일 내용 위에 몇줄 정확히 읊어보라고 하거나 경로 알려달라고하면, 어디에 있는 HERMES.md 읽었는지 확인가능합니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기