Lab 02: Obsidian LLM 위키에 내 프로젝트 세팅하기

• Lab 01에서 만든 LLM-Wiki를 열고 개인 프로젝트 공간을 확인합니다.
• 프로젝트 홈에 목적, 결과물, 현재 상태를 정리합니다.
• 업무 기준, 참고 지식, 결정 기록, 워크플로우 후보를 서로 연결합니다.
• 어떤 LLM 에이전트를 쓰더라도 다시 읽을 수 있는 프로젝트 맥락을 남깁니다.
• 팀 프로젝트를 시작한 뒤에도 개인 작업 맥락을 이 위키에 계속 축적할 준비를 합니다.

개인 LLM 위키는 단순한 자료 저장소가 아닙니다. 사람에게는 자신의 작업이 어떻게 연결되어 왔는지 이해하는 지식 그래프이고, AI 에이전트에게는 지금까지의 작업 맥락을 다시 읽을 수 있는 장기기억 저장소입니다.

Obsidian은 이 위키를 사람이 탐색하는 프론트엔드처럼 동작합니다. 노트 사이에 [[wikilink]]를 만들면 Graph view와 Backlinks에서 자료, 기준, 결정, 워크플로우 후보가 어떻게 이어지는지 볼 수 있습니다.

반대로 Codex, Claude Code, Kiro 같은 에이전트는 같은 Markdown 파일을 읽고 수정하는 작업 환경입니다. 사람이 Obsidian에서 보는 폴더와 에이전트가 읽는 폴더는 같은 폴더입니다. 따라서 기록이 쌓일수록 에이전트는 대화창 하나에 갇히지 않고, 이전 작업의 기준과 맥락을 다시 읽으며 이어서 일할 수 있습니다.

이 과정의 목적은 노트앱을 예쁘게 꾸미는 것이 아닙니다. 머릿속 감각으로 처리하던 업무 기준을 파일로 꺼내는 것입니다.

변화	의미
암묵지	나만 감으로 알고 있는 판단, 기준, 예외
명시지	다른 사람과 에이전트에게 설명할 수 있는 노트, 카드, 결정 기록
프로젝트 기억	특정 결과물을 만들기 위해 쌓은 기준, 자료, 판단, 실행 맥락
Skill 후보	반복 패턴을 에이전트가 다시 수행할 수 있게 묶은 작업 단위

이 워크숍에서는 처음 길을 잃지 않도록 최소 구조를 추천합니다. 하지만 이 구조를 정답처럼 그대로 유지하는 것이 목표는 아닙니다. LLM-Wiki는 각자가 계속 사용할 개인 작업 기억이기 때문에, 실제로 쓰면서 자신의 프로젝트와 작업 방식에 맞게 조정해 나가는 것이 중요합니다.

기본으로 유지하면 좋은 구조는 세 가지입니다.

LLM-Wiki/
├── 00-inbox/
├── 10-projects/
└── 90-archive/

폴더	역할
00-inbox	아직 정리되지 않은 자료, 링크, 대화, 아이디어를 임시로 받는 곳
10-projects	실제 결과물과 연결되는 프로젝트별 작업 기억을 쌓는 곳
90-archive	끝났거나 지금은 쓰지 않지만 보관할 자료를 옮기는 곳

프로젝트 내부 구성은 추천 예시일 뿐입니다. 처음에는 아래처럼 단순하게 시작합니다. 여기서 {project-name}은 본인이 정한 프로젝트 폴더 이름입니다.

10-projects/{project-name}/
├── README.md
├── work-criteria-card.md
├── knowledge-card.md
├── decision-log.md
├── progress.md
└── workflow-card.md

사용하다 보면 프로젝트에 따라 다른 구조가 더 편할 수 있습니다. 자료가 많아지면 references, notes, decisions, workflows 같은 하위 폴더를 만들 수 있고, 하나의 카드가 길어지면 여러 노트로 나눌 수도 있습니다.

중요한 기준은 폴더 이름이 아닙니다. 내 일이 어떤 입력에서 시작되고, 어떤 기준으로 판단되며, 어떤 결과물로 이어지는지 패턴이 남아야 합니다. 사람이 다시 봐도 이해되고, 에이전트가 읽어도 그 패턴을 따라 다음 작업을 이어가거나 비슷한 작업을 다시 수행할 수 있어야 합니다.

Lab 02는 새 노트앱을 꾸미는 시간이 아닙니다. Lab 01에서 만든 LLM-Wiki 안에 내가 하고 싶은 프로젝트 하나를 세팅하는 시간입니다.

아직 다운로드하지 않았다면 아래 파일을 받아도 됩니다. 이미 LLM-Wiki 폴더가 있다면 같은 폴더를 그대로 사용합니다. 이미 작성한 파일이 있다면 새 템플릿으로 덮어쓰지 않습니다.

먼저 아래 파일이 있는지 확인합니다. 템플릿에는 시작용 폴더 my-project가 들어 있습니다. 이 이름은 고정값이 아닙니다. 본인이 시작할 프로젝트가 들어갈 자리이며, 이번 단계에서 실제 프로젝트 이름으로 바꾸어 사용합니다.

