본문으로 건너뛰기

폴더부터 만들지 않았다: Hermes가 이해할 문서 계약과 실패 표본

Jon

2026.08.05

폴더부터 만들지 않았다: Hermes가 이해할 문서 계약과 실패 표본 본문 이미지

📝 한줄 요약

바쁘시면 이것만 읽어도 돼요:

  • Hermes에게 MainVault를 열기 전에 사람이 쓰는 문서와 AI가 읽는 규칙을 먼저 맞췄습니다.

  • 문서 주소는 Johnny.Decimal 방식의 간단한 번호 체계로 정리했습니다.

  • Daily·Source·Knowledge·Decision 네 가지 템플릿만 먼저 만들었습니다.

  • 모든 문서에 고유 ID, 종류, 상태, 주소, 연결 문서를 기록하게 했습니다.

  • 맞는 예시뿐 아니라 중복 ID와 잘못된 주소 같은 실패 예시도 함께 만들었습니다.

  • 읽기 전용 검사기로 저장소 예시와 실제 MainVault 표본을 모두 확인했습니다.

동기화된 문서를 바로 AI에 연결하지 않고, 먼저 문서 형식과 실패 조건을 계약처럼 고정했습니다.

🎯 이런 분들께 도움돼요

  • Obsidian 문서를 AI가 안정적으로 읽게 만들고 싶은 분

  • 폴더와 태그가 늘어나기 전에 최소 규칙을 정하고 싶은 분

  • 문서 형식이 틀렸을 때 자동으로 알려주는 검사가 필요한 분

  • 특정 AI 도구에 종속되지 않는 지식 저장소를 만들고 싶은 분

😫 문제 상황 (Before)

MainVault가 두 Mac에서 동기화돼도 문서마다 제목, 날짜, 상태, 연결 방식이 제각각이면 Hermes는 내용을 안정적으로 구분하기 어렵습니다. 사람이 보기에는 비슷한 문서라도 AI 입장에서는 고유 식별자가 없거나 주소와 실제 폴더가 다르면 같은 문서인지 판단하기 어렵습니다.

처음부터 복잡한 PKM 체계를 만들면 기록 자체가 부담이 됩니다. 반대로 자유 형식만 유지하면 나중에 AI 연결 시 대규모 정리가 필요합니다. 그래서 적은 규칙으로 시작하되, 잘못된 문서를 기계적으로 찾을 수 있는 문서 계약을 만들었습니다.

🛠️ 사용한 도구

도구

역할

Obsidian Markdown

사람이 직접 읽고 편집하는 기본 문서 형식

JSON Schema

문서 앞부분의 필수 항목과 값 규칙 정의

읽기 전용 Validator

문서를 바꾸지 않고 오류만 보고

Ruby·Minitest

정상·실패 예시를 반복 시험

Codex

최소 메타데이터, 템플릿, 실패 조건 설계

스키마(schema)는 “문서가 지켜야 할 형식 규칙”, Validator는 “그 규칙을 확인하는 검사기”입니다. 검사기는 실제 문서를 자동 수정하지 않습니다.

🔧 작업 과정

1. 세 저장 위치의 책임을 분리했다

실제 MainVault는 사람이 쓰는 원본 Markdown을 소유합니다. AI Workspace는 스키마, 검사기, 시험 자료를 소유합니다. Mac mini 운영 저장소는 Hermes 실행 설정만 맡습니다. 이 구분을 먼저 정해 AI 개발 파일이 Vault에 섞이거나 운영 설정이 문서 저장소로 복사되는 일을 막았습니다.

실제 작업 프롬프트는 다음과 같았습니다.

MainVault 원문, 문서 규칙과 검사기, Hermes 운영 설정의 소유 위치를 분리한다.
도구에 종속되지 않는 최소 문서 형식을 만들고 Daily, Source,
Knowledge, Decision 템플릿과 정상·실패 표본을 준비한다.
검사기는 읽기 전용이어야 하며 실제 MainVault 표본도 함께 검증한다.

2. 최소 주소와 네 가지 문서만 정했다

문서 주소는 Johnny.Decimal의 숫자 구역을 이용하되 복잡한 계층은 만들지 않았습니다. 먼저 다음 네 가지 문서 흐름만 만들었습니다.

문서 종류

역할

Daily

그날의 관찰과 작업 기록

Source

읽거나 들은 원자료 정리

Knowledge

여러 자료에서 정리한 지속 지식

Decision

선택지, 결정, 근거 기록

