연세대학교 학부생 대상 4시간 집중 특강 실습용 Starter Repository
"질문할 때마다 다시 찾지 말고, 수집할 때 미리 정리하자!" (LLM Wiki)
📑 세미나 교안 슬라이드 → https://modulabs.github.io/okf-wiki-starter/
매번 LLM에게 질문할 때마다 긴 문서를 다시 검색하고 계신가요?
이 워크숍에서는 Obsidian과 Claude Code, 그리고 **OKF(Open Knowledge Format)**를 활용하여 '공부하고 수집할수록 스스로 연결되고 축적되는 나만의 지식 위키'를 구축하는 방법을 배웁니다.
- 🏢 Obsidian: 나만의 생각과 메모가 담기는 작업실
- 🧑💼 AI (Claude): 자료를 요약하고 정돈해 주는 사서
- 📖 LLM Wiki: 쌓일수록 지식의 복리 효과를 내는 나만의 서재
- RAG의 한계와 LLM Wiki 이해: 질문할 때마다 다시 찾는 RAG에는 축적이 없습니다. 미리 정리해 두는 방식이 왜 다른지 이해합니다.
- AI 실습 환경 구축: Claude 데스크톱 앱의 Code 탭과 Obsidian, 웹 클리퍼를 내 컴퓨터에 직접 세팅합니다. 터미널은 쓰지 않습니다.
- 지식 축적의 선순환 체득: 수집한 자료를 위키 문서로 합성하고, 질문을 통해 정제된 답변을 다시 위키로 저장하는 복리 구조를 경험합니다.
- 지식 그래프 시각화: Obsidian Graph View를 읽는 법을 익히고, 연결 안 된 문서와 끊긴 링크를 점검합니다.
수업 전까지 두 개만 설치해 오시면 됩니다. 용량이 커서 강의실에서 50명이 동시에 받으면 오래 걸리는 것들입니다. 나머지 설정은 전부 수업에서 함께 합니다.
1. Claude 데스크톱 앱 — https://claude.com/download
브라우저 버전이 아니라 컴퓨터에 설치하는 앱이어야 합니다. 설치 후 배포받은 계정으로 로그인하고, 앱의 Code 탭이 눌리는지만 확인해 주세요.
2. Obsidian — https://obsidian.md
내려받아 설치하고 실행까지만 해보시면 됩니다.
💡 일찍 도착하셨다면 못 받으신 게 있는지 확인하고 다운로드를 먼저 걸어 두세요.
본 저장소를 내려받으면 아래와 같은 폴더 구조로 구성되어 있습니다.
okf-wiki-starter/
├── 📁 raw/ # 1. 웹 클리퍼나 파일로 수집한 원본 자료(.md)를 넣는 공간
├── 📁 wiki/ # 2. AI가 OKF 규칙에 맞춰 요약·합성한 개념 문서가 생성되는 공간
├── 📁 .claude/skills/ # 3. AI가 따르는 정리 규칙(okf-wiki 스킬)과 문서 템플릿
├── 📁 docs/ # 4. 강의 교안 슬라이드 (GitHub Pages로 공개)
├── 📄 lint_okf.py # 위키 점검 도구 (선택 — "위키 점검해 줘"로도 됩니다)
└── 📄 README.md # 강의 실습 안내서 (현재 문서)
| 시간 | 모듈 | 학습 목표 (Key Concepts) | 실습 활동 (Hands-on) |
|---|---|---|---|
| 0:00 - 0:10 | 0-1. 오프닝 | 강사 소개 및 최종 결과물 미리보기 | 4시간 뒤 완성할 개인 지식 위키 시각화 확인 |
| 0:10 - 0:40 | 1-1. ① 지식관리 에이전트를 위한 LLM wiki와 OKF 이해하기 | • RAG의 한계 (축적이 남지 않음) • LLM Wiki의 '미리 정리' 이점 • OKF 구조 (마크다운 + 표식), v0.1 → v0.2 |
지식 관리 에이전트의 작동 원리 이해 |
| 0:40 - 1:30 | 2-1. ② 클로드 환경 세팅 | 내 컴퓨터에 직접 AI 실습 환경 구축 | • Claude 데스크톱 앱 설치 및 로그인 • Code 탭에서 실습 폴더 열기 • okf-wiki-starter 내려받기(ZIP)• Obsidian 및 웹 클리퍼 세팅 |
| 1:30 - 1:40 | 2-2. 휴식 | 휴식 시간 | |
| 1:40 - 2:10 | 3-1. ③ 내 문서로 지식 관리 에이전트 시작하기 | AI의 문서 요약·병합·상호 연결 원리 이해 | • 웹 클리퍼로 관심 자료 2~3개 raw/에 저장• "raw 폴더 읽어서 위키로 정리해 줘" 실행 • 자료 추가 시 기존 문서 누적 업데이트 확인 |
| 2:10 - 2:40 | 3-2. ③ 내 문서로 지식 관리 에이전트 시작하기 | • 출처 기반 답변 생성 • 답변 재저장을 통한 지식의 복리 축적 |
• "위키 근거로 OO 알려줘, 출처 달아줘" 질의• 출처 달린 답을 다시 위키로 저장하여 서재 확장 • 그래프 상 신규 노드 연결 확인 |
| 2:40 - 2:50 | 3-3. 휴식 | 휴식 시간 | |
| 2:50 - 3:35 | 4-1. ④ 연결망으로 보는 나만의 지식 위키 완성하기 | • Obsidian 그래프 뷰 읽는 법 • 연결 안 된 문서와 끊긴 링크 점검 |
• 지식 구조 시각화 실습 • [도전 과제] 끊긴 링크 0건, 연결 안 된 문서 0건 달성 • 전공에 맞춘 지식 정리 규칙 커스텀 |
| 3:35 - 3:55 | 5-1. ④ 연결망으로 보는 나만의 지식 위키 완성하기 | 구축한 지식 위키 공유 및 피드백 | 2분 피어 시연 (내 그래프 화면 및 질의응답을 통해 보완한 지식 공백 공유) |
| 3:55 - 4:00 | 0-2. 마무리 | 지속적 활용법 및 회고 | 수업 이후 개인 지식 베이스 지속 확장 팁 |
- Obsidian 그래프에서 개념들이 선으로 이어지는지 봅니다.
wiki/안에index.md(목차),log.md(작업 기록), 그리고 개념 문서들이 생겼는지 봅니다.- Claude에게
위키 점검해 줘라고 하면 상태를 훑어 줍니다. 끊긴 링크 0건, 연결 안 된 문서 0건이면 완성입니다.
raw/의 예제 대신 내가 관심 있는 자료를 넣어 보세요. 웹 클리퍼로 기사를 담거나, 텍스트를 복사해 raw/내주제.md 로 저장한 뒤 raw 폴더 읽어서 위키로 정리해 줘 라고 하면 됩니다.
자료가 쌓일수록 문서 수가 아니라 문서의 밀도가 올라갑니다. 같은 개념을 다룬 자료를 하나 더 넣어 보시면 새 문서가 생기는 게 아니라 기존 문서에 줄이 늘어나는 걸 보실 수 있습니다.
| 증상 | 이렇게 해보세요 |
|---|---|
Code 탭에서 /okf-wiki 가 안 보여요 |
연 폴더가 맞는지 확인하세요. 압축을 풀면 같은 이름의 폴더가 한 겹 더 있는 경우가 많습니다 |
| "Git is required" 가 떠요 (Windows) | Git 설치 후 Claude 앱을 껐다 켜세요 |
| 파일이 안 만들어져요 | 승인을 물어보는 화면이 떴는지 보세요. 승인 전에는 아무것도 바뀌지 않습니다 |
| 그래프가 비어 있어요 | 아직 "정리해 줘"를 안 돌렸다면 정상입니다 |
| 그래프에 선이 안 보여요 | 문서에 [[...]] 연결이 있는지, Obsidian이 Claude와 같은 폴더를 열었는지 확인하세요 |
- Q. 관심 주제나 전공 관련 수집할 자료가 떠오르지 않으면 어떻게 하나요?
- 수업 현장에서 제공하는 예시 주제 리스트(요리, 기업 신기술 동향 등) 중 하나를 선택해 시작하시면 됩니다.
- Q. 코딩 경험이 전혀 없는데 따라갈 수 있나요?
- 네! 직접 코드를 짜지 않고 AI 명령어(프롬프트)와 템플릿을 활용하므로 누구나 끝까지 완성할 수 있습니다.
- Q. 터미널이나 명령어를 써야 하나요?
- 아닙니다. Claude 데스크톱 앱 안에서 한국어로 부탁하면 됩니다.
🎓 연세대학교 일일 특강 실습용 레포지토리