파일	확인할 내용
00-start-here.md	주요 노트로 이동하는 시작 링크
00-inbox/workflow-candidates.md	Lab 01에서 적은 결과물 후보와 선택 이유
00-inbox/trend-note.md	Lab 01의 URL 실습에서 만든 트렌드 노트
10-projects/{project-name}/README.md	내 프로젝트 홈
10-projects/{project-name}/work-criteria-card.md	선택한 결과물의 목적, 입력, 기준, 완료 조건
10-projects/{project-name}/knowledge-card.md	프로젝트에 필요한 자료와 해석
10-projects/{project-name}/decision-log.md	중요한 선택과 이유
10-projects/{project-name}/progress.md	오늘 한 일, 확인한 것, 남은 일
10-projects/{project-name}/workflow-card.md	반복 업무와 Skill, Hook 후보

템플릿을 그대로 열면 {project-name} 자리에 my-project가 들어 있습니다. 이 폴더 이름을 자신의 프로젝트에 맞게 바꿉니다. 예를 들어 content-factory, team-report-helper, research-wiki처럼 프로젝트가 무엇을 만들려는지 드러나는 이름이 좋습니다. Obsidian에서 폴더명을 바꾸면 연결된 링크가 함께 갱신되는지 확인합니다.

Obsidian에서 00-start-here.md를 열고 연결된 노트를 따라가 봅니다. 그다음 Graph view나 Backlinks에서 workflow-candidates, trend-note, work-criteria-card, progress, workflow-card가 서로 연결되어 있는지 확인합니다.

프로젝트 홈은 에이전트에게 “이 프로젝트가 무엇인지” 알려주는 시작점입니다. 새로운 LLM 에이전트를 열었을 때도 이 파일을 먼저 읽히면 프로젝트의 목적과 현재 상태를 빠르게 공유할 수 있어야 합니다.

10-projects/{project-name}/README.md에 아래 항목을 채웁니다.

# 프로젝트 이름

## 이 프로젝트는 무엇을 만드는가
-

## 왜 이 프로젝트를 하는가
-

## 최종 결과물
-

## 현재 상태
-

## 에이전트가 먼저 읽을 노트
- [[work-criteria-card]]
- [[knowledge-card]]
- [[decision-log]]
- [[progress]]
- [[workflow-card]]

그다음 work-criteria-card.md를 확인합니다. Lab 01에서 이미 작성했다면 부족한 부분을 보강하고, 아직 비어 있다면 프로젝트 홈을 기준으로 채웁니다.

업무 기준 카드는 좋은 결과와 부족한 결과를 구분하는 기준입니다. AI에게 일을 맡길 때 가장 먼저 필요한 것도 이 기준입니다.

특히 아래 항목은 반드시 적습니다.

항목	질문
목적	왜 이 결과물이 필요한가
입력	무엇을 넣고 시작하는가
좋은 결과의 기준	어떤 결과물이 쓸 만한가
예외와 중단 조건	언제 멈추거나 사람에게 물어봐야 하는가
완료 기준	끝났다고 말할 수 있는 상태는 무엇인가

00-inbox는 임시 보관함입니다. 아직 어디에 쓸지 정해지지 않은 링크, 대화, 후보, 트렌드 노트를 먼저 받습니다.

Lab 02에서는 00-inbox/trend-note.md를 그대로 복사하지 않습니다. work-criteria-card.md와 연결해, 내 프로젝트에 필요한 지식으로 다시 정리합니다.

이번 단계에서 읽을 파일은 세 가지입니다.

파일	역할
00-inbox/trend-note.md	정리 전 자료
10-projects/{project-name}/work-criteria-card.md	어떤 기준으로 볼지 알려주는 프로젝트 맥락
10-projects/{project-name}/knowledge-card.md	프로젝트 안에 남길 정리된 지식

에이전트에게는 다음처럼 요청할 수 있습니다.

너는 내 LLM-Wiki를 정리하는 리서치 보조자다.

읽을 파일:
- 00-inbox/trend-note.md
- 10-projects/{project-name}/README.md
- 10-projects/{project-name}/work-criteria-card.md
- 10-projects/{project-name}/knowledge-card.md

작업:
1. trend-note.md에서 내 프로젝트와 관련 있는 내용을 고른다.
2. 프로젝트 홈과 업무 기준 카드의 목적, 입력, 좋은 결과 기준과 연결한다.
3. knowledge-card.md 템플릿에 맞춰 한 줄 요약, 핵심 내용, 내 업무와의 연결을 작성한다.
4. AI에게 맡길 수 있는 일과 사람이 검토해야 할 일을 분리한다.
5. 관련 노트에는 [[trend-note]], [[work-criteria-card]], [[progress]], [[workflow-card]] 링크를 남긴다.

지식 카드는 단순 요약이 아닙니다. 원문 내용, 내 해석, 내 업무와의 연결, AI에게 맡길 일, 사람이 검토할 일을 나누어 적는 카드입니다.

