novel-writing-guide/templates/project-structure.md

소설 프로젝트 폴더 구조

버전: 4.0 (Single Source of Truth) 작성일: 2026-01-23 용도: 새 프로젝트 폴더 구조 참조 주요 변경: claude.md 필수, standards 파일 Guide 참조

---

📁 전체 구조

novel-project/
│
├── claude.md                    # ⭐ Claude 작업 규칙 (필수!)
├── CLAUDE.md                    # AI 협업 프로토콜 (deprecated)
├── README.md                    # 프로젝트 소개
├── CHANGELOG.md                 # 전체 변경 이력
├── .gitignore                   # Git 제외 파일
├── .gitattributes               # Git 속성
│
├── settings/                    # 🎨 마스터 파일 (설계용)
│   ├── characters-master.md     # 전체 권 통합 캐릭터
│   ├── timeline-master.md       # 전체 타임라인
│   ├── plot-master.md           # 전체 권 줄거리
│   └── writing-guide.md         # 전체 공통 작성 규칙
│
│   # ⚠️ standards 파일들은 Guide/templates/standards/에서 읽기!
│   # 프로젝트별로 복사하지 않음!
│
├── 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	⭐ Claude 작업 규칙 (표준 위치 명시, 필수!)	프로젝트 시작 시 1회
CLAUDE.md	AI 협업 프로토콜 (deprecated)	거의 없음
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 토큰)	작성 규칙	매 세션

⚠️ standards 파일은 프로젝트에 복사하지 않음!

모든 standards 파일은 Guide/templates/standards/에서 읽기:

• verification-mode.md (검증)
• fix-mode.md (수정)
• polish-mode.md (다듬기)
• modification-mode.md (수정)
• writing-mode.md (작성)
• file-formats.md (형식)
• chapter-format.md (챕터)
• creative-writing.md (창작)
• retouch-mode.md (재작성)
• renaming-protocol.md (리네임)

이유: Single Source of Truth - 버전 불일치 방지

---

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 0: 프로젝트 초기화 (v4.0)

# claude.md 생성 (필수!)
cp ../Guide/templates/claude.md.template ./claude.md
# 프로젝트명 수정 필요!

Phase 1: 설계

mkdir settings
# characters-master.md, timeline-master.md, plot-master.md 작성

Phase 2: 권별 플롯

mkdir -p volumes/vol-01
# vol-01/plot-master.md 작성

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

mkdir -p volumes/vol-01/{plots,summaries,chapters}
# 플롯 분할, 작업 파일 추출, Git 초기화

Phase 4: 작성

# "1~5화 작성해" 명령
# chapters/ch-001~005.md 생성
# summaries/summary-001-005.md 생성

---

📌 참고

• 메인 가이드: Novel Writing Project Guide.md
• 템플릿:
  • templates/claude.md.template ⭐ (필수!)
  • templates/CLAUDE.md.template (선택)
  • templates/chapter-template.md
  • templates/project-structure.md (이 파일)
• 표준 파일: templates/standards/ (중앙 관리)

---

작성일: 2026-01-23 버전: 4.0 작성자: Alex