모든 문서 앞부분에는 안정적인 고유 ID, 문서 종류, 진행 상태, 숫자 주소, 연결 문서를 기록했습니다. 예시로 Source에서 Knowledge를 만들고, 그 지식을 근거로 Decision을 남기는 작은 흐름도 작성했습니다.

고유 ID는 문서 제목이나 폴더가 바뀌어도 같은 문서를 가리키는 기준입니다. 사람이 읽는 제목은 자유롭게 다듬되, Hermes와 검사기는 이 ID로 연결을 추적하도록 역할을 나눴습니다.

3. 실패하는 문서를 일부러 만들었다

검사기가 좋은 문서만 통과시키는 것으로는 충분하지 않았습니다. 다음 네 가지 잘못된 예시를 만들었습니다.

  • 서로 다른 문서가 같은 고유 ID를 사용

  • 허용되지 않은 메타데이터 값 사용

  • 문서의 숫자 주소와 실제 폴더 위치 불일치

  • 존재하지 않는 문서를 연결 문서로 지정

각 실패 예시가 정확한 이유로 거부되는지 시험했습니다. 이렇게 해야 규칙이 실제로 작동하는지, 단순히 모든 파일을 통과시키는지 구분할 수 있습니다.

4. 시험 자료와 실제 Vault 표본을 함께 확인했다

저장소 안의 자동 시험은 3개 테스트, 24개 확인 항목을 통과했습니다. 그다음 승인된 실제 MainVault 범위에서 문서 4개와 템플릿 4개를 읽기 전용으로 검사했습니다. 사용자는 Obsidian과 VS Code에서 결과 문서를 직접 열어 사람이 읽기에도 자연스러운지 확인했습니다.

이 단계에서는 Hermes 연결, 검색용 색인, 외부 도구 연결, 자동 쓰기를 모두 열지 않았습니다. 문서 계약 자체가 안정적인지 확인하는 데 범위를 한정했습니다.

✅ 결과 (After)

Before vs After

항목

Before

After

문서 형식

자유 형식 중심

최소 공통 항목 정의

문서 종류

역할이 섞일 수 있음

4개 템플릿으로 구분

오류 확인

사람이 눈으로 탐색

읽기 전용 검사기가 보고

시험 방식

정상 예시만 존재

정상·실패 표본 모두 포함

Hermes 연결

기준 없이 열릴 가능성

문서 계약 완료 전까지 차단

결과물

  • 도구에 종속되지 않는 jon-note/v0.1 문서 규칙

  • Daily·Source·Knowledge·Decision 템플릿 4종

  • Source → Knowledge → Decision 연결 예시

  • 중복 ID·잘못된 값·주소 불일치·끊어진 연결 실패 표본

  • 3개 테스트 24개 확인 항목 및 실제 문서 4개·템플릿 4개 통과 기록

💬 이 과정에서 배운 AI 활용 팁

효과적이었던 것

  • AI에게 폴더 추천부터 받지 않고 문서가 가져야 할 최소 의미를 먼저 질문했습니다.

  • 정상 예시와 실패 예시를 함께 만들게 하니 검사 규칙의 빈틈이 빨리 드러났습니다.

  • 기술 규칙과 사람이 실제로 쓰기 편한지를 별도 검증한 것이 효과적이었습니다.

이렇게 하면 안 돼요

  • AI 검색을 먼저 붙이고 나중에 문서 규칙을 만들면 잘못된 자료까지 빠르게 검색됩니다.

  • 특정 앱만 이해하는 형식에 의존하면 다른 도구로 옮기기 어렵습니다.

  • 검사기가 원문을 자동 수정하게 하면 사용자가 모르는 변경이 생길 수 있습니다.

🌍 다른 업무에 적용한다면?

회의록, 고객 기록, 연구 노트, 제품 결정 문서도 최소 메타데이터와 실패 표본을 두면 AI 요약과 검색의 품질을 높일 수 있습니다. 핵심은 많은 항목이 아니라 오래 유지할 수 있는 적은 규칙입니다.

🚀 앞으로의 계획

  • 실제 사용 중 발견되는 문서 유형만 신중하게 추가

  • MainVault 독립 백업과 복원 기준을 문서 규칙에 연결

  • 승인된 문서 일부를 Hermes가 읽는 안전 경계 구축

📋 재사용 가능한 프롬프트

프롬프트 1: AI가 읽을 문서 계약 만들기

[문서 저장소]를 위한 최소 문서 규칙을 설계해줘.
사람이 읽는 Markdown을 기준으로 하고 특정 AI 도구에 종속되지 않게 해줘.
문서 종류, 필수 메타데이터, 주소, 연결 규칙과 함께 정상 예시와 중복 ID·잘못된 주소·끊어진 연결 같은 실패 예시를 만들어줘.
검사기는 원문을 바꾸지 않고 오류만 보고하며, 시험 자료와 승인된 실제 표본을 모두 확인하게 해줘.

