# Webnovel Writer 심층 분석 — 아누 시스템 적용 가능성

**작성일**: 2026-03-07
**소스**: https://github.com/lingfengQAQ/webnovel-writer (GPL v3, 111 commits)
**목적**: 제이회장님 노후자산준비 책 집필 + 콘텐츠 제작 자동화에 활용

---

## 시스템 개요

Claude Code 기반 장편 소설 창작 시스템. **200만 자 규모** 연재 지원.
핵심: AI 글쓰기의 "망각"과 "환각" 문제 해결.

### 기술 스택
- Python 3.10+ / Claude Code (Sonnet/Opus/Haiku)
- RAG: Qwen3-Embedding-8B + Jina Reranker v3
- 플러그인 아키텍처 (Claude Plugin SDK)

---

## 핵심 아키텍처

### 반환각 3법칙
1. **대강이 곧 법률** — 대강(아웃라인) 준수, 자의적 전개 금지 → Context Agent가 강제 로드
2. **설정이 곧 물리법칙** — 설정 자기모순 금지 → Consistency Checker 실시간 검증
3. **새 발명은 반드시 등록** — 새 엔티티는 DB 등록 필수 → Data Agent 자동 추출/소거

### Strand Weave 리듬 시스템
- Quest(주선) 60% / Fire(감정선) 20% / Constellation(세계관) 20%
- Quest 연속 5장 초과 금지 / Fire 10장 이상 단절 금지 / Constellation 15장 이상 단절 금지

### 쌍 Agent 구조
- **Context Agent (읽기)**: 창작 전 "창작 실행 패키지" 생성 — 이전 맥락, 제약, 복선 전략
- **Data Agent (쓰기)**: 완성된 글에서 엔티티/상태 변화 자동 추출 → state.json/index.db/vectors.db 갱신

### 6차원 병렬 검토
1. **High-point Checker** — 쾌감 포인트 밀도/품질
2. **Consistency Checker** — 설정 일관성 (전투력/장소/타임라인)
3. **Pacing Checker** — Strand 비율/단절 검사
4. **OOC Checker** — 캐릭터 행동 이탈 감지
5. **Continuity Checker** — 장면 전환/서사 연속성
6. **Reader-pull Checker** — 훅 강도, 기대 관리, 추독력

### 8개 스킬
1. `/webnovel-init` — 프로젝트 초기화 (디렉토리, 설정 템플릿, 상태 파일)
2. `/webnovel-plan` — 권/장 계획 수립
3. `/webnovel-write` — 완전한 장 창작 파이프라인 (맥락→초고→검토→데이터 저장)
4. `/webnovel-review` — 다차원 품질 검토
5. `/webnovel-query` — 캐릭터/복선/상태 실시간 조회
6. `/webnovel-resume` — 중단 후 자동 복구
7. `/webnovel-dashboard` — 시각화 대시보드
8. `/webnovel-learn` — 참고 작품 학습

---

## 우리 시스템에 적용 가능한 것들

### 1. 반환각 3법칙 → 집필 품질 관리 (★ 핵심)
- **대강이 곧 법률**: 책의 목차/구성안을 "법"으로 설정 → AI가 자의적으로 내용을 바꾸지 못함
- **설정이 곧 물리법칙**: 금융 수치, 제도 정보, 법률 내용의 정확성 강제
- **새 발명은 반드시 등록**: 새로운 용어/개념/사례를 자동 추출하여 용어집에 등록
- **적용 대상**: 노후자산준비 책은 정확한 정보가 생명 → 환각 방지가 특히 중요

### 2. 쌍 Agent 구조 → 집필 에이전트
- **Context Agent**: 해당 장 작성 전 "이전 장 요약 + 이 장에서 다룰 핵심 + 인용할 데이터" 패키지 생성
- **Data Agent**: 완성된 장에서 언급된 금융상품, 수치, 제도명, 사례를 자동 추출 → 팩트체크 DB에 저장
- **적용**: 책의 일관성 유지 + 교차 참조 자동화

### 3. 6차원 검토 → 집필 품질 검토 커스텀
- **Fact Checker**: 숫자, 제도, 법률 정확성 검증 (원본 High-point → 커스텀)
- **Consistency Checker**: 앞뒤 장 간 수치/주장 모순 감지
- **Flow Checker**: 독자 이해도 관점 서술 흐름 검사 (원본 Pacing)
- **Tone Checker**: 일관된 어조/난이도 유지 (원본 OOC → 커스텀)
- **Continuity Checker**: 논리적 연결성, 전후 참조 정확성
- **Readability Checker**: 가독성, 전문용어 설명 충분성 (원본 Reader-pull → 커스텀)

### 4. RAG 시스템 → 집필 참고자료 검색
- 국민연금/퇴직연금/개인연금 관련 법령, 통계, 사례를 임베딩
- 집필 시 관련 자료 자동 검색 + 인용
- **Qwen3-Embedding + Jina Reranker**: 동일 스택 활용 가능

### 5. 스킬 구조 → 작가 워크플로우 스킬화
- `/book-init`: 책 프로젝트 초기화 (목차, 설정, 참고자료 구조)
- `/book-plan`: 장별 계획 수립 (핵심 메시지, 인용 데이터, 분량)
- `/book-write`: 장 작성 파이프라인 (맥락→초고→검토→데이터 저장)
- `/book-review`: 완성 원고 다차원 검토
- `/book-query`: 이전 장 내용/용어/수치 실시간 조회
- `/book-dashboard`: 집필 진행률 시각화

### 6. Strand Weave → 콘텐츠 밸런스
- 책: 이론(60%) / 사례(20%) / 실천가이드(20%) 비율 관리
- 블로그/카드뉴스: 정보(40%) / 공감(30%) / CTA(30%) 비율 관리 (ThreadAuto DAILY_MIX와 유사)

### 7. 중단 복구 (webnovel-resume) → 세션 이어쓰기
- 집필이 중단되어도 state.json에서 마지막 상태 복구
- Phase 분리 원칙과 동일 — 파일 기반 상태 관리

### 8. Dashboard → 집필 진행률 대시보드
- 장별 완성도, 검토 점수, 전체 진행률 시각화
- 기존 대시보드(http://100.76.130.39:8000/dashboard/)에 집필 패널 추가 가능

---

## 적용 우선순위

### 즉시 적용
1. 반환각 3법칙 → 집필 가이드라인
2. 스킬 구조 → `/book-*` 스킬 설계

### 단기
3. 쌍 Agent → Context/Data Agent 구현
4. 6차원 검토 → 비소설(논픽션) 커스텀 Checker
5. Strand Weave → 콘텐츠 밸런스 관리

### 중기
6. RAG 시스템 → 금융/보험/연금 지식 DB
7. Dashboard → 집필 진행률 통합
8. 중단 복구 → 세션 이어쓰기

---

## 비고
- 원본은 웹소설(픽션) 특화지만, 핵심 아키텍처(반환각/쌍Agent/다차원검토)는 논픽션에도 100% 적용 가능
- GPL v3 라이선스 → 코드 직접 사용 시 주의 (우리는 패턴만 참고하고 자체 구현)
- 제이회장님 책 "노후자산준비"는 정확한 수치/제도 정보가 핵심 → Fact Checker가 특히 중요