프로젝트를 시작했다면 선택 이유, 진행 상태, 다음 실행 후보를 남겨야 합니다. 그래야 나중에 다른 에이전트를 쓰더라도 왜 이 프로젝트를 시작했는지, 어디까지 진행했는지, 어떤 방향으로 이어가야 하는지 다시 설명할 수 있습니다.

먼저 decision-log.md에 이번 결정을 남깁니다.

# Decision: 내 첫 LLM-Wiki 프로젝트를 시작한다

## 결정
- 이 프로젝트를 개인 LLM-Wiki의 첫 프로젝트로 세팅한다.

## 결정 이유
- 내가 반복해서 만들고 싶은 결과물과 연결된다.
- 입력과 출력이 설명 가능하다.
- 이후 Skill과 Hook으로 확장할 반복 작업이 있다.

## 관련 노트
- [[00-inbox/workflow-candidates]]
- [[work-criteria-card]]
- [[knowledge-card]]
- [[progress]]
- [[workflow-card]]

그다음 progress.md에는 오늘의 진행 로그를 남깁니다. 진행 로그는 완성된 문서가 아니라 이어달리기 기록입니다. 작업이 중간에 멈춰도 사람이 다시 보거나 에이전트가 읽고 이어서 진행할 수 있어야 합니다.

# 진행 로그

## YYYY-MM-DD

### 오늘 한 일
- LLM-Wiki를 열고 프로젝트 폴더를 실제 프로젝트 이름으로 바꿨다.
- 프로젝트 홈, 업무 기준 카드, 지식 카드 초안을 작성했다.

### 확인한 것
- 좋은 결과의 기준을 3개 이상 적었다.
- 참고 자료와 프로젝트 목적이 연결되는지 확인했다.

### 남은 일
- workflow-card.md에 반복 업무 후보를 더 구체화한다.
- 팀 프로젝트가 시작되면 개인 위키 안에 팀 프로젝트 폴더를 추가한다.

### 다음에 에이전트에게 읽힐 파일
- [[README]]
- [[work-criteria-card]]
- [[knowledge-card]]
- [[decision-log]]
- [[workflow-card]]

마지막으로 workflow-card.md에는 아직 완성된 자동화가 아니라, 반복될 가능성이 있는 작업 후보만 적습니다.

항목	작성할 내용
반복 업무	앞으로 여러 번 하게 될 일
입력	매번 들어오는 자료나 요청
처리 단계	사람이 설명할 수 있는 순서
최종 산출물	끝나면 남아야 하는 파일이나 결과
검증 기준	좋은 결과인지 확인할 기준
Skill 후보	나중에 에이전트에게 반복 실행시킬 수 있는 부분
Hook 후보	커밋, PR, 파일 저장처럼 자동으로 검사하거나 실행할 지점

이 워크숍에서는 개인 위키를 만든 뒤 팀 프로젝트로 확장합니다. 이때 중요한 것은 GitHub 저장소와 개인 LLM-Wiki가 서로 다른 층의 기록이라는 점입니다.

팀 GitHub 저장소는 하나의 팀 프로젝트에 대한 공동 기록입니다. 반면 개인 LLM-Wiki는 내가 참여하는 여러 프로젝트의 작업 기억을 프로젝트별로 쌓는 개인 저장소입니다. 그 프로젝트는 때로는 혼자 진행하는 개인 프로젝트이고, 때로는 팀 저장소와 연결된 팀 프로젝트가 됩니다.

공간	역할
팀 GitHub 저장소	특정 팀 프로젝트 하나의 공식 작업 공간. 브랜치, 커밋, PR, README, 리뷰, 합의된 기록이 남습니다.
개인 LLM-Wiki	여러 개인/팀 프로젝트를 가로질러 내가 이해한 맥락, 맡은 작업의 기준, 에이전트에게 다시 읽힐 기억이 프로젝트별로 쌓입니다.

지금 만드는 10-projects/{project-name}은 개인 프로젝트 하나의 예시입니다. 이후 팀 프로젝트를 시작하면 같은 LLM-Wiki 안에 팀 프로젝트용 폴더를 추가할 수 있습니다.

LLM-Wiki/
└── 10-projects/
    ├── {personal-project}/
    └── team-project/

팀 저장소에는 팀이 공유해야 할 결과와 합의된 기록을 남깁니다. 개인 LLM-Wiki에는 내가 그 팀 프로젝트에서 이해한 배경, 맡은 일, 판단 기준, 에이전트에게 다시 읽힐 맥락을 남깁니다.

이렇게 하면 한 팀 저장소에서 함께 일하면서도 각자는 자기만의 방식으로 에이전트에게 읽힐 장기기억을 쌓을 수 있습니다. 핵심은 하나입니다. 팀 저장소에는 함께 합의할 기록을 남기고, 개인 LLM-Wiki에는 내가 다음 작업을 이어가기 위해 필요한 맥락을 남깁니다.