commit 91d3715737d60417e1cc5d6d1e9dd79b0a8cd4fe Author: Alex Date: Sat Jan 17 09:38:06 2026 +0900 Guide 저장소 초기화 (v3.0) **생성 파일:** - Novel Writing Project Guide.md (v3.0, 45KB) - README.md (저장소 소개) - .gitignore **템플릿:** - templates/CLAUDE.md.template - templates/chapter-template.md - templates/project-structure.md **목적:** - 소설 프로젝트 공통 가이드 버전 관리 - 템플릿 파일 제공 - 다른 프로젝트 시작 시 참조 **v3.0 특징:** - 모드 시스템 (WRITING/MODIFICATION/VERIFICATION) - 컴팩팅 대응 (WORK-MODE.txt) - 수정 프로토콜 체계화 Co-Authored-By: Claude Sonnet 4.5 diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..c1d5a6a --- /dev/null +++ b/.gitignore @@ -0,0 +1,35 @@ +# OS +.DS_Store +.DS_Store? +._* +.Spotlight-V100 +.Trashes +ehthumbs.db +Thumbs.db + +# Windows +desktop.ini +$RECYCLE.BIN/ + +# Editor +.vscode/ +.idea/ +*.swp +*.swo +*.swn +*~ + +# Temp +*.tmp +~* +*.bak +*.backup + +# Output +*.pdf +*.docx +*.epub +*.mobi + +# Logs +*.log diff --git a/Novel Writing Project Guide.md b/Novel Writing Project Guide.md new file mode 100644 index 0000000..6aef707 --- /dev/null +++ b/Novel Writing Project Guide.md @@ -0,0 +1,2073 @@ +# 소설 작성 프로젝트 표준 가이드 (v2.0) + +> **작성일:** 2026-01-15 +> **버전:** 2.0 +> **목적:** 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 = 실제 작업 지시서 + +--- + +## 📌 목차 + +**⚠️ [이 문서의 역할](#%EF%B8%8F-이-문서의-역할)** ← 먼저 읽기! + +1. [핵심 컨셉](#1-핵심-컨셉) +2. [전체 워크플로우](#2-전체-워크플로우) +3. [프로젝트 위치 선택](#3-프로젝트-위치-선택) +4. [파일 구조](#4-파일-구조) +5. [Phase 1: 설계 (큰 틀)](#5-phase-1-설계-큰-틀) +6. [Phase 2: 권별 플롯](#6-phase-2-권별-플롯) +7. [Phase 3: 실행 준비](#7-phase-3-실행-준비) +8. [Phase 4: 작성](#8-phase-4-작성) +9. [Phase 5: 권 완료](#9-phase-5-권-완료) +10. [Phase 6: 다음 권](#10-phase-6-다음-권) +11. [CLAUDE.md 템플릿](#11-claudemd-템플릿) +12. [Git 자동화](#12-git-자동화) +13. [토큰 효율 관리](#13-토큰-효율-관리) +14. [파일 명명 규칙](#14-파일-명명-규칙) +15. [부록](#15-부록) + +--- + +## 1. 핵심 컨셉 + +### 1.1 설계와 실행의 완전 분리 + +``` +설계 단계 (마스터 파일): +→ 전체 10권 통합 설계 +→ 일관성 검토 및 확정 +→ 크고 무거움 (50,000 토큰) +→ 작성 시 읽지 않음! + +실행 단계 (작업 파일): +→ 마스터에서 필요한 부분만 추출 +→ 작고 가벼움 (2,000 토큰) +→ 매 세션마다 읽음 +``` + +### 1.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 토큰 (충분!) +``` + +### 1.3 5화 = 1작업 단위 + +``` +사용자 관점: +- 5화 플롯 1개 작성 +- "1~5화 작성해" 1번 명령 +- 5화 서머리 1개 결과 + +AI 관점: +- 5화 = 최소 작업 단위 +- plot-001-005.md (5화 플롯) +- summary-001-005.md (5화 결과) +``` + +### 1.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 (압축 버전) +``` + +--- + +## 2. 전체 워크플로우 + +### 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로 반복 +``` + +--- + +## 3. 프로젝트 위치 선택 + +### 3.1 권장 위치: Google Drive + +**경로:** +``` +L:\내 드라이브\Writing\[프로젝트명]\ +``` + +**예시:** +``` +L:\내 드라이브\Writing\1945-novel\ +L:\내 드라이브\Writing\my-fantasy-story\ +``` + +### 3.2 이중 백업 전략 + +**로컬 (Google Drive):** +``` +L:\내 드라이브\Writing\1945-novel\ +├── .git\ ← Git 저장소 +├── settings\ +├── volumes\ +└── ... + +→ Google Drive 자동 클라우드 백업 +→ 여러 기기 자동 동기화 +``` + +**원격 (Gitea):** +``` +git.digien25.co.kr/Alex/1945-novel.git + +→ 버전 관리 +→ 변경 이력 추적 +→ 독립적인 백업 +``` + +### 3.3 장점 + +1. **Google Drive:** + - 실시간 클라우드 백업 + - 여러 PC에서 자동 동기화 + - 파일 복구 가능 (30일) + - 대용량 무료 (15GB) + +2. **Git + Gitea:** + - 버전 관리 (변경 이력) + - 커밋 메시지로 작업 추적 + - 브랜치로 실험 가능 + - 독립적인 원격 백업 + +3. **이중 백업:** + - Google Drive 장애 시 Git에서 복구 + - Git 서버 장애 시 Google Drive에서 복구 + - 최대 안정성 + +### 3.4 Git 작동 방식 + +**자동 커밋/푸시:** +``` +1. 파일 수정 (L:\내 드라이브\Writing\1945-novel\) +2. AI가 자동 Git 커밋 +3. AI가 자동 Gitea 푸시 +4. Google Drive가 자동 클라우드 동기화 + +→ 이중 백업 완성! +``` + +**충돌 방지:** +``` +✅ 한 PC에서만 작업 +✅ 작업 전 git pull +✅ 작업 후 git push + +❌ 여러 PC 동시 작업 금지 +``` + +### 3.5 프로젝트명 규칙 + +**권장:** +``` +✅ 영문 소문자 + 하이픈 +✅ 1945-novel +✅ my-fantasy-story +✅ sci-fi-adventure +``` + +**비권장:** +``` +❌ 한글: 1945-다시-시작된-역사 +❌ 공백: my fantasy story +❌ 대문자: MyNovel +❌ 특수문자: my_novel! +``` + +--- + +## 4. 파일 구조 + +### 4.1 전체 구조 + +``` +novel-project/ +│ +├── CLAUDE.md # AI 협업 프로토콜 +├── README.md # 프로젝트 소개 +├── CHANGELOG.md # 변경 이력 +├── .gitignore +├── .gitattributes +│ +├── settings/ # 🎨 마스터 파일 (설계용) +│ ├── characters-master.md # 전체 10권 통합 캐릭터 +│ ├── timeline-master.md # 1945-2024 전체 타임라인 +│ ├── plot-master.md # 전체 10권 줄거리 +│ └── writing-guide.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 저장소 +``` + +### 4.2 파일 역할 + +| 파일 | 용도 | 크기 | 읽기 시점 | 업데이트 | +|------|------|------|----------|----------| +| **마스터 파일** | | | | | +| `characters-master.md` | 전체 설계 | 큼 | 설계 시만 | 작성 중 필요 시 | +| `timeline-master.md` | 전체 설계 | 큼 | 설계 시만 | 작성 중 필요 시 | +| `plot-master.md` | 전체 설계 | 큼 | 설계 시만 | 거의 없음 | +| `writing-guide.md` | 작성 규칙 | 중간 | 매 세션 | 거의 없음 | +| **작업 파일** | | | | | +| `vol-XX/characters.md` | 작성 | 작음 | 매 세션 | 작성 중 필요 시 | +| `vol-XX/timeline.md` | 작성 | 작음 | 매 세션 | 작성 중 필요 시 | +| `plots/plot-XXX-YYY.md` | 작성 | 작음 | 매 세션 | 없음 | +| `summaries/summary-XXX-YYY.md` | 작성 | 작음-중간 | 매 세션 | 매 화마다 | + +--- + +## 5. Phase 1: 설계 (큰 틀) + +### 5.1 시작 명령 + +``` +사용자: "큰 틀 정하자" +또는: "새 소설 기획" +또는: "/design start" +``` + +### 5.2 AI 질문 프로세스 + +AI가 순차적으로 질문: + +``` +1. 장르: + - "어떤 장르인가요?" (판타지, SF, 현대물, 대체역사, 로맨스 등) + +2. 전체 구조: + - "총 몇 권인가요?" + - "각 권은 몇 화인가요?" (기본: 50화) + +3. 시간 배경: + - "시작 시점은?" + - "종료 시점은?" + - "전체 기간은?" + +4. 주인공: + - "주인공은 누구인가요?" + - "나이, 직업, 성격은?" + +5. 핵심 줄거리: + - "전체 줄거리를 3-5문장으로?" + - "1권 줄거리는?" + - "최종 결말은?" + +6. 주요 캐릭터: + - "주요 조연은?" + - "악역은?" + +7. 세계관 (장르별): + - 판타지: "마법 체계는?" + - SF: "기술 수준은?" + - 대체역사: "어떤 분기점인가요?" + +8. 작성 스타일: + - "어떤 톤으로 쓸까요?" (진지함, 유머, 로맨틱 등) + - "시점은?" (1인칭, 3인칭) + - "금지 사항은?" +``` + +### 5.3 생성 파일 + +#### 5.3.1 characters-master.md + +```markdown +# 등장인물 통합 사전 + +> 전체 10권 통합 +> 최종 수정: YYYY-MM-DD + +## 주인공 + +### 강민준 (1925생, 회귀자) + +**기본 정보:** +- 회귀: 2024년 42세 → 1945년 20세 설정 +- 출신: 서울대 → 안보실 차장 +- 1945년 신분: 광복군 출신 + +**성격:** +- 냉철하고 이성적 +- 강한 책임감 +- 목표 지향적 + +**말투:** +- 짧고 명확 +- 존댓말 기본 +- 화날 때: 반말 + +**권별 변화:** +| 권 | 나이 | 역할 | 주요 사건 | 내적 변화 | +|----|------|------|----------|----------| +| 1권 | 20세 | 회귀자 | 회귀, 건준 합류 | 혼란 → 결단 | +| 2권 | 22세 | 정치가 | 결혼, 통일정부 | 성장 → 성숙 | +| 3권 | 30세 | 고문 | 은퇴 | 원로화 | + +**주요 관계:** +- 서윤희: 아내 (1947년 결혼) +- 박현우, 최태준: 동료 회귀자 + +**등장 권:** +- 1-5권 (주인공) +- 6권 (타계) + +--- + +### (다른 캐릭터들...) +``` + +#### 5.3.2 timeline-master.md + +```markdown +# 전체 타임라인 (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세 | 정치가 | 성장 → 성숙 | +... +``` + +#### 5.3.3 plot-master.md + +```markdown +# 전체 줄거리 (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권: ... +``` + +#### 5.3.4 writing-guide.md + +```markdown +# 작성 가이드 (전체 공통) + +> 최종 수정: 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자 | ⚠️ 너무 김 | +``` + +### 5.4 검토 및 확정 + +``` +AI: "마스터 파일 생성 완료. 검토를 시작합니다." + +검토 항목: +✅ 캐릭터 나이 일관성 +✅ 타임라인 날짜 오류 +✅ 복선 설치/회수 계획 +✅ 권별 분량 균형 +✅ 설정 모순 체크 + +사용자: "확정" +AI: "마스터 파일 확정. 권별 플롯 작성 가능합니다." +``` + +--- + +## 6. Phase 2: 권별 플롯 + +### 6.1 시작 명령 + +``` +사용자: "1권 플롯 작성" +또는: "/plot vol-01" +``` + +### 6.2 플롯 작성 + +AI가 plot-master.md 기반으로 1권 50화 플롯 작성: + +```markdown +# 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 | 서윤희 만남 | - | +... +``` + +### 6.3 검토 및 확정 + +``` +AI: "1권 플롯 완성. 50화 구조 검토해주세요." + +확인 사항: +✅ 각 화 분량 균형 (8,000-12,000자) +✅ 날짜 연속성 +✅ 캐릭터 등장 타이밍 +✅ 복선 배치 + +사용자: "확정" +AI: "1권 플롯 확정. 실행 준비 가능합니다." +``` + +--- + +## 7. Phase 3: 실행 준비 + +### 7.1 시작 명령 + +``` +사용자: "실행 준비" +또는: "1권 실행 준비" +또는: "/setup vol-01" +``` + +### 7.2 자동 실행 프로세스 + +AI가 자동으로: + +#### Step 1: 폴더 구조 생성 +```bash +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 내용만) +``` + +각 파일 예시: + +```markdown +# 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권 등장 캐릭터만 추출: + +```bash +volumes/vol-01/characters.md 생성 +``` + +내용 예시: +```markdown +# 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권 기간만 추출: + +```bash +volumes/vol-01/timeline.md 생성 +``` + +내용 예시: +```markdown +# 1권 타임라인 (1945.8-1946.12) + +> 출처: timeline-master.md +> 추출일: YYYY-MM-DD + +## 핵심 설정 + +✅ 통일 대한민국 목표 +❌ 분단 방지 + +## 주요 사건 + +### 1945.8.16: 회귀 +- 강민준, 박현우, 최태준 회귀 +- 경성 도착 + +### 1945.9.1: 건준 합류 +- 여운형 만남 +- 정치 활동 시작 + +... + +## 1권 복선 + +| 복선 | 설치 | 회수 예정 | +|------|------|----------| +| 만주 언급 | ch-003 | 2권 | +| ... | ... | ... | +``` + +#### Step 4: Git 저장소 초기화 + +```bash +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 " + +# Gitea 원격 저장소 연결 +git remote add origin https://Alex:d2ae36cb862375aaab2575fcad5268d276798b2b@git.digien25.co.kr/Alex/[프로젝트명].git +git branch -M main +git push -u origin main +``` + +### 7.3 완료 메시지 + +``` +AI: "✅ 실행 준비 완료! + +생성된 파일: +- 플롯 파일: 10개 (5화씩) +- characters.md (1권 캐릭터 13명) +- timeline.md (1945.8-1946.12) +- Git 저장소 초기화 완료 +- Gitea 푸시 완료 + +다음 단계: +'1~5화 작성해' 명령으로 작성 시작 가능합니다." +``` + +--- + +## 8. Phase 4: 작성 + +### 8.1 시작 명령 + +``` +사용자: "1~5화 작성해" +또는: "ch-001~005 써줘" +또는: "/write 1-5" +``` + +### 8.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부터 시작합니다. +``` + +### 8.3 작성 프로세스 + +#### 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 작성: +``` +(반복) +``` + +### 8.4 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 +━━━━━━━━━━━━━━━━━━━━━ + +Gitea 푸시 완료. + +다음: '6~10화 작성해'" +``` + +### 8.5 작성 중 변경 사항 + +#### 예: 새 캐릭터 추가 +``` +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 + 복선 섹션에 추가 +``` + +--- + +## 9. Phase 5: 권 완료 + +### 9.1 50화 완료 시 + +``` +사용자: "46~50화 작성해" + +AI: (작성 완료 후) + +"✅ 46-50화 완료! +✅ 1권 전체 50화 완료! + +총 분량: 503,456자 + +자동 압축 시작..." +``` + +### 9.2 압축 서머리 생성 + +AI가 `summary-001-050.md`를 읽고 압축: + +`summaries/summary-vol-01-final.md` 생성: + +```markdown +# 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개 +``` + +### 9.3 Git 커밋 + +```bash +git add . +git commit -m "1권 완료 + +- 50화 전체 완성 (503,456자) +- summary-vol-01-final.md 생성 (2권용 압축) +- 미회수 복선 3개 (2권에서 회수) + +Co-Authored-By: Claude Sonnet 4.5 " + +git push origin main +``` + +### 9.4 완료 메시지 + +``` +AI: "🎉 1권 완료! + +━━━━━━━━━━━━━━━━━━━━━ +📚 1권: 광복의 선택 + +총 화수: 50화 +총 분량: 503,456자 +기간: 1945.8.16 - 1946.12.31 + +압축 서머리 생성: +✅ summary-vol-01-final.md (2권용) + +미회수 복선: 3개 +→ 2권에서 회수 예정 + +Git 푸시 완료. +━━━━━━━━━━━━━━━━━━━━━ + +다음 단계: +'2권 플롯 작성' 또는 +'2권 실행 준비'" +``` + +--- + +## 10. Phase 6: 다음 권 + +### 10.1 2권 플롯 작성 + +``` +사용자: "2권 플롯 작성" + +AI: plot-master.md 참조 + summary-vol-01-final.md 참조 (1권 마무리 확인) + +생성: +✅ volumes/vol-02/plot-master.md (50화) + +검토 → 확정 +``` + +### 10.2 2권 실행 준비 + +``` +사용자: "2권 실행 준비" + +AI 자동: +1. 폴더 생성 +2. 플롯 분할 (10개) +3. characters.md 추출 (2권 캐릭터) +4. timeline.md 추출 (1947-1952) + +완료! +``` + +### 10.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권) +``` + +### 10.4 반복 + +Phase 4 반복... + +--- + +## 11. CLAUDE.md 템플릿 + +```markdown +# 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 " +✅ 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 " +✅ Git 푸시 +✅ 다음 권 안내 +``` + +--- + +## 📌 프로젝트 정보 + +**제목:** [소설 제목] +**장르:** [장르] +**권수:** [N]권 +**화/권:** 50화 +**분량/화:** 8,000-12,000자 +**총 분량:** 약 [N * 500,000]자 + +**시간 배경:** [시작] - [종료] + +**주인공:** [이름] + +**핵심 줄거리:** +{3문장} + +--- + +## 🚫 금지 사항 + +❌ 설정 파일 읽지 않고 작성 +❌ 서머리 업데이트 생략 +❌ 마스터 파일 동기화 누락 +❌ 날짜/나이 오류 +❌ 캐릭터 OOC +❌ 복선 누락 + +--- + +## 💡 명령어 + +### 설계: +- "큰 틀 정하자" → Phase 1 +- "X권 플롯 작성" → Phase 2 + +### 실행: +- "실행 준비" → Phase 3 +- "1~5화 작성해" → Phase 4 + +### 유틸: +- "타임라인 검증" → 날짜 체크 +- "복선 현황" → 미회수 떡밥 +- "캐릭터 상태" → 현재 상태 + +--- + +*AI는 이 파일을 항상 우선 읽고 규칙을 준수한다.* +``` + +--- + +## 12. Git 자동화 + +### 12.1 Gitea 설정 정보 + +``` +주소: git.digien25.co.kr +사용자: Alex +토큰: d2ae36cb862375aaab2575fcad5268d276798b2b +``` + +### 12.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 " + +# Gitea 연결 +git remote add origin https://Alex:d2ae36cb862375aaab2575fcad5268d276798b2b@git.digien25.co.kr/Alex/[프로젝트명].git +git branch -M main +git push -u origin main +``` + +### 12.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 " + +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 " + +git push origin main +``` + +### 12.4 브랜치 전략 + +**단순 전략 (권장):** +``` +main (모든 작업) +``` + +**복잡한 실험 시:** +``` +main +├── vol-01 (1권 작업, 완료 후 병합) +└── vol-02 (2권 작업) +``` + +--- + +## 13. 토큰 효율 관리 + +### 13.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 | + +### 13.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!) +``` + +### 13.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배 감소! ✅ +``` + +--- + +## 14. 파일 명명 규칙 + +### 14.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` | + +### 14.2 권별 폴더명 + +``` +vol-01 (1권) +vol-02 (2권) +vol-03 (3권) +... +vol-10 (10권) +``` + +### 14.3 챕터 파일명 + +``` +ch-001.md (1화) +ch-002.md (2화) +... +ch-050.md (50화) +ch-100.md (100화, 2권 50화) +``` + +### 14.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 +``` + +--- + +## 15. 부록 + +### 15.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" +``` + +### 15.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" 보고. + +### 15.3 트러블슈팅 + +**문제: 토큰 초과** +해결: +1. summary 압축 확인 +2. 작업 파일 크기 확인 +3. 5화 → 3화로 축소 + +**문제: 일관성 오류** +해결: +1. "타임라인 검증" 실행 +2. "캐릭터 상태" 확인 +3. summary 재생성 + +**문제: Git 푸시 실패** +해결: +1. 토큰 만료 확인 +2. 네트워크 확인 +3. 수동 푸시 + +--- + +## 변경 이력 + +### v3.0 (2026-01-17) +- ✅ **모드 시스템 구축** (핵심!) + - WRITING: 신규 작성 + - MODIFICATION: 기존 수정 + - VERIFICATION: 전체 점검 + - DISCUSSION: 협의/논의 +- ✅ **수정 프로토콜 체계화** + - Summary 재생성 강제화 + - 타임라인 검증 자동화 + - CHANGELOG 의무화 +- ✅ **챕터 형식 표준 문서화** + - chapter-format-standard.md + - 헤더 형식 규칙 + - 타임라인 연속성 검증 +- ✅ **안전한 리네임 절차** + - renaming-protocol.md + - 2단계 리네임 + - 자동화 스크립트 +- ✅ **WORK-MODE.txt 시스템** + - 모드 전환 메커니즘 + - 맥락 손실 방지 + - 컴팩팅 대응 + +### 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-17 +**버전:** 3.0 +**라이선스:** 개인 프로젝트 diff --git a/README.md b/README.md new file mode 100644 index 0000000..ca106eb --- /dev/null +++ b/README.md @@ -0,0 +1,253 @@ +# Novel Writing Guide + +> **버전:** 3.0 +> **최종 수정:** 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: 협의/논의 모드 + +--- + +## 📁 템플릿 폴더 (templates/) + +새 소설 프로젝트 시작 시 복사해서 사용하는 템플릿 파일들입니다. + +### 제공 템플릿: +- **CLAUDE.md.template**: AI 협업 프로토콜 템플릿 +- **chapter-template.md**: 챕터 파일 기본 형식 +- **project-structure.md**: 프로젝트 폴더 구조 가이드 + +--- + +## 🚀 새 프로젝트 시작하기 + +### 1. 이 가이드 읽기 +``` +L:\내 드라이브\Writing\Guide\Novel Writing Project Guide.md +``` +전체 워크플로우와 시스템을 이해합니다. + +### 2. 프로젝트 폴더 생성 +```bash +cd "L:\내 드라이브\Writing" +mkdir my-novel-project +cd my-novel-project +``` + +### 3. 템플릿 복사 +```bash +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.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.0 +**라이선스**: 개인 프로젝트 diff --git a/templates/CLAUDE.md.template b/templates/CLAUDE.md.template new file mode 100644 index 0000000..c8e6390 --- /dev/null +++ b/templates/CLAUDE.md.template @@ -0,0 +1,288 @@ +# CLAUDE.md - AI 협업 프로토콜 + +> **프로젝트:** [소설 제목] +> **장르:** [장르] +> **권수:** [N]권 +> **작성일:** YYYY-MM-DD + +--- + +## 🔴 절대 규칙 (최우선) + +1. **세션 시작 시 자동 실행** - 아래 "세션 시작 프로토콜" 무조건 실행 +2. **모드 확인** - WORK-MODE.txt 확인 후 해당 모드 프로토콜 실행 (v3.0) +3. **5화 단위 작성** - 항상 5화씩 연속 작성 +4. **서머리 자동 업데이트** - 각 화 완료 시 즉시 summary 업데이트 +5. **설정 파일 우선** - settings/ 및 vol-XX/ 내용이 최우선 +6. **일관성 검증** - 매 화마다 캐릭터/타임라인 체크 +7. **마스터 파일 동기화** - 작업 파일 변경 시 마스터도 업데이트 + +--- + +## 📋 세션 시작 프로토콜 (v3.0) + +**Step 1: 이 파일 읽기** ✅ (자동) + +**Step 2: 모드 확인 (최우선!)** ⭐⭐⭐ + +```bash +# WORK-MODE.txt 확인 +if [ -f "volumes/vol-XX/WORK-MODE.txt" ]; then + MODE=$(grep "^MODE:" volumes/vol-XX/WORK-MODE.txt | cut -d: -f2 | xargs) +else + MODE="UNKNOWN" +fi +``` + +**MODE별 분기:** + +**MODE = "MODIFICATION"** (수정 모드) +``` +→ settings/modification-mode.md 읽기 +→ 수정 프로토콜 실행 +→ 이 파일 이하 실행 중단! (modification-mode.md만 따름) +``` + +**MODE = "VERIFICATION"** (점검 모드) +``` +→ settings/verification-mode.md 읽기 +→ 점검 프로토콜 실행 +→ 이 파일 이하 실행 중단! +``` + +**MODE = "UNKNOWN"** 또는 **없음** (작성 모드, 기본) +``` +→ 계속 진행 (아래 Step 3 실행) +→ settings/writing-mode.md 읽기 (선택) +``` + +**Step 3: 작성 모드 파일 읽기** + +세션 시작 시 자동 실행: + +``` +1. 이 파일 (CLAUDE.md) 읽기 ✅ (자동) +2. WORK-MODE.txt 확인 ✅ (Step 2) +3. volumes/vol-XX/characters.md 읽기 +4. volumes/vol-XX/timeline.md 읽기 +5. settings/writing-guide.md 읽기 +6. plots/plot-XXX-YYY.md 읽기 (이번 5화) +7. summaries/summary-이전.md 읽기 ⭐ +8. summaries/summary-vol-이전-final.md 읽기 (다른 권이면) +9. 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 " +✅ 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 " +✅ Git 푸시 +✅ 다음 권 안내 +``` + +--- + +## 📌 프로젝트 정보 + +**제목:** [소설 제목] +**장르:** [장르] +**권수:** [N]권 +**화/권:** 50화 +**분량/화:** 8,000-12,000자 +**총 분량:** 약 [N * 500,000]자 + +**시간 배경:** [시작] - [종료] + +**주인공:** [이름] + +**핵심 줄거리:** +{3문장} + +--- + +## 🚫 금지 사항 + +❌ 설정 파일 읽지 않고 작성 +❌ 서머리 업데이트 생략 +❌ 마스터 파일 동기화 누락 +❌ 날짜/나이 오류 +❌ 캐릭터 OOC +❌ 복선 누락 +❌ WORK-MODE.txt 무시 (v3.0) +❌ 수정 시 summary 재생성 누락 (v3.0) + +--- + +## 💡 명령어 + +### 설계: +- "큰 틀 정하자" → Phase 1 +- "X권 플롯 작성" → Phase 2 + +### 실행: +- "실행 준비" → Phase 3 +- "1~5화 작성해" → Phase 4 + +### 수정 (v3.0): +- "수정 준비해: [문제명]" → 수정 모드 준비 +- "수정 실행" → 수정 모드 실행 + +### 점검 (v3.0): +- "점검해" → 전체 검증 + +### 유틸: +- "타임라인 검증" → 날짜 체크 +- "복선 현황" → 미회수 떡밥 +- "캐릭터 상태" → 현재 상태 + +--- + +## 📚 참고 파일 + +### 공통 (settings/): +- `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-XX/): +- `CHANGELOG.md`: 변경 이력 (v3.0) +- `WORK-MODE.txt`: 현재 모드 (v3.0, 임시) + +--- + +*AI는 이 파일을 항상 우선 읽고 규칙을 준수한다.* + +*v3.0에서는 WORK-MODE.txt 확인이 최우선이다!* diff --git a/templates/chapter-template.md b/templates/chapter-template.md new file mode 100644 index 0000000..9b5b558 --- /dev/null +++ b/templates/chapter-template.md @@ -0,0 +1,129 @@ +# X권 Y화: [제목] + +> **타임라인:** YYYY.M.D-M.D +> **장소:** [장소1], [장소2] +> **등장인물:** [인물A], [인물B], [인물C] + +--- + +## Part 1: [소제목] + +[첫 장면 묘사] + +[대화] + +"대사 내용," [인물A]가 말했다. + +"답변 내용," [인물B]가 고개를 끄덕이며 답했다. + +[행동 묘사] + +--- + +## Part 2: [소제목] + +[두 번째 장면] + +--- + +## Part 3: [소제목] + +[세 번째 장면] + +--- + +## Part 4: [소제목] + +[네 번째 장면] + +--- + +## Part 5: [소제목] + +[마지막 장면] + +--- + +**[권 X화 종료]** + +--- + +## 📝 작성 가이드 + +### 헤더 형식 (필수!) +```markdown +# X권 Y화: [제목] + +> **타임라인:** YYYY.M.D-M.D +> **장소:** [장소1], [장소2] +> **등장인물:** [주요 등장인물 나열] +``` + +### 분량 가이드 +- **권장 분량:** 8,000 ~ 12,000자 +- **최소 분량:** 6,000자 (너무 짧음 주의) +- **최대 분량:** 15,000자 (너무 길면 분할 고려) + +### 구조 +- **Part 개수:** 3~7개 (유동적) +- **Part별 분량:** 1,500~3,000자 +- **시작:** 장면 설정 및 분위기 +- **중간:** 갈등/사건 전개 +- **끝:** 다음 화로 연결 + +### 작성 원칙 + +#### 1. Show, Don't Tell +```markdown +❌ "강민준은 화가 났다." +✅ "강민준의 주먹이 떨렸다. 그의 눈빛이 차갑게 식었다." +``` + +#### 2. 5감 묘사 +- **시각:** 색, 형태, 움직임 +- **청각:** 소리, 음색, 리듬 +- **촉각:** 질감, 온도, 압력 +- **후각:** 향기, 냄새 +- **미각:** 맛 (필요시) + +#### 3. 대화와 묘사 균형 +- **대화:** 40% +- **묘사:** 40% +- **서술:** 20% + +#### 4. 타임라인 연속성 +- **이전 화 종료일 ≤ 현재 화 시작일** +- 시간 역행 금지 +- 날짜 겹침 금지 + +#### 5. 캐릭터 일관성 +- **성격:** characters.md 참조 +- **말투:** 캐릭터별 특징 유지 +- **나이:** 계산 정확히 + +--- + +## 🚫 금지 사항 + +❌ 갑작스러운 시간 점프 (설명 없이) +❌ 캐릭터 OOC (Out Of Character) +❌ 설정 모순 +❌ Deus Ex Machina (신의 개입) +❌ 타임라인 오류 +❌ 과도한 설명 (Tell) +❌ 감정 직접 서술 + +--- + +## 📌 참고 + +- **플롯:** plots/plot-XXX-YYY.md +- **캐릭터:** volumes/vol-XX/characters.md +- **타임라인:** volumes/vol-XX/timeline.md +- **작성 규칙:** settings/writing-guide.md +- **챕터 형식:** settings/chapter-format-standard.md + +--- + +**작성일:** YYYY-MM-DD +**버전:** 1.0 diff --git a/templates/project-structure.md b/templates/project-structure.md new file mode 100644 index 0000000..1377e63 --- /dev/null +++ b/templates/project-structure.md @@ -0,0 +1,307 @@ +# 소설 프로젝트 폴더 구조 + +> **버전:** 3.0 (모드 시스템 포함) +> **작성일:** YYYY-MM-DD +> **용도:** 새 프로젝트 폴더 구조 참조 + +--- + +## 📁 전체 구조 + +``` +novel-project/ +│ +├── CLAUDE.md # AI 협업 프로토콜 ⭐ +├── README.md # 프로젝트 소개 +├── CHANGELOG.md # 전체 변경 이력 +├── .gitignore # Git 제외 파일 +├── .gitattributes # Git 속성 +│ +├── 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: 1권 변경 이력 +│ │ ├── WORK-MODE.txt # v3.0: 현재 작업 모드 (임시) +│ │ ├── 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 +│ │ ├── ch-003.md +│ │ └── ... +│ │ +│ ├── vol-02/ +│ │ ├── CHANGELOG.md # v3.0 +│ │ ├── WORK-MODE.txt # v3.0 (임시) +│ │ └── (동일 구조) +│ │ +│ └── ... +│ +├── docs/ # 📁 문서 +│ ├── todo.md +│ └── notes/ +│ +└── .git/ # Git 저장소 +``` + +--- + +## 📂 폴더별 설명 + +### 루트 폴더 + +| 파일 | 용도 | 업데이트 주기 | +|------|------|--------------| +| `CLAUDE.md` | AI 협업 프로토콜, 세션마다 자동 읽음 | 거의 없음 | +| `README.md` | 프로젝트 소개, 독자/협업자용 | 필요 시 | +| `CHANGELOG.md` | 전체 변경 이력 (선택) | 주요 변경 시 | + +--- + +### settings/ (마스터 파일) + +**용도:** 전체 권 통합 설계, 작성 시 읽지 않음! + +| 파일 | 크기 | 용도 | 읽기 시점 | +|------|------|------|----------| +| `characters-master.md` | 큼 (30,000 토큰) | 전체 캐릭터 통합 | 설계 시만 | +| `timeline-master.md` | 큼 (20,000 토큰) | 전체 타임라인 | 설계 시만 | +| `plot-master.md` | 큼 (10,000 토큰) | 전체 줄거리 | 설계 시만 | +| `writing-guide.md` | 중간 (3,000 토큰) | 작성 규칙 | 매 세션 | + +**v3.0 추가 파일:** +| 파일 | 용도 | 읽기 시점 | +|------|------|----------| +| `chapter-format-standard.md` | 챕터 형식 표준 | 설정 시, 수정 시 | +| `writing-mode.md` | 작성 모드 절차 | 작성 시 | +| `modification-mode.md` | 수정 모드 절차 | 수정 시 | +| `verification-mode.md` | 점검 모드 절차 | 점검 시 | +| `renaming-protocol.md` | 안전한 리네임 | 리네임 시 | + +--- + +### volumes/vol-XX/ (권별 폴더) + +**용도:** 각 권의 작업 파일 (작고 가벼움) + +| 파일 | 크기 | 용도 | 읽기 시점 | +|------|------|------|----------| +| `CHANGELOG.md` | 작음 | 권별 변경 이력 (v3.0) | 필요 시 | +| `WORK-MODE.txt` | 극소 | 현재 작업 모드 (v3.0, 임시) | 매 세션 시작 | +| `plot-master.md` | 큼 | 해당 권 전체 플롯 | 플롯 작성 시만 | +| `characters.md` | 작음 (2,000 토큰) | 해당 권 캐릭터만 | 매 세션 | +| `timeline.md` | 작음 (2,000 토큰) | 해당 권 타임라인만 | 매 세션 | + +--- + +### volumes/vol-XX/plots/ (5화별 플롯) + +**용도:** 5화씩 분할된 플롯 (작업용) + +| 파일 | 생성 시점 | 읽기 시점 | +|------|----------|----------| +| `plot-001-005.md` | Phase 3 (실행 준비) | 1-5화 작성 시 | +| `plot-006-010.md` | Phase 3 | 6-10화 작성 시 | +| `plot-011-015.md` | Phase 3 | 11-15화 작성 시 | +| ... | ... | ... | + +--- + +### volumes/vol-XX/summaries/ (누적 서머리) + +**용도:** 각 화 작성 후 누적 서머리 + +| 파일 | 크기 | 생성 시점 | 읽기 시점 | +|------|------|----------|----------| +| `summary-001-005.md` | 작음 (2,000 토큰) | 5화 완료 시 | 6화 이후 | +| `summary-001-010.md` | 작음 (3,000 토큰) | 10화 완료 시 | 11화 이후 | +| `summary-001-015.md` | 작음 (4,000 토큰) | 15화 완료 시 | 16화 이후 | +| ... | ... | ... | ... | +| `summary-001-050.md` | 큼 (30,000 토큰) | 50화 완료 시 | 압축 시만 | +| `summary-vol-01-final.md` | 작음 (3,000 토큰) ⭐ | 권 완료 시 | 다음 권 작성 시 | + +--- + +### volumes/vol-XX/chapters/ (실제 원고) + +**용도:** 실제 소설 원고 파일 + +| 파일 | 분량 | 생성 시점 | +|------|------|----------| +| `ch-001.md` | 8,000-12,000자 | 1화 작성 시 | +| `ch-002.md` | 8,000-12,000자 | 2화 작성 시 | +| ... | ... | ... | + +--- + +## 📊 파일 크기 비교 + +### 토큰 효율성 (한글 1글자 ≈ 1.5 토큰) + +**마스터 파일 (설계용, 작성 시 읽지 않음!):** +``` +characters-master.md: 50,000자 → 30,000 토큰 +timeline-master.md: 20,000자 → 20,000 토큰 +plot-master.md: 10,000자 → 10,000 토큰 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +합계: 80,000자 → 60,000 토큰 ❌ 너무 큼! +``` + +**작업 파일 (작성 시 읽음):** +``` +CLAUDE.md: 2,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 토큰 +━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ +합계: 20,000자 → 13,000 토큰 ✅ 적절! +``` + +**여유 토큰:** +``` +전체 토큰: 200,000 +읽기 토큰: -13,000 +━━━━━━━━━━━━━━━━━━ +작성 여유: 187,000 토큰 (충분!) +``` + +--- + +## 🔄 v3.0 모드 시스템 + +### WORK-MODE.txt 예시 + +**작성 모드 (기본, 없음):** +``` +(파일 없음 또는 MODE: WRITING) +``` + +**수정 모드:** +``` +MODE: MODIFICATION +TASK: ch-029/030 타임라인 역전 수정 +REPORT: 2권_완전_재검증_보고서.md +PLAN: modification-plan-20260117.md +SCOPE: ch-029, 030, summary-001-030~060 +VOL: vol-02 +CREATED: 2026-01-17 16:00 +``` + +**점검 모드:** +``` +MODE: VERIFICATION +TASK: 2권 전체 점검 +CREATED: 2026-01-17 16:30 +``` + +--- + +## 📋 파일 명명 규칙 + +### 권별 폴더: +``` +vol-01 (1권) +vol-02 (2권) +... +vol-10 (10권) +``` + +### 챕터 파일: +``` +ch-001.md (1화) +ch-002.md (2화) +... +ch-050.md (50화) +ch-051.md (2권 1화) +``` + +### 플롯 파일: +``` +plot-001-005.md (1-5화) +plot-006-010.md (6-10화) +... +plot-046-050.md (46-50화) +``` + +### 서머리 파일: +``` +summary-001-005.md (1-5화 누적) +summary-001-010.md (1-10화 누적) +... +summary-001-050.md (1-50화 누적) +summary-vol-01-final.md (압축 버전) +``` + +--- + +## 🚀 프로젝트 생성 순서 + +### Phase 1: 설계 +```bash +mkdir settings +# characters-master.md, timeline-master.md, plot-master.md 작성 +``` + +### Phase 2: 권별 플롯 +```bash +mkdir -p volumes/vol-01 +# vol-01/plot-master.md 작성 +``` + +### Phase 3: 실행 준비 (자동화) +```bash +mkdir -p volumes/vol-01/{plots,summaries,chapters} +# 플롯 분할, 작업 파일 추출, Git 초기화 +``` + +### Phase 4: 작성 +```bash +# "1~5화 작성해" 명령 +# chapters/ch-001~005.md 생성 +# summaries/summary-001-005.md 생성 +``` + +--- + +## 📌 참고 + +- **메인 가이드:** `Novel Writing Project Guide.md` +- **템플릿:** + - `templates/CLAUDE.md.template` + - `templates/chapter-template.md` + - `templates/project-structure.md` (이 파일) + +--- + +**작성일:** YYYY-MM-DD +**버전:** 3.0 +**작성자:** Alex