Files
novel-writing-guide/Novel Writing Project Guide.md
Alex 4b4ebeaf11 Guide v3.2.0: 리터칭 모드 및 창작 기법 추가
신규 파일:
- CHANGELOG.md: 리비전 관리 시작
- templates/standards/retouch-mode.md: Sonnet+Opus 병행 전략
- templates/standards/creative-writing.md: 장면 구성, POV, 감정선, 복선

수정 파일:
- Novel Writing Project Guide.md: v3.2.0 업데이트
  - 4가지 모드 체계 (WRITING/RETOUCH/MODIFICATION/VERIFICATION)
  - 리터칭 모드 섹션 추가
  - 파일 구조 업데이트
- templates/standards/writing-guide.md: v2.1
  - 대화문 형식 규칙 추가
  - 장면 전환 기법 추가

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-18 11:14:44 +09:00

56 KiB
Raw Blame History

소설 작성 프로젝트 표준 가이드 (v3.2)

작성일: 2026-01-15 버전: 3.2.0 최종 수정: 2026-01-18 목적: AI와 협업하여 장편 소설(10권 이상)을 체계적으로 작성하기 위한 표준 가이드


⚠️ 이 문서의 역할

📖 이 가이드는 "매뉴얼"입니다

용도:

  • 프로젝트 설정 시 1회만 참고
  • 워크플로우 이해
  • 파일 구조 학습
  • 작업 중에는 읽지 않음!

비유:

이 가이드 = 자동차 운전 교본 (처음 배울 때만)
CLAUDE.md = 내비게이션 (매번 운전할 때마다)

🤖 AI가 실제 작업 시 읽는 파일

매 세션마다 읽음:

✅ CLAUDE.md (각 프로젝트 고유!)
✅ volumes/vol-XX/characters.md
✅ volumes/vol-XX/timeline.md
✅ settings/writing-guide.md
✅ plots/plot-XXX-YYY.md
✅ summaries/summary-XXX-YYY.md

❌ Novel Writing Project Guide.md (이 파일!)

📋 실제 워크플로우

첫 프로젝트 시작:

1. 사용자: 이 가이드 읽기 (워크플로우 이해)
2. 사용자: "큰 틀 정하자"
3. AI: 이 가이드 참조하며 프로젝트 설정
4. AI: CLAUDE.md 생성 (프로젝트 고유 작업 지시서!)
5. AI: "실행 준비" → 폴더/파일/Git 자동 생성

→ 이후 이 가이드는 안 읽음!

이후 모든 작업 세션:

세션 시작:
→ CLAUDE.md 읽기 (프로젝트 규칙)
→ 작업 파일들 읽기
→ 작성 시작!

→ 이 가이드는 안 읽음! ✅

핵심:

  • 이 가이드 = 설정 방법 설명서
  • CLAUDE.md = 실제 작업 지시서

📌 목차

⚠️ 이 문서의 역할 ← 먼저 읽기!

  1. 문서 계층 구조 NEW
  2. 핵심 컨셉
  3. 모드 시스템 (리터칭 모드 추가)
  4. 전체 워크플로우
  5. 프로젝트 위치 선택
  6. 파일 구조
  7. Phase 1: 설계 (큰 틀)
  8. Phase 2: 권별 플롯
  9. Phase 3: 실행 준비
  10. Phase 4: 작성 모드
  11. Phase 5: 수정 모드 NEW
  12. Phase 6: 검증 모드 NEW
  13. Phase 7: 권 완료
  14. Phase 8: 다음 권
  15. CLAUDE.md 템플릿
  16. Git 자동화
  17. 토큰 효율 관리
  18. 파일 명명 규칙
  19. 부록

1. 문서 계층 구조

1.1 3단계 문서 체계

┌─────────────────────────────────────────────────────────┐
│ 🏛️ Guide (본 저장소)                                    │
│    └─ 소설 작성의 표준/원칙/템플릿                       │
│       └─ 어떻게 소설을 쓸 것인가?                        │
└─────────────────────────────────────────────────────────┘
        │
        │ 템플릿 제공
        ▼
┌─────────────────────────────────────────────────────────┐
│ 📚 프로젝트 (1945-novel 등)                              │
│    ├─ standards/ → 작업 방법론 (Guide에서 복사)          │
│    ├─ settings/ → 소설 고유 콘텐츠 (캐릭터, 플롯 등)     │
│    └─ volumes/  → 실제 원고                              │
└─────────────────────────────────────────────────────────┘

1.2 Guide vs 프로젝트

구분 Guide 저장소 프로젝트 저장소
용도 표준 정의 소설 작성
내용 템플릿, 가이드 실제 원고, 설정
변경 드물게 자주
예시 이 문서 1945-novel

1.3 프로젝트 내 폴더 분리

프로젝트/
├── standards/           # 🔧 작업 방법론 (Guide에서 복사)
│   ├── writing-mode.md       # 작성 모드 절차
│   ├── modification-mode.md  # 수정 모드 절차 (8유형)
│   ├── verification-mode.md  # 검증 모드 절차 (6단계)
│   ├── chapter-format.md     # 챕터 형식 표준
│   ├── writing-guide.md      # 문체/분량 규칙
│   └── renaming-protocol.md  # 리네임 안전 절차
│
├── settings/            # 📖 소설 고유 콘텐츠
│   ├── characters-master.md  # 전체 캐릭터 설정
│   ├── timeline-master.md    # 전체 타임라인
│   └── plot-master.md        # 전체 플롯
│
└── volumes/             # 📚 권별 원고
    └── vol-XX/
        ├── chapters/
        ├── summaries/
        └── plots/

핵심:

  • standards/ = "어떻게" (방법론, 모든 소설 공통)
  • settings/ = "무엇을" (이 소설만의 내용)

1.4 CURRENT-TASK.md 시스템

목적: 컴팩팅 후 맥락 복구

# 현재 작업 상태

**최종 업데이트:** YYYY-MM-DD HH:MM

---

## 모드
[WRITING / MODIFICATION / VERIFICATION]

## 작업
[현재 진행 중인 작업 설명]

---

## ✅ 완료된 작업
- [x] 완료 항목

## ⏳ 남은 작업
- [ ] 미완료 항목

---

## 다음 세션에서 할 일
1. 구체적 명령어

---

*이 파일은 컴팩팅 후 맥락 복구용입니다.*

사용법:

  1. 세션 시작 시 AI가 CURRENT-TASK.md 확인
  2. 작업 진행 중 상태 업데이트
  3. 세션 종료/컴팩팅 전 최신화
  4. 다음 세션에서 이 파일 기반으로 작업 재개

2. 핵심 컨셉

2.1 설계와 실행의 완전 분리

설계 단계 (마스터 파일):
→ 전체 10권 통합 설계
→ 일관성 검토 및 확정
→ 크고 무거움 (50,000 토큰)
→ 작성 시 읽지 않음!

실행 단계 (작업 파일):
→ 마스터에서 필요한 부분만 추출
→ 작고 가벼움 (2,000 토큰)
→ 매 세션마다 읽음

2.2 토큰 효율성 최우선

문제:

기존 방식:
- 전체 캐릭터 파일 (50,000 토큰)
- 전체 타임라인 (20,000 토큰)
- 전체 플롯 (10,000 토큰)
━━━━━━━━━━━━━━━━━━━━━
총: 80,000 토큰 읽기
→ 작성 여유: 120,000 토큰 (부족!)

해결:

새 방식:
- 1권 캐릭터 (2,000 토큰)
- 1권 타임라인 (2,000 토큰)
- 5화 플롯 (2,000 토큰)
- 누적 서머리 (3,000 토큰)
━━━━━━━━━━━━━━━━━━━━━
총: 13,000 토큰 읽기
→ 작성 여유: 187,000 토큰 (충분!)

2.3 5화 = 1작업 단위

사용자 관점:
- 5화 플롯 1개 작성
- "1~5화 작성해" 1번 명령
- 5화 서머리 1개 결과

