AI가 막혔을 때

책을 쓰다 보면 AI 워크플로 자체가 막힐 때가 옵니다. 챕터 내용이 막힌 것이 아니라 흐름이 멈춘 것입니다. 자주 마주치는 몇 가지와 빠져나오는 방법을 정리합니다.

챕터 게이트가 두 번 불합격일 때

챕터를 다 쓰면 AI-smell 게이트가 실행됩니다. 불합격이면 다시 쓰는데, 두 번 다시 써도 또 불합격이면 오케스트레이터가 멈추고 사용자에게 넘깁니다. 무한히 다시 쓰지 않습니다.

이때 챕터를 직접 읽어 봅니다. 보통 같은 원인이 반복됩니다. 대사가 다 똑같은 톤이거나, 캐릭터 묘사가 “아름다운” 같은 무의미한 형용사로 채워졌거나, 문장 길이가 단조롭습니다. “대사를 캐릭터별로 구분해서 다시 써줘”처럼 막힌 원인을 짚어 주면 점수가 떨어집니다. 막연히 “다시 써줘”라고 하는 것보다 빠릅니다.

연속성이 어긋났다고 할 때

continuity-check가 챕터를 인덱스와 대조하다 어긋남을 잡으면 챕터별 chapters/ch{NN}_continuity.md에 기록합니다. 이것은 막힌 것이 아닙니다. 어긋난 설정이 의도된 변화인지 실수인지를 사람이 판단하는 단계입니다.

캐릭터가 다쳐서 설정이 바뀐 것이라면 “이 시점부터 설정이 바뀐다”고 알려 인덱스를 갱신합니다. 실수라면 챕터를 고칩니다. 자세한 설명은 continuity에 있습니다.

book_type을 잘못 골랐을 때

쓰다 보니 “이건 소설보다 에세이가 맞겠다” 싶으면 종류를 바꿀 수 있습니다. “에세이로 바꿔줘”라고 하면 Tier 1로 롤백합니다. 다만 종류가 바뀌면 켜지는 스킬이 통째로 바뀌어서, 이미 짠 세계관이나 캐릭터 설정이 새 종류에서 무의미해질 수 있습니다. 무엇을 살리고 무엇을 버릴지 AI가 같이 정리해 줍니다. 도중에 바꿀 수는 있지만 그만한 비용이 따릅니다.

세션이 끊겨 어디까지 했는지 모를 때

며칠 만에 다시 열었거나 여러 권을 작업하다 헷갈리면, 세션 시작 훅(session-start.sh)이 활성 책의 진행을 자동으로 가져옵니다. 그래도 헷갈리면 “지금 어느 책 몇 장까지 했어?”라고 물어봅니다. books.json과 활성 책의 progress.md를 종합해 알려 줍니다.

다음 세션을 위해 작업을 끝낼 때 active.md에 다음 시작점을 적어 두면, 다음 세션이 매끄럽게 이어집니다. stop-reminder.sh가 비어 있으면 알려 주기도 합니다.

그래도 안 풀리면

에러 메시지를 그대로 복사해 Claude Code에 붙여 넣고 “이거 왜 이래?”라고 묻는 것이 가장 빠를 때가 많습니다. 그래도 안 되면 troubleshooting에서 같은 증상을 찾고, 거기에도 없으면 GitHub 이슈를 엽니다.

다음

자주 부딪히는 증상 모음은 troubleshooting에 있습니다.