흩어진 회고와 인계 파일을 경로 링크 색인으로 모으기
2026.10.22

소개
3주차 강의에서 야호심 님이 정리한 PKM, 제텔카스텐, LLM 위키의 역할 구분을 기준으로, 제 작업 폴더 여러 곳에 흩어진 회고와 인계 파일 24개를 원본 이동 없이 경로 링크 색인 한 장으로 모으고 그 상태를 명령어로 쟀습니다. 쓰던 AI 세션의 인계 문서가 여기저기 쌓여 있는데 어디에 무엇이 있는지 한눈에 찾지 못하는 분, 파일을 옮기지 않고 연결부터 시도해 보고 싶은 분이 읽으면 도움이 될 것 같습니다.
3주차는 야호심 님의 설명과 수강생 사례 발표 여섯 건으로 짜인 세션이었습니다. 야호심 님은 1년 동안 AI 워크스페이스를 만들며 PKM, 제텔카스텐, LLM 위키를 차례로 만났다고 소개하고, 세 개념을 각각 설명하는 파일 세 개와 실습 프롬프트를 나눠 주었습니다. 프롬프트는 세 문장입니다. 이 파일이 무엇인지 설명해 달라, 지금 내 워크스페이스를 이 개념에 비춰 분석해 달라, 그래서 어떻게 하면 좋을지 제안하고 이끌어 달라는 내용입니다. 야호심 님이 자기 환경에서 돌려 읽어 준 결과에는 네 층의 역할 구분이 있었습니다. 기존 노트는 그날 배운 것을, PKM 검색은 자료가 어디 있는지를, 제텔카스텐식 연결은 이 생각이 다른 생각과 왜 연결되는지를, LLM 위키는 여러 자료를 종합한 현재의 이해와 바뀐 점을 맡는다는 것입니다.
저는 이번 기수에 이 스터디를 청강합니다. 2주차 글 끝에 적은 계획 가운데 "회고, 인계 파일 20개가 8곳에 있고 허브에는 0개이니 원본은 옮기지 않고 경로 링크로만 모아 본다"를 이번 주 작업으로 골랐습니다. 측정은 2026-10-22에 했고, 측정 대상 폴더와 저장소는 읽기만 했습니다. 2주차 계획 아홉 가지의 실행 여부도 같은 날 확인했습니다.
진행 방법
사용 도구: Claude Code, Python 3(st_birthtime으로 파일 생성 시각 확인), pytest, git(읽기 명령만)
Step 1. 강의 기준의 질문 표
강의 내용 가운데 명령어로 셀 수 있는 것만 골랐습니다. 세 파일 원문은 카카오톡으로만 배포되어 저는 받지 못했으므로 프롬프트를 파일 그대로 돌리지는 못했습니다. 대신 야호심 님이 읽어 준 역할 구분의 질문을 기준으로 삼았습니다.
강의의 층 | 강의가 던진 질문 | 이번에 잰 것 |
|---|---|---|
PKM 검색 | 자료가 어디 있는가 | 회고, 인계 파일이 색인 한 장에서 열리는가 |
제텔카스텐식 연결 | 이 생각이 다른 생각과 왜 연결되는가 | 파일 사이에 이어지는 근거가 있는가 |
LLM 위키 | 현재의 이해는 무엇이며 무엇이 바뀌었는가 | 인계 문서가 저장소의 현재 상태를 따라오는가 |
2주차 이월 | 속성으로 노트를 잇는다 | 허브의 속성과 연결 키 기준선 |
Step 2. 측정 스크립트 재사용
2주차 스크립트를 기간만 바꿔 그대로 다시 돌렸습니다. 한 가지는 고쳤습니다. 2주차에는 원격 정보를 갱신하려고 git fetch를 썼는데, 이번에는 읽기 전용 원칙에 맞춰 뺐습니다. 3주차 기간은 9월 23일부터 10월 22일까지 30일이고, 2주차 기간(9월 15일부터 10월 14일)도 같은 스크립트로 다시 셌습니다.
KMP_DUPLICATE_LIB_OK=TRUE OMP_NUM_THREADS=1 python3 -I 24기AI워크스페이스_3주차_측정.py
회고, 인계 파일의 정의는 2주차와 같습니다. 새 기록 가운데 파일 이름에 회고, retro, reflection, worklog, 일지, HANDOFF, session이 들어간 것입니다.
Step 3. 검사를 먼저 쓴 색인 생성기
색인을 만드는 코드는 숫자를 내므로 검사를 먼저 썼습니다. 모의 파일로 참값을 아는 경우를 만들었습니다. 종류 판정, 본문에 다른 파일 이름이 나오면 잇는 규칙, 색인의 링크 수가 파일 수와 같은지(왕복), 같은 입력이면 같은 출력이 나오는지, 파일이 사라지면 열리지 않는 링크를 세는지를 검사합니다.
python3 -m pytest -q test_build_retro_index.py
모듈이 없는 상태에서 먼저 실패하는 것을 확인했고, 구현 뒤 10개가 통과했습니다. 규칙 한 줄을 일부러 망가뜨린 사본에서는 해당 검사가 실패하는 것도 확인했습니다. 실제 파일에 돌려 보니 관계가 12쌍으로 나왔는데, HANDOFF.md라는 이름이 저장소 경계를 넘어 다른 저장소의 같은 이름 파일로 이어진 5쌍이 섞여 있었습니다. 이 경우를 검사 두 개로 추가하고 같은 저장소 안에서만 잇게 고쳐 7쌍이 되었습니다. 최종 검사는 12개입니다.
Step 4. 색인 만들기
python3 -I build_retro_index.py
측정 결과의 목록에서 파일 24개를 읽어 곳별로 묶고, 종류, 수정일, 크기, 첫 제목 줄과 함께 절대 경로 마크다운 링크로 적었습니다. 파일을 옮기거나 고치지 않았고, 색인은 이 스터디 폴더의 3주차/실습/에만 두었습니다. 색인 파일 이름에는 회고나 인계라는 낱말을 넣지 않았습니다. 넣으면 다음 측정에서 색인 자신이 회고 파일로 세어집니다.
Step 5. 인계 파일의 신선도
git 저장소 안에 있는 인계 파일 13개에 대해 저장소의 마지막 커밋일에서 파일 수정일을 뺐습니다. 양수이면 파일이 코드보다 오래된 것입니다.
git -C <저장소> log -1 --format=%cd --date=short

