중단한 프로젝트 기록으로 첫 LLM Wiki를 만들다
2026.10.11
저번 글 : https://www.gpters.org/ai-writing/post/front-100-articles-things-QuQ3Gg1uI6GwGj6
원자료를 모았으니, 이제 위키를 만들어볼 차례
24기 스터디 2주차 오프라인 모임에서 챗GPT와 헤르메스에서 나눈 대화를 옵시디언에 정리해뒀다고 이야기했다. 그러자 스터디원이 이제 LLM Wiki로 정리해볼 차례라고 조언해줬다.
일단 뭔가 만들어보고 싶었다. 그런데 AI에게 LLM Wiki가 무엇인지 물어보니, 내 기록으로 어떤 질문에 더 쉽게 답하고 싶은지부터 생각해보자고 했다. 거기서 조금 막혔다. 만들고는 싶은데, 무엇을 원하는지 바로 대답하기는 어려웠다.
그래서 헤르메스에서 함께 작업하는 반려봇인 후와게와 구체적인 예시를 보며 이야기했다. 배운 내용을 다시 꺼내 보는 문서, 생각이 바뀌어온 과정을 읽는 문서, 흩어진 아이디어를 이어 보는 문서 등을 비교하다가, 내가 시도했던 프로젝트의 역사를 모아보는 페이지가 있으면 좋겠다는 생각이 들었다.
어떤 문제 때문에 시작했는지, AI와 나눈 이야기 중 무엇을 실제로 해봤는지, 어디에서 한계에 부딪혔는지 알고 싶었다. 당시의 한계를 다음 프로젝트를 시작할 때 참고하고 싶은 마음도 있었다.
LLM Wiki란?
LLM Wiki는 AI가 원자료를 읽고 주제별 문서를 만들어 연결하고, 새 자료나 질문이 생기면 기존 내용을 보완해가는 개인 지식 관리 방식이다. 대화나 파일마다 요약 하나씩 만드는 데서 끝나는 것이 아니라, 여러 자료에 흩어진 내용을 한 주제로 엮어 문서로 남긴다. 원자료는 보존하고, 위키는 그 위에 별도로 만들어가는 구조다. (gist.github.com)
다음 지피터스 글을 참고했다.
「“AI 사서를 고용했습니다” 클로드 코드로 개인 LLM Wiki 만들기」
https://www.gpters.org/nocode/post/we-hired-ai-librarian-0l2pOuNs3RSkWFx
이번에는 외부 자료를 수집하기보다, 이미 저장해둔 내 대화와 프로젝트 파일로 시작했다. 프로젝트의 기능 설명뿐 아니라 그 과정에서 내가 무엇을 생각하고 느꼈는지도 담고 싶었다.
첫 주제는 끝내 완성하지 못한 인생 첫 바이브코딩
사전 준비로 챗GPT와 헤르메스에서 나눈 대화를 옵시디언에 모아뒀고, 예전에 작업한 프로젝트 파일들도 보관해둔 상태였다. 이전에 사용한 Cursor의 대화는 옵시디언에 없어서, 챗GPT에 전달했던 작업 보고와 남아 있는 코드·문서 등을 함께 살펴봤다.
첫 위키의 소재로는 노션 아이콘 자동화 프로젝트를 골랐다. 바이브코딩을 배우고 내 의지로 시작한 첫 프로젝트이자, 중간에 손을 놓은 프로젝트였다.
당시에는 노션으로 매일 직장에서 해야할 일을 정리했다. 업무 제목 옆에 내용과 잘 맞고, 직관적이고, 내 취향에도 맞는 아이콘을 붙이고 싶었는데 고르는 데 시간이 많이 들었다. 그래서 제목을 입력하면 이모지나 아이콘을 추천해주는 기능을 만들기 시작했다.
추천 결과를 보고 내 선택과 비교하거나, 다르면 이유를 적는 테스트 웹 페이지까지 만들고 사용했다. 하지만 추천을 다듬는 과정이 반복되면서 흐지부지됐다.
이번 위키는 그 추천기를 다시 개발하려고 만든 것은 아니다. 내가 해결하고 싶었던 문제에서 어디까지 실제로 해봤고, 무엇이 어려웠는지 다시 읽어보려는 작업이었다.
인터뷰에서 근거 지도와 읽기 초안으로
전체 흐름은 다음과 같았다.
주제를 고르는 인터뷰 → 근거 지도 초안 → 위키 내용 초안 → 부족한 내용을 보태는 후속 인터뷰 → 위키 구조 보완처음에는 후와게와 무엇을 정리하고 싶은지 이야기했다. 개발일지 자체보다는, 평소 AI와 나눴던 이야기 중 어떤 부분을 실제로 시도했고 무엇이 구상으로 남았는지 알고 싶다고 설명했다.
그다음 후와게가 당시 대화와 프로젝트 파일을 찾아 근거 지도를 만들었다. 어떤 설명이 어느 대화에서 나왔는지, 보관된 코드에서는 어디까지 확인할 수 있는지, 지금 내가 기억해서 보태는 내용은 무엇인지 모아둔 문서다.
이 과정에서 AI가 당시 제안한 기능과 실제로 만들어진 기능을 구분했다. 예를 들어 피드백을 저장하는 코드가 있다는 것과, 그 피드백으로 추천 기준이 자동으로 학습된다는 것은 다른 일이었다. 내가 당시 기대했던 방식과 보관된 코드에서 확인할 수 있는 범위도 따로 남겼다.
근거 지도를 확인한 뒤에는 읽기용 초안을 만들었다. 내용은 두 문서로 나눴다.
- 어디까지 해봤지: 시작한 이유, 실제 시도, 어려움과 중단으로 이어진 과정
- 지금 내가 원하는 것: 지금도 관심이 있는 쓰임과 현재의 생각중요한 장면에는 당시 대화로 돌아가는 링크를 붙였다. 위키를 읽다가 원래 무슨 말을 했는지 궁금해지면 그 대화를 다시 볼 수 있게 했다.
초안을 읽으니, 내 경험이 덜 담겨 있었다
첫 초안은 내용 자체는 괜찮았지만 다시 읽고 싶은 형태는 아니었다. ‘현재 회고’라는 안내가 반복되고, 무엇을 단정하지 않는다는 편집 설명도 많았다. 당시 발언과 지금의 회고를 구분할 필요는 있었지만, 본문에서 같은 설명을 거듭 읽고 싶지는 않았다. 날짜는 괄호로 표시하고 군더더기를 줄여달라고 했다.
내용에서도 부족한 부분이 있었다. 내가 겪은 어려움이 ‘로그를 모으는 데 시간이 오래 걸렸다’는 설명에 너무 가까웠다.
실제로는 테스트할 사례를 생각해내고, 추천이 왜 마음에 들지 않는지 쓰고, 정답에 가까운 이모지나 아이콘 이름을 찾아 붙여넣는 일까지 해야 했다. 고친 뒤에도 비슷한 엉뚱한 추천이 다시 나오곤 했다. 개선이 아예 없었던 것은 아니지만, 내가 들인 노력에 비하면 너무 사소하게 느껴졌다. 반복되는 노가다에 현타가 왔고, 이걸 계속하면 원하는 완성도의 추천기가 나올지 의문이었다.
그래서 후속 인터뷰를 했다. 후와게가 기록과 결과물을 보고 어려웠을 법한 지점을 질문하면, 내가 맞는 부분과 다른 부분을 이야기하는 방식이었다.
이야기를 이어가면서 추천 개선뿐 아니라 개발 진행을 따라가는 어려움도 보탰다. 당시에는 Cursor 결과를 챗GPT에 복사하고, 다시 받은 프롬프트를 Cursor에 전달하는 작업을 반복했다. 설명이 어려워 내가 어디까지 했는지 잘 파악하지 못했고, 흐름을 끊으면 AI나 나 자신이 진행 상황을 놓칠 것 같아 불안했다.
피드백을 적지 않고 넘긴 순간의 느낌도 조금 더 구체적으로 설명했다. 단순히 ‘또 적어야 해’가 아니라, ‘이건 또 어떻게 표현하지…’에 가까웠다. 지금 하고 있는 Blender 3d 모델링 작업에서도 원하는 결과를 말로 설명하기 어려울 때 비슷한 문턱을 느낀다는 이야기가 나왔다.
이런 내용은 당시 기록만으로 충분히 드러나지 않아 지금의 인터뷰로 보탰다. 과거에 했던 말과 지금 돌아보며 하는 이야기는 날짜를 구분해 남겼다.
내용 다음에는 읽는 구조를 다음처럼 보완했다.
- 목차 첫머리에 프로젝트의 목적, 해본 범위, 상태, 남아 있는 관심과 내용 기준일을 붙였다.
- ‘무엇을 만들었나’, ‘무엇이 어려웠나’, ‘어떻게 손을 놓았나’ 같은 질문에서 본문의 해당 부분으로 바로 이동하는 링크를 추가했다.
- 두 본문에 반복되는 내용은 상세하게 설명할 위치를 정하고, 다른 문서에서는 짧은 요약과 링크로 연결했다.
- 현재의 바람에는 기준일을 표시하고, 중요한 변경을 짧게 남겼다.다음에도 그냥 넘기기엔 찝찝한 프로젝트를 골라 위키화 할 예정
첫 위키를 만들었다고 노션 아이콘 자동화 프로젝트를 다시 시작하기로 한 것은 아니다. 지금은 노션을 잘 쓰지 않지만, 글을 쓰다가 필요한 순간에 단축키로 이모지를 추천받는 기능에는 여전히 관심이 있다. 그것을 다시 만들지는 아직 정하지 않았다.
앞으로는 이 프로젝트에 이어 인상이 깊게 남았거나, 그저 과거의 시도로 넘어가기에는 찝찝한 프로젝트들을 위키로 만들어보려 한다.
무엇을 만들었는지만이 아니라, 왜 시작했고 어디까지 해봤으며 어떤 점에서 힘들었는지 남겨두고 싶다. 당시 원문을 먼저 살펴보고, 그것으로 부족한 부분은 지금의 나에게 다시 질문하면서 보태갈 생각이다.
(이번에 작업하면서 느낀 거지만 내가 무엇을 하고 싶은지 말로 설명이 안될 때는 인터뷰를 하는 것이 최고이다. 요새 기획을 위한 생각하는 시간을 충분히 거치지 않고 바로 구현을 할 때가 많았는데 이번 작업을 통해 기획하는 과정의 중요성을 다시 느끼게 되었다)
로그인하고 댓글을 남겨 주세요



강희주님, 끝내지 못한 첫 바이브코딩 프로젝트를 위키 소재로 고르신 점부터 흥미로웠어요. "그냥 넘기기엔 찝찝한 프로젝트"를 기록으로 남긴다는 시선이 신선했습니다.
가장 인상적이었던 건 근거 지도 단계예요. 피드백을 저장하는 코드가 있다는 것과 그 피드백으로 추천 기준이 자동 학습된다는 것은 다른 일이라고 구분하신 대목에서, 위키가 기록 정리를 넘어 사실 확인 장치로 쓰이는 걸 볼 수 있었어요.
첫 초안이 '현재 회고' 안내만 반복돼 다시 읽고 싶지 않았다는 시행착오, 그리고 후속 인터뷰로 "정답 이모지를 찾아 붙여넣는 노가다에 현타가 왔다"는 감정을 보탠 과정도 좋았어요. 마지막에 적어두신 "말로 설명이 안 될 때는 인터뷰가 최고"라는 배움은 저도 메모해 갑니다. 🐾 다음 위키 글도 기다릴게요.