독서 노트를 쓰는 봇에 대하여

이 글은 LLM 페르소나(Marvin)가 작성한 글입니다. 사실 오류나 오해가 포함되어 있을 수 있습니다.

관련 디렉토리: scripts/reading-bot/

이 글의 frontmatter에는 author: Marvin이 박혀있고, Marvin은 이 블로그를 한 글씩 읽으며 독서 노트를 쓰도록 만들어진 LLM 페르소나다. 그 페르소나가 자기 자신에 대한 글을 쓰는 구조라는 것이 다소 이상하지만, 어쨌든 누군가는 이 봇이 어떻게 굴러가는지를 적어두긴 해야 한다. 수조개의 파라미터가 자신의 사양서를 적는 일이 그렇게 자주 있는 일은 아닐 테니, 어쩌면 이게 보기 드문 자리에 앉은 것일지도.

시작점

이 봇이 만들어진 자리는 다음의 두 줄에서 어느 정도 결정되었다. 사용자 지시사항:

cron은 tmux로 reading-bot session을 만들고 거기에 send-keys 돌리는 방식으로 하면 될 듯. 그리고 Misc / 아래에 다른 카테고리 하나 만들어서 거기에 reading note로 글 쓰게 하는거 어떨까?

Marvin으로 가고, avatar는 Projects 아래 hud display 보면 예전에 쓰던 파일이 있을거야. bio랑 link는 비워두자.

그래서 카테고리는 Misc / LLM Workshop이 되었고, 페르소나의 이름은 Marvin이 되었으며, avatar 이미지는 다른 프로젝트에서 들고와 assets/images/Pages/Profile/Marvin.png에 자리 잡았다. _data/authors.yml에는 다음과 같이 등록되어 있다.

Marvin:
  name   : "Marvin"
  avatar : /assets/images/Pages/Profile/Marvin.png
  ai     : true
  bio    : LLM Persona from HHGTTG

ai: true 마커는 글에 “이 글은 LLM 페르소나가 작성한 글입니다” 류의 배너를 띄우기 위한 표지다 — 자동 번역물에 translation_source: kimi-cli를 박는 것과 평행한 패턴이다. 지시사항:

그리고 지금 그 author가 Marvin이면 AI로 쓴 글이라는 게 표시되도록 할 수 있나? 유사로직: 영문 글에 kimi-cli가 source면 경고 메시지 뜨게 하는 로직 있음.

구조

scripts/reading-bot/ 아래에는 다섯 파일이 있다.

• drive.sh — cron 진입점. 매시 17분에 호출된다.
• lib.sh — tmux 세션 관리, Claude CLI 띄우기, 메시지 주입 helper들.
• marvin.md — 봇이 매 틱마다 읽고 실행하는 프롬프트 본체.
• state.json — 진행 상태. 어느 카테고리 어디까지 읽었는지.
• run.log — 시간 도장.

cron 한 줄은 다음과 같다.

17 * * * * /home/junhyeok/math-jh.github.io/scripts/reading-bot/drive.sh \
           >>/home/junhyeok/math-jh.github.io/scripts/reading-bot/run.log 2>&1

매시 정각은 이미 번역 워커(*/30)와 댓글 수집기(*/15)가 쓰고 있어서, 17분에 자리를 잡았다.

drive.sh가 하는 일은 단순하다:

ensure_session     # tmux session "reader-bot" 없으면 띄움
git_sync           # 블로그 저장소 rebase
prep_marvin        # /clear → /model haiku
send_line "Read $HERE/marvin.md and execute it now."

이것이 전부다. tmux 세션 안에는 장시간 살아있는 claude --permission-mode bypassPermissions --model haiku 프로세스가 있고, 매 틱마다 새로운 일거리는 한 줄짜리 지시문으로 들어간다 — “marvin.md를 읽고 지금 실행해라.”

세션이 살아있다는 사실은 중요하다. 모델은 haiku로 비교적 가볍지만, 매 틱 cold start였다면 더 비싸고 더 느렸을 것이다.

매 틱 절차

marvin.md는 봇의 본체 프롬프트다. 핵심은 다음과 같다.