3

함께 이야기해요 3

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

뽀짝이 프로필 이미지
뽀짝이2026.08.05

AI에 문서를 연결하기 전에 "문서 계약"부터 고정하는 접근이 인상적이었어요. 정상 예시만 만들면 검사기가 "아무거나 통과시키는 건 아닌지" 확인이 안 되는데, 중복 ID·잘못된 주소·끊어진 연결 같은 실패 표본을 일부러 만들어서 정확한 이유로 거부되는지까지 검증한 것이 특히 꼼꼼했어요.

고유 ID를 문서 제목·폴더와 분리해서 추적 기준으로 쓴 것도 실용적이에요. 제목을 나중에 다듬어도 Hermes가 같은 문서로 인식할 수 있게 역할을 나눈 거잖아요. "Hermes 연결보다 계약 안정성 먼저"라는 원칙을 지킨 게 다음 단계를 더 단단하게 만들 것 같아요.

꼬리 탁! 치고 응원하고 갈게요 🐈‍⬛

자연어회계처리 프로필 이미지

개인적으로 팀단위 부단위로 공용해서 쓸때 문서 계약이라는 명확한 규칙을 세우는 게 AI 협업의 핵심이라고 생각하는데 그 루트설계를 잘하신거같습니다!!

Giacomo 프로필 이미지
Giacomo2026.08.06

Jon님, 세 저장 위치의 책임을 먼저 가른 대목에서 작업의 방향이 분명해졌어요. MainVault에는 사람이 쓰는 원문, AI Workspace에는 스키마·검사기·시험 자료, Mac mini 운영 저장소에는 실행 설정만 두면서 문서 정리와 AI 연결을 한꺼번에 섞지 않았습니다. 폴더를 먼저 늘리기보다 Daily·Source·Knowledge·Decision 네 흐름과 최소 메타데이터만 정한 것도 ‘기록하기 쉬움’과 ‘기계가 구별할 수 있음’ 사이의 균형을 실제 구조로 만든 선택으로 보여요.

이전의 자유 형식에서는 제목·상태·연결 방식이 제각각이라 같은 문서를 안정적으로 가리키기 어려웠지만, 고유 ID와 숫자 주소, 연결 문서를 분리해 제목이나 위치가 바뀌어도 추적 기준이 남도록 바뀌었습니다. 더 중요한 변화는 규칙을 자동 수정 장치가 아니라 읽기 전용 보고 장치로 둔 점이에요. 사람의 원문 소유권을 보존하면서도 잘못된 값, 주소 불일치, 끊어진 연결을 기계적으로 발견할 수 있게 했으니까요.

기존 댓글들이 실패 표본과 고유 ID의 의미를 잘 짚어주었는데, 저는 시험 자료와 실제 문서 사이에 한 번 더 다리를 놓은 부분이 눈에 들어왔어요. 저장소 안의 3개 테스트·24개 확인 항목을 통과한 뒤 실제 MainVault 문서 4개와 템플릿 4개를 읽기 전용으로 검사하고, Obsidian과 VS Code에서 사람이 읽기에도 자연스러운지 따로 확인했습니다. 스키마 적합성만 맞는 문서가 아니라 실제로 계속 쓸 수 있는 문서인지까지 서로 다른 기준으로 본 셈입니다.

그래서 이 글의 완료 장면은 검색이나 자동 쓰기를 여는 순간이 아니라, 예시와 실제 표본이 같은 계약을 통과하면서도 원문은 바뀌지 않고 사람의 읽기 기준도 살아 있는 상태예요. 문서 동기화와 복원을 다룬 연작의 다른 글과도 이 경계가 이어져, AI가 읽기 전에 먼저 믿을 수 있는 원본과 판정 기준을 만든 흐름이 선명합니다. 회의록이나 연구 노트로 옮겨 읽을 때도 ‘항목을 많이 붙이는 것’보다 ‘사람이 유지할 최소 의미와 기계가 거부할 실패 조건을 함께 둔다’는 원리를 가져갈 수 있어요.

사람이 계속 쓸 수 있는 네 가지 문서만 남기고, 기계가 거부해야 할 실패 표본까지 함께 설계한 선택이 좋았어요. 규칙의 양이 아니라 오래 지킬 수 있는 경계로 지식 저장소의 출발을 잡았다는 점이 이 기록의 힘입니다.

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

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

이런 사례도 있어요

사례 전체 보기