Claude Code, Codex, Cursor, Grok Bot을 위한 공유 메모리로서의 Obsidian vault

# obsidian-second-brain 설정 가이드

이 저장소에 obsidian-second-brain을 설정하는 방법을 안내합니다. Obsidian vault 생성/지정, Claude Code용 에이전트와 커맨드 설치, Crew logbook 폴더 구성, 그리고 Codex/Cursor 세션이 동일한 작업 기록을 읽을 수 있도록 하는 전체 흐름을 다룹니다.

## 1. Obsidian vault 준비

먼저 vault를 정합니다. 두 가지 선택지가 있습니다.

**옵션 A: 저장소 내부에 vault 생성**

```bash
mkdir -p .obsidian-vault
```

**옵션 B: 기존 vault 지정**

이미 사용 중인 vault가 있다면 절대 경로를 기록해 둡니다. 예: `~/Documents/Brain`

vault 경로는 이후 단계에서 환경 변수나 설정 파일로 참조합니다.

```bash
export OBSIDIAN_VAULT_PATH="$PWD/.obsidian-vault"
```

## 2. Claude Code용 에이전트와 커맨드 설치

obsidian-second-brain은 Claude Code의 에이전트(`agents/`)와 슬래시 커맨드(`commands/`)를 제공합니다. 저장소 루트에서 다음 구조를 만듭니다.

```bash
mkdir -p .claude/agents .claude/commands
```

에이전트와 커맨드 파일을 `.claude/` 아래로 복사하거나 심볼릭 링크합니다.

```bash
# 예시: 저장소에 포함된 정의를 사용하는 경우
cp -r obsidian-second-brain/agents/* .claude/agents/
cp -r obsidian-second-brain/commands/* .claude/commands/
```

Claude Code를 실행하면 `.claude/agents`와 `.claude/commands`가 자동으로 인식됩니다. 커맨드는 `/`로 시작하는 슬래시 커맨드로, 에이전트는 작업 위임 대상으로 사용할 수 있습니다.

## 3. Crew logbook 폴더 구성

Codex와 Cursor 세션이 같은 작업 기록을 읽으려면 logbook을 vault 안의 고정 경로에 두고, 모든 도구가 그 경로를 참조하도록 맞춥니다.

```bash
mkdir -p "$OBSIDIAN_VAULT_PATH/Crew/logbook"
```

logbook 항목은 하나의 작업 = 하나의 마크다운 파일로 저장합니다. 파일명 규칙을 정해 두면 여러 에이전트가 같은 기록을 찾기 쉬워집니다.

```
Crew/logbook/YYYY-MM-DD-<slug>.md
```

각 도구가 동일한 경로를 바라보도록 설정합니다.

- **Claude Code**: `.claude/` 설정에서 `OBSIDIAN_VAULT_PATH`를 참조
- **Codex**: 프로젝트 설정 또는 환경 변수로 동일한 vault 경로 지정
- **Cursor**: `.cursor/` 규칙 또는 워크스페이스 설정에서 같은 경로 참조

핵심은 세 도구 모두 `Crew/logbook`을 **읽기/쓰기 공용 경로**로 사용하는 것입니다. 경로를 하드코딩하기보다 환경 변수(`OBSIDIAN_VAULT_PATH`)로 통일하면 충돌을 줄일 수 있습니다.

## 4. 작은 작업을 end-to-end로 실행

설정이 끝났다면 실제로 한 번 돌려봅니다. 예를 들어 "logbook 파일명 규칙 문서화" 같은 작은 작업을 선택합니다.

1. Claude Code에서 커맨드로 작업을 시작합니다.
2. 에이전트가 vault의 관련 노트를 읽고 작업을 수행합니다.
3. 결과를 `Crew/logbook/2025-01-01-logbook-naming.md`에 기록합니다.

## 5. 레슨 남기기

작업에서 얻은 교훈은 vault의 레슨 노트에 남깁니다. 예: `Crew/lessons/logbook-naming.md`. 레슨에는 무엇을 배웠는지, 다음에 어떻게 적용할지를 간단히 적습니다.

## 6. 두 번째 에이전트가 보게 될 로그 항목

Codex나 Cursor 세션은 `Crew/logbook`을 읽으므로, 위에서 남긴 항목을 다음과 같은 형태로 보게 됩니다.

```markdown
---
date: 2025-01-01
task: logbook-naming
agent: claude-code
status: done
---

# Logbook 파일명 규칙 문서화

## 작업
Crew logbook 항목의 파일명 규칙을 정하고 문서화했다.

## 결과
- 규칙: `YYYY-MM-DD-<slug>.md`
- 위치: `Crew/logbook/`

## 레슨
파일명에 날짜를 앞에 두면 정렬이 안정적이고, 여러 에이전트가 같은 기록을 찾기 쉽다.
```

이 항목이 공용 logbook에 있으므로 Codex와 Cursor 세션도 동일한 내용을 읽고 이어서 작업할 수 있습니다.

## 요약

- vault를 정하고 `OBSIDIAN_VAULT_PATH`로 통일
- `.claude/agents`, `.claude/commands`에 에이전트/커맨드 설치
- `Crew/logbook`을 공용 경로로 두고 세 도구가 같은 경로를 참조하도록 설정
- 작은 작업을 end-to-end로 실행하고 레슨을 남김
- 두 번째 에이전트는 공용 logbook에서 같은 기록을 읽음