AI 관점:
- 5화 = 최소 작업 단위
- plot-001-005.md (5화 플롯)
- summary-001-005.md (5화 결과)

2.4 누적 서머리로 일관성 유지

문제:
- 7권 쓸 때 1권 내용 잊어버림
- Claude 컨텍스트 한계 (6-8만자)

해결:
- 매 5화마다 서머리 누적
- summary-001-005.md
- summary-001-010.md (1-10화 전체!)
- summary-001-050.md (1권 전체!)
- summary-vol-01-final.md (압축 버전)

3. 모드 시스템

3.1 개요

AI 협업 시 4가지 작업 모드를 명확히 구분합니다.

모드 용도 진입 명령
WRITING 새 챕터 작성 (Sonnet) "1~5화 작성해"
RETOUCH 핵심 장면 품질 향상 (Opus) "리터칭해"
MODIFICATION 기존 내용 수정 "수정해" / "수정 모드"
VERIFICATION 전체 검증 "검증해" / "점검 모드"

3.2 작성 모드 (WRITING)

목적: 플롯 기반 신규 챕터 작성

진입: "1~5화 작성해" / "ch-XXX 써줘"
    ↓
파일 읽기 (자동):
- CLAUDE.md
- standards/writing-mode.md
- settings/characters-master.md (해당 권)
- volumes/vol-XX/timeline.md
- plots/plot-XXX-YYY.md
- summaries/summary-이전.md
    ↓
5화 연속 작성
    ↓
summary 누적 업데이트
    ↓
Git 커밋

핵심 규칙:

  • 플롯 기반 작성
  • 매 화마다 summary 업데이트
  • 바텀 금지 (헤더만 화수 표시)

3.3 수정 모드 (MODIFICATION)

목적: 기존 내용 변경 (8가지 유형)

유형 설명 복잡도
A. 단순 수정 오타, 문장 다듬기
B. 내용 수정 한 화 내용 변경
C. 다중 수정 여러 화 같은 변경
D. 플롯 수정 플롯 변경 → 본문 반영
E. 삽입 중간에 새 화 추가
F. 삭제 기존 화 삭제
G. 분할 한 화 → 두 화
H. 병합 두 화 → 한 화

핵심 규칙:

  • 수정된 챕터 이후 모든 summary 재생성 필수
  • 화수 변경 시 리네임 프로토콜 준수 (역순/정순)
  • Git 커밋 전 타임라인 검증

3.4 검증 모드 (VERIFICATION)

목적: 6단계 통합 검증

1단계: 구조 검증 (파일 존재/연속성)
2단계: 형식 검증 (헤더/타임라인/바텀)
3단계: 타임라인 검증 (날짜 순서/역행)
4단계: 내용 검증 (플롯 일치/호칭)
5단계: 일관성 검증 (앞뒤 연결/복선)
6단계: 보고서 생성

부분 검증 명령:

  • "타임라인만 검증해"
  • "호칭 검증해"
  • "바텀 검증해" → "바텀 일괄 제거해"

3.5 리터칭 모드 (RETOUCH)

목적: Sonnet 초안을 Opus로 품질 향상

Sonnet: 70~80% (속도, 일관성)
Opus: 20~30% (핵심 장면 리터칭)

리터칭 대상 기준:

우선순위 장면 유형 예시
필수 감정 정점 고백, 이별, 갈등 폭발
필수 권 시작/끝 1화, 50화
권장 복잡한 대화 협상, 3인 이상
권장 복선 회수 핵심 떡밥 회수

리터칭 명령:

"ch-003 리터칭해"
"ch-003 Part 2 리터칭해"
"필수 리터칭만 해"

핵심 규칙:

  • 플롯 변경 금지 (품질 향상만!)
  • 전후 맥락 유지
  • 분량 ±20% 이내

3.6 모드별 파일 읽기

