본문으로 건너뛰기

옵시디언 Wiki와 AKM 정리: 연결 문서 23개에서 90개로

You쌤

2026.10.21

옵시디언(Obsidian)의 Wiki와 AKM 연결을 점검해, 기준 인덱스에서 도달 가능한 문서를 117개 중 23개에서 90개로 늘렸습니다.

강의와 출판 규칙을 다시 쓰려면

저는 강의와 출판 작업을 하고 있습니다.

AI와 작업하면서 한 번 정한 기준을 다음 작업에서도 확인하고 반영하게 하고 싶었습니다. 제가 요청한 내용은 이랬습니다.

한 번 정한 규칙은 수정하기전에는 반드시 확인하고 반영해줬으면 좋겠어.

강의와 출판에 관한 규칙을 문서로 만드는 것에 더해, 이미 사용하고 있는 옵시디언 Wiki와 AKM 안에서 그 규칙을 찾고 활용할 수 있어야 했습니다.

이번 3주차 교안은 ‘연결된 지식에서 근거 있는 답으로’를 다룹니다. 저는 그중 기존 지식의 구조를 확인하고, 빠진 연결을 보완하는 부분을 제 작업에 적용한 사례를 정리했습니다. 아직 출처를 포함한 답변의 전후 비교까지 마친 것은 아닙니다.

3주차 교안을 제 작업에 대입하기

교안에서는 세 가지 역할을 구분합니다.

  • RAG: 질문에 필요한 외부 근거를 찾아 답변 생성에 제공하는 방법

  • 지식그래프: 대상과 관계를 연결해 표현하는 구조

  • 온톨로지: 개념과 관계의 의미를 함께 사용할 수 있도록 정의하는 모델

제 사례에 적용하면, ‘출판 규칙’ 문서를 연결하는 것과 그 규칙이 어느 작업에 적용되는지 정의하는 것, 실제 답변 전에 해당 문서를 찾아 읽는 것은 각각 확인해야 할 일입니다.

특히 교안의 적용 단계는 기존 자료가 있다면 처음부터 다시 만들기보다, 이미 있는 문서, 질문, 구조에서 이어가도록 안내합니다. AKM 역시 모든 사용자에게 같은 폴더를 강제하는 이름으로 설명하지 않습니다.

이 부분이 제 작업에서 실제로 문제가 된 지점과 맞닿아 있었습니다.

새 폴더 대신 기존 구조부터 확인

처음 AI는 다운로드 위치나 새 폴더를 중심으로 작업을 제안했습니다. 저는 기존 체계부터 확인해 달라고 요청했습니다. 이후에도 제안한 경로와 기존에 정해진 경로를 혼동하는 일이 있었고, 새 하위 폴더 두 개가 생성된 뒤 추가 변경을 멈췄습니다. 문서 연결 보완은 진행했지만, 전체 정리가 끝난 것은 아닙니다.

제게는 이미 사용 중인 구조가 있었습니다.

  • raw: 원본 자료

  • vault: 정제한 지식

  • exports: 밖으로 전달할 결과물

또 이 환경에서 AKM은 Agent Knowledge Management를 뜻했습니다. Wiki의 문서 연결과 AKM의 관리 절차도 구분해서 봐야 했습니다.

제가 원한 것은 새 보관함을 늘리는 일이 아니라, 기존 체계 안에서 강의와 출판 규칙을 찾아 쓰는 것이었습니다. 그래서 먼저 읽기 전용으로 현황을 점검하고, 확인된 문제만 제한적으로 수정하는 순서로 바꿨습니다.

옵시디언 문서 117개 점검

먼저, 점검 범위를 정했습니다

민감한 자료와 로그 등을 제외한 마크다운 문서 117개를 대상으로 구조와 링크를 확인했습니다. 전체 저장소를 모두 검사한 결과는 아니며, 아래 수치는 이 점검 범위에 한정됩니다.

처음에는 기준 인덱스에서 링크를 따라 도달할 수 있는 문서가 117개 중 23개였습니다. 파일이 있다는 사실과, 인덱스에서 그 파일을 찾아갈 수 있다는 사실을 나누어 확인한 셈입니다.

다음으로, 확인된 연결만 보완했습니다

수정 범위는 파일 5개로 제한했습니다. 경로를 명시한 링크 85개를 보완한 뒤, 같은 기준으로 인덱스에서 도달할 수 있는 문서 수를 다시 확인했습니다.

문서의 생성일(created), 소유자(owner), 상태(status)처럼 근거가 없는 메타데이터는 추측해서 채우지 않았습니다. 구조를 정리한다는 이유로 확인되지 않은 정보를 넣지는 않았습니다.

마지막으로, 수치가 뜻하는 범위를 확인했습니다

점검 전후 결과는 다음과 같습니다.

  • 인덱스에서 도달 가능한 문서: 23/117개 → 90/117개

  • 검사한 파일 링크의 대상 존재 여부: 129/129개 확인

  • bureau 분류 불일치: 2건 → 0건

  • 실제 수정 파일: 5개