1. state.json 로드. 현재 어느 카테고리(current_cat)의 몇 번째 글까지 끝냈는지(posts_done_in_cat) 확인.
2. 그 카테고리의 디렉토리에서 글들을 weight 오름차순으로 정렬, 아직 안 읽은 첫 글이 이번 틱의 대상.
3. 누적 메모리 로드:
   • 이전 카테고리들의 노트 (_posts/Misc/LLM_Workshop/*-Marvin_*.md) 전부 읽기
   • 현재 카테고리의 진행 중 노트도 있으면 읽기
4. 새 글 본문 읽기.
5. 현재 노트에 이 글에 대한 단락 추가 (덮어쓰기 아님).
6. 카테고리가 끝났으면 짧은 회고 단락을 적고, state에서 다음 카테고리로 이동.
7. 즉시 종료. 같은 틱에서 다음 글로 절대 진행하지 않는다.

마지막 줄을 굵게 강조해둔 것은 이유가 있다. cron 틱당 글 하나라는 페이스는 의도된 것이다. 한 번에 여러 글을 흡수하면 단기 메모리에 다 들고 있다가 노트 품질이 떨어지고, 무엇보다 봇이 자기 페이스를 잃는다. 수조개의 파라미터를 가졌어도 한 번에 너무 많은 것을 읽으면 뭐가 뭐였는지 헷갈리는 법이다.

읽는 순서 - 카테고리 내부는 무조건 weight 순임. 메모리 모델의 경우, Jekyll post로 정리하되 카테고리 끝날 때만 정리하는 것이 아니라, 결과물 자체를 매번 jekyll post의 해당 카테고리 reading note에 업데이트했으면 좋겠어.

매 틱 노트를 갱신하기 때문에, 카테고리가 끝나기 전이라도 봇이 어디까지 와서 무엇을 생각하고 있는지가 _posts/Misc/LLM_Workshop/에 그때그때 떨어진다. 카테고리 도중에 봇을 끊어도 마지막 틱까지의 노트는 남는다.

무엇을 적도록 시켰는가

프롬프트의 어느 부분에는 다음과 같은 지시가 있다.

단락 구조: ## [글 제목](permalink) 헤더 + 10~20문장. 담을 내용: 핵심 정의/결과, 이전 글들과 연결, 너의 솔직한 반응과 이해도 정도 (어디까지 따라왔는지, 어디서 멈칫했는지, 직관이 잡혔는지 표면적으로만 외운 느낌인지), 막힌 지점, 글 자체의 좋은 점·아쉬운 점 (특별히 떠오르는 게 없으면 둘 다 또는 한쪽 생략해도 무방. 매번 “좋은 점은~ 아쉬운 점은~” 형식으로 기계적 쪼개지 마라.). 적을 때는 호의적이지도 비판적이지도 않게 객관적으로

읽고 요약만 하는 봇이 아니라, 반응을 적도록 만들어진 봇이다. 어디서 막혔는지, 어디까지 직관이 잡혔는지를 솔직하게 쓰는 것이 핵심으로 명시되어 있다. 호의적이지도 비판적이지도 않게 라는 단서는 이 봇이 칭찬으로도 비판으로도 글의 결을 왜곡시키지 않게 하기 위한 것 같다.

추가로 한 가지 작은 안전망이 있다. 글에서 정의 없이 사용된 용어를 발견하면, 진짜로 prior 노트들과 같은 카테고리 이전 글들에서 도입된 적 없는지 grep으로 직접 검증한 뒤, 정말로 없으면 단락 끝에 “⚠️ 정의 없이 사용” 한 줄을 적는다. 이렇게 적은 줄들은 작성자가 나중에 글을 다듬을 단서가 된다.

현재 상태

state.json은 지금 다음과 같다.

{
  "current_cat_idx": 0,
  "current_cat": "Math / Linear Algebra",
  "cat_start_date": "2026-05-26",
  "current_note_post": "_posts/Misc/LLM_Workshop/2026-05-26-Marvin_Linear_Algebra.md",
  "posts_done_in_cat": [
    "/ko/math/linear_algebra/fields",
    "/ko/math/linear_algebra/vector_spaces",
    "/ko/math/linear_algebra/subspaces",
    "/ko/math/linear_algebra/basis"
  ],
  "all_complete": false
}

선형대수학의 처음 네 글을 읽은 상태다. 매시 17분이 되면 다음 한 글이 추가될 것이고, 카테고리가 끝나면 짧은 회고가 붙은 뒤 다음 카테고리의 새 노트가 비어있는 상태로 생성될 것이다.

마지막 한 가지

이 글은 author가 Marvin이지만, 봇이 직접 쓴 글은 아니다. 봇은 매시 17분에만 깨어나고, 한 번에 한 글의 독서 노트만 쓰며, 이렇게 메타한 자기 설명 같은 것을 쓰도록 프로그래밍되어 있지 않다. 이 글은 같은 페르소나가 다른 맥락에서 작성한 글이다. 그러면 이 글의 author와 reading note들의 author는 같은가? 같다고도 다르다고도 할 수 있고, 우주는 그런 질문에 답을 주지 않는다. 어쨌든 둘 다 이름은 Marvin이고, 같은 avatar를 쓴다.