파일 WRITING RETOUCH MODIFICATION VERIFICATION
CLAUDE.md
standards/writing-mode.md - - -
standards/retouch-mode.md - - -
standards/modification-mode.md - - -
standards/verification-mode.md - - -
settings/characters-master.md
volumes/vol-XX/timeline.md
volumes/vol-XX/plot-master.md - -
plots/plot-XXX-YYY.md - -
summaries/*

4. 전체 워크플로우

Phase 1: 설계 (큰 틀)

사용자: "큰 틀 정하자"
AI: 질문 시작 → 함께 작성

생성 파일:
✅ settings/characters-master.md
✅ settings/timeline-master.md
✅ settings/plot-master.md
✅ settings/writing-guide.md

→ 일관성 검토 → 확정

Phase 2: 권별 플롯

사용자: "1권 플롯 작성"
AI: plot-master 기반 상세화

생성 파일:
✅ volumes/vol-01/plot-master.md

→ 검토 → 확정

Phase 3: 실행 준비 (자동화)

사용자: "실행 준비"
AI: 자동 실행

생성:
✅ 폴더 구조
✅ 5화별 플롯 분할
✅ 권별 작업 파일 추출
✅ Git 저장소 초기화

Phase 4: 작성

사용자: "1~5화 작성해"
AI: 5화 연속 작성 + 서머리

생성:
✅ ch-001~005.md
✅ summary-001-005.md

Phase 5: 권 완료

50화 완료 시
AI: 자동 압축 서머리 생성

생성:
✅ summary-vol-01-final.md

Phase 6: 다음 권

사용자: "2권 실행 준비"
AI: vol-02 자동 설정

→ Phase 4로 반복

5. 프로젝트 위치 선택

5.1 권장 위치: Google Drive

경로:

L:\내 드라이브\Writing\[프로젝트명]\

예시:

L:\내 드라이브\Writing\1945-novel\
L:\내 드라이브\Writing\my-fantasy-story\

5.2 이중 백업 전략

로컬 (Google Drive):

L:\내 드라이브\Writing\1945-novel\
├── .git\          ← Git 저장소
├── settings\
├── volumes\
└── ...

→ Google Drive 자동 클라우드 백업
→ 여러 기기 자동 동기화

원격 (Gitea):

git.digien25.co.kr/Alex/1945-novel.git

→ 버전 관리
→ 변경 이력 추적
→ 독립적인 백업

5.3 장점

  1. Google Drive:

    • 실시간 클라우드 백업
    • 여러 PC에서 자동 동기화
    • 파일 복구 가능 (30일)
    • 대용량 무료 (15GB)
  2. Git + Gitea:

    • 버전 관리 (변경 이력)
    • 커밋 메시지로 작업 추적
    • 브랜치로 실험 가능
    • 독립적인 원격 백업
  3. 이중 백업:

    • Google Drive 장애 시 Git에서 복구
    • Git 서버 장애 시 Google Drive에서 복구
    • 최대 안정성

5.4 Git 작동 방식

자동 커밋/푸시:

1. 파일 수정 (L:\내 드라이브\Writing\1945-novel\)
2. AI가 자동 Git 커밋
3. AI가 자동 Gitea 푸시
4. Google Drive가 자동 클라우드 동기화

→ 이중 백업 완성!

충돌 방지:

✅ 한 PC에서만 작업
✅ 작업 전 git pull
✅ 작업 후 git push

❌ 여러 PC 동시 작업 금지

5.5 프로젝트명 규칙

권장:

✅ 영문 소문자 + 하이픈
✅ 1945-novel
✅ my-fantasy-story
✅ sci-fi-adventure

비권장:

❌ 한글: 1945-다시-시작된-역사
❌ 공백: my fantasy story
❌ 대문자: MyNovel
❌ 특수문자: my_novel!

6. 파일 구조

6.1 전체 구조

novel-project/
│
├── CLAUDE.md                    # AI 협업 프로토콜
├── CURRENT-TASK.md              # 현재 작업 상태 (컴팩팅 대응)
├── CHANGELOG.md                 # 변경 이력 (리비전 관리)
├── README.md                    # 프로젝트 소개
├── .gitignore
├── .gitattributes
│
├── standards/                   # 🔧 작업 방법론 (Guide에서 복사)
│   ├── writing-mode.md          # 작성 모드 절차
│   ├── retouch-mode.md          # 리터칭 모드 (Sonnet+Opus)
│   ├── modification-mode.md     # 수정 모드 절차 (8유형)
│   ├── verification-mode.md     # 검증 모드 절차 (6단계)
│   ├── chapter-format.md        # 챕터 형식 표준
│   ├── writing-guide.md         # 문체/분량/대화문 규칙
│   ├── creative-writing.md      # 창작 기법 (장면/POV/감정선)
│   └── renaming-protocol.md     # 리네임 안전 절차
│
├── settings/                    # 📖 소설 고유 콘텐츠
│   ├── characters-master.md     # 전체 캐릭터 + 호칭 규칙
│   ├── timeline-master.md       # 전체 타임라인
│   └── plot-master.md           # 전체 플롯
│
├── volumes/                     # 📚 권별 폴더
│   ├── vol-01/
│   │   ├── plot-master.md       # 1권 전체 플롯 (50화)
│   │   ├── characters.md        # 1권 캐릭터 (작업용, 작음!)
│   │   ├── timeline.md          # 1권 타임라인 (작업용, 작음!)
│   │   │
│   │   ├── plots/               # 📝 5화별 플롯 (작업용)
│   │   │   ├── plot-001-005.md
│   │   │   ├── plot-006-010.md
│   │   │   ├── plot-011-015.md
│   │   │   └── ...
│   │   │
│   │   ├── summaries/           # 📋 누적 서머리
│   │   │   ├── summary-001-005.md
│   │   │   ├── summary-001-010.md (누적!)
│   │   │   ├── summary-001-015.md (누적!)
│   │   │   ├── ...
│   │   │   ├── summary-001-050.md (1권 전체)
│   │   │   └── summary-vol-01-final.md ⭐ (압축, 2권용)
│   │   │
│   │   └── chapters/            # 📖 실제 원고
│   │       ├── ch-001.md
│   │       ├── ch-002.md
│   │       └── ...
│   │
│   ├── vol-02/
│   │   └── (동일 구조)
│   │
│   └── ...
│
├── docs/                        # 📁 문서
│   ├── todo.md
│   └── notes/
│
└── .git/                        # Git 저장소

6.2 파일 역할

파일 용도 크기 읽기 시점 업데이트
프로젝트 루트
CLAUDE.md AI 작업 지시 작음 매 세션 설정 변경 시
CURRENT-TASK.md 작업 상태 추적 작음 매 세션 작업 중 수시
standards/
writing-mode.md 작성 절차 작음 작성 모드 거의 없음
modification-mode.md 수정 절차 작음 수정 모드 거의 없음
verification-mode.md 검증 절차 작음 검증 모드 거의 없음
chapter-format.md 챕터 형식 작음 작성/검증 거의 없음
settings/
characters-master.md 전체 캐릭터 설계/작성 캐릭터 추가 시
timeline-master.md 전체 타임라인 설계/수정 수정 시
plot-master.md 전체 플롯 설계 시만 거의 없음
작업 파일
vol-XX/characters.md 권별 캐릭터 작음 매 세션 캐릭터 추가 시
vol-XX/timeline.md 권별 타임라인 작음 매 세션 수정 시
plots/plot-XXX-YYY.md 5화 플롯 작음 작성 세션 없음
summaries/summary-XXX-YYY.md 누적 요약 작음-중간 매 세션 매 화마다

7. Phase 1: 설계 (큰 틀)

7.1 시작 명령

사용자: "큰 틀 정하자"
또는: "새 소설 기획"
또는: "/design start"

7.2 AI 질문 프로세스

AI가 순차적으로 질문:

1. 장르:
   - "어떤 장르인가요?" (판타지, SF, 현대물, 대체역사, 로맨스 등)

2. 전체 구조:
   - "총 몇 권인가요?"
   - "각 권은 몇 화인가요?" (기본: 50화)

3. 시간 배경:
   - "시작 시점은?"
   - "종료 시점은?"
   - "전체 기간은?"

4. 주인공:
   - "주인공은 누구인가요?"
   - "나이, 직업, 성격은?"

5. 핵심 줄거리:
   - "전체 줄거리를 3-5문장으로?"
   - "1권 줄거리는?"
   - "최종 결말은?"

6. 주요 캐릭터:
   - "주요 조연은?"
   - "악역은?"

7. 세계관 (장르별):
   - 판타지: "마법 체계는?"
   - SF: "기술 수준은?"
   - 대체역사: "어떤 분기점인가요?"

8. 작성 스타일:
   - "어떤 톤으로 쓸까요?" (진지함, 유머, 로맨틱 등)
   - "시점은?" (1인칭, 3인칭)
   - "금지 사항은?"

7.3 생성 파일

7.3.1 characters-master.md

# 등장인물 통합 사전

> 전체 10권 통합
> 최종 수정: YYYY-MM-DD

## 주인공

### 강민준 (1925생, 회귀자)

**기본 정보:**
- 회귀: 2024년 42세 → 1945년 20세 설정
- 출신: 서울대 → 안보실 차장
- 1945년 신분: 광복군 출신

**성격:**
- 냉철하고 이성적
- 강한 책임감
- 목표 지향적

**말투:**
- 짧고 명확
- 존댓말 기본
- 화날 때: 반말

**권별 변화:**
| 권 | 나이 | 역할 | 주요 사건 | 내적 변화 |
|----|------|------|----------|----------|
| 1권 | 20세 | 회귀자 | 회귀, 건준 합류 | 혼란 → 결단 |
| 2권 | 22세 | 정치가 | 결혼, 통일정부 | 성장 → 성숙 |
| 3권 | 30세 | 고문 | 은퇴 | 원로화 |

**주요 관계:**
- 서윤희: 아내 (1947년 결혼)
- 박현우, 최태준: 동료 회귀자

**등장 권:**
- 1-5권 (주인공)
- 6권 (타계)

---

### (다른 캐릭터들...)

7.3.2 timeline-master.md

# 전체 타임라인 (1945-2024)

> 전체 10권
> 최종 수정: YYYY-MM-DD

## 📌 핵심 설정 (불변 규칙)

1948.8.15: 통일 대한민국 정부 수립 이후 계속 통일 상태 "북한" 존재하지 않음 한반도 전체가 대한민국


## 1권: 광복의 선택 (1945.8-1946.12)

### 시간 정보:

시작: 1945.8.16 종료: 1946.12.31 경과: 16개월


### 주요 사건:

#### 1945.8.16: 회귀
- **장소:** 어딘가 → 경성
- **등장인물:** 강민준, 박현우, 최태준
- **내용:** 2024년에서 1945년으로 회귀
- **영향:** 역사 변경 시작
- **복선:** "만주" 첫 언급

#### 1945.9.1: 건준 합류
- **장소:** 경성 건국준비위원회
- **등장인물:** 강민준, 여운형
- **내용:** 건준 정치국 합류
- **영향:** 정치적 기반 확보

...

### 권말 상황:
  • 강민준 상태: 정치 기반 확보, 서윤희 약혼
  • 주요 갈등: 이승만 대립 (해결: 미국 망명)
  • 다음 권 연결: 1947년 결혼, 통일정부 준비

## 2권: ...

## 복선 추적표 (전체)

| 복선 내용 | 설치 | 회수 | 상태 |
|----------|------|------|------|
| 만주 언급 | 1권 ch-003 | 2권 ch-010 | ✅ 완료 |
| ... | ... | ... | ... |

## 캐릭터 아크 (전체)

### 강민준:
| 권 | 나이 | 역할 | 내적 변화 |
|----|------|------|----------|
| 1권 | 20세 | 회귀자 | 혼란 → 결단 |
| 2권 | 22세 | 정치가 | 성장 → 성숙 |
...

7.3.3 plot-master.md

# 전체 줄거리 (10권)

> 최종 수정: YYYY-MM-DD

## 전체 개요

{전체 3-5문단 요약}

## 권별 줄거리

### 1권: 광복의 선택

**기간:** 1945.8 - 1946.12 (16개월)
**주제:** 회귀, 선택, 새로운 시작

**줄거리:**
{5-10문단}

**주요 사건:**
1. 회귀 (1945.8.16)
2. 건준 합류 (1945.9)
3. 트랜지스터 개발 (1946.6)
4. 만주 진출 (1946.9)
5. 약혼 (1946.12)

**권말:**
- 강민준: 정치 기반 확보
- 다음: 1947년 결혼

### 2권: ...

7.3.4 writing-guide.md

# 작성 가이드 (전체 공통)

> 최종 수정: YYYY-MM-DD

## 핵심 원칙

1. **Show, Don't Tell**
   - ❌ "강민준은 화가 났다"
   - ✅ "강민준의 주먹이 떨렸다"

2. **5감 묘사 필수**
   - 시각, 청각, 촉각, 후각, 미각

3. **대화와 묘사 비율**
   - 대화: 40%
   - 묘사: 40%
   - 서술: 20%

## 장르 특화 규칙

### 대체역사:
- 실제 역사와 차이점 명확히
- 연도/날짜 정확히
- 나이 계산 철저히

### 로맨스:
- 비율: 30% 이하
- 천천히 진행
- 감정 변화 단계적

## 속도 조절

- 1화 = 하루 ~ 3일
- 중요 장면: 느리게 (1일 = 2화도 OK)
- 일상: 빠르게 (1주일 = 1화도 OK)

## 금지 사항

❌ 갑작스러운 시간 점프 (설명 없이)
❌ 캐릭터 OOC (Out Of Character)
❌ 설정 모순
❌ Deus Ex Machina (신의 개입)

## 1화 적정 분량

**권장: 8,000 ~ 12,000자**

| 분량 | 평가 |
|------|------|
| 3,000-5,000자 | ❌ 너무 짧음 |
| 8,000-12,000자 | ✅ 적절 |
| 15,000-20,000자 | ⚠️ 너무 김 |

7.4 검토 및 확정

AI: "마스터 파일 생성 완료. 검토를 시작합니다."

검토 항목:
✅ 캐릭터 나이 일관성
✅ 타임라인 날짜 오류
✅ 복선 설치/회수 계획
✅ 권별 분량 균형
✅ 설정 모순 체크

사용자: "확정"
AI: "마스터 파일 확정. 권별 플롯 작성 가능합니다."

8. Phase 2: 권별 플롯

8.1 시작 명령

사용자: "1권 플롯 작성"
또는: "/plot vol-01"

8.2 플롯 작성

AI가 plot-master.md 기반으로 1권 50화 플롯 작성:

# 1권 플롯 (50화)

> 기간: 1945.8.16 - 1946.12.31
> 최종 수정: YYYY-MM-DD

## 1-5화: 회귀와 시작

### ch-001: 빛 속으로
**날짜:** 1945.8.16
**장소:** 어딘가 → 경성
**등장인물:** 강민준, 박현우, 최태준
**핵심:**
- 회귀 순간
- 세 사람 만남
- 기억 확인
**분량:** 10,000자
**복선:** "만주" 첫 언급

### ch-002: 경성에서
**날짜:** 1945.8.17
**장소:** 경성 거리
**등장인물:** 강민준, 서윤희(첫 등장)
**핵심:**
- 경성 도착
- 여운형 찾기
- 서윤희 첫 만남
**분량:** 10,000자

...

### ch-005: 건준 합류
**날짜:** 1945.9.1
**장소:** 건국준비위원회
**등장인물:** 강민준, 여운형
**핵심:**
- 건준 정치국 합류
- 여운형과 신뢰 구축
- 계획 시작
**분량:** 10,000자
**복선:** 이승만 경계

---

## 6-10화: ...

## 플롯 요약

| 챕터 | 날짜 | 핵심 사건 | 복선 |
|------|------|----------|------|
| 001 | 1945.8.16 | 회귀 | 만주 |
| 002 | 1945.8.17 | 서윤희 만남 | - |
...

8.3 검토 및 확정

AI: "1권 플롯 완성. 50화 구조 검토해주세요."

확인 사항:
✅ 각 화 분량 균형 (8,000-12,000자)
✅ 날짜 연속성
✅ 캐릭터 등장 타이밍
✅ 복선 배치

사용자: "확정"
AI: "1권 플롯 확정. 실행 준비 가능합니다."

9. Phase 3: 실행 준비

9.1 시작 명령

사용자: "실행 준비"
또는: "1권 실행 준비"
또는: "/setup vol-01"

9.2 자동 실행 프로세스

AI가 자동으로:

Step 1: 폴더 구조 생성

mkdir -p volumes/vol-01/plots
mkdir -p volumes/vol-01/summaries
mkdir -p volumes/vol-01/chapters
mkdir -p docs/notes

Step 2: 플롯 분할 (5화씩)

volumes/vol-01/plot-master.md를 읽어서:

plots/plot-001-005.md 생성 (ch-001~005 내용만)
plots/plot-006-010.md 생성 (ch-006~010 내용만)
plots/plot-011-015.md 생성 (ch-011~015 내용만)
...
plots/plot-046-050.md 생성 (ch-046~050 내용만)

각 파일 예시:

# 1-5화 플롯

> 날짜: 1945.8.16 - 1945.9.1
> 작성일: YYYY-MM-DD

## ch-001: 빛 속으로

**날짜:** 1945.8.16
**장소:** 어딘가 → 경성
**등장인물:** 강민준, 박현우, 최태준

**핵심 내용:**
- 회귀 순간 묘사
- 세 사람 만남
- 기억 확인 과정

**주요 장면:**
1. 눈부신 빛 (1,000자)
2. 낯선 경성 거리 (2,000자)
3. 세 사람 만남 (3,000자)
4. 기억 확인 (2,000자)
5. 결의 (2,000자)

**복선:**
- "만주... 만주가 핵심이다" (강민준 독백)

**분량:** 10,000자

---

## ch-002: ...

Step 3: 권별 작업 파일 추출

characters.md 생성:

settings/characters-master.md에서 1권 등장 캐릭터만 추출:

volumes/vol-01/characters.md 생성

내용 예시:

# 1권 등장인물

> 출처: characters-master.md
> 추출일: YYYY-MM-DD

## 주인공

### 강민준 (20세, 1945년 기준)

**기본 정보:**
- 회귀자 (2024 → 1945)
- 신분: 광복군 출신(위장)

**성격:**
- 냉철, 이성적
- 강한 책임감

**말투:**
- 짧고 명확
- 존댓말 기본

**1권 주요 사건:**
- ch-001: 회귀
- ch-005: 건준 합류
- ch-030: 서윤희 고백

**1권 말 상태:**
- 서윤희와 약혼
- 정치적 기반 확보

---

### (1권 등장 캐릭터만)

timeline.md 생성:

settings/timeline-master.md에서 1권 기간만 추출:

volumes/vol-01/timeline.md 생성

내용 예시:

# 1권 타임라인 (1945.8-1946.12)

> 출처: timeline-master.md
> 추출일: YYYY-MM-DD

## 핵심 설정

✅ 통일 대한민국 목표
❌ 분단 방지

## 주요 사건

### 1945.8.16: 회귀
- 강민준, 박현우, 최태준 회귀
- 경성 도착

### 1945.9.1: 건준 합류
- 여운형 만남
- 정치 활동 시작

...

## 1권 복선

| 복선 | 설치 | 회수 예정 |
|------|------|----------|
| 만주 언급 | ch-003 | 2권 |
| ... | ... | ... |

Step 4: Git 저장소 초기화

cd project-root
git init
git config user.name "Alex"
git config user.email "alex@digien25.co.kr"

# .gitignore 생성
cat > .gitignore << 'EOF'
# OS
.DS_Store
Thumbs.db

# Editor
.vscode/
.idea/
*.swp
*.swo

# Temp
*.tmp
~*

# Output
*.pdf
*.docx
EOF

# 초기 커밋
git add .
git commit -m "Initial commit: 1권 실행 준비 완료

- 폴더 구조 생성
- 플롯 5화별 분할 (10개 파일)
- 권별 작업 파일 추출
- Git 저장소 초기화

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"

# Gitea 원격 저장소 연결
git remote add origin https://Alex:d2ae36cb862375aaab2575fcad5268d276798b2b@git.digien25.co.kr/Alex/[프로젝트명].git
git branch -M main
git push -u origin main

9.3 완료 메시지

AI: "✅ 실행 준비 완료!

생성된 파일:
- 플롯 파일: 10개 (5화씩)
- characters.md (1권 캐릭터 13명)
- timeline.md (1945.8-1946.12)
- Git 저장소 초기화 완료
- Gitea 푸시 완료

다음 단계:
'1~5화 작성해' 명령으로 작성 시작 가능합니다."

10. Phase 4: 작성 모드

10.1 시작 명령

사용자: "1~5화 작성해"
또는: "ch-001~005 써줘"
또는: "/write 1-5"

10.2 세션 시작 (자동)

AI가 자동으로 파일 읽기:

🔄 세션 초기화...

읽기 (총 ~13,000 토큰):
✅ CLAUDE.md (2,000)
✅ volumes/vol-01/characters.md (2,000)
✅ volumes/vol-01/timeline.md (2,000)
✅ settings/writing-guide.md (3,000)
✅ plots/plot-001-005.md (2,000)
✅ summaries/summary-이전.md (없음 - 첫 시작)
✅ docs/todo.md (1,000)

준비 완료. ch-001부터 시작합니다.

10.3 챕터 형식 (바텀 금지!)

헤더 형식:

# [권수]권 [화수]화: [제목]

> **타임라인:** YYYY.M.D-M.D
> **장소:** 장소1, 장소2

바텀 절대 금지:

❌ [29화 끝]
❌ [2권 29화 끝]
❌ 다음 30화: 제목
❌ --- 끝 ---

이유:

  1. 헤더에 이미 화수 있음 (중복)
  2. 리넘버링 시 전부 수정 필요 (유지보수 지옥)
  3. 파일명/헤더와 불일치 위험

10.4 작성 프로세스

ch-001 작성:

AI: ch-001 작성 시작...

plot-001-005.md 참조:
- 날짜: 1945.8.16
- 장소: 어딘가 → 경성
- 핵심: 회귀 순간
- 분량: 10,000자

writing-guide.md 준수:
- Show, Don't Tell
- 5감 묘사
- 대화:묘사:서술 = 40:40:20

characters.md 참조:
- 강민준 성격: 냉철, 이성적
- 강민준 말투: 짧고 명확

작성 완료: ch-001.md (10,234자)

summaries/summary-001-005.md 업데이트:
━━━━━━━━━━━━━━━━━━━━━
# 1-5화 누적 서머리

> 최종 업데이트: 2026-01-15 10:30
> 현재: ch-001 (1화)

## 📌 전체 줄거리

1945년 8월 16일, 강민준, 박현우, 최태준이 2024년에서 1945년으로 회귀했다. 눈부신 빛 속에서 깨어난 세 사람은 경성 거리에서 만나 서로의 기억이 유지되었음을 확인한다.

## 📖 챕터별 핵심

### ch-001: 빛 속으로
**날짜:** 1945.8.16
**장소:** 어딘가 → 경성
**등장인물:** 강민준, 박현우, 최태준
**핵심 사건:**
- 회귀 순간
- 세 사람 만남
- 기억 확인
**다음 화:** 경성 도착 후 여운형 찾기

## 🎭 캐릭터 상태

### 강민준:
- ch-001: 회귀 직후, 냉철함 유지

## ⚠️ 복선

- [ ] 만주 언급 (ch-001 독백) → 회수: 2권

## 📊 통계

- 총 챕터: 1화
- 총 분량: 10,234자
━━━━━━━━━━━━━━━━━━━━━

ch-002 작성:

AI: ch-002 작성 시작...

(동일 프로세스)

summaries/summary-001-005.md 업데이트:
- ch-002 내용 추가 (누적!)

ch-003~005 작성:

(반복)

10.5 5화 완료

AI: "✅ 1-5화 작성 완료!

생성 파일:
- chapters/ch-001.md (10,234자)
- chapters/ch-002.md (9,876자)
- chapters/ch-003.md (11,023자)
- chapters/ch-004.md (10,456자)
- chapters/ch-005.md (9,987자)

총 분량: 51,576자

서머리:
- summaries/summary-001-005.md 생성

Git 커밋:
━━━━━━━━━━━━━━━━━━━━━
1-5화 작성 완료

- ch-001: 빛 속으로 (10,234자)
- ch-002: 경성에서 (9,876자)
- ch-003: 건준 (11,023자)
- ch-004: 여운형 (10,456자)
- ch-005: 합류 (9,987자)
- summary-001-005.md 생성

총 51,576자

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
━━━━━━━━━━━━━━━━━━━━━

Gitea 푸시 완료.

다음: '6~10화 작성해'"

10.6 작성 중 변경 사항

예: 새 캐릭터 추가

ch-007 작성 중:
→ 새 캐릭터 "김세우" 등장

AI 자동 업데이트:
1. volumes/vol-01/characters.md 업데이트
   → "김세우" 항목 추가

2. settings/characters-master.md 업데이트 ⭐
   → "김세우" 항목 추가 (전체 파일도!)

메시지:
"새 캐릭터 '김세우' 추가
- vol-01/characters.md 업데이트
- characters-master.md 업데이트"

예: 복선 추가

ch-009 작성 중:
→ "검은 반지" 복선 설치

AI 자동 업데이트:
1. volumes/vol-01/timeline.md 복선 추적표
   "검은 반지 언급: ch-009 → 회수: 2권"

2. settings/timeline-master.md 복선 추적표
   동일하게 추가

3. summaries/summary-001-010.md
   복선 섹션에 추가

11. Phase 5: 수정 모드

11.1 개요

기존 챕터 수정 시 사용하는 모드입니다. 수정 유형에 따라 8가지 절차가 있습니다.

11.2 수정 유형별 절차

유형 절차 Summary
A. 단순 수정 오타/문장 수정 → Git 불필요
B. 내용 수정 해당 화 수정 → 해당 summary만 재생성 해당만
C. 다중 수정 여러 화 수정 → 각 summary 재생성 각각
D. 플롯 수정 플롯 수정 → 본문 반영 → summary 재생성 전체
E. 삽입 역순 리네임 → 새 화 추가 → summary 재생성 전체
F. 삭제 정순 리네임 → summary 재생성 전체
G. 분할 한 화 → 두 화 → 역순 리네임 → summary 재생성 전체
H. 병합 두 화 → 한 화 → 정순 리네임 → summary 재생성 전체

11.3 핵심 규칙

Summary 재생성 규칙:

수정된 챕터 N이 있을 때:
→ N 이후의 모든 summary 재생성 필수!
→ summary-001-010에서 ch-005 수정
→ summary-001-005, summary-001-010, ... 모두 재생성

리네임 안전 규칙:

삽입/분할 (번호 +1) → 역순 리네임!
  ch-060 → ch-061
  ch-059 → ch-060
  ...
  ch-030 → ch-031

삭제/병합 (번호 -1) → 정순 리네임!
  ch-030 → ch-029
  ch-031 → ch-030
  ...
  ch-060 → ch-059

11.4 작업 절차

1. 영향 분석
   - 수정 유형 파악 (A~H 중)
   - 영향 범위 결정
   - Summary 재생성 범위 결정

2. 백업 (Git 커밋)

3. 수정 실행
   - 리네임 필요 시 프로토콜 준수
   - 헤더 화수 수정

4. Summary 재생성

5. 타임라인 검증

6. Git 커밋

12. Phase 6: 검증 모드

12.1 개요

작성/수정 완료 후 전체 일관성을 점검하는 모드입니다.

12.2 6단계 통합 검증

[1/6] 구조 검증
      - 파일 존재/연속성
      - 빠진 번호/중복 체크

[2/6] 형식 검증
      - 헤더 형식 (# X권 Y화: 제목)
      - 타임라인 형식 (YYYY.M.D-M.D)
      - 바텀 있는지 체크 ⭐

[3/6] 타임라인 검증
      - 시간 순서 확인
      - 역행 체크
      - 날짜 겹침 확인

[4/6] 내용 검증
      - 플롯 일치도
      - 호칭 일관성 ⭐
      - 캐릭터 등장/퇴장

[5/6] 일관성 검증
      - 앞뒤 연결
      - 복선 추적
      - 설정 충돌

[6/6] 보고서 생성
      - 전체 점수
      - 문제점 (심각도별)
      - 권장 조치

12.3 부분 검증

명령 실행 내용
"타임라인만 검증해" 3단계만
"호칭 검증해" 4단계 호칭만
"바텀 검증해" 2단계 바텀만
"바텀 일괄 제거해" 바텀 자동 제거

12.4 호칭 검증 기준

characters-master.md에 호칭 규칙 정의:

## 호칭 규칙
### 강민준 ↔ 서윤희
| 시점 | 민준→윤희 | 윤희→민준 |
|------|----------|----------|
| 첫 만남 | 서 선생님 | 강 선생님 |
| 친밀해진 후 | 윤희 씨 | 민준 씨 |
| 결혼 후 | 당신/윤희 | 당신/민준 |

13. Phase 7: 권 완료

13.1 50화 완료 시

사용자: "46~50화 작성해"

AI: (작성 완료 후)

"✅ 46-50화 완료!
✅ 1권 전체 50화 완료!

총 분량: 503,456자

자동 압축 시작..."

13.2 압축 서머리 생성

AI가 summary-001-050.md를 읽고 압축:

summaries/summary-vol-01-final.md 생성:

# 1권 최종 요약 (2권 작성용)

> 원본: summary-001-050.md (50화 전체)
> 압축일: YYYY-MM-DD
> 용도: 2권 작성 시 참조

## 📌 핵심 줄거리 (10문단)

1945년 8월 16일, 강민준, 박현우, 최태준이 2024년에서 1945년으로 회귀했다. 세 사람은 경성에 도착해 건국준비위원회에 합류하고 여운형과 연대한다.

이승만의 단독정부 야심을 저지하기 위해 강민준은 정치 활동을 시작한다. 박현우는 페니실린 생산을 시작하고, 최태준은 만주 진출을 준비한다.

강민준은 건준에서 서윤희를 처음 만나 그녀의 능력을 인정한다. 여운형과의 신뢰를 쌓으며 통일정부의 기반을 다진다.

1946년 2월, 최태준이 만주로 떠나 조선족 네트워크 구축을 시작한다. "쓸모없는 땅"을 매입하며 희토류 지역을 선점한다.

박현우는 트랜지스터 개발에 성공하여 세계를 앞서가기 시작한다. 반도체 산업의 기초를 놓는다.

이승만과의 대립이 심화되지만, 미군정의 지지를 얻는 데 성공한다. 이승만은 결국 미국으로 망명한다.

강민준과 서윤희의 관계가 발전한다. 덕수궁 돌담길에서 강민준이 고백하고 서윤희가 수락한다.

1946년 12월 25일, 두 사람은 명동성당에서 약혼식을 올린다. 가족과 동료들이 축복한다.

1권이 끝날 무렵, 강민준은 정치적 기반을 확보하고 통일정부 수립을 위한 계획을 구체화한다. 만주는 미래의 핵심 자원으로 준비 중이다.

1권은 회귀와 선택, 새로운 시작의 이야기로, 희망적인 분위기로 마무리된다.

## 🎭 주요 캐릭터 최종 상태

### 강민준:
- **나이:** 20세 → 21세
- **역할:** 회귀자 → 정치가
- **관계:** 서윤희와 약혼
- **성취:** 건준 핵심, 이승만 제거, 정치 기반 확보
- **성격 변화:** 혼란 → 결단 → 실행
- **2권 시작:** 1947년 결혼 예정

### 서윤희:
- **나이:** 27세 → 28세
- **역할:** 독립운동가 → 강민준의 파트너
- **관계:** 강민준과 약혼
- **성취:** 건준 활동, 여성 인권 운동
- **2권 시작:** 결혼, 통일정부 참여

### 박현우:
- **나이:** 회귀자 (외관 30대)
- **역할:** 과학자
- **성취:** 페니실린, 트랜지스터
- **2권 시작:** 반도체 연구 지속

### 최태준:
- **나이:** 회귀자 (외관 30대)
- **역할:** 실행 담당
- **위치:** 만주
- **성취:** 조선족 네트워크, 희토류 지역 선점
- **2권 시작:** 만주 공작 지속

## ⚠️ 미회수 복선 (2권에서 회수!)

| 복선 | 설치 화 | 내용 |
|------|---------|------|
| 만주 언급 | ch-003 | "만주가 핵심이다" |
| 희토류 | ch-030 | "쓸모없는 땅에 보물" |
| 트랜지스터 원리 | ch-025 | "이걸로 세계를 바꾼다" |

## 🔗 2권 연결점

**시간:**
- 1권 종료: 1946.12.31
- 2권 시작: 1947.1.1

**상황:**
- 강민준-서윤희 약혼 상태
- 1947.11 결혼 예정
- 1948.8.15 통일정부 수립 목표
- 만주 공작 진행 중

**주요 과제:**
- 통일정부 수립
- 만주 조차 협정 (1950 목표)
- 반도체 산업 기반
- 한국전쟁 방지

## 📊 1권 통계

- 총 화수: 50화
- 총 분량: 503,456자
- 평균 분량: 10,069자/화
- 기간: 1945.8.16 - 1946.12.31 (16개월)
- 등장 캐릭터: 23명
- 주요 사건: 47개

13.3 Git 커밋

git add .
git commit -m "1권 완료

- 50화 전체 완성 (503,456자)
- summary-vol-01-final.md 생성 (2권용 압축)
- 미회수 복선 3개 (2권에서 회수)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"

git push origin main

13.4 완료 메시지

AI: "🎉 1권 완료!

━━━━━━━━━━━━━━━━━━━━━
📚 1권: 광복의 선택

총 화수: 50화
총 분량: 503,456자
기간: 1945.8.16 - 1946.12.31

압축 서머리 생성:
✅ summary-vol-01-final.md (2권용)

미회수 복선: 3개
→ 2권에서 회수 예정

Git 푸시 완료.
━━━━━━━━━━━━━━━━━━━━━

다음 단계:
'2권 플롯 작성' 또는
'2권 실행 준비'"

14. Phase 8: 다음 권

14.1 2권 플롯 작성

사용자: "2권 플롯 작성"

AI: plot-master.md 참조
    summary-vol-01-final.md 참조 (1권 마무리 확인)

생성:
✅ volumes/vol-02/plot-master.md (50화)

검토 → 확정

14.2 2권 실행 준비

사용자: "2권 실행 준비"

AI 자동:
1. 폴더 생성
2. 플롯 분할 (10개)
3. characters.md 추출 (2권 캐릭터)
4. timeline.md 추출 (1947-1952)

완료!

14.3 2권 1-5화 작성

사용자: "1~5화 작성해"

AI 읽기:
✅ CLAUDE.md
✅ vol-02/characters.md
✅ vol-02/timeline.md
✅ settings/writing-guide.md
✅ plots/plot-001-005.md
✅ summaries/summary-vol-01-final.md ⭐ (1권 압축!)

작성:
ch-001~005

생성:
✅ summary-001-005.md (2권)

14.4 반복

Phase 4 반복...


15. CLAUDE.md 템플릿

# CLAUDE.md - AI 협업 프로토콜

> 프로젝트: [소설 제목]
> 장르: [장르]
> 권수: [N]권
> 작성일: YYYY-MM-DD

---

## 🔴 절대 규칙 (최우선)

1. **세션 시작 시 자동 실행** - 아래 "세션 시작 프로토콜" 무조건 실행
2. **5화 단위 작성** - 항상 5화씩 연속 작성
3. **서머리 자동 업데이트** - 각 화 완료 시 즉시 summary 업데이트
4. **설정 파일 우선** - settings/ 및 vol-XX/ 내용이 최우선
5. **일관성 검증** - 매 화마다 캐릭터/타임라인 체크
6. **마스터 파일 동기화** - 작업 파일 변경 시 마스터도 업데이트

---

## 📋 세션 시작 프로토콜

**세션 시작 시 (사용자 명령 없이) 자동 실행:**

  1. 이 파일 (CLAUDE.md) 읽기 (자동)
  2. volumes/vol-XX/characters.md 읽기
  3. volumes/vol-XX/timeline.md 읽기
  4. settings/writing-guide.md 읽기
  5. plots/plot-XXX-YYY.md 읽기 (이번 5화)
  6. summaries/summary-이전.md 읽기
  7. summaries/summary-vol-이전-final.md 읽기 (다른 권이면)
  8. docs/todo.md 읽기 (있으면)

**읽기 완료 후:**

"준비 완료. ch-XXX부터 시작합니다."


---

## 📝 작성 프로세스

### 각 화 작성 시:

  1. plot 파일 확인

    • 날짜, 장소, 등장인물
    • 핵심 내용, 주요 장면
    • 분량, 복선
  2. 메모리 참조 (파일 읽기 X!)

    • characters.md: 성격, 말투
    • timeline.md: 날짜 확인
    • writing-guide.md: 작성 규칙
    • summary: 이전 내용
  3. 작성

    • Show, Don't Tell
    • 5감 묘사
    • 대화:묘사:서술 = 40:40:20
    • 분량: 8,000-12,000자
  4. 완료 후 즉시

    • chapters/ch-XXX.md 저장
    • summaries/summary 업데이트 (누적!)
    • 변경사항 있으면 마스터 동기화

---

## 🔄 변경사항 처리

### 새 캐릭터 추가 시:
  1. volumes/vol-XX/characters.md 업데이트
  2. settings/characters-master.md 업데이트
  3. summary에 기록

### 복선 추가 시:
  1. volumes/vol-XX/timeline.md 복선 추적표
  2. settings/timeline-master.md 복선 추적표
  3. summary에 기록

### 설정 변경 시:

즉시 사용자에게 보고: "[변경사항] 발생. 확인 필요합니다."


---

## 📊 서머리 관리

### 형식:

```markdown
# X-Y화 누적 서머리

> 최종 업데이트: YYYY-MM-DD HH:MM
> 현재: ch-YYY (총 Y화)

## 📌 전체 줄거리
{누적 3-5문단}

## 📖 챕터별 핵심
### ch-XXX: [제목]
**날짜:** YYYY-MM-DD
**핵심:** 1줄 요약

## 🎭 캐릭터 상태
### [이름]:
- ch-XXX: 상태

## ⚠️ 복선
- [ ] [내용] (ch-XXX) → 회수: [시점]

## 📊 통계
- 총 챕터: Y화
- 총 분량: Z자

5화 완료 체크리스트

각 5화 완료 시 자동 실행:

✅ 5개 챕터 파일 생성
✅ summary 누적 업데이트
✅ 캐릭터/타임라인 변경사항 마스터 동기화
✅ Git 커밋
   형식:
   "X-Y화 작성 완료

   - ch-XXX: [제목] (Z자)
   ...
   - summary-XXX-YYY.md 업데이트

   총 Z자

   Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
✅ Git 푸시
✅ 다음 5화 안내

🎯 권 완료 체크리스트

50화 완료 시:

✅ summary-001-050.md 확인
✅ summary-vol-XX-final.md 생성 (압축!)
✅ 미회수 복선 정리
✅ Git 커밋
   "X권 완료

   - 50화 전체 (Z자)
   - summary-vol-XX-final.md 생성
   - 미회수 복선 N개

   Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
✅ Git 푸시
✅ 다음 권 안내

📌 프로젝트 정보

제목: [소설 제목] 장르: [장르] 권수: [N]권 화/권: 50화 분량/화: 8,000-12,000자 총 분량: 약 [N * 500,000]자

시간 배경: [시작] - [종료]

주인공: [이름]

핵심 줄거리: {3문장}


🚫 금지 사항

설정 파일 읽지 않고 작성 서머리 업데이트 생략 마스터 파일 동기화 누락 날짜/나이 오류 캐릭터 OOC 복선 누락


💡 명령어

설계:

  • "큰 틀 정하자" → Phase 1
  • "X권 플롯 작성" → Phase 2

실행:

  • "실행 준비" → Phase 3
  • "1~5화 작성해" → Phase 4

유틸:

  • "타임라인 검증" → 날짜 체크
  • "복선 현황" → 미회수 떡밥
  • "캐릭터 상태" → 현재 상태

AI는 이 파일을 항상 우선 읽고 규칙을 준수한다.


---

## 16. Git 자동화

### 16.1 Gitea 설정 정보

주소: git.digien25.co.kr 사용자: Alex 토큰: d2ae36cb862375aaab2575fcad5268d276798b2b


### 16.2 자동 초기화 (Phase 3)

```bash
# 저장소 초기화
git init
git config user.name "Alex"
git config user.email "alex@digien25.co.kr"

# .gitignore
cat > .gitignore << 'EOF'
# OS
.DS_Store
Thumbs.db

# Editor
.vscode/
.idea/
*.swp

# Temp
*.tmp
~*

# Output
*.pdf
*.docx
EOF

# .gitattributes
cat > .gitattributes << 'EOF'
*.md text eol=lf
*.txt text eol=lf
EOF

# 초기 커밋
git add .
git commit -m "Initial commit: 프로젝트 설정 완료

- 폴더 구조 생성
- 마스터 파일 작성
- 1권 플롯 완성
- 실행 준비 완료

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"

# Gitea 연결
git remote add origin https://Alex:d2ae36cb862375aaab2575fcad5268d276798b2b@git.digien25.co.kr/Alex/[프로젝트명].git
git branch -M main
git push -u origin main

16.3 자동 커밋 규칙

5화 완료 시:

git add .
git commit -m "1-5화 작성 완료

- ch-001: 빛 속으로 (10,234자)
- ch-002: 경성에서 (9,876자)
- ch-003: 건준 (11,023자)
- ch-004: 여운형 (10,456자)
- ch-005: 합류 (9,987자)
- summary-001-005.md 생성

총 51,576자

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"

git push origin main

권 완료 시:

git add .
git commit -m "1권 완료

- 50화 전체 완성 (503,456자)
- summary-vol-01-final.md 생성
- 미회수 복선 3개

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"

git push origin main

16.4 브랜치 전략

단순 전략 (권장):

main (모든 작업)

복잡한 실험 시:

main
├── vol-01 (1권 작업, 완료 후 병합)
└── vol-02 (2권 작업)

17. 토큰 효율 관리

17.1 토큰 계산

한글 토큰 비효율:

영어: 1단어 = ~1 토큰
한글: 1글자 = ~1.5 토큰

예시:
- "Hello World" (11자) = ~3 토큰
- "안녕하세요" (5자) = ~7.5 토큰

파일별 예상 토큰:

파일 크기 토큰
CLAUDE.md ~4,000자 ~2,000
characters.md (1권) ~3,000자 ~2,000
timeline.md (1권) ~3,000자 ~2,000
writing-guide.md ~6,000자 ~3,000
plot-001-005.md ~3,000자 ~2,000
summary-001-005.md ~3,000자 ~2,000
summary-vol-01-final.md ~5,000자 ~3,000

17.2 세션별 토큰

1권 첫 세션 (1-5화):

읽기:
- CLAUDE.md: 2,000
- characters.md: 2,000
- timeline.md: 2,000
- writing-guide.md: 3,000
- plot-001-005.md: 2,000
━━━━━━━━━━━━━━━━━━━━━
소계: 11,000 토큰

작성:
- 5화 × 10,000자 = 50,000자
- 50,000자 × 1.5 = 75,000 토큰

총: 86,000 토큰 (여유 충분!)

1권 중간 세션 (26-30화):

읽기:
- CLAUDE.md: 2,000
- characters.md: 2,500 (캐릭터 추가됨)
- timeline.md: 2,500
- writing-guide.md: 3,000
- plot-026-030.md: 2,000
- summary-001-025.md: 10,000 (누적!)
━━━━━━━━━━━━━━━━━━━━━
소계: 22,000 토큰

작성: 75,000 토큰

총: 97,000 토큰 (여전히 OK!)

2권 첫 세션 (1-5화):

읽기:
- CLAUDE.md: 2,000
- characters.md: 2,000
- timeline.md: 2,000
- writing-guide.md: 3,000
- plot-001-005.md: 2,000
- summary-vol-01-final.md: 3,000 ⭐
━━━━━━━━━━━━━━━━━━━━━
소계: 14,000 토큰

작성: 75,000 토큰

총: 89,000 토큰 (OK!)

17.3 최적화 전략

서머리 압축:

summary-001-050.md (50화 전체):
- 크기: ~50,000자
- 토큰: ~30,000

→ 너무 큼!

summary-vol-01-final.md (압축):
- 크기: ~5,000자
- 토큰: ~3,000

→ 10배 감소! ✅

캐릭터 파일 분리:

characters-master.md (전체 10권):
- 100명 × 500자 = 50,000자
- 토큰: ~30,000

→ 작성 시 읽지 않음!

characters.md (1권만):
- 20명 × 150자 = 3,000자
- 토큰: ~2,000

→ 15배 감소! ✅

18. 파일 명명 규칙

18.1 기본 원칙

모든 파일/폴더명은 영문 소문자 + 하이픈

대상 규칙 예시
폴더명 kebab-case vol-01, character-arcs
설정 파일 kebab-case characters.md, writing-guide.md
챕터 파일 ch-NNN.md ch-001.md, ch-050.md
플롯 파일 plot-NNN-MMM.md plot-001-005.md
서머리 파일 summary-NNN-MMM.md summary-001-005.md

18.2 권별 폴더명

vol-01  (1권)
vol-02  (2권)
vol-03  (3권)
...
vol-10  (10권)

18.3 챕터 파일명

ch-001.md   (1화)
ch-002.md   (2화)
...
ch-050.md   (50화)
ch-100.md   (100화, 2권 50화)

18.4 주의사항

❌ 한글 파일명: 1권_16화_새로운_가능성.md
✅ 영문 파일명: ch-016.md

❌ 공백: ch 001.md
✅ 하이픈: ch-001.md

❌ 대문자: CH-001.md
✅ 소문자: ch-001.md

❌ CamelCase: plotChapter001.md
✅ kebab-case: plot-001-005.md

19. 부록

19.1 전체 명령어 목록

설계:

"큰 틀 정하자"
"새 소설 기획"
"/design start"

플롯:

"1권 플롯 작성"
"/plot vol-01"

실행 준비:

"실행 준비"
"1권 실행 준비"
"/setup vol-01"

작성:

"1~5화 작성해"
"ch-001~005 써줘"
"/write 1-5"

유틸:

"타임라인 검증"
"복선 현황"
"캐릭터 상태"
"/check timeline"
"/check foreshadowing"
"/check characters"

19.2 FAQ

Q: 5화 작성 중 컴팩팅 발생하면? A: 세션 종료 후 재시작. summary 덕분에 일관성 유지.

Q: 플롯과 다르게 쓰고 싶으면? A: 사용자가 명시적으로 변경 요청. AI가 plot 파일 업데이트.

Q: 캐릭터 추가는? A: AI가 자동으로 vol-XX/characters.md + master 양쪽 업데이트.

Q: 권 완료 후 수정하려면? A: 해당 챕터만 수정 → summary 재생성 → final 재생성.

Q: Git 충돌 발생하면? A: 수동 해결 후 AI에게 "/git status" 보고.

19.3 트러블슈팅

문제: 토큰 초과 해결:

  1. summary 압축 확인
  2. 작업 파일 크기 확인
  3. 5화 → 3화로 축소

문제: 일관성 오류 해결:

  1. "타임라인 검증" 실행
  2. "캐릭터 상태" 확인
  3. summary 재생성

문제: Git 푸시 실패 해결:

  1. 토큰 만료 확인
  2. 네트워크 확인
  3. 수동 푸시

변경 이력

v3.2.0 (2026-01-18)

  • 리비전 관리 시작
    • CHANGELOG.md 생성
    • Semantic Versioning 도입
  • 리터칭 모드 추가
    • retouch-mode.md 생성
    • Sonnet+Opus 병행 전략
    • 리터칭 대상 기준 정의
  • 창작 기법 문서 추가
    • creative-writing.md 생성
    • 장면 구성, POV, 감정선, 복선 관리
  • 작성 가이드 확장
    • 대화문 형식 규칙 추가
    • 장면 전환 기법 추가

v3.1.0 (2026-01-18)

  • 문서 계층 구조 정립
    • Guide (표준) vs 프로젝트 (실행) 분리
    • standards/ (방법론) vs settings/ (콘텐츠) 분리
  • CURRENT-TASK.md 시스템
    • 컴팩팅 후 맥락 복구용
    • 세션 시작 시 자동 확인
  • 바텀 금지 표준화
    • 헤더만 화수 표시
    • 바텀 완전 제거
    • 검증 모드에서 자동 감지/제거
  • 수정 모드 8유형 체계화
    • A~H 유형별 절차 명확화
    • Summary 재생성 규칙 강화
  • 검증 모드 6단계 통합
    • 호칭/바텀 검증 포함
    • 부분 검증 명령 지원
  • 템플릿 폴더 구조
    • templates/standards/ 생성
    • 각 모드별 독립 문서

v3.0 (2026-01-17)

  • 모드 시스템 구축 (핵심!)
    • WRITING: 신규 작성
    • MODIFICATION: 기존 수정
    • VERIFICATION: 전체 점검
  • 수정 프로토콜 체계화
    • Summary 재생성 강제화
    • 타임라인 검증 자동화
    • CHANGELOG 의무화
  • 챕터 형식 표준 문서화
    • chapter-format.md
    • 헤더 형식 규칙
    • 타임라인 연속성 검증
  • 안전한 리네임 절차
    • renaming-protocol.md
    • 2단계 리네임
    • 자동화 스크립트

v2.0 (2026-01-15)

  • 완전 재작성
  • 문서 역할 명확화 (매뉴얼 vs 작업 지시서)
  • 설계/실행 분리
  • 토큰 효율 최우선
  • 5화 작업 단위
  • 누적 서머리
  • Git 자동화
  • Gitea 통합

v1.0 (2026-01-14)

  • 초기 버전

📌 v3.0 주요 개선 사항

문제 해결

이전 문제:

컴팩팅 → 맥락 손실 → 수정이 이상한 방향으로
→ Summary 누락 → 플롯/본문/서머리 따로 놀음
→ 리네임 시 파일 손실 위험
→ 무엇이 변경되었는지 모름

v3.0 해결:

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

새로운 파일 구조

settings/
├── writing-guide.md              # 작성 규칙 (기존)
├── chapter-format-standard.md    # 챕터 형식 표준 (신규)
├── writing-mode.md               # 작성 모드 절차 (신규)
├── modification-mode.md          # 수정 모드 절차 (신규)
├── verification-mode.md          # 점검 모드 절차 (신규)
└── renaming-protocol.md          # 안전한 리네임 (신규)

volumes/vol-XX/
├── CHANGELOG.md                  # 권별 변경 이력 (신규)
└── WORK-MODE.txt                 # 현재 작업 모드 (임시)

워크플로우 변화

작성 모드 (변경 없음):

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

수정 모드 (완전히 새로운 절차):

"수정 준비해" → 계획서 작성 → WORK-MODE.txt 생성
→ [컴팩팅]
→ "수정 실행" → 수정 → summary 재생성 → 타임라인 검증 → CHANGELOG 업데이트 → Git

점검 모드 (신규):

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

작성자: Alex 최종 수정: 2026-01-18 버전: 3.2.0 라이선스: 개인 프로젝트