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

소설 프로젝트 폴더 구조

버전: 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: 설계

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/chapter-template.md
  • templates/project-structure.md (이 파일)

---

작성일: YYYY-MM-DD 버전: 3.0 작성자: Alex