결과와 배운 점
측정 결과 (2026-10-22, 기간 9/23~10/22, ~/knowledge-hub, ~/Documents, ~/projects 기준)
항목 | 값 |
|---|---|
색인에 모은 파일 | 24개, 8곳. 열리는 링크 38/38(파일 24개와 관계 링크 14개) |
종류 | 인계 18, 회고 2, 사본 2, 이름만 겹침 2 |
허브 안의 회고, 인계 파일 | 0개 |
서로 이어진 파일 | 7쌍, 파일 9/24개 |
인계 파일의 뒤처짐 | git 안 13개 중 5개. 인계 문서(HANDOFF 류) 7개로 좁히면 3개 |
같은 기간 재측정 | 2주차 글의 20개, 8곳이 14개, 6곳으로 |
내 새 기록, 남의 글 | 2,740개, 13,198개 |
허브 새 기록 | 89개 그대로, 비율 4.7%에서 3.2% |
본문 있는 커밋 | 599개 중 335개(55.9%). 2주차 73.0% |
2주차 계획 아홉 가지의 실행 결과
2주차 계획 | 실행 여부 | 확인한 값 |
|---|---|---|
허브 커밋과 원격 결정 | 하지 않았습니다 | 원격 0, 커밋하지 않은 변경 147건, 마지막 커밋 8월 31일 |
허브에 인박스 폴더 | 하지 않았습니다 | 인박스 폴더 0개 |
남의 글 12,873개의 위치 | 정하지 않았습니다 | 10월 15일 이후 허브 |
3주차 기준선 | 했습니다 | 같은 스크립트로 재서 아래 표에 둠 |
옵시디언 설치와 열기 | 하지 않았습니다 | 앱 없음, |
회고 파일 모으기 | 했습니다 | 이번 글의 색인 |
| 하지 않았습니다 |
|
재측정 항목 | 했습니다 | 위 표 |
측정 스크립트 보관 | 했습니다 | 2주차 스크립트를 복제해 재사용 |
강의 기준으로 읽은 결과

