# 소설 프로젝트 폴더 구조 > **버전:** 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