AI 에이전트는 세션 간 단서가 유지될 때만 시간이 지남에 따라 유용해집니다. Obsidian은 에이전트가 행동하기 전에 읽을 수 있는 내구성이 뛰어나고, 로컬이며, 구조화된 기억 계층을 제공합니다. 에이전트는 더 이상 제로에서 시작하지 않습니다 — 당신의 세계에서 시작합니다.
도구 이전에 에이전트가 메모리가 필요한 이유
대부분의 사람들은 메모리 없이 AI를 사용합니다. 그들은 Claude, ChatGPT, Claude Code 또는 다른 도우미를 열고, 컨텍스트를 붙여넣고, 프로젝트를 설명하고, 도움을 요청하고, 답변을 다른 곳에 복사하고, 다음 날 같은 의식을 반복합니다. 도우미는 똑똑할 수 있지만 대화가 시작되기 전에 작업의 상태를 알지 못합니다.
본능은 먼저 에이전트에게 도구를 주는 것입니다. Gmail, Slack, Notion, GitHub, Linear, Google Calendar, 브라우저, 파일 시스템을 연결하세요. 그런 다음 에이전트가 유용해지기를 바랍니다. 그 순서는 잘못되었습니다.
도구 접근은 에이전트에게 손을 주지만, 메모리는 그에게 판단력을 줍니다. 메모리 없이 에이전트는 여전히 일을 할 수 있지만, 어떤 일이 중요한지, 무엇이 이미 일어났는지, 현재의 우선 순위는 무엇인지, 어떤 제약이 적용되는지를 알지 못합니다. 유용한 에이전트는 행동하기 전에 기본 질문에 대답해야 합니다:
| 질문 | 왜 중요한가 |
|---|---|
| 이 프로젝트는 무엇과 관련이 있나요? | 일반적인 답변과 잘못된 맥락을 방지합니다. |
| 현재 상태는 무엇인가요? | 예전 작업을 반복하는 것을 방지합니다. |
| 다음 행동은 무엇인가요? | 메모리를 실행으로 전환합니다. |
| 누가 관련되어 있나요? | 관계 및 커뮤니케이션 맥락을 추가합니다. |
| 이미 어떤 결정이 이루어졌나요? | 오래된 이유를 다시 따지는 것을 방지합니다. |
| 곧 마감되는 것은 무엇인가요? | 긴급성 및 우선 순위를 만듭니다. |
| 어제 무엇이 변경되었나요? | 연속성을 줍니다. |
| 건드리지 말아야 할 것은 무엇인가요? | 안전 경계를 추가합니다. |
이것이 Obsidian의 가치입니다. 제대로 구조화되면, 작업의 읽을 수 있는 지도가 됩니다 — 단순히 노트를 저장하는 장소가 아니라, 에이전트가 행동하기 전에 읽는 첫 번째 두뇌입니다. 원리는 간단합니다: 에이전트에게 프롬프트에서 당신의 세상을 재구성하라고 요청하지 마세요. 읽을 수 있는 세상을 주세요.
왜 Obsidian이 에이전트 메모리로 잘 작동하는가
Obsidian은 폐쇄된 작업 공간이나 독점 도구보다 선택할 가치가 있는 에이전트 메모리에 몇 가지 이점이 있습니다.
노트는 로컬 Markdown 파일입니다. 에이전트, 스크립트 또는 터미널 도구는 복잡한 API 없이도 이를 읽을 수 있습니다. Markdown 파일의 폴더는 독점 객체로 가득 찬 폐쇄된 작업 공간보다 에이전트가 검사하기 훨씬 쉽습니다.
Obsidian은 링크 및 백링크를 지원합니다. 이를 통해 사람, 프로젝트, 회의, 결정 및 작업의 그래프를 만들 수 있습니다. 에이전트는 텍스트만 필요하지 않습니다 — 그들은 컨텍스트 조각 간의 관계를 필요로 합니다.
Obsidian은 속성을 지원합니다. 이는 노트 상단의 구조화된 필드입니다. 프로젝트 노트에는 status, priority, deadline, next_action이 있을 수 있습니다. 사람 노트에는 last_contact, relationship, next_touchpoint가 있을 수 있습니다. 이러한 필드가 존재하면, 금고는 쿼리할 수 있게 됩니다.
Dataview와 같은 플러그인은 금고를 경량 데이터베이스로 변환합니다. Dataview는 Obsidian을 위한 라이브 인덱스 및 쿼리 엔진으로, 노트에 메타데이터를 추가하고 Dataview 쿼리 언어로 쿼리할 수 있게 해줍니다. 노트가 변경됨에 따라 쿼리를 최신 상태로 유지합니다.
Obsidian은 사용자 제어 하에 유지됩니다. 개인 에이전트 메모리에는 그것이 중요합니다. 어시스턴트는 결국 당신의 프로젝트, 개인 노트, 관계, 클라이언트 맥락, 일일 로그 및 기록을 읽게 될 수 있습니다. 이러한 메모리를 로컬 우선 시스템에 유지하는 것은 블랙박스 챗봇 기록 안에 모든 것을 저장하는 것보다 더 많은 제어력을 제공합니다.
Obsidian은 연간 청구 시 월 $4(월별 청구 시 월 $5)로 Sync를 제공하며, 연간 청구 시 월 $8(월별 청구 시 월 $10)로 Publish를 제공합니다. 핵심 앱은 제한 없이 무료입니다. 에이전트 메모리 설정을 위해 대부분의 사용자는 무료 앱과 무료 Dataview 플러그인만 필요합니다.
Obsidian은 규율이 필요합니다. 만약 당신의 노트가 일관성이 없다면, 에이전트는 그 일관성을 상속받습니다. 만약 당신이 프로젝트 상태를 업데이트하지 않는다면, 대시보드는 거짓말을 합니다. 그러나 금고를 신중하게 설계하면, 그것은 AI 에이전트를 위한 최고의 개인 메모리 레이어 중 하나가 됩니다.
아키텍처: 원시 캡처, 구조화된 메모리, 대시보드, 브리핑
Obsidian 에이전트의 두뇌는 하나의 큰 노트 폴더가 되어서는 안 됩니다. 전사(transcript)는 결정과 동일하지 않습니다. 일일 노트는 작업과 동일하지 않습니다. 대시보드는 프로젝트 파일과 동일하지 않습니다. 구조는 서로 다른 수준의 맥락을 분리해야 합니다:
| 층 | 예시 | 역할 |
|---|---|---|
| 원시 캡처 | 회의 전사, 음성 메모, 복사한 이메일, 연구 덤프 | 무슨 일이 일어났는지 보존합니다. |
| 처리된 메모리 | 프로젝트 노트, 사람 노트, 결정 노트, 회의 요약 | 무엇을 의미하는지 설명합니다. |
| 구조화된 필드 | 상태, 마감일, 우선 순위, 소유자, 다음 행동 | 메모리를 쿼리 가능하게 만듭니다. |
| 대시보드 | 오늘의 우선 순위, 오래된 프로젝트, 열려 있는 루프 | 현재 어떤 것이 중요한지를 보여줍니다. |
| 에이전트 브리핑 | 아침 종합, 주간 검토, 위험 요약 | 맥락을 행동으로 전환합니다. |
이 분리는 중요합니다. 모든 것이 원시 캡처로 유지된다면, 에이전트는 너무 많은 발굴을 해야 합니다. 모든 것이 고 rigid 구조가 된다면, 시스템은 유지하기 어렵게 됩니다. 원시 캡처가 존재하도록 허용하되, 점진적으로 유용한 맥락을 구조화된 노트로 추출하세요.
에이전트는 층을 가로질러 이동할 수 있어야 합니다: 전사를 읽고, 결정을 추출하고, 프로젝트 노트를 업데이트하고, 열린 루프를 만들고, 그 결과를 내일의 브리핑에서 언급하는 것입니다. 그것이 메모리가 작동하게 되는 방법입니다.
금고 구조
좋은 에이전트 읽기 가능한 금고는 명확한 작업을 가진 간단한 폴더가 필요합니다. 일주일 후에 포기할 만큼 복잡한 시스템을 만들지 않도록 하세요. 실용적인 구조:
AI-Agent-Brain/
├── 00 - DASHBOARD/
├── 01 - DAILY/
├── 02 - PROJECTS/
├── 03 - PEOPLE/
├── 04 - TASKS/
├── 05 - MEETINGS/
├── 06 - DECISIONS/
├── 07 - TRANSCRIPTS/
├── 08 - RESEARCH/
├── 09 - BRIEFINGS/
├── 10 - TEMPLATES/
└── 99 - ARCHIVE/
터미널에서 생성하세요:
mkdir -p "AI-Agent-Brain"/{"00 - DASHBOARD","01 - DAILY","02 - PROJECTS","03 - PEOPLE","04 - TASKS","05 - MEETINGS","06 - DECISIONS","07 - TRANSCRIPTS","08 - RESEARCH","09 - BRIEFINGS","10 - TEMPLATES","99 - ARCHIVE"}
그런 다음 AI-Agent-Brain을 Obsidian 금고로 엽니다. 각 폴더에는 고유한 역할이 있습니다:
| 폴더 | 거기에 무엇이 들어가나요 | 왜 에이전트가 필요합니까 |
|---|---|---|
| 00 - DASHBOARD | 일일 대시보드 및 제어 패널 | 에이전트에게 방향을 제공합니다. |
| 01 - DAILY | 하루에 하나의 노트 | 연속성을 만듭니다. |
| 02 - PROJECTS | 활동 중인 프로젝트마다 하나의 노트 | 목표, 상태, 마감일, 다음 행동을 보여줍니다. |
| 03 - PEOPLE | 중요한 사람마다 하나의 노트 | 관계 메모리를 제공합니다. |
| 04 - TASKS | 작업 노트 또는 구조화된 작업 파일 | 무엇을 해야 하는지를 보여줍니다. |
| 05 - MEETINGS | 회의 노트 및 요약 | 결정 및 약속을 캡처합니다. |
| 06 - DECISIONS | 결정 기록 | 반복 이유를 방지합니다. |
| 07 - TRANSCRIPTS | 원시 통화, 음성 메모, 녹음 | 원시 맥락을 보존합니다. |
| 08 - RESEARCH | 외부 조사, 기사, 도구 노트 | 외부 지식을 연결합니다. |
| 09 - BRIEFINGS | AI 생성 아침 및 주간 요약 | 메모리를 행동으로 전환합니다. |
| 10 - TEMPLATES | 표준 노트 형식 | 시스템의 일관성을 유지합니다. |
| 99 - ARCHIVE | 비활성 또는 오래된 자료 | 활성 메모리를 깨끗하게 유지합니다. |
폴더 이름은 역할의 분리보다 덜 중요합니다. 에이전트가 현재 프로젝트 상태를 필요로 한다면, 02 - PROJECTS로 가야 합니다. 어제의 미완료 항목이 필요하다면, 01 - DAILY로 가야 합니다. 관계 맥락이 필요하다면, 03 - PEOPLE로 가야 합니다.
Obsidian 설치하기
Obsidian은 macOS, Windows, Linux, iOS 및 Android에서 사용할 수 있습니다. 대부분의 사용자는 공식 사이트에서 설치하고 금고를 만들거나 열고 위의 폴더 구조를 지정하세요. Dataview를 추가할 준비가 되었을 때 커뮤니티 플러그인을 활성화하세요.
Linux에서는 Snap을 통해 설치할 수 있습니다:
sudo snap install Obsidian --classic
로컬 우선 에이전트 두뇌를 위해 중요한 것은 Obsidian을 어떻게 설치하느냐가 아니라 — 금고가 당신의 도구가 직접 읽을 수 있는 Markdown 파일의 폴더라는 것입니다.
가격: 이 설정에 드는 비용
핵심 Obsidian 앱은 제한 없이 무료입니다. 로컬 금고를 사용하기 위해 계정이 필요하지 않습니다. 선택적인 유료 부분은 동기화, 게시 및 상업적 사용에 관한 것입니다.
| 구성 요소 | 비용 | 언제 필요합니까 |
|---|---|---|
| Obsidian 핵심 앱 | 무료 | 로컬 단일 장치 금고에 충분합니다. |
| Obsidian Sync | $4/사용자/월(연간) 또는 $5/사용자/월(월간) | 장치 간 공식 암호화된 동기화를 사용합니다. |
| Obsidian Publish | $8/사이트/월(연간) 또는 $10/사이트/월(월간) | 금고를 웹사이트로 게시하는 데 사용합니다. |
| Dataview 플러그인 | 무료 | 라이브 대시보드 및 쿼리에 필요합니다. |
| Claude Code | Claude 요금제에 따라 다릅니다. | 터미널에서 금고 파일을 읽고 업데이트하는 데 유용합니다. |
| GitHub 개인 레포 백업 | 무료(제한 있음) 또는 유료 | 선택적 백업 및 버전 관리입니다. |
에이전트 메모리 설정의 경우, 대부분의 사람들은 무료 앱과 무료 Dataview 플러그인으로 시작할 수 있습니다. 공식적인 다중 장치 동기화가 필요하다면 Sync에 대해 지불하세요. 일부 노트를 공개 사이트로 전환하려면 Publish에 대해서만 지불하세요.
Dataview 설치하기
Dataview는 대시보드를 유용하게 만드는 플러그인입니다. Dataview 없이도 Obsidian은 여전히 좋은 메모리 시스템이지만, 대시보드는 대부분 수동으로 유지됩니다. Dataview 사용 시 대시보드는 노트를 읽고 자동으로 업데이트됩니다.
Obsidian 내부에서 설치하세요:
- 설정을 엽니다.
- 커뮤니티 플러그인으로 이동합니다.
- 제한 모드를 껍니다.
- 찾아보기를 클릭합니다.
- Dataview를 검색합니다.
- 설치 및 활성화합니다.
Dataview는 지식 기반에 대한 라이브 인덱스 및 쿼리 엔진입니다. 이를 통해 노트에 메타데이터를 추가하고 해당 메타데이터를 쿼리하여 정보를 나열, 필터링, 정렬 또는 그룹화할 수 있습니다. 활성화된 후에는 어떤 노트든 Dataview 쿼리 블록을 포함할 수 있으며, 금고가 변경됨에 따라 자동으로 업데이트됩니다.
노트 템플릿
시스템은 노트에 일관된 구조가 있어야만 작동합니다. 각 노트 유형에는 일관되게 유지되는 소규모 필드 세트를 가져야 합니다. 모든 것을 모델링하려는 유혹을 피하세요 — 에이전트와 대시보드를 위해 충분한 구조가 필요하지만, 너무 지나치면서 노트를 작성하는 것이 세금처럼 느껴지게 해서는 안 됩니다.
Project note
---
type: project
status: active
priority: high
deadline: 2026-06-15
owner: Vincent
next_action: Draft the article intro
completion: 40
related_people:
- Sarah
- Alex
---
# Project Name
## Goal
What this project is supposed to achieve.
## Current state
Where things stand right now.
## Constraints
Important limits, dependencies, risks, or decisions.
## Notes
Useful context for the project.
Person note
---
type: person
relationship: investor
status: active
last_contact: 2026-05-18
next_touchpoint: 2026-05-25
priority: high
context: Interested in AI Career
---
# Person Name
## Context
Who they are and why they matter.
## History
Important interactions, conversations, or commitments.
## Preferences
Communication style, interests, boundaries, or useful details.
## Next touchpoint
What should happen next.
Task note
---
type: task
status: in-progress
project: AI Career
due: 2026-05-22
priority: high
energy: deep
---
# Task Name
## Outcome
What done looks like.
## Notes
Context, links, blockers, or requirements.
Meeting note
---
type: meeting
date: 2026-05-22
project: AI Career
people:
- Sarah
- Alex
status: processed
---
# Meeting with Sarah and Alex
## Summary
Short summary of the conversation.
## Decisions
- Decision 1
- Decision 2
## Action items
- [ ] Action item 1
- [ ] Action item 2
## Follow-up
What needs to happen next.
Decision note
---
type: decision
date: 2026-05-22
project: AI Career
status: decided
impact: high
---
# Decision: Use Obsidian as the agent memory layer
## Context
What led to this decision.
## Options considered
- Option A
- Option B
- Option C
## Decision
What was chosen.
## Why
The reasoning behind the choice.
## Revisit if
Conditions that would change the decision.
Daily note
---
type: daily
date: 2026-05-22
focus: Finish Obsidian agent memory article
energy: medium
---
# 2026-05-22
## Focus
The main thing that matters today.
## Plan
- [ ] First important task
- [ ] Second important task
- [ ] Third important task
## Open loops
OPEN: Follow up on the contractor stack article visual.
OPEN: Decide whether to turn the Obsidian article into a setup guide.
## End of day
What changed today.
In daily notes, use OPEN: as a convention for unresolved items that should carry forward. The dashboard queries these automatically.
대시보드는 저장하지 말고 읽어야 합니다
이것은 시스템 전반에서 가장 중요한 디자인 원칙입니다. 대시보드는 정보를 넣는 또 다른 장소가 아닙니다. 그것은 금고의 나머지 부분에서 읽고 현재 어떤 것이 중요한지를 드러내는 노트입니다.
만약 대시보드가 수동 노트가 된다면, 그것은 썩게 될 것입니다. 만약 그것이 프로젝트 노트, 작업 노트, 사람 노트 및 일일 노트에서 읽는다면, 기본 노트가 최신 상태인 한 현재성을 유지합니다.
파일을 생성하세요:
touch "AI-Agent-Brain/00 - DASHBOARD/Dashboard.md"
그런 다음 Dataview 쿼리로 섹션을 추가하세요. 각 쿼리를 Obsidian 노트의 Dataview 코드 블록 안에 배치하세요.
오늘의 우선 순위
TABLE WITHOUT ID
file.link AS "작업",
due AS "마감일",
project AS "프로젝트",
priority AS "우선 순위"
FROM "04 - TASKS"
WHERE type = "task"
AND status != "complete"
AND (due = date(today) OR due < date(today))
SORT priority DESC, due ASC
LIMIT 10
LIMIT 10는 의도적입니다. 47개의 연체 작업을 보여주는 대시보드는 명확성을 생성하지 않습니다 — 불안을 생성합니다.
활동 중인 프로젝트
TABLE WITHOUT ID
file.link AS "프로젝트",
priority AS "우선 순위",
completion + "%" AS "완료",
deadline AS "마감일",
next_action AS "다음 행동"
FROM "02 - PROJECTS"
WHERE type = "project"
AND status = "active"
SORT priority DESC, deadline ASC
가장 중요한 열은 next_action입니다. 에이전트는 프로젝트를 진행하는 데 어떤 것이 필요한지를 절대적으로 추측해서는 안 됩니다.
다가오는 마감일
TABLE WITHOUT ID
file.link AS "항목",
type AS "유형",
deadline AS "마감일",
status AS "상태"
FROM ""
WHERE deadline >= date(today)
AND deadline <= date(today) + dur(7 days)
AND status != "complete"
SORT deadline ASC
이 쿼리는 deadline 필드가 있는 모든 노트를 잡아냅니다 — 프로젝트, 전달물, 결정 노트 또는 기타 구조화된 파일들입니다.
연락할 사람들
TABLE WITHOUT ID
file.link AS "사람",
relationship AS "관계",
last_contact AS "마지막 연락",
next_touchpoint AS "다음 접점",
priority AS "우선 순위"
FROM "03 - PEOPLE"
WHERE type = "person"
AND status = "active"
AND next_touchpoint <= date(today)
SORT priority DESC, last_contact ASC
이것은 관계 메모리를 행동으로 전환합니다. 어시스턴트는 작업만을 기억해서는 안 됩니다 — 그들은 사람도 기억해야 합니다.
어제의 열린 루프
일일 노트에서 앞으로 Carry해야 할 항목을 위해 OPEN: 규칙을 사용하세요:
LIST
FROM "01 - DAILY"
WHERE type = "daily"
AND date = date(today) - dur(1 day)
FLATTEN file.lists AS item
WHERE contains(string(item), "OPEN:")
열린 루프는 항상 공식적인 작업이 아닙니다. 그것은 종종 시스템이 없으면 사라지는 작은 미해결 항목입니다.
최근 결정들
TABLE WITHOUT ID
file.link AS "결정",
project AS "프로젝트",
date AS "날짜",
impact AS "영향"
FROM "06 - DECISIONS"
WHERE type = "decision"
AND date >= date(today) - dur(14 days)
SORT date DESC
이것은 에이전트가 행동하기 전에 최근 전략적 맥락을 이해할 수 있게 해줍니다.
오래된 프로젝트들
TABLE WITHOUT ID
file.link AS "프로젝트",
priority AS "우선 순위",
deadline AS "마감일",
next_action AS "다음 행동"
FROM "02 - PROJECTS"
WHERE type = "project"
AND status = "active"
AND (next_action = null OR completion < 100)
SORT deadline ASC
여기에 last_reviewed 필드를 프로젝트 노트에 추가하여 개선할 수 있습니다.
아침 브리핑 워크플로우
대시보드는 데이터를 보여줍니다. 브리핑은 데이터가 의미하는 바를 설명합니다. 여기에서 에이전트는 유용하게 됩니다. 모델이 대시보드를 반복해 주기를 원하지 않고, 상황을 종합해 주기를 원합니다.
좋은 아침 브리핑 프롬프트:
내 Obsidian 대시보드 노트와 그것이 참조하는 모든 파일을 읽어라.
오늘 이루어야 할 가장 중요한 단일 작업을 알려주는 아침 브리핑을 종합하라.
1. 오늘 이루어야 할 가장 중요한 것.
2. 정오 이전에 주의가 필요한 것과 그 이유.
3. 오늘 행동하지 않으면 위험한 것.
4. 가장 주의가 필요한 사람이나 관계.
5. 내가 시작하기 전에 해야 할 열려있는 결정 하나.
테이블을 설명하지 마라. 그들이 의미하는 바를 말해줘라.
브리핑을 300단어 이하로 유지하라.
가장 긴급한 것부터 시작하라.
"테이블을 설명하지 마라"는 지시사항이 중요합니다. 많은 어시스턴트는 가시적인 데이터를 요약하는 대신 해석합니다. 브리핑의 요점은 메모리를 판단으로 전환하는 것이지, 대시보드를 다시 요약하는 것이 아닙니다.
출력을 다음에 저장하세요:
AI-Agent-Brain/09 - BRIEFINGS/2026-05-22 - Morning Briefing.md
또는 오늘의 일일 노트의 01 - DAILY에 추가하세요.
Claude Code를 금고에 연결하기
Claude Code는 터미널에 있는 에이전틱 코딩 도구로, 코드베이스를 이해하고 파일과 도구 간의 일상적인 작업을 수행하는 데 도움을 줍니다. 그것은 당신의 금고 폴더 내에서 작동할 수 있으며 Markdown 파일을 직접 읽거나 업데이트할 수 있습니다.
macOS, Linux 또는 WSL에서 공식 네이티브 설치 프로그램으로 Claude Code를 설치하세요:
curl -fsSL https://claude.ai/install.sh | bash
또는 npm을 사용하여 설치하세요(노드 JS 18 이상 필요):
npm install -g @anthropic-ai/claude-code
그런 다음 금고 디렉터리를 엽니다:
cd ~/AI-Agent-Brain
claude
거기에서 Claude Code에게 Markdown 파일을 읽고 업데이트하라고 요청하세요:
00 - DASHBOARD/Dashboard.md와 그와 연결된 노트를 읽어라.
이 형식을 사용하여 09 - BRIEFINGS에서 오늘의 아침 브리핑을 생성하라:
- 가장 중요한 우선 순위
- 정오 이전의 주의
- 무시했을 때의 위험
- 연락할 관계
- 결정해야 할 것
그런 다음 오늘의 일일 노트에 01 - DAILY에 한 단락 요약을 추가하라.
프로젝트 노트를 수정하지 마라, 먼저 묻도록 하라.
"프로젝트 노트를 수정하지 마라, 먼저 묻도록 하라" 규칙은 Claude Code가 파일을 편집할 수 있기 때문에 중요합니다. 그것이 변경할 수 있는 것과 매우 변경할 수 없는 것에 대해 명확히 하는 것은 원치 않는 재작성으로부터 보호합니다. 여기에서 CLAUDE.md 규칙 파일이 필수적이게 됩니다.
CLAUDE.md 규칙 파일 추가하기
규칙 파일은 에이전트에게 금고 내에서 어떻게 행동해야 하는지를 알려줍니다. 각 세션이 에이전트가 무엇을 만질 수 있는지에 대한 새로운 협상으로 변하지 않도록 방지합니다. 금고 루트에 생성하세요:
touch "AI-Agent-Brain/CLAUDE.md"
다음 내용을 추가하세요:
# CLAUDE.md
당신은 AI 에이전트 메모리 시스템으로 사용되는 Obsidian 금고 내에서 작업하고 있습니다.
## 핵심 규칙
- 추천하기 전에 관련 노트를 읽으세요.
- 중복 노트를 생성하는 것보다 기존 노트를 업데이트하는 것을 선호합니다.
- 명시적으로 지시되지 않는 한 노트를 삭제하지 마세요.
- 요청하지 않는 한 전체 노트를 다시 쓰지 마세요.
- 새로운 노트를 만들 때는 10 - TEMPLATES의 템플릿을 사용하세요.
- YAML 프론트 매터를 보존하세요.
- 필드가 누락된 경우, 발명하기 전에 물어보세요.
- 중요한 미해결 항목은 관련 일일 노트에 OPEN: 줄로 추가하세요.
- 의미 있는 선택이 이루어질 때 06 - DECISIONS에 결정을 기록하세요.
- 생성된 브리핑은 요청 받지 않는 한 300단어 이내로 유지하세요.
## 폴더 역할
- 00 - DASHBOARD: 개요 및 제어 패널.
- 01 - DAILY: 일일 노트 및 열린 루프.
- 02 - PROJECTS: 프로젝트 상태 및 다음 행동.
- 03 - PEOPLE: 관계 메모리.
- 04 - TASKS: 작업 노트.
- 05 - MEETINGS: 회의 노트 및 요약.
- 06 - DECISIONS: 결정 로그.
- 07 - TRANSCRIPTS: 원시 전사 및 캡처.
- 08 - RESEARCH: 외부 연구.
- 09 - BRIEFINGS: 생성된 요약.
- 10 - TEMPLATES: 노트 템플릿.
- 99 - ARCHIVE: 비활성 자료.
## 안전
- 대규모 구조 변경을 하기 전에 물어보세요.
- 파일을 이동하기 전에 물어보세요.
- 한 번에 다섯 개 이상의 노트를 변경하기 전에 물어보세요.
- 수정한 내용을 요약하세요.
이 파일은 금고를 통제된 작업 공간으로 만듭니다. 에이전트는 단순히 무작위 노트를 읽는 것이 아니라, 정의된 규칙 내에서 운영하고 있습니다.
MCP를 통해 금고 연결하기
보다 고급 설정을 위해 MCP(Model Context Protocol)는 에이전트를 로컬 도구 및 데이터 소스에 연결할 수 있습니다. Claude Code는 Anthropic이 AI 도구 통합을 위한 개방형 표준으로 설명하는 MCP를 통해 외부 도구에 연결하는 것을 지원합니다. 가장 간단한 경로는 여전히 Claude Code가 금고 폴더 내에서 직접 작동하게 하는 것입니다 — 그것이 대부분의 사용자에게는 충분합니다.
보다 고급 경로는 파일 시스템 MCP 서버를 통해 금고를 노출하는 것입니다:
npx -y @modelcontextprotocol/server-filesystem ~/AI-Agent-Brain
그런 다음 클라이언트를 해당 파일 시스템 서버를 사용하도록 구성하세요. 정확한 구성은 클라이언트에 따라 다릅니다 — Claude Desktop, Claude Code, Cursor, Windsurf 또는 기타 MCP 호환 도구입니다.
안전 포인트는 중요합니다: 에이전트에게 전체 홈 디렉토리를 노출하지 마세요. 금고 폴더만 노출하고, 가능하면 클라이언트가 지원하는 경우 읽기 전용 워크플로로 시작하세요.
Git 백업 및 버전 관리
Obsidian Sync는 공식적인 동기화 및 버전 기록을 제공하지만, 일부 기술 사용자는 Git을 선호합니다. Git은 Markdown 파일을 깨끗하게 버전 관리하고 전체 감사 추적을 제공합니다. 금고 내에서:
cd ~/AI-Agent-Brain
git init
git add .
git commit -m "초기 Obsidian 에이전트 두뇌 설정"
.gitignore를 추가하세요:
.Obsidian/workspace*
.Obsidian/cache
.trash/
.DS_Store
정기적으로 커밋하세요:
git add .
git commit -m "프로젝트 및 일일 노트 업데이트"
개인 GitHub 레포지토리에 푸시하려면:
git remote add origin [email protected]:YOUR_USERNAME/ai-agent-brain.git
git branch -M main
git push -u origin main
민감한 노트는 공개 레포지토리에 넣지 마세요. 금고에 사람 노트, 클라이언트 정보, 기록, 사업 계획 또는 개인 결정을 포함하고 있다면, 그것을 기밀 인프라처럼 다루세요.
쓰기 다시 루프
읽기는 시스템의 절반에 불과합니다. 에이전트는 또한 다시 써야 합니다. 만약 그것이 금고를 읽기만 한다면, 금고는 현실에서 멀어질 것입니다. 만약 그것이 부주의하게 쓴다면, 금고는 시끄러워질 것입니다. 좋은 쓰기 다시 루프는 작업이 발생한 후 메모리를 업데이트합니다.
| 이벤트 | 쓰기 다시 행동 |
|---|---|
| 작업 완료됨 | 작업을 완료된 것으로 표시하거나 프로젝트 완료를 업데이트합니다. |
| 새 결정이 이루어졌음 | 결정 노트를 생성합니다. |
| 회의 끝남 | 회의를 요약하고 행동 항목을 추출합니다. |
| 관계가 닿음 | 사람 노트 및 last_contact를 업데이트합니다. |
| 연구 완료됨 | 출처 및 요약과 함께 연구 노트를 작성합니다. |
| 프로젝트가 진행됨 | next_action 및 상태를 업데이트합니다. |
| 열린 루프 발견됨 | 일일 노트에 OPEN: 줄을 추가합니다. |
| 하루가 끝남 | 종료 요약을 추가합니다. |
일일 노트의 간단한 쓰기 다시 규약:
DONE: AI 커리어 기사 초안 완료.
UPDATE: AI 커리어 — 완료: 70
OPEN: Obsidian 에이전트 메모리 기사의 비주얼 선택.
DECISION: "Obsidian은 에이전트를 위한 첫 번째 두뇌로"를 기사 각도로 사용.
그런 다음 에이전트는 일일 노트를 처리하고 관련 파일을 업데이트할 수 있습니다:
오늘의 일일 노트를 읽어라.
DONE, UPDATE, OPEN 및 DECISION으로 시작하는 줄을 처리하라.
- DONE 줄의 경우, 명백한 경우에 일치하는 작업 노트를 업데이트한다.
- UPDATE 줄의 경우, 일치하는 프로젝트 노트를 업데이트한다.
- OPEN 줄의 경우, 그것들을 일일 노트에 보관하고 내일의 브리핑에 포함시킨다.
- DECISION 줄의 경우, 06 - DECISIONS에서 결정 노트를 만든다.
편집하기 전에 변경 사항을 보여줘라.
"편집하기 전에" 조항은 안전 장치입니다. 워크플로가 신뢰할 수 있게 되면, 일부 낮은 위험 업데이트는 자동으로 진행될 수 있습니다.
전사: 금고를 과부하히지 않는 원시 메모리
전사는 강력하지만 위험합니다. 모든 회의, 음성 메모 및 전화를 Obsidian에 처리하지 않고 덤프하면, 금고는 무겁고 시끄러워집니다. 원자료를 위해 07 - TRANSCRIPTS를 사용하지만, 유용한 맥락을 구조화된 노트로 추출하세요.
전사 처리 프롬프트:
이 전사를 읽어라.
다음 생성:
1. 다섯 개의 요약.
2. 결정 목록.
3. 작업 항목 목록.
4. 언급된 사람들.
5. 언급된 프로젝트들.
6. 열린 루프들.
7. 프로젝트 노트나 사람 노트에 대해 업데이트해야 할 사항.
아직 파일을 업데이트하지 마라. 먼저 제안된 변경 사항을 보여줘라.
검토 후, 에이전트에게 05 - MEETINGS에서 회의 노트를 작성하고, 필요할 경우 06 - DECISIONS에서 결정 노트를 작성하고, 관련 프로젝트 노트에 대한 업데이트 및 일일 노트에서 OPEN: 항목을 추가하라고 요청하세요. 이렇게 하면 전사가 저장소가 아닌 메모리로 바뀝니다.
연구 노트: 복합적인 외부 맥락
에이전트는 내부 메모리가 필요하지만, 신선한 외부 맥락도 필요합니다. 연구가 대화 내에만 존재하면 사라집니다. 연구가 노트가 되면, 그것은 복합됩니다. 도구 비교, 시장 노트, 회사 조사, 기술 설명, 출처 요약 및 경쟁 분석을 위해 08 - RESEARCH를 사용하세요.
---
type: research
topic: Obsidian agent memory
date: 2026-05-22
status: active
source_quality: mixed
related_project: AI Career
---
# 연구: Obsidian 에이전트 메모리
## 요약
중요한 것은 무엇인지.
## 주요 발견
- 발견 1
- 발견 2
- 발견 3
## 출처
- 출처 1
- 출처 2
## 영향
이것이 무엇을 변경하는지.
## 후속 조치
다음에 조사할 사항.
연구는 항상 프로젝트 및 결정과 연결되어야 합니다. 그렇지 않으면, 아무도 사용하지 않는 도서관이 됩니다.
30일 구현 계획
하루 만에 전체 시스템을 구축하지 마세요. 최소 버전을 구축하고 사용한 다음, 가치가 생기는 곳에서 구조를 추가하세요.
Week 1: Build the memory skeleton
Create the vault folders, install Obsidian, and create templates for daily notes, projects, people, and tasks. Start with only a few fields: type, status, priority, deadline, and next_action. Do not install ten plugins — install Dataview only when you are ready to build the dashboard.
Goal for week 1: 5 project notes, 10 people notes, daily notes for the week, and one simple dashboard structure.
Week 2: Add the dashboard
Install Dataview and create the first dashboard sections: today's priorities, active projects, upcoming deadlines, people to contact, and open loops. Do not obsess over perfect queries. The dashboard should answer one question: what matters today?
Goal for week 2: Dashboard that updates from notes, OPEN: convention in daily notes, morning briefing prompt saved.
Week 3: Connect an agent
Install Claude Code or connect an MCP-compatible assistant to the vault. Start read-only: ask it to read the dashboard and generate a morning briefing. Do not let it edit notes yet.
Goal for week 3: Agent can read dashboard, agent can produce morning briefing, briefings saved in 09 - BRIEFINGS.
Week 4: Add controlled write-back
Let the agent update low-risk files: append to daily notes, create briefing notes, create draft decision notes, or propose project updates. Require approval before edits that affect project status, people notes, or multiple files.
Goal for week 4: Agent can propose updates, agent can write approved briefings, agent can extract decisions and open loops, weekly review generated from the vault. By day 30, you should spend less time re-explaining context and more time reviewing synthesis.
일반적인 실수들
1. 분류법을 과도하게 구축하기
거대한 금고 분류법은 생산적으로 느껴지지만 보통 무너집니다. 실제 작업을 지원하는 가장 작은 구조부터 시작하세요.
2. 일관성이 없는 속성
어떤 프로젝트 노트가 deadline을 사용하고, 다른 노트는 due를 사용하고, 또 다른 노트는 target_date를 사용하면, 쿼리가 깨질 것입니다. 필드 이름을 선택하고 고수하세요.
3. 모든 생각을 작업으로 만들기
모든 것이 작업 시스템에 속하는 것은 아닙니다. 일부 항목은 열린 루프이고, 일부는 결정이며, 일부는 노트이고, 일부는 원시 맥락입니다.
4. 전사를 처리하지 않고 덤프하기
원시 캡처는 중요한 맥락이 구조화된 메모리로 추출될 수 있을 때만 유용합니다.
5. 에이전트가 너무 빨리 너무 많이 편집하게 하기
읽기 전용 분석으로 시작한 후, 초안만 변경한 다음, 승인된 쓰기로 전환하세요. 완전한 자율성은 당연시되지 않고 얻어져야 합니다.
6. 대시보드 데이터와 판단을 혼동하기
대시보드는 존재하는 것을 보여줍니다. 브리핑은 그것이 의미하는 바를 설명합니다.
최소한의 유효한 Obsidian 에이전트 두뇌
가장 작은 유용한 설정은 복잡하지 않습니다. 필요합니다: 하나의 Obsidian 금고, 일일 노트, 프로젝트, 사람 및 작업을 위한 폴더, 대시보드, Dataview, 아침 브리핑 프롬프트, 신중한 에이전트 연결 및 중요한 출력을 다시 쓰도록 하는 규칙입니다.
최소 명령줄 설정:
mkdir -p "AI-Agent-Brain"/{"00 - DASHBOARD","01 - DAILY","02 - PROJECTS","03 - PEOPLE","04 - TASKS","09 - BRIEFINGS","10 - TEMPLATES"}
cd "AI-Agent-Brain"
그런 다음 02 - PROJECTS/AI Career.md에 당신의 첫 번째 프로젝트 노트를 추가하세요:
---
type: project
status: active
priority: high
deadline: 2026-06-15
owner: Vincent
next_action: Obsidian 에이전트 메모리 기사를 초안 작성
completion: 20
---
# AI Career
## 목표
AI 직업, 도구, 창립자 리소스 및 에이전트 워크플로를 위한 최상의 리소스를 구축합니다.
## 현재 상태
여러 기사가 초안되었습니다. Obsidian 에이전트 두뇌 기사가 다음입니다.
## 노트
실용적인 가이드, 강력한 시각 자료 및 구조화된 비교에 집중하세요.
Obsidian에서 폴더를 열고 Dataview를 활성화하면 시스템이 시작됩니다.
최종 보기
Obsidian은 유행한다고 해서 에이전트에게 가치 있는 것이 아닙니다. 그것은 에이전트에게 사용자가 소유하는 내구성 있는, 읽기 쉬운, 구조화된 메모리 레이어를 제공하기 때문에 가치가 있습니다.
어시스턴트는 맥락이 세션 간에 지속되지 않는 한 유용해질 수 없습니다. 프로젝트, 사람, 결정, 회의, 전사, 열린 루프 및 우선 순위는 모두 채팅 창을 넘어 어딘가에 존재해야 합니다. Obsidian은 메모리를 넣기에 가장 간단한 장소 중 하나입니다. 로컬이고, Markdown 기반이며, 링크 가능하고, 쿼리 가능하며 유연합니다.
실용적인 경로는 분명합니다: 작은 금고로 시작하고 일관된 속성을 추가하며, 수동으로 정보를 저장하는 것이 아니라 노트에서 읽는 대시보드를 구축하고, 에이전트를 사용하여 아침 브리핑을 생성한 다음, 점진적으로 쓰기 다시, 전사 처리, 연구 노트 및 제어된 업데이트를 추가하는 것입니다.
그 결과는 단순히 더 나은 노트 작성 시스템이 아닙니다. 그것은 AI 에이전트를 위한 작업 메모리 레이어입니다. 그것이 진정한 변혁입니다: 에이전트는 더 이상 제로에서 시작하지 않습니다. 그것은 당신의 세상에서 시작합니다.
Frequently Asked Questions
Obsidian은 모든 노트를 자신의 장치에 일반 Markdown 파일로 저장하는 로컬 노트-taking 앱입니다. AI 에이전트 메모리에 좋은 이유는 에이전트와 스크립트가 복잡한 API 없이도 이러한 파일을 직접 읽을 수 있고, 노트에 쿼리 가능하도록 구조화된 YAML 전면 정보를 포함할 수 있으며, Dataview 플러그인이 금고를 경량 라이브 데이터베이스로 바꾸기 때문입니다. 클라우드 기반 도구와 달리 금고는 전적으로 사용자 통제 하에 있습니다.
네. 핵심 Obsidian 앱은 개인 용도로 제한 없이 무료입니다. 선택적 유료 추가 기능으로는 암호화된 다중 기기 동기화를 위한 Obsidian 동기화(연간 청구 시 $4/월 또는 월별 $5/월)와 노트를 웹사이트로 게시하기 위한 Obsidian 게시(연간 청구 시 $8/월 또는 월별 $10/월)가 있습니다. AI 에이전트 메모리 시스템의 경우 대부분의 사용자는 무료 앱과 무료 Dataview 커뮤니티 플러그인만 필요합니다.
Dataview는 Obsidian을 위한 무료 커뮤니티 플러그인으로, 노트 위에서 실시간 인덱스 및 쿼리 엔진 역할을 합니다. 노트에 메타데이터 필드를 추가하고 해당 필드를 쿼리하여 동적 표, 목록 및 대시보드를 생성하는 데 도움을 주며, 노트가 변경될 때 자동으로 업데이트됩니다. AI 에이전트 두뇌에 대해 Dataview는 Markdown 파일 폴더를 쿼리 가능한 운영 대시보드로 바꾸는 역할을 합니다 — 오늘의 우선순위, 진행 중인 프로젝트, 다가오는 마감일 및 연락할 사람들을 자동으로 보여줍니다.
공식 설치 프로그램(curl -fsSL https://claude.ai/install.sh | bash) 또는 npm(npm install -g @anthropic-ai/claude-code)을 통해 Claude Code를 설치합니다. 터미널에서 금고 폴더로 이동합니다(cd ~/AI-Agent-Brain) 그리고 'claude'를 실행합니다. 그러면 Claude Code가 금고에 있는 Markdown 파일을 읽고 쓸 수 있습니다. 수정할 수 있는 폴더와 실행 전에 승인해야 하는 작업에 대한 규칙이 포함된 CLAUDE.md 파일을 금고 루트에 추가합니다.
CLAUDE.md 파일은 금고의 루트에 배치된 규칙 파일로, AI 에이전트가 금고 내에서 작업할 때 어떻게 행동해야 하는지를 알려줍니다. 어떤 폴더가 어떤 목적을 수행하는지, 에이전트가 변경할 수 있는 것과 변경할 수 없는 것, 편집 전에 언제 질문해야 하는지, 템플릿 및 YAML 전면 정보를 처리하는 방법, 한 번에 다섯 개 이상의 노트를 변경하기 전에 승인을 요구하는 등 안전 경계를 정의합니다. 이를 통해 각 에이전트 세션이 권한 및 맥락에 대해 새롭게 협상하는 것을 방지합니다.
Claude Code 또는 다른 에이전트를 금고 폴더에 지정한 후, 대시보드 노트와 모든 링크된 파일을 읽도록 요청하는 프롬프트를 제공합니다. 데이터를 종합하도록 지시합니다 - 요약이 아니라: 가장 중요한 우선 순위를 식별하고, 정오 전에 주의를 요구하는 것, 오늘 위험에 처한 것, 주의가 필요한 관계, 및 우선 순위로 결정해야 할 내용을 알려줍니다. 중요한 지시는 '테이블을 설명하지 말고, 그 의미를 말해줘.' 결과를 09 - BRIEFINGS에 저장하거나 오늘의 일일 노트에 추가합니다.
네, 에이전트는 금고에 있는 Markdown 파일을 편집하여 Obsidian에 다시 쓸 수 있습니다. 안전한 접근 방식은 점진적으로 다시 쓰기를 구축하는 것입니다: 읽기 전용 분석으로 시작한 후, 에이전트가 저장 전에 보여주는 제안으로 이동하고, 일일 노트 및 브리핑과 같은 저위험 파일에 대한 승인된 다시 쓰기로 진행합니다. 에이전트가 프로젝트 노트, 사람 노트 또는 한 번에 다섯 개 이상의 파일을 수정하기 전에 명시적으로 승인을 요구합니다. CLAUDE.md 규칙 파일과 '편집 전 변경 사항을 보여줘'라는 지시는 주요 안전 메커니즘입니다.