91d3715737
**생성 파일:** - 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 <noreply@anthropic.com>
308 lines
9.0 KiB
Markdown
308 lines
9.0 KiB
Markdown
# 소설 프로젝트 폴더 구조
|
|
|
|
> **버전:** 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
|