novel-writing-guide/README.md

Novel Writing Guide

버전: 3.1 최종 수정: 2026-01-17 용도: AI 협업 장편 소설 작성 시스템

---

📚 이 저장소는

AI(Claude)와 협업하여 장편 소설(10권 이상)을 체계적으로 작성하기 위한 공통 가이드 및 템플릿 모음입니다.

각 소설 프로젝트는 독립적인 Git 저장소로 관리되며, 이 Guide 저장소의 표준과 템플릿을 참조하여 구축됩니다.

---

📖 주요 문서

Novel Writing Project Guide.md

메인 가이드 문서입니다.

포함 내용:

• 전체 워크플로우 (Phase 1~6)
• 파일 구조 및 명명 규칙
• 토큰 효율 관리 전략
• 5화 단위 작성 시스템
• 누적 서머리 시스템
• Git 자동화
• v3.0 모드 시스템:
  • WRITING: 신규 작성 모드
  • MODIFICATION: 기존 수정 모드
  • VERIFICATION: 전체 점검 모드
  • DISCUSSION: 협의/논의 모드

validation-standards.md (v3.1 신규)

검증 모드 전용 가이드 문서입니다.

포함 내용:

• 3가지 검증 모드:
  • 본문 검증: 챕터 자체 완결성 확인
  • 플롯 검증: 플롯과 본문 일치성 확인
  • 요약본 검증: 2종 요약본 크로스체크
• 배치 검증 시스템:
  • 10개씩 6개 배치로 나눠 검증
  • 각 배치마다 검증 요약본 생성
  • 컴팩팅 대응 프로토콜
• 검증 요약본 형식:
  • 챕터별 상세 정보
  • 제목-내용 일치 확인
  • 타임라인 검증
  • 캐릭터 일관성 체크
• 검증 보고서 템플릿:
  • 본문 검증 보고서
  • 플롯 검증 보고서
  • 요약본 검증 보고서

---

📁 템플릿 폴더 (templates/)

새 소설 프로젝트 시작 시 복사해서 사용하는 템플릿 파일들입니다.

제공 템플릿:

• CLAUDE.md.template: AI 협업 프로토콜 템플릿
• chapter-template.md: 챕터 파일 기본 형식
• project-structure.md: 프로젝트 폴더 구조 가이드

---

🚀 새 프로젝트 시작하기

1. 이 가이드 읽기

L:\내 드라이브\Writing\Guide\Novel Writing Project Guide.md

전체 워크플로우와 시스템을 이해합니다.

2. 프로젝트 폴더 생성

cd "L:\내 드라이브\Writing"
mkdir my-novel-project
cd my-novel-project

3. 템플릿 복사

cp ../Guide/templates/CLAUDE.md.template ./CLAUDE.md
cp ../Guide/templates/project-structure.md ./docs/

4. 프로젝트 설정

AI와 함께 "큰 틀 정하자" 명령으로 설계 시작:

• Phase 1: 설계 (마스터 파일 생성)
• Phase 2: 권별 플롯 작성
• Phase 3: 실행 준비 (자동화)
• Phase 4: 작성 시작

---

🎯 핵심 컨셉

1. 설계와 실행의 분리

• 마스터 파일: 전체 10권 통합 설계 (크고 무거움, 작성 시 읽지 않음)
• 작업 파일: 필요한 부분만 추출 (작고 가벼움, 매 세션 읽음)

2. 토큰 효율 최우선

• 한글 1글자 ≈ 1.5 토큰
• 권별 작업 파일로 토큰 13,000 이하 유지
• 작성 여유 토큰 187,000 확보

3. 5화 = 1작업 단위

• plot-001-005.md (5화 플롯)
• "1~5화 작성해" 1번 명령
• summary-001-005.md (5화 결과)

4. 누적 서머리로 일관성 유지

• summary-001-005.md
• summary-001-010.md (1-10화 전체 누적!)
• summary-001-050.md (1권 전체!)
• summary-vol-01-final.md (압축, 다음 권용)

5. 모드 기반 워크플로우 (v3.0)

• WORK-MODE.txt로 현재 작업 모드 명시
• 컴팩팅 후에도 맥락 유지
• 수정 시 Summary 재생성 강제화
• 타임라인 검증 자동화

---

📐 파일 구조 예시

