실전 가이드 개요

나에게 맞는 시작점 찾기

💡 빠른 시작: Gobi Desktop으로 AI4PKM을 처음 설치하신다면 온보딩 시나리오를 따라해보세요!

flowchart TB
    A["🌱 PKM 초보자"] --> B["배경 지식"]
    B --> C["마이그레이션"]
    C --> D["Terminal 설치"]
    D --> E["고급 기능"]

    A2["📦 Obsidian 입문"] --> C
    A3["🤖 Claude Code 입문"] --> D
    A4["⚡ 고급 사용자"] --> E

AI4PKM이란?

AI4PKM은 AI 기반 개인 지식관리(Personal Knowledge Management) 시스템입니다.

핵심 가치:

• 마크다운 파일로 지식을 저장하고 관리
• AI가 지식 수집, 정리, 활용을 자동화
• Obsidian Vault를 기반으로 동작

"완벽하지 않아도 됩니다. 일단 시작하세요."

아키텍처

flowchart BT
    subgraph Gobi["🖥️ Gobi Desktop"]
        subgraph Storage["Storage"]
            FS[📁 File System]
        end
        subgraph Interface["Interface"]
            OBS[📝 Obsidian]
            CC[🤖 Claude Code]
        end
        subgraph Core["Core"]
            ORC[Orchestrator]
            CLI[AI4PKM CLI]
        end
    end

    Storage --> Interface --> Core

    D1[/"마크다운 파일 저장소"/]
    D2[/"사용자 UI · AI 인터페이스"/]
    D3[/"이벤트 감지 · Agent 실행"/]
    D4[/"전체 시스템 통합 GUI"/]

    Storage ~~~ D1
    Interface ~~~ D2
    Core ~~~ D3
    Gobi ~~~ D4

Obsidian 마이그레이션

다른 도구에서 Obsidian으로 옮기려면:

마이그레이션 후 (1) AI4PKM 터미널 설치 가이드로 이동하세요.

Claude Code란?

터미널에서 실행되는 AI 어시스턴트입니다.

ChatGPT와의 차이점:

설치 방법은 (1) AI4PKM 터미널 설치 가이드를 참조하세요.

시작하기 전에

필수:

• Obsidian 설치
• Vault 폴더 생성

도구 선택 가이드

도구 구성 흐름

flowchart LR
    subgraph Base[기본]
        OBS[Obsidian]
        CC[Claude Code]
    end

    subgraph Auto[자동화]
        ORC[Orchestrator]
        CLI[CLI]
    end

    subgraph GUI[편의성]
        GD[Gobi Desktop]
    end

    Base --> Auto --> GUI

상황별 추천

도구별 상세 가이드

Gobi Desktop (GUI)

AI4PKM Orchestrator의 GUI 클라이언트. 터미널 없이 모든 설정과 관리를 시각적으로 수행.

추천 상황:

• 처음 AI4PKM을 시작할 때
• 시각적 인터페이스를 선호할 때
• Agent/Prompt 설정을 변경할 때
• 실행 상태를 모니터링할 때
• 실패한 Task를 재실행할 때

주요 기능:

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

Claude Code CLI (터미널)

터미널에서 AI와 직접 대화하며 작업 수행. 빠르고 유연한 작업에 적합.

추천 상황:

• 빠른 질문이나 즉석 작업
• 복잡한 파일 수정이나 코드 작업
• 스크립트 자동화
• 터미널 환경에 익숙할 때

기본 명령:

# 대화 시작
claude

# 즉석 요청
claude "오늘 할 일 정리해줘"

# 이전 대화 이어가기
claude --resume

# 특정 작업 실행
claude "Ingest 폴더의 새 파일들 처리해줘"

장점:

• 빠른 응답 속도
• 파일 시스템 직접 접근
• 자동화 스크립트 연동 가능

Orchestrator (백그라운드 자동화)

이벤트 기반으로 Agent를 자동 실행하는 시스템. 설정 후 백그라운드에서 무인 동작.

추천 상황:

• 파일이 추가/수정될 때 자동 처리
• 정기적인 스케줄 실행 (매일 아침 브리핑 등)
• 외부 데이터 자동 수집 (Limitless, Photos 등)
• 여러 AI 모델로 동시 처리 (비교/평가)

동작 방식:

flowchart LR
    E[이벤트 발생] --> O[Orchestrator]
    O --> A[Agent 실행]
    A --> T[Task 완료]

이벤트 종류:

• 파일 생성/수정 감지
• Cron 스케줄
• 외부 데이터 폴링

→ 상세: (0) Orchestrator 개요, (4) Orchestrator 설정, (5) CLI 명령어 가이드, (1) Poller 시스템 가이드, (2) 커스텀 Agent 만들기

Learning Path

A. PKM 초보자

목표: 저장 습관 만들기 + Obsidian 설치

1. PKM 입문 자료 학습 (추천: Building a Second Brain)
2. Obsidian 설치 및 Vault 생성
3. 첫 노트 작성 (오늘 배운 것 한 줄)

일일 시간: 5분
다음 단계: B로 이동

B. Obsidian 입문

목표: 기존 노트 마이그레이션 + Obsidian 익숙해지기

1. Obsidian Importer 플러그인으로 마이그레이션
2. 위키링크 [[]] 사용해보기
3. 일주일간 매일 노트 작성

Obsidian 학습 자료:

일일 시간: 10분
다음 단계: C로 이동

C. Claude Code 입문

목표: CLI Agent 설치 및 첫 대화

1. (1) AI4PKM 터미널 설치 가이드 따라하기
2. Claude Code로 첫 요청: claude "오늘 할 일 정리해줘"
3. DIR 워크플로우 실습 (EIC, GDR)

일일 시간: 15분
다음 단계: D로 이동

D. 고급 사용자

목표: 자동화 + 커스텀 워크플로우

1. (2) Gobi Desktop 가이드로 GUI 설정
2. (3) Agent Skill 가이드로 스킬 활용
3. (0) Orchestrator 개요로 자동화 구축
4. (5) CLI 명령어 가이드로 CLI 마스터
5. (1) Poller 시스템 가이드로 외부 데이터 연동
6. (2) 커스텀 Agent 만들기로 나만의 에이전트 생성

일일 시간: 30분+
가능한 활동: 워크플로우 자동화, 커스텀 Prompt 개발

도구 조합 예시

일상적인 사용 패턴

아침: Orchestrator가 자동으로 일일 브리핑 생성
     → Gobi Desktop Logs에서 확인

오전: 새 클리핑 추가
     → Orchestrator가 자동 감지 및 처리

오후: 빠른 질문이나 작업
     → Claude Code CLI로 즉석 처리

저녁: 오늘 처리된 Task 확인
     → Gobi Desktop Tasks 탭

트러블슈팅 패턴

1. Gobi Desktop → Logs 탭에서 에러 확인
2. Gobi Desktop → Tasks 탭에서 Failed 상태 확인
3. 원인 파악 후 Retry 버튼으로 재실행
4. 또는 Claude Code CLI로 수동 처리

핵심 메시지

"비개발자도 80%의 기능을 터미널 없이 사용할 수 있어요."

• Gobi Desktop: 설정과 모니터링의 중심
• Claude Code CLI: 빠른 작업과 복잡한 처리
• Orchestrator: 반복 작업의 자동화

세 도구를 상황에 맞게 조합하면 효율적인 지식관리 시스템을 구축할 수 있습니다.

학습 경로

다음 단계:

개발자 가이드: