PKM(자기저술 학습 노트) vs LLM 자동 위키¶

한 줄 요약: LLM 위키는 "이 코드·도메인은 무엇인가"를 기계가 빠짐없이 서술한 참조 문서, 자기저술 PKM(learning-notes / troubleshooting)은 "내가 무엇을 틀렸고 무엇을 배웠나"를 본인이 직접 쓴 인지 기록이다. 전자는 영토의 지도, 후자는 지도 만든 사람 머릿속의 변화(delta). 둘은 대체재가 아니라 상보재다.

문제 / 배경¶

LLM에 레포를 붙이면 코드 위키를 자동 생성해 주는 도구가 흔해졌다(자동 코드 위키, 자동 문서화). 그러면 자연히 의문이 든다:

"내가 손으로 쌓는 learning-notes / troubleshooting은, 이제 그냥 LLM 위키의 열등한 수동 버전 아닌가? 갈아끼워야 하나?"

결론부터: 아니다. 두 산출물은 목적·내용물·출처·성공지표가 다르다. 자기저술 PKM을 자동 위키로 대체하면 더 예쁜 참조 문서를 얻는 대신, 그걸 만든 이유(본인의 이해)를 잃는다. 이 노트는 그 차이를 다섯 축으로 못 박고, 언제 무엇을 쓸지를 정리한다.

이 사이트의 PKM 운영법 자체는 Learning Pipeline Playbook 참조 — 이 글은 그 시스템을 왜 자동 위키로 대체하지 않는가에 대한 답이다.

해법 / 개념¶

다섯 축 비교¶

축	자기저술 PKM (notes / troubleshooting)	LLM 자동 위키
선별 기준	마찰로 선별 — "1분 이상 헤맴", "두 번 안 묻기", "이게 단독으로 잡는 진짜 실패가 뭔가"	완전성으로 수집 — 있는 걸 고르게 다 서술
핵심 내용물	오개념·함정(negative knowledge): "이렇게 하지 마라 + 직관적인 방법이 왜 깨지나"	현재의 옳은 상태: 무엇을 하지 말지·왜 뻔한 길이 막히는지는 빠짐
출처(ground truth)	실제 겪은 사건(날짜·에러·커밋) — 경험적, "아파서" 검증됨	코드에서 합성 — 의도된 동작·엣지케이스를 매끈하게 뭉개거나 환각 가능
청중·성공지표	미래의 나 + "면접에서 내 말로 설명" — 비유·Q&A 포함	불특정 독자 + 커버리지·검색성 — API 표·구조도
쓰는 행위	직접 쓰는 마찰이 곧 이해 고착(generation effect)	LLM이 대신 씀 → 그 인지 단계를 건너뜀

자동 위키에 구조적으로 없는 두 가지¶

서술형 위키는 "현재 상태"를 그리므로 다음을 원리적으로 담지 못한다:

함정(negative space) — "지뢰 위치". "이 직관적 접근은 이래서 깨진다"는 부정 지식은 코드의 현재 상태가 아니라 경험한 실패에서만 나온다. 위키는 잘못된 길(다시 밟기 쉬운 그 길)을 보존하지 않는다. 정작 시간을 아껴 주는 건 이 부정 지식인데.
승격 파이프라인 — 이해의 "졸업". 현장 메모 → 일반화된 공개본 → 사적 보관(미완성/회고)으로 이해를 졸업시키는 단계는 자기저술 PKM의 핵심이다. 위키엔 "이걸 이제 내가 남에게 가르칠 수 있다"는 상태 전이가 없다.

generation effect — 외주 줄 수 없는 부분¶

PKM의 진짜 목표가 "내 말로 설명 가능한 이해"라면, 그 이해는 읽기가 아니라 직접 쓰는 행위에서 생긴다(generation effect: 스스로 생성한 정보가 수동적으로 읽은 정보보다 훨씬 잘 남는다). LLM이 위키를 대신 써 주면 문서는 생기지만 바뀐 뇌는 안 생긴다. 즉 이해를 외주화하면 이해를 갖지 못한다 — 목적 자체를 무력화한다.

LLM 위키가 진짜 더 나은 곳 (공정하게)¶

대체재가 아니라 상보재인 이유 — 위키가 이기는 영역은 분명히 있다:

온보딩 커버리지 — 새로 합류한 사람은 특이한 함정 말고 전체 지도가 먼저 필요하다.
구조·내비게이션 — 호출 그래프·자동 크로스링크·디렉터리 맵.
인적 비용 0, 커밋마다 자동 최신화.

핵심은 답하는 질문이 다르다는 것: 위키는 "이 시스템이 무엇인가", PKM은 "내가 무엇을 배웠나".

언제 무엇을 — 의사결정¶

도입 판단 (LLM 위키를 들일 것인가)¶

상황	권장
팀이 있어 남이 이 코드를 읽어야 함	LLM 위키 ✅ (커버리지가 값을 함)
내가 모르는 대형 레거시에 투입 — 영토 파악이 먼저	LLM 위키 ✅ (일시적으로)
오픈소스로 외부 기여자에게 연다	LLM 위키 ✅
솔로 + 내가 코드를 이미 안다	자동 위키 보류 — 메울 빈칸이 없음
목표가 본인 이해 / 면접 설명	자기저술 PKM — 외주 불가

휴리스틱: LLM 위키는 "불특정 다수의 온보딩 커버리지"를 푼다. 그 문제가 실제로 있는가? 없으면(솔로·기지 코드) 도입은 ROI 마이너스에 가깝다 — 관측 안 되는 부품·자동생성 노이즈·환각 리스크만 늘어 자가교정 시스템에 역행한다.

함께 쓸 때의 역할 분담¶

둘 다 둔다면 이렇게 나눈다:

LLM 위키 = 영토의 참조 지도(무엇이 어디 있나, 전체 구조). 기계가 유지.
자기저술 PKM = 함정 지도 + 개념 이해(내가 틀린 곳, 왜 그런가). 본인이 유지.

위키가 "이 모듈은 X를 한다"를 적고, PKM이 "X를 이렇게 쓰면 Y 때문에 깨진다(내가 당함)"를 적는다.