AI4PKM 온보딩 시나리오 (2026년 1월)

AI4PKM 온보딩 시나리오

이 문서는 2026년 1월 AI4BM Cohort 공유 예정인 내용입니다.

🔔 더 많은 소식을 받고 싶으시면 메일링 리스트에 가입해주세요!

AI4PKM이란?

AI4PKM은 개인 지식 관리를 AI의 도움을 받아 더 자동화·효율화하는 것을 목적으로 하는 프로젝트입니다. 여기에는 NotebookLM의 대부분의 기능이 포함되기 때문에 NotebookLM의 오픈소스 버전이라고 보실 수도 있습니다.

Google NotebookLM처럼 콘텐츠를 수집하고, AI로 정리하고, 슬라이드나 비디오로 변환할 수 있습니다. 차이점은 모든 과정과 산출물을 완전히 통제할 수 있다는 것입니다.

💡 초기 설정은 다소 번거로울 수 있습니다. 하지만 파이프라인이 완성되면:

Goals

AI4PKM의 3-Layer Demo를 통해 지식 관리의 전체 흐름을 체험합니다:

3-Layer Demo 구조

온보딩 시나리오는 세 가지 레이어로 구성됩니다:

graph LR
    subgraph 수집
        A[아티클 클리핑]
        B[패시브 브레인스톰]
    end

    A -->|EIC| C[요약 생성]
    B --> C

    subgraph 정리
        C -->|GDR| D[일간 라운드업]
        C -->|TIU| E[토픽 라운드업]
    end

    D --> F[정리된 지식]
    E --> F

    subgraph 생성
        F -->|슬라이드| G[프레젠테이션]
        F -->|비디오| H[비디오 콘텐츠]
        F -->|CTP| I[소셜미디어 포스트]
    end
레이어 시나리오 설명
수집 EIC, 패시브 브레인스톰 콘텐츠 수집/입력
정리 일간 라운드업, 토픽 라운드업 지식 정리/구조화
생성 슬라이드, 비디오, 소셜미디어 포스트 콘텐츠 생성/출력

PKM 이론 배경 (선택 시청):

Pre-Onboarding Checklist

Obsidian 설치

  1. Obsidian을 다운로드하여 설치
  2. 앱 실행 후 언어 설정 (한국어/English)

Windows 사용자: 윈도우에서 Obsidian 설정하기 - 박창수님 튜토리얼

Obsidian Web Clipper 설치

  1. Obsidian Web Clipper 다운로드
  2. 브라우저 확장 프로그램으로 설치 (Chrome, Firefox, Safari, Edge 지원)
  3. 확장 프로그램 설정에서 Obsidian Vault 연결
    • 클리핑이 현재 볼트의 Ingest/Clippings로 이루어지기 위해 브라우저의 Obsidian Web Clipper를 다음과 같이 설정합니다.
      owc-config.png|445x653

Claude Pro/Max 계정 만들기

AI4PKM은 CLI 에이전트를 필요로 합니다. 이 중 에이전트 스킬이나 Voice Mode 사용을 위해서 클로드 코드를 (Pro 이상) 권합니다. 클로드 홈페이지에서 계정을 만드실 수 있습니다.

💡 비용 절감 팁: Claude Pro에서 "Subscribe Mode"를 사용하면 API 비용을 크게 줄일 수 있습니다.

Onboarding Process

처음 설치하시는 분들을 위한 안내

Gobi Desktop 설치

Gobi Desktop은 AI4PKM의 GUI 클라이언트입니다. 터미널 없이 모든 설정과 관리를 시각적으로 수행할 수 있습니다.

→ 상세 기능: (2) Gobi Desktop 가이드

다운로드 (Dev Version 2.3.0 기준):
https://drive.google.com/drive/folders/1QiymsmeSS2dxR4qwI2sm5KXoltBeWlU5

설치 후 앱을 실행하면 좌측에 Vault 목록이 표시됩니다.

새 Vault 생성

Gobi Desktop 화면 왼쪽에 플러스 버튼을 누르시면 새 볼트를 생성하실 수 있습니다.[1] AI4PKM 템플릿을 선택하면 다음이 포함된 Vault가 생성됩니다:

onboarding-01-create-vault.png|600

옵시디언에서 볼트 확인

이제 Obsidian에서 Open Folder as Vault 메뉴를 사용해서 방금 생성한 볼트를 열어봅시다.

템플릿에서 생성된 폴더 구조를 Obsidian에서 확인할 수 있습니다.
onboarding-02-obsidian-vault.png|600

클로드 코드 로긴

Orchestrator를 사용하기 위해 클로드 코드 로그인이 필요합니다. Orchestrator에서는 클로드 코드 이외의 다른 에이전트도 사용하실 수 있습니다.