my-novel-project/
│
├── CLAUDE.md                    # AI 협업 프로토콜
├── README.md
├── CHANGELOG.md
│
├── settings/                    # 마스터 파일 (설계용)
│   ├── characters-master.md
│   ├── timeline-master.md
│   ├── plot-master.md
│   ├── writing-guide.md
│   ├── chapter-format-standard.md    # v3.0
│   ├── writing-mode.md               # v3.0
│   ├── modification-mode.md          # v3.0
│   ├── verification-mode.md          # v3.0
│   └── renaming-protocol.md          # v3.0
│
├── volumes/                     # 권별 폴더
│   ├── vol-01/
│   │   ├── CHANGELOG.md              # v3.0
│   │   ├── WORK-MODE.txt             # v3.0 (임시)
│   │   ├── plot-master.md
│   │   ├── characters.md
│   │   ├── timeline.md
│   │   ├── plots/
│   │   │   ├── plot-001-005.md
│   │   │   └── ...
│   │   ├── summaries/
│   │   │   ├── summary-001-005.md
│   │   │   ├── summary-001-010.md
│   │   │   └── ...
│   │   └── chapters/
│   │       ├── ch-001.md
│   │       └── ...
│   └── vol-02/
│       └── (동일 구조)
│
└── .git/

---

🔧 v3.0 주요 개선

문제 해결

이전 문제:

• 컴팩팅 → 맥락 손실 → 수정이 이상한 방향으로
• Summary 누락 → 플롯/본문/서머리 불일치
• 리네임 시 파일 손실 위험
• 변경 이력 추적 불가

v3.0 해결:

• WORK-MODE.txt → 모드 명시 → 맥락 유지
• modification-mode.md → Summary 재생성 강제
• renaming-protocol.md → 안전한 2단계 리네임
• CHANGELOG.md → 변경 이력 추적

모드별 워크플로우

작성 모드:

"1~5화 작성해" → 작성 → summary 누적 → Git

수정 모드:

"수정 준비해" → 계획서 → WORK-MODE.txt 생성
→ [컴팩팅]
→ "수정 실행" → 수정 → summary 재생성 → 검증 → CHANGELOG → Git

점검 모드:

"점검해" → 전수 검사 → 보고서 작성 → Git

---

📊 적용 예시

실제 프로젝트

• 1945-novel: "1945, 다시 시작된 역사" (대체역사 소설, 10권)
  • 위치: L:\내 드라이브\Writing\1945-novel\
  • 상태: 2권 작성 중 (65화)
  • v3.0 시스템 적용 완료

---

🔗 참고 링크

Git 저장소 (Gitea)

• 서버: git.digien25.co.kr
• 사용자: Alex
• 프로젝트 예시:
  • https://git.digien25.co.kr/Alex/1945-novel.git
  • https://git.digien25.co.kr/Alex/novel-writing-guide.git

백업 전략

• Google Drive: 실시간 클라우드 동기화
• Git + Gitea: 버전 관리 및 원격 백업
• 이중 백업: 최대 안정성 확보

---

📝 버전 히스토리

v3.1 (2026-01-17)

• ✅ validation-standards.md 추가 (검증 모드 전용 가이드)
• ✅ 배치 검증 시스템 (10개씩 분할, 컴팩팅 대응)
• ✅ 검증 요약본 시스템 (validation-batch-XX.md)
• ✅ 2종 요약본 크로스체크 (작성 요약본 vs 검증 요약본)
• ✅ 검증 보고서 템플릿 3종

v3.0 (2026-01-17)

• ✅ 모드 시스템 구축 (WRITING/MODIFICATION/VERIFICATION/DISCUSSION)
• ✅ 수정 프로토콜 체계화 (Summary 재생성 강제, 타임라인 검증)
• ✅ 챕터 형식 표준 문서화
• ✅ 안전한 리네임 절차
• ✅ WORK-MODE.txt 시스템 (컴팩팅 대응)
• ✅ CHANGELOG.md 도입

v2.0 (2026-01-15)

• ✅ 완전 재작성
• ✅ 설계/실행 분리
• ✅ 토큰 효율 최우선
• ✅ 5화 작업 단위
• ✅ 누적 서머리
• ✅ Git 자동화

v1.0 (2026-01-14)

• 초기 버전

---

🤝 기여

이 가이드는 Alex의 개인 프로젝트이지만, 개선 제안은 언제나 환영합니다.

---

📧 연락처

• 작성자: Alex
• 이메일: alex@digien25.co.kr

---

마지막 업데이트: 2026-01-17 버전: 3.1 라이선스: 개인 프로젝트