271c11d6fc
- claude.md.template 추가 (프로젝트별 필수 파일) - README.md v4.0: Single Source of Truth 핵심 컨셉 추가 - project-structure.md v4.0: claude.md 필수화, standards 제거 - standards 파일들은 Guide/templates/standards/에서만 관리 - 프로젝트별/권별 standards 복사 금지 - 버전 불일치 원천 차단 주요 변경사항: 1. 새 프로젝트 시작 시 claude.md 생성 필수 2. 모든 모드 진입 시 Guide/templates/standards/ 참조 3. 프로젝트 내 standards/ 디렉토리 생성 금지 4. volumes/vol-XX/validation-standards.md 생성 금지 이유: 표준 파일이 여러 곳에 복사되면 버전 불일치 발생 해결: Guide를 유일한 소스로 지정, claude.md로 강제 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
324 lines
9.3 KiB
Markdown
324 lines
9.3 KiB
Markdown
# 소설 프로젝트 폴더 구조
|
|
|
|
> **버전:** 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)
|
|
```bash
|
|
# claude.md 생성 (필수!)
|
|
cp ../Guide/templates/claude.md.template ./claude.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/CLAUDE.md.template` (선택)
|
|
- `templates/chapter-template.md`
|
|
- `templates/project-structure.md` (이 파일)
|
|
- **표준 파일:** `templates/standards/` (중앙 관리)
|
|
|
|
---
|
|
|
|
**작성일:** 2026-01-23
|
|
**버전:** 4.0
|
|
**작성자:** Alex
|