자료가 어디 있는지(PKM 검색)는 해결됐습니다. 8곳의 24개가 색인 한 장에서 열립니다. 종류를 나눠 보니 2주차에 "회고 20개"라고 부르던 것은 대부분 인계 문서였습니다. 이번 24개 가운데 회고는 2개이고 18개가 HANDOFF와 SESSION 기록입니다. 회고를 모으려던 계획이 실제로는 인계 기록을 모으는 일이었습니다.
파일이 왜 이어지는지(제텔카스텐식 연결)는 일부만 잴 수 있었습니다. 본문에 다른 파일 이름이 나오는 것은 검증 가능한 연결이라 7쌍을 찾았고, 24개 중 15개는 어디와도 이어지지 않았습니다. 다만 이름이 언급된다는 사실은 "왜" 이어지는지가 아닙니다. 야호심 님이 예로 든 관계 문장("이 회고는 새 프로젝트를 시작할 때 시간과 에너지를 먼저 검토하는 차례다")은 파일 내용을 읽고 판단해야 쓸 수 있어, 이번에는 쓰지 못했습니다.
현재의 이해가 따라오는지(LLM 위키)는 문서마다 달랐습니다. 인계 문서 7개 중 3개가 저장소 마지막 커밋보다 1일에서 4일 오래되었습니다. 뒤처짐 10일로 가장 긴 둘은 날짜가 붙은 세션 기록이라 마지막 커밋 뒤에 갱신될 이유가 없는 파일입니다. 반대로 한 분석 저장소는 8월 28일 이후 커밋이 없는데 인계 문서는 9월 24일에 수정되었고, 이 저장소에는 커밋하지 않은 변경이 161건 있습니다.
속성으로 노트를 잇는 기준선은 한 주 동안 그대로였습니다. 허브는 10월 11일 이후 새 파일이 없었고, 허브 비율이 4.7%에서 3.2%로 내려간 것은 분모인 내 새 기록이 늘었기 때문입니다.

측정 정의의 함정 두 가지
생성 시각으로 세면 덮어써 저장한 문서가 새 파일로 다시 잡힙니다. 같은 기간을 같은 스크립트로 다시 세니 2주차 글의 회고, 인계 파일 20개, 8곳이 14개, 6곳이 되었습니다. 원인 하나는 확인했습니다. 한 저장소의 HANDOFF.md는 git에 처음 들어온 날이 10월 3일인데 파일 생성 시각은 10월 20일이고, 다른 저장소의 HANDOFF.md는 9월 25일에 처음 들어왔는데 생성 시각이 10월 9일입니다. 도구가 파일을 새로 써서 교체하면 생성 시각이 다시 찍힙니다. 두 파일로 이 현상은 확인했지만, 6개가 줄어든 전부를 이것만으로 설명하지는 못했습니다. 같은 기간의 내 새 기록(1,908개가 2,023개)과 남의 글(12,873개가 13,198개)도 늘었는데, 2주차 측정을 한 10월 14일 이후에 같은 날 생긴 파일일 수 있으나 확인하지 못했습니다.

본문 있는 커밋 비율 73.0%가 55.9%로 내려간 것은 한 저장소 때문이었습니다. 해커톤 저장소 B의 커밋 165개 중 본문이 있는 것은 15개(9.1%)이고, 이 저장소를 빼면 434개 중 320개(73.7%)입니다. 이 저장소는 커밋 제목 길이의 중앙값이 74자여서 설명이 제목에 담겨 있을 수 있으나, 원인은 확인하지 못했습니다. 본문 유무만으로는 커밋 기록의 질을 재기 어렵다는 점이 남았습니다.
시행착오
처음 관계를 12쌍으로 세었다가, 같은 이름의 파일이 다른 저장소로 이어진 것을 걸러 7쌍으로 줄였습니다.
git 로그의 날짜 서식을
%cs로 적었다가 이 환경의 git이 읽지 못해--date=short로 바꿨습니다.색인 이름에 회고나 인계를 넣지 않은 것은 사전에 정한 조치이고, 다음 측정에서 효과가 있는지는 아직 확인하지 못했습니다.
하지 못한 것
세 실습 파일을 받지 못해 실습 프롬프트 1을 그대로 돌리지 못했습니다.
관계 문장을 쓰려면 파일 내용을 읽고 판단해야 하는데 이번에는 이름 언급만 연결했습니다.
종류는 파일 이름만 보고 나눴고 내용은 열어 보지 않았습니다.
3주차 정식 과제의 제출 방법은 자막과 채팅에서 확인되지 않았습니다.
이 측정은 2026년 10월 22일 기준으로 ~/knowledge-hub, ~/Documents, ~/projects 아래 md 파일 20,742개 중 9월 23일부터 10월 22일 사이에 생성되고 이후 수정된 파일 가운데 이름에 회고와 인계 관련 낱말이 든 24개를 대상으로 한 결과입니다. 같은 컴퓨터에서 다른 세션이 파일을 쓰고 있어 측정 순간의 목록입니다. 노션 덤프 내용, ~/.claude 아래 세션 기록, 다른 기기의 자료, git 밖의 백업은 보지 않았습니다.
도움 받은 글
24기 AI워크스페이스 3주차 강의 (야호심, 하이호, 사례 발표자들): PKM, 제텔카스텐, LLM 위키의 역할 구분, 실습 프롬프트 1의 세 문장, 연결 방식을 대화로 정하는 요령
24기 AI워크스페이스 2주차 강의와 제 2주차 글: 측정 스크립트와 이월한 계획 아홉 가지