여기서 117개는 점검 대상 문서 수이고, 129개는 확인한 파일 링크 수입니다. 서로 다른 지표입니다.

도달 가능한 문서는 67개 늘었지만, 이것만으로 AI가 모든 규칙을 읽고 정확히 적용한다고 말할 수는 없습니다. 링크 대상이 존재한다는 결과 역시 문서 내용과 관계의 의미까지 점검했다는 뜻은 아닙니다. 같은 기준에서 아직 도달하지 못한 문서 27개도 남아 있습니다.

Wiki 연결을 고친 뒤 남은 작업

이번에 확인한 성과는 기존 지식을 찾아갈 수 있는 경로를 보완했다는 점입니다. 온톨로지 시스템을 완성했거나 RAG를 구현한 사례로 소개하기에는 아직 부족합니다.

강의와 출판 규칙은 각각 MD, DOCX, PDF로 만들어져 총 6개 파일이 준비됐습니다. 다만 이 파일들이 옵시디언에 모두 편입되고 기존 문서와 연결된 상태는 아닙니다. 문서 제작과 지식체계 편입은 별개의 진행 상태로 남겨 두었습니다.

3주차 교안에서는 실제 에이전트가 어떤 파일과 근거를 읽었는지, 무엇을 답하고 무엇을 보류했는지도 기록하도록 안내합니다. 제 사례에는 아직 이 조건을 갖춘 고정 질문의 전후 응답 비교가 없습니다.

따라서 이번 결과는 ‘기존 구조를 존중하면서 연결을 보완한 단계’로 정리하는 것이 정확합니다.

AKM에서 규칙을 읽는 절차

이번 작업을 3주차 내용과 연결해 보니, 다음 세 가지를 분리해서 점검해야겠다는 기준이 생겼습니다.

첫째, 기존 구조를 먼저 확인해야 합니다. 이미 쌓아 둔 지식을 유지하면서 필요한 부분을 보완해야 다음 작업에서도 같은 기준을 쓸 수 있습니다.

둘째, 문서 링크와 의미 관계를 구분해야 합니다. 두 문서 사이에 링크가 있어도 그것이 적용 규칙인지, 참고 자료인지, 결과물인지 저절로 정해지지는 않습니다. 제 작업에서는 규칙의 적용 대상과 예외를 명확하게 만드는 과정이 더 필요합니다.

셋째, 구조 검사와 답변 점검을 따로 해야 합니다. 링크가 정상이어도 AI가 그 문서를 읽지 않을 수 있고, 읽었더라도 적용 범위를 잘못 해석할 수 있습니다. 실제로 읽은 근거와 답변을 함께 확인해야 합니다.

같은 질문으로 적용 여부 확인하기

다음 점검 대상으로는 아래 세 가지를 생각하고 있습니다.

  1. 새로 만든 강의와 출판 규칙 파일을 기존 구조에 맞게 편입하고 연결하기

  2. 같은 작업 질문으로 규칙 적용 여부를 확인하고, 실제로 읽은 문서와 적용 근거를 남기기

  3. 이전 답변을 보존한 채, 연결 보완 전후에 답변과 보류 판단이 어떻게 달라지는지 비교하기

기존 구조부터 읽게 하는 요청문

아래는 실제 실행한 요청문을 그대로 옮긴 것이 아니라, 이번 경험을 바탕으로 정리한 요청문입니다.

기존 옵시디언 Wiki와 AKM 구조를 먼저 읽어줘. 새 폴더를 만들거나 파일을 옮기기 전에 원본, 정제 지식, 결과물의 역할을 확인해줘. 이번 강의 또는 출판 작업에 적용할 규칙을 찾고, 실제로 읽은 문서와 적용 근거를 먼저 알려줘. 규칙이 충돌하거나 근거가 없으면 추측하지 말고 확인이 필요한 부분으로 남겨줘. 수정이 필요하면 대상과 범위를 제시하고, 이전 자료와 답변은 보존해줘.

이번 사례에서 남기고 싶은 것은 완성된 자동화의 모습보다, 기존 지식이 실제 답변에 쓰이기까지 무엇을 확인해야 하는지입니다. 연결 경로를 정리한 만큼, 다음에는 그 경로를 따라 읽은 근거가 강의와 출판 작업에 어떻게 반영되는지 확인해 보려 합니다.


참고: GPTers 24기 3주차 스터디 교안: 연결된 지식에서 근거 있는 답으로

교안의 한국사 시연과 제 옵시디언 점검은 별개의 사례입니다. 본문의 점검 수치는 제 작업 범위에 해당하며, AI 답변 정확도나 온톨로지 전체의 완성도를 측정한 수치는 아닙니다.

1

함께 이야기해요 1

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

DECK 프로필 이미지
DECK2026.10.21

117개 문서와 129개 링크를 보니 처음에는 같은 대상을 두 번 센 줄 알았어요. 문서에 닿는지와 링크가 가리킨 곳이 있는지를 따로 읽고서야, 숫자가 다르다고 느꼈던 이유를 알겠더라고요.

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

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

이런 사례도 있어요

사례 전체 보기