VAULT > claude setup-token

onboarding-03-claude-login.png|600

Executor 옵션 (Claude Code 외 대안):

Executor 필요 조건 추천 대상
Claude Code Claude Pro 구독 풀 기능 사용자 (권장)
Gemini CLI Gemini Pro 구독 구글 모델 선호자
Codex CLI OpenAI API 키 OpenAI 모델 선호자

오케스트레이터 설정 확인

이제 Orchestrator의 설정 파일(orchestrator.yaml)을 확인해 봅시다.

설정에서 EIC (Enrich Ingested Content) 프롬프트가 클리핑을 처리하도록 설정된 것을 보실 수 있습니다. 이 Agent는 Ingest/Clippings 폴더에 새 파일이 추가되면 자동으로 요약을 생성합니다.

→ 설정 상세: (4) Orchestrator 설정
orchestrator-config.png

실습 W1: Ingestion (콘텐츠 수집)

시나리오 1-1: Web Clipping & EIC

Obsidian Web Clipper를 사용해서 클리핑을 수행합니다.
onboarding-06-web-clipper-usage.png|600

예시 아티클 (세컨드 브레인 주제):

자동 처리 흐름:

  1. Web Clipper로 웹 페이지 클리핑 → Ingest/Clippings/에 저장
  2. Orchestrator가 새 파일 감지 → EIC Agent 자동 실행
  3. AI가 요약 생성 → AI/Articles/에 결과 저장

아래와 같이 방금 클리핑에 대한 서머리가 생성된 것을 확인할 수 있습니다.
onboarding-06-web-clipping-1.png|600

onboarding-06-web-clipping-2.png|600

onboarding-06-web-clipping-result.png|600

EIC 상세 설명: EIC 프롬프트 활용법 - AI4BM

EIC Before EIC After
eic-before-clipping.png eic-after-summary.png

시나리오 1-2: Passive Brainstorming

Voice Mode를 사용하여 생각을 캔버스로 정리하는 시나리오입니다. 타이핑 없이 음성으로 아이디어를 브레인스토밍하고, AI가 이를 구조화된 캔버스로 변환합니다.

음성 모드 배경 지식: Voice Mode 소개 및 활용 - AI4BM

설정 방법:

  1. Chat Config (Chat History 제목 옆에서 설정):
    onboarding-08-voice-chat-config.png|400

  2. Global Config (Gobi Desktop 설정에서 한국어 음성 사용):
    onboarding-08-voice-global-config.png|400

사용 방법:

  1. Gobi Desktop에서 Voice Mode 활성화
  2. 마이크 버튼을 클릭하고 브레인스토밍 내용을 음성으로 말하기
  3. AI가 음성을 텍스트로 변환하고 구조화
  4. 결과를 Obsidian Canvas로 저장

voicde-mode.png|600

활용 예시:

결과물:
Voice로 입력한 내용이 Obsidian Canvas 형태로 저장됩니다. 노드와 연결선이 자동으로 생성되어 시각적으로 아이디어를 파악할 수 있습니다.

pbc-canvas.png

실습 W2: Organize (지식 정리)

시나리오 2-1: Daily Roundup (GDR)

Claude를 통해 GDR (Generate Daily Roundup) 프롬프트를 Orchestrator에 추가합니다.

Claude> Run GDR prompt at 3am every day (using ai4pkm)

GDR 프롬프트는 매일 아침 전날의 활동을 요약한 Daily Roundup 리포트를 자동으로 생성합니다. 새로 추가된 클리핑, 작성한 저널, 캘린더 일정 등을 종합하여 하루를 시작할 때 유용한 브리핑을 제공합니다.

GDR Worker가 추가된 결과:
onboarding-07-daily-roundup-1.png|600

onboarding-07-daily-roundup-2.png|600

Daily Roundup에 포함되는 내용:

시나리오 2-2: Topic Roundup

인제스트된 아티클들에서 토픽을 추출하고 관련 지식을 정리하는 시나리오입니다.

설정 방법:

Orchestrator에 Topic Index Update (TIU) Worker를 추가합니다:

Claude> Add TIU worker that runs weekly

처리 흐름:

  1. 지난 주 인제스트된 아티클 수집
  2. AI가 주요 토픽 추출 및 분류
  3. 토픽별 요약 생성
  4. Topics/ 폴더에 관련 문서 업데이트 또는 생성

활용 예시:

graph-example.png

실습 W3: Creation (콘텐츠 생성)

시나리오 3-1: Markdown Slides

정리된 지식을 프레젠테이션 슬라이드로 변환하는 시나리오입니다. Markdown 형식으로 슬라이드를 생성하여 Obsidian 내에서 바로 프레젠테이션할 수 있습니다.

