GitHub 오픈소스 탐험

최근 개인 지식 관리(PKM) 시스템에 대한 관심이 높아지면서 많은 툴과 프레임워크가 등장하고 있습니다. 하지만 그 중에서도 ballred/obsidian-claude-pkm 프로젝트는 단순한 스타터 키트가 아닌, 목표에서 하루의 일과까지 연결하는 실행 시스템으로 많은 주목을 받고 있습니다. 이 프로젝트는 개인의 3년 비전을 시작으로, 매일의 작업까지 체계적으로 관리할 수 있는 환경을 제공합니다. 이번 포스트에서는 이 프로젝트의 주요 기능과 설치 방법, 그리고 실제 활용 사례를 살펴보도록 하겠습니다.

Obsidian + Claude Code의 구조

이 시스템은 다음과 같은 흐름으로 구성되어 있습니다:

3-Year Vision ──→ Yearly Goals ──→ Projects ──→ Monthly Goals ──→ Weekly Review ──→ Daily Tasks
                                      ↑
                              /project new
                         (the bridge layer)

각 레이어는 서로 연계되어 있으며, 이를 통해 목표와 작업의 연관성을 명확하게 할 수 있습니다. 예를 들어, /daily 명령어를 사용하면 주간 리뷰에서 도출된 하나의 큰 목표를 매일의 작업으로 가져올 수 있습니다.

이 시스템의 특징

체계적인 목표 관리:

- Goals/0. Three Year Goals.md에서 장기적인 비전을 설정하고, 이를 기반으로 연간, 월간, 주간 목표를 설정할 수 있습니다.

진행 상황 추적:

- 각 주간 리뷰는 프로젝트의 현재 상태를 점검하고, 목표 진행 상황을 계산하여 다음 주의 계획을 수립하는 데 도움을 줍니다.

유연한 프로젝트 생성:

- /project new 명령어로 새로운 프로젝트를 생성하고, 이를 목표에 연결할 수 있는 기능을 제공합니다.

AI 기반 지원:

- Claude Code CLI를 통해 AI의 도움을 받아 목표 관리와 프로젝트 진행 상황을 더욱 효율적으로 관리할 수 있습니다.

설치 및 기본 사용법

필수 조건

Obsidian 설치
Claude Code CLI 설치
Git 설치

설치 과정

아래 명령어를 통해 프로젝트를 클론하고 설정할 수 있습니다:

# 클론 및 설정
git clone https://github.com/ballred/obsidian-claude-pkm.git
cd obsidian-claude-pkm
chmod +x scripts/setup.sh && ./scripts/setup.sh

# Obsidian에서 vault 열기, 그 후 Claude Code 시작하기
cd ~/your-vault-location
claude

처음 실행했을 때 환영 메시지와 함께 연결 구조가 시각화됩니다. /onboard 명령어를 실행하면 개인화된 설정을 할 수 있는 과정이 시작됩니다.

기존 Vault가 있는 경우

이미 Vault가 있다면, 아래 명령어를 통해 기존 구조를 자동으로 인식하고 설정할 수 있습니다:

cd ~/your-existing-vault
claude
# 그 후: /adopt 입력

Windows 사용자

Windows에서도 간단하게 설치할 수 있습니다:

git clone https://github.com/ballred/obsidian-claude-pkm.git
cd obsidian-claude-pkm
scripts\setup.bat

기본 명령어 사용법

이 시스템에서 사용할 수 있는 주요 명령어는 다음과 같습니다:

스킬	명령어	목적
Daily	`/daily`	아침 계획, 중간 확인, 저녁 반성
Weekly	`/weekly`	주간 리뷰, 프로젝트 요약
Monthly	`/monthly`	월간 리뷰, 분기 목표 점검
Project	`/project`	목표에 연결된 프로젝트 생성, 추적, 보관
Review	`/review`	스마트 라우터

실제 활용 시나리오

예를 들어, 당신이 한 달 안에 새로운 블로그 포스트를 작성하는 목표를 세웠다고 가정해봅시다. 매주 /weekly 명령어를 실행하여 지난 주의 진행 상황을 점검하고, 필요한 경우 목표를 조정할 수 있습니다. 매일 아침 /daily 명령어로 하루의 주요 작업을 정리하고, 저녁에는 오늘 수행한 작업을 정리하여 목표 진행 상황을 확인합니다. 이를 통해 목표와 일상이 어떻게 연결되는지 명확하게 파악할 수 있습니다.

유사 도구 비교

이와 비슷한 도구로는 Notion, Todoist 등이 있지만, obsidian-claude-pkm은 모든 목표와 작업이 서로 연결되어 있다는 점에서 차별화됩니다. 개인의 비전부터 일상적인 작업까지 체계적으로 관리할 수 있는 점이 큰 장점입니다.

실천 가능한 목표 관리 시스템, Obsidian과 Claude 코드의 조화