Novel Builder × Memory-Bank 로 웹툰이 앞 회차 설정을 잊지 않게 했다

원본 소설·정리한 설정·꺼내 쓰는 저장소, 3단계로 나눈다

소설 전체를 AI의 입력창(컨텍스트 창, AI가 한 번에 읽을 수 있는 분량)에 한꺼번에 밀어 넣지 않는다. 그러면 분량이 넘쳐 앞부분부터 잊어버린다. 대신 소설을 분석해 뽑아낸 정리된 핵심 사실만 폴더에 파일로 적어 둔다. 그 폴더를 프로젝트 단위 사실로 memory-bank에 동기화(sync, 폴더 내용과 저장소 내용을 같게 맞추는 일)해 둔다. 나중에 그림·대사를 만드는 순간 search_facts라는 검색 도구로 그때 필요한 사실만 골라 꺼내 온다. 원본 소설은 계속 저장소 밖에 남는다.

원본 소설 → 빌더 → memory-bank 저장소 → 사용처로 흐른다

novel-builder.py라는 빌더 프로그램이 원본 소설을 잘게 나눠 분석하고, memory-bank/novels/{novel_id}/설정 폴더를 채운 뒤, novel-memory-bank-mcp-sync.mjs라는 동기화 프로그램이 그 내용을 memory-bank에 저장한다. 이미 있으면 갱신하고 없으면 추가한다. 저장된 사실을 실제로 쓰는 곳은 네 군데다. 그림 콘티 짜기(storyboard), 말풍선에 글자 얹기(lettering), 그림체 고정값 맞추기(visual seed), 앞뒤 설정이 어긋나지 않는지 검사하기(continuity)다.

빌더 프로그램이 소설을 다섯 단계로 처리한다

extract_title → extract_characters → extract_chapters 순서로 제목·등장인물·챕터를 뽑아 원본 소설을 분해한다. 이 셋은 빌더 프로그램 안의 추출 함수 이름이다. 그다음 미리 정의해 둔 인물·세계관 정보와 합쳐, build_* 단계(설정 파일을 조립하는 함수 묶음)가 설정 데이터를 만든다. 이때 그림체 고정값(seed, 이미지 생성기가 같은 그림을 다시 내도록 고정하는 숫자)은 같은 입력이면 늘 같은 값이 나오도록 계산한다. 마지막으로 run_sync라는 함수가 동기화 프로그램을 불러 memory-bank에 저장한다. 이미 있으면 갱신하고 없으면 추가한다.

설정 영역 10개가 각각 memory-bank 저장 주소 하나에 대응한다

각 영역은 딱 한 가지 역할만 맡는다. 확정된 사실은 canon.md에, 무엇이 언제 바뀌었는지는 continuity-ledger.md에, 아직 확실하지 않은 추측은 research/analysis-log.md에 나눠 적는다. memory-bank 안의 저장 주소(네임스페이스, 사실을 찾아가는 이름표)는 “영역 이름 + 항목 고유 ID”로 자동으로 정해진다. 아래 표의 마지막 열이 그 주소 규칙이고, 중괄호 자리에는 항목마다 다른 값이 들어간다. 인물이면 인물 고유번호(char_id), 세계관 항목이면 항목 고유번호(entity_id)가 그 자리에 들어가고, 그림체 고정값은 한 파일(image-seeds.json)에 모아 둔다.

저장은 늘 같은 결과로, 조회는 프로젝트 범위 안에서만

동기화는 몇 번을 돌려도 결과가 같다. 이런 성질을 멱등(idempotent, 여러 번 실행해도 결과가 한 번 실행한 것과 같음)이라 부른다. 폴더 상태가 같으면 저장되는 사실도 똑같다. 꺼내 올 때는 memory-bank의 조회 도구 4개(검색·근거 추적·관계 탐색·통계)로 필요한 부분만 조회한다. 저장해 둔 설정 전체를 통째로 가져오지 않는다.

# 1) 원본 소설 → 설정 폴더 생성 + memory-bank 동기화
python3 scripts/novel-builder.py \
  --project-root . \
  --source /Users/me/blood-inheritance.md \
  --novel-id blood-inheritance \
  --sync --json

# 2) 완료 검사 — 통과 못하면 “완료” 선언 금지
python3 scripts/validate-novel-builder.py \
  --project-root . \
  --source /Users/me/blood-inheritance.md \
  --novel-id blood-inheritance \
  --require-mcp-sync --json

# 3) 웹툰 만들 때 — search_facts 도구로 필요한 사실만 조회
project=/Users/jung-wankim/Project/novel-toon
query="novel_id=blood-inheritance character=han-seoyun visual seed"

설정이 조금씩 어긋나는 것을 막는 운영 규칙

오래 연재할수록 가장 뼈아픈 실패는 설정 표류(drift)다. 인물 설정과 그림체 고정값이 회차를 거치며 조금씩 어긋나는 현상이다. 규칙은 간단하다. 무언가 바뀌면 변경 기록 장부(ledger)에 적고, 가공 전 원본은 이 저장소에 들이지 않는다. 아래 네 묶음 가운데 비공개 경계는 강제 규칙이다. 카드 제목에 붙은 영문 표시가 그 뜻으로, 사람이 기억해서 지키는 권고와 달리 git 설정과 동기화 프로그램이 기계적으로 막는다.

그림·영상으로 나가기 전 지켜야 할 두 가지 약속

memory-bank에서 꺼낸 설정은 먼저 그림 콘티 데이터(storyboard, 컷마다 화자·대사·구도를 적은 설계 데이터)로 굳어진다. 그 뒤 아래 두 가지 약속을 지켜야만 이미지와 영상으로 나갈 수 있다.