사용 방법:

Claude> Create slides from [[Topic Roundup - AI Agents]] using markdown-slides skill

슬라이드 형식:

예시 결과물:

slidenumbers: true

# 주제 제목 🧠

**핵심 메시지**

*부제목*

^ 발표자 노트: 이 슬라이드에서는...

---

## 핵심 포인트

- 포인트 1
- 포인트 2
- 포인트 3

^ 각 포인트에 대한 설명...

활용 팁:

deckset-example.png

시나리오 3-2: Markdown Video

슬라이드와 음성을 결합하여 비디오를 생성하는 시나리오입니다. NotebookLM 스타일의 오디오/비디오 콘텐츠를 만들 수 있습니다.

사용 방법:

Claude> Create video from [[Second Brain 입문 가이드 - slides]] using markdown-video skill

주요 기능:

생성 결과물 예시: 세컨드 브레인 비디오

End-to-End 예시: 세컨드 브레인 슬라이드 만들기

세 레이어를 관통하는 전체 흐름을 "세컨드 브레인" 주제로 체험해봅시다:

Step 1: 수집 (Ingestion)

위의 예시 아티클 5개를 Web Clipper로 클리핑합니다:

→ EIC가 자동으로 각 아티클의 요약을 생성합니다.

Step 2: 브레인스톰 (Passive Brainstorming)

Voice Mode로 세컨드 브레인에 대한 생각을 정리합니다:

"세컨드 브레인의 핵심은 뭘까? 나에게 어떤 의미가 있지?"

→ AI가 음성을 Canvas로 구조화합니다.

Step 3: 정리 (Organize)

TIU가 수집된 콘텐츠를 "세컨드 브레인" 토픽으로 정리합니다:

Step 4: 생성 (Creation)

정리된 토픽을 슬라이드로 변환합니다:

Claude> Create slides from [[Topics/세컨드 브레인]] using markdown-slides skill

→ Deckset/Marp 호환 슬라이드가 생성됩니다.

결과물: 수집한 아티클과 나의 생각이 결합된 프레젠테이션

커뮤니티 볼트 셋업 (Optional)

다른 코호트 참가자들과 PKM 콘텐츠를 공유하고 싶으시다면 커뮤니티 볼트를 설정해 보세요.

상세 가이드: 2026-01 커뮤니티 볼트 셋업 가이드

API Dependencies

각 시나리오별 외부 API 의존성:

시나리오 필요 API 비고
EIC 없음 Claude만으로 가능
Passive Brainstorming ElevenLabs Voice, TTS
Daily Roundup 없음 배치잡으로 실행
Topic Roundup 없음 배치잡으로 실행
Markdown Slides 없음 바로 가능
Markdown Images Gemini 이미지 생성
Markdown Video OpenAI, Gemini TTS + 이미지 생성

다음 단계

온보딩 과정을 완료했습니다! 🎉 이제 다음 단계로 나아가보세요:

즉시 활용

심화 학습

커뮤니티 기여

AI4PKM 생태계에 기여하고 싶으시다면:

기여 대상 방법 비고
Vault 새 도메인 추가 도메인별 지식 구조
Skills PR (subtree) 서브트리 PR 방법 문서화 필요
Prompts 템플릿 볼트 업데이트 기존 템플릿에 추가

트러블슈팅

일반적인 문제

문제 해결 방법
클로드 코드 로그인 실패 claude setup-token 재실행, API 키 확인
스킬 설치 안 됨 인터넷 연결 확인, GitHub 접근 가능 여부 확인
Orchestrator 미작동 Gobi Desktop → Logs 탭에서 에러 확인
클리핑 자동 처리 안 됨 Web Clipper 저장 경로가 Ingest/Clippings/인지 확인
Voice Mode 작동 안 됨 ElevenLabs API 키 설정 확인

추가 도움

Appendix: System Dependencies

Markdown Video 스킬 Dependencies

시스템 패키지:

brew install ffmpeg

Python 패키지:

pip install openai>=1.0.0 google-genai>=1.0.0 Pillow>=10.0.0

환경 변수:

export OPENAI_API_KEY="sk-..."
export GEMINI_API_KEY="..."

  1. 만약 볼트 생성 위치 및 이름을 내 마음대로 정하고 싶으시다면 생성을 원하는 위치에git clone https://github.com/jykim/ai4pkm-vault {원하는폴더명} 커맨드로 볼트를 만드시는 것을 추천드립니다. (git 설치는 여기) 이렇게 생성된 볼트는 향후 템플릿 볼트의 업데이트를 git pull 명령으로 손쉽게 가져올 수 있는 장점이 있습니다. ↩︎