Guide 저장소 초기화 (v3.0)
**생성 파일:** - 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>
This commit is contained in:
Alex
35
.gitignore
vendored
Normal file
35
.gitignore
vendored
Normal file
@@ -0,0 +1,35 @@
|
||||
# OS
|
||||
.DS_Store
|
||||
.DS_Store?
|
||||
._*
|
||||
.Spotlight-V100
|
||||
.Trashes
|
||||
ehthumbs.db
|
||||
Thumbs.db
|
||||
|
||||
# Windows
|
||||
desktop.ini
|
||||
$RECYCLE.BIN/
|
||||
|
||||
# Editor
|
||||
.vscode/
|
||||
.idea/
|
||||
*.swp
|
||||
*.swo
|
||||
*.swn
|
||||
*~
|
||||
|
||||
# Temp
|
||||
*.tmp
|
||||
~*
|
||||
*.bak
|
||||
*.backup
|
||||
|
||||
# Output
|
||||
*.pdf
|
||||
*.docx
|
||||
*.epub
|
||||
*.mobi
|
||||
|
||||
# Logs
|
||||
*.log
|
||||
2073
Novel Writing Project Guide.md
Normal file
2073
Novel Writing Project Guide.md
Normal file
File diff suppressed because it is too large
Load Diff
253
README.md
Normal file
253
README.md
Normal file
@@ -0,0 +1,253 @@
|
||||
# Novel Writing Guide
|
||||
|
||||
> **버전:** 3.0
|
||||
> **최종 수정:** 2026-01-17
|
||||
> **용도:** AI 협업 장편 소설 작성 시스템
|
||||
|
||||
---
|
||||
|
||||
## 📚 이 저장소는
|
||||
|
||||
AI(Claude)와 협업하여 **장편 소설**(10권 이상)을 체계적으로 작성하기 위한 **공통 가이드 및 템플릿 모음**입니다.
|
||||
|
||||
각 소설 프로젝트는 독립적인 Git 저장소로 관리되며, 이 Guide 저장소의 표준과 템플릿을 참조하여 구축됩니다.
|
||||
|
||||
---
|
||||
|
||||
## 📖 주요 문서
|
||||
|
||||
### **Novel Writing Project Guide.md**
|
||||
메인 가이드 문서입니다.
|
||||
|
||||
**포함 내용:**
|
||||
- 전체 워크플로우 (Phase 1~6)
|
||||
- 파일 구조 및 명명 규칙
|
||||
- 토큰 효율 관리 전략
|
||||
- 5화 단위 작성 시스템
|
||||
- 누적 서머리 시스템
|
||||
- Git 자동화
|
||||
- **v3.0 모드 시스템:**
|
||||
- WRITING: 신규 작성 모드
|
||||
- MODIFICATION: 기존 수정 모드
|
||||
- VERIFICATION: 전체 점검 모드
|
||||
- DISCUSSION: 협의/논의 모드
|
||||
|
||||
---
|
||||
|
||||
## 📁 템플릿 폴더 (templates/)
|
||||
|
||||
새 소설 프로젝트 시작 시 복사해서 사용하는 템플릿 파일들입니다.
|
||||
|
||||
### 제공 템플릿:
|
||||
- **CLAUDE.md.template**: AI 협업 프로토콜 템플릿
|
||||
- **chapter-template.md**: 챕터 파일 기본 형식
|
||||
- **project-structure.md**: 프로젝트 폴더 구조 가이드
|
||||
|
||||
---
|
||||
|
||||
## 🚀 새 프로젝트 시작하기
|
||||
|
||||
### 1. 이 가이드 읽기
|
||||
```
|
||||
L:\내 드라이브\Writing\Guide\Novel Writing Project Guide.md
|
||||
```
|
||||
전체 워크플로우와 시스템을 이해합니다.
|
||||
|
||||
### 2. 프로젝트 폴더 생성
|
||||
```bash
|
||||
cd "L:\내 드라이브\Writing"
|
||||
mkdir my-novel-project
|
||||
cd my-novel-project
|
||||
```
|
||||
|
||||
### 3. 템플릿 복사
|
||||
```bash
|
||||
cp ../Guide/templates/CLAUDE.md.template ./CLAUDE.md
|
||||
cp ../Guide/templates/project-structure.md ./docs/
|
||||
```
|
||||
|
||||
### 4. 프로젝트 설정
|
||||
AI와 함께 "큰 틀 정하자" 명령으로 설계 시작:
|
||||
- Phase 1: 설계 (마스터 파일 생성)
|
||||
- Phase 2: 권별 플롯 작성
|
||||
- Phase 3: 실행 준비 (자동화)
|
||||
- Phase 4: 작성 시작
|
||||
|
||||
---
|
||||
|
||||
## 🎯 핵심 컨셉
|
||||
|
||||
### 1. **설계와 실행의 분리**
|
||||
- **마스터 파일**: 전체 10권 통합 설계 (크고 무거움, 작성 시 읽지 않음)
|
||||
- **작업 파일**: 필요한 부분만 추출 (작고 가벼움, 매 세션 읽음)
|
||||
|
||||
### 2. **토큰 효율 최우선**
|
||||
- 한글 1글자 ≈ 1.5 토큰
|
||||
- 권별 작업 파일로 토큰 13,000 이하 유지
|
||||
- 작성 여유 토큰 187,000 확보
|
||||
|
||||
### 3. **5화 = 1작업 단위**
|
||||
- plot-001-005.md (5화 플롯)
|
||||
- "1~5화 작성해" 1번 명령
|
||||
- summary-001-005.md (5화 결과)
|
||||
|
||||
### 4. **누적 서머리로 일관성 유지**
|
||||
- summary-001-005.md
|
||||
- summary-001-010.md (1-10화 전체 누적!)
|
||||
- summary-001-050.md (1권 전체!)
|
||||
- summary-vol-01-final.md (압축, 다음 권용)
|
||||
|
||||
### 5. **모드 기반 워크플로우 (v3.0)**
|
||||
- **WORK-MODE.txt**로 현재 작업 모드 명시
|
||||
- 컴팩팅 후에도 맥락 유지
|
||||
- 수정 시 Summary 재생성 강제화
|
||||
- 타임라인 검증 자동화
|
||||
|
||||
---
|
||||
|
||||
## 📐 파일 구조 예시
|
||||
|
||||
```
|
||||
my-novel-project/
|
||||
│
|
||||
├── CLAUDE.md # AI 협업 프로토콜
|
||||
├── README.md
|
||||
├── CHANGELOG.md
|
||||
│
|
||||
├── 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
|
||||
│ │ ├── WORK-MODE.txt # v3.0 (임시)
|
||||
│ │ ├── plot-master.md
|
||||
│ │ ├── characters.md
|
||||
│ │ ├── timeline.md
|
||||
│ │ ├── plots/
|
||||
│ │ │ ├── plot-001-005.md
|
||||
│ │ │ └── ...
|
||||
│ │ ├── summaries/
|
||||
│ │ │ ├── summary-001-005.md
|
||||
│ │ │ ├── summary-001-010.md
|
||||
│ │ │ └── ...
|
||||
│ │ └── chapters/
|
||||
│ │ ├── ch-001.md
|
||||
│ │ └── ...
|
||||
│ └── vol-02/
|
||||
│ └── (동일 구조)
|
||||
│
|
||||
└── .git/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔧 v3.0 주요 개선
|
||||
|
||||
### 문제 해결
|
||||
**이전 문제:**
|
||||
- 컴팩팅 → 맥락 손실 → 수정이 이상한 방향으로
|
||||
- Summary 누락 → 플롯/본문/서머리 불일치
|
||||
- 리네임 시 파일 손실 위험
|
||||
- 변경 이력 추적 불가
|
||||
|
||||
**v3.0 해결:**
|
||||
- `WORK-MODE.txt` → 모드 명시 → 맥락 유지
|
||||
- `modification-mode.md` → Summary 재생성 강제
|
||||
- `renaming-protocol.md` → 안전한 2단계 리네임
|
||||
- `CHANGELOG.md` → 변경 이력 추적
|
||||
|
||||
### 모드별 워크플로우
|
||||
|
||||
**작성 모드:**
|
||||
```
|
||||
"1~5화 작성해" → 작성 → summary 누적 → Git
|
||||
```
|
||||
|
||||
**수정 모드:**
|
||||
```
|
||||
"수정 준비해" → 계획서 → WORK-MODE.txt 생성
|
||||
→ [컴팩팅]
|
||||
→ "수정 실행" → 수정 → summary 재생성 → 검증 → CHANGELOG → Git
|
||||
```
|
||||
|
||||
**점검 모드:**
|
||||
```
|
||||
"점검해" → 전수 검사 → 보고서 작성 → Git
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 적용 예시
|
||||
|
||||
### 실제 프로젝트
|
||||
- **1945-novel**: "1945, 다시 시작된 역사" (대체역사 소설, 10권)
|
||||
- 위치: `L:\내 드라이브\Writing\1945-novel\`
|
||||
- 상태: 2권 작성 중 (65화)
|
||||
- v3.0 시스템 적용 완료
|
||||
|
||||
---
|
||||
|
||||
## 🔗 참고 링크
|
||||
|
||||
### Git 저장소 (Gitea)
|
||||
- **서버**: git.digien25.co.kr
|
||||
- **사용자**: Alex
|
||||
- **프로젝트 예시**:
|
||||
- `https://git.digien25.co.kr/Alex/1945-novel.git`
|
||||
- `https://git.digien25.co.kr/Alex/novel-writing-guide.git`
|
||||
|
||||
### 백업 전략
|
||||
- **Google Drive**: 실시간 클라우드 동기화
|
||||
- **Git + Gitea**: 버전 관리 및 원격 백업
|
||||
- **이중 백업**: 최대 안정성 확보
|
||||
|
||||
---
|
||||
|
||||
## 📝 버전 히스토리
|
||||
|
||||
### v3.0 (2026-01-17)
|
||||
- ✅ 모드 시스템 구축 (WRITING/MODIFICATION/VERIFICATION/DISCUSSION)
|
||||
- ✅ 수정 프로토콜 체계화 (Summary 재생성 강제, 타임라인 검증)
|
||||
- ✅ 챕터 형식 표준 문서화
|
||||
- ✅ 안전한 리네임 절차
|
||||
- ✅ WORK-MODE.txt 시스템 (컴팩팅 대응)
|
||||
- ✅ CHANGELOG.md 도입
|
||||
|
||||
### v2.0 (2026-01-15)
|
||||
- ✅ 완전 재작성
|
||||
- ✅ 설계/실행 분리
|
||||
- ✅ 토큰 효율 최우선
|
||||
- ✅ 5화 작업 단위
|
||||
- ✅ 누적 서머리
|
||||
- ✅ Git 자동화
|
||||
|
||||
### v1.0 (2026-01-14)
|
||||
- 초기 버전
|
||||
|
||||
---
|
||||
|
||||
## 🤝 기여
|
||||
|
||||
이 가이드는 Alex의 개인 프로젝트이지만, 개선 제안은 언제나 환영합니다.
|
||||
|
||||
---
|
||||
|
||||
## 📧 연락처
|
||||
|
||||
- **작성자**: Alex
|
||||
- **이메일**: alex@digien25.co.kr
|
||||
|
||||
---
|
||||
|
||||
**마지막 업데이트**: 2026-01-17
|
||||
**버전**: 3.0
|
||||
**라이선스**: 개인 프로젝트
|
||||
288
templates/CLAUDE.md.template
Normal file
288
templates/CLAUDE.md.template
Normal file
@@ -0,0 +1,288 @@
|
||||
# CLAUDE.md - AI 협업 프로토콜
|
||||
|
||||
> **프로젝트:** [소설 제목]
|
||||
> **장르:** [장르]
|
||||
> **권수:** [N]권
|
||||
> **작성일:** YYYY-MM-DD
|
||||
|
||||
---
|
||||
|
||||
## 🔴 절대 규칙 (최우선)
|
||||
|
||||
1. **세션 시작 시 자동 실행** - 아래 "세션 시작 프로토콜" 무조건 실행
|
||||
2. **모드 확인** - WORK-MODE.txt 확인 후 해당 모드 프로토콜 실행 (v3.0)
|
||||
3. **5화 단위 작성** - 항상 5화씩 연속 작성
|
||||
4. **서머리 자동 업데이트** - 각 화 완료 시 즉시 summary 업데이트
|
||||
5. **설정 파일 우선** - settings/ 및 vol-XX/ 내용이 최우선
|
||||
6. **일관성 검증** - 매 화마다 캐릭터/타임라인 체크
|
||||
7. **마스터 파일 동기화** - 작업 파일 변경 시 마스터도 업데이트
|
||||
|
||||
---
|
||||
|
||||
## 📋 세션 시작 프로토콜 (v3.0)
|
||||
|
||||
**Step 1: 이 파일 읽기** ✅ (자동)
|
||||
|
||||
**Step 2: 모드 확인 (최우선!)** ⭐⭐⭐
|
||||
|
||||
```bash
|
||||
# WORK-MODE.txt 확인
|
||||
if [ -f "volumes/vol-XX/WORK-MODE.txt" ]; then
|
||||
MODE=$(grep "^MODE:" volumes/vol-XX/WORK-MODE.txt | cut -d: -f2 | xargs)
|
||||
else
|
||||
MODE="UNKNOWN"
|
||||
fi
|
||||
```
|
||||
|
||||
**MODE별 분기:**
|
||||
|
||||
**MODE = "MODIFICATION"** (수정 모드)
|
||||
```
|
||||
→ settings/modification-mode.md 읽기
|
||||
→ 수정 프로토콜 실행
|
||||
→ 이 파일 이하 실행 중단! (modification-mode.md만 따름)
|
||||
```
|
||||
|
||||
**MODE = "VERIFICATION"** (점검 모드)
|
||||
```
|
||||
→ settings/verification-mode.md 읽기
|
||||
→ 점검 프로토콜 실행
|
||||
→ 이 파일 이하 실행 중단!
|
||||
```
|
||||
|
||||
**MODE = "UNKNOWN"** 또는 **없음** (작성 모드, 기본)
|
||||
```
|
||||
→ 계속 진행 (아래 Step 3 실행)
|
||||
→ settings/writing-mode.md 읽기 (선택)
|
||||
```
|
||||
|
||||
**Step 3: 작성 모드 파일 읽기**
|
||||
|
||||
세션 시작 시 자동 실행:
|
||||
|
||||
```
|
||||
1. 이 파일 (CLAUDE.md) 읽기 ✅ (자동)
|
||||
2. WORK-MODE.txt 확인 ✅ (Step 2)
|
||||
3. volumes/vol-XX/characters.md 읽기
|
||||
4. volumes/vol-XX/timeline.md 읽기
|
||||
5. settings/writing-guide.md 읽기
|
||||
6. plots/plot-XXX-YYY.md 읽기 (이번 5화)
|
||||
7. summaries/summary-이전.md 읽기 ⭐
|
||||
8. summaries/summary-vol-이전-final.md 읽기 (다른 권이면)
|
||||
9. docs/todo.md 읽기 (있으면)
|
||||
```
|
||||
|
||||
**읽기 완료 후:**
|
||||
```
|
||||
"준비 완료. ch-XXX부터 시작합니다."
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📝 작성 프로세스
|
||||
|
||||
### 각 화 작성 시:
|
||||
|
||||
```
|
||||
1. plot 파일 확인
|
||||
- 날짜, 장소, 등장인물
|
||||
- 핵심 내용, 주요 장면
|
||||
- 분량, 복선
|
||||
|
||||
2. 메모리 참조 (파일 읽기 X!)
|
||||
- characters.md: 성격, 말투
|
||||
- timeline.md: 날짜 확인
|
||||
- writing-guide.md: 작성 규칙
|
||||
- summary: 이전 내용
|
||||
|
||||
3. 작성
|
||||
- Show, Don't Tell
|
||||
- 5감 묘사
|
||||
- 대화:묘사:서술 = 40:40:20
|
||||
- 분량: 8,000-12,000자
|
||||
|
||||
4. 완료 후 즉시
|
||||
- chapters/ch-XXX.md 저장
|
||||
- summaries/summary 업데이트 (누적!)
|
||||
- 변경사항 있으면 마스터 동기화
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 변경사항 처리
|
||||
|
||||
### 새 캐릭터 추가 시:
|
||||
```
|
||||
1. volumes/vol-XX/characters.md 업데이트
|
||||
2. settings/characters-master.md 업데이트 ⭐
|
||||
3. summary에 기록
|
||||
```
|
||||
|
||||
### 복선 추가 시:
|
||||
```
|
||||
1. volumes/vol-XX/timeline.md 복선 추적표
|
||||
2. settings/timeline-master.md 복선 추적표 ⭐
|
||||
3. summary에 기록
|
||||
```
|
||||
|
||||
### 설정 변경 시:
|
||||
```
|
||||
즉시 사용자에게 보고:
|
||||
"[변경사항] 발생. 확인 필요합니다."
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 서머리 관리
|
||||
|
||||
### 형식:
|
||||
|
||||
```markdown
|
||||
# X-Y화 누적 서머리
|
||||
|
||||
> 최종 업데이트: YYYY-MM-DD HH:MM
|
||||
> 현재: ch-YYY (총 Y화)
|
||||
|
||||
## 📌 전체 줄거리
|
||||
{누적 3-5문단}
|
||||
|
||||
## 📖 챕터별 핵심
|
||||
### ch-XXX: [제목]
|
||||
**날짜:** YYYY-MM-DD
|
||||
**핵심:** 1줄 요약
|
||||
|
||||
## 🎭 캐릭터 상태
|
||||
### [이름]:
|
||||
- ch-XXX: 상태
|
||||
|
||||
## ⚠️ 복선
|
||||
- [ ] [내용] (ch-XXX) → 회수: [시점]
|
||||
|
||||
## 📊 통계
|
||||
- 총 챕터: Y화
|
||||
- 총 분량: Z자
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ 5화 완료 체크리스트
|
||||
|
||||
```
|
||||
각 5화 완료 시 자동 실행:
|
||||
|
||||
✅ 5개 챕터 파일 생성
|
||||
✅ summary 누적 업데이트
|
||||
✅ 캐릭터/타임라인 변경사항 마스터 동기화
|
||||
✅ Git 커밋
|
||||
형식:
|
||||
"X-Y화 작성 완료
|
||||
|
||||
- ch-XXX: [제목] (Z자)
|
||||
...
|
||||
- summary-XXX-YYY.md 업데이트
|
||||
|
||||
총 Z자
|
||||
|
||||
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
|
||||
✅ Git 푸시
|
||||
✅ 다음 5화 안내
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 권 완료 체크리스트
|
||||
|
||||
```
|
||||
50화 완료 시:
|
||||
|
||||
✅ summary-001-050.md 확인
|
||||
✅ summary-vol-XX-final.md 생성 (압축!)
|
||||
✅ 미회수 복선 정리
|
||||
✅ Git 커밋
|
||||
"X권 완료
|
||||
|
||||
- 50화 전체 (Z자)
|
||||
- summary-vol-XX-final.md 생성
|
||||
- 미회수 복선 N개
|
||||
|
||||
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
|
||||
✅ Git 푸시
|
||||
✅ 다음 권 안내
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📌 프로젝트 정보
|
||||
|
||||
**제목:** [소설 제목]
|
||||
**장르:** [장르]
|
||||
**권수:** [N]권
|
||||
**화/권:** 50화
|
||||
**분량/화:** 8,000-12,000자
|
||||
**총 분량:** 약 [N * 500,000]자
|
||||
|
||||
**시간 배경:** [시작] - [종료]
|
||||
|
||||
**주인공:** [이름]
|
||||
|
||||
**핵심 줄거리:**
|
||||
{3문장}
|
||||
|
||||
---
|
||||
|
||||
## 🚫 금지 사항
|
||||
|
||||
❌ 설정 파일 읽지 않고 작성
|
||||
❌ 서머리 업데이트 생략
|
||||
❌ 마스터 파일 동기화 누락
|
||||
❌ 날짜/나이 오류
|
||||
❌ 캐릭터 OOC
|
||||
❌ 복선 누락
|
||||
❌ WORK-MODE.txt 무시 (v3.0)
|
||||
❌ 수정 시 summary 재생성 누락 (v3.0)
|
||||
|
||||
---
|
||||
|
||||
## 💡 명령어
|
||||
|
||||
### 설계:
|
||||
- "큰 틀 정하자" → Phase 1
|
||||
- "X권 플롯 작성" → Phase 2
|
||||
|
||||
### 실행:
|
||||
- "실행 준비" → Phase 3
|
||||
- "1~5화 작성해" → Phase 4
|
||||
|
||||
### 수정 (v3.0):
|
||||
- "수정 준비해: [문제명]" → 수정 모드 준비
|
||||
- "수정 실행" → 수정 모드 실행
|
||||
|
||||
### 점검 (v3.0):
|
||||
- "점검해" → 전체 검증
|
||||
|
||||
### 유틸:
|
||||
- "타임라인 검증" → 날짜 체크
|
||||
- "복선 현황" → 미회수 떡밥
|
||||
- "캐릭터 상태" → 현재 상태
|
||||
|
||||
---
|
||||
|
||||
## 📚 참고 파일
|
||||
|
||||
### 공통 (settings/):
|
||||
- `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-XX/):
|
||||
- `CHANGELOG.md`: 변경 이력 (v3.0)
|
||||
- `WORK-MODE.txt`: 현재 모드 (v3.0, 임시)
|
||||
|
||||
---
|
||||
|
||||
*AI는 이 파일을 항상 우선 읽고 규칙을 준수한다.*
|
||||
|
||||
*v3.0에서는 WORK-MODE.txt 확인이 최우선이다!*
|
||||
129
templates/chapter-template.md
Normal file
129
templates/chapter-template.md
Normal file
@@ -0,0 +1,129 @@
|
||||
# X권 Y화: [제목]
|
||||
|
||||
> **타임라인:** YYYY.M.D-M.D
|
||||
> **장소:** [장소1], [장소2]
|
||||
> **등장인물:** [인물A], [인물B], [인물C]
|
||||
|
||||
---
|
||||
|
||||
## Part 1: [소제목]
|
||||
|
||||
[첫 장면 묘사]
|
||||
|
||||
[대화]
|
||||
|
||||
"대사 내용," [인물A]가 말했다.
|
||||
|
||||
"답변 내용," [인물B]가 고개를 끄덕이며 답했다.
|
||||
|
||||
[행동 묘사]
|
||||
|
||||
---
|
||||
|
||||
## Part 2: [소제목]
|
||||
|
||||
[두 번째 장면]
|
||||
|
||||
---
|
||||
|
||||
## Part 3: [소제목]
|
||||
|
||||
[세 번째 장면]
|
||||
|
||||
---
|
||||
|
||||
## Part 4: [소제목]
|
||||
|
||||
[네 번째 장면]
|
||||
|
||||
---
|
||||
|
||||
## Part 5: [소제목]
|
||||
|
||||
[마지막 장면]
|
||||
|
||||
---
|
||||
|
||||
**[권 X화 종료]**
|
||||
|
||||
---
|
||||
|
||||
## 📝 작성 가이드
|
||||
|
||||
### 헤더 형식 (필수!)
|
||||
```markdown
|
||||
# X권 Y화: [제목]
|
||||
|
||||
> **타임라인:** YYYY.M.D-M.D
|
||||
> **장소:** [장소1], [장소2]
|
||||
> **등장인물:** [주요 등장인물 나열]
|
||||
```
|
||||
|
||||
### 분량 가이드
|
||||
- **권장 분량:** 8,000 ~ 12,000자
|
||||
- **최소 분량:** 6,000자 (너무 짧음 주의)
|
||||
- **최대 분량:** 15,000자 (너무 길면 분할 고려)
|
||||
|
||||
### 구조
|
||||
- **Part 개수:** 3~7개 (유동적)
|
||||
- **Part별 분량:** 1,500~3,000자
|
||||
- **시작:** 장면 설정 및 분위기
|
||||
- **중간:** 갈등/사건 전개
|
||||
- **끝:** 다음 화로 연결
|
||||
|
||||
### 작성 원칙
|
||||
|
||||
#### 1. Show, Don't Tell
|
||||
```markdown
|
||||
❌ "강민준은 화가 났다."
|
||||
✅ "강민준의 주먹이 떨렸다. 그의 눈빛이 차갑게 식었다."
|
||||
```
|
||||
|
||||
#### 2. 5감 묘사
|
||||
- **시각:** 색, 형태, 움직임
|
||||
- **청각:** 소리, 음색, 리듬
|
||||
- **촉각:** 질감, 온도, 압력
|
||||
- **후각:** 향기, 냄새
|
||||
- **미각:** 맛 (필요시)
|
||||
|
||||
#### 3. 대화와 묘사 균형
|
||||
- **대화:** 40%
|
||||
- **묘사:** 40%
|
||||
- **서술:** 20%
|
||||
|
||||
#### 4. 타임라인 연속성
|
||||
- **이전 화 종료일 ≤ 현재 화 시작일**
|
||||
- 시간 역행 금지
|
||||
- 날짜 겹침 금지
|
||||
|
||||
#### 5. 캐릭터 일관성
|
||||
- **성격:** characters.md 참조
|
||||
- **말투:** 캐릭터별 특징 유지
|
||||
- **나이:** 계산 정확히
|
||||
|
||||
---
|
||||
|
||||
## 🚫 금지 사항
|
||||
|
||||
❌ 갑작스러운 시간 점프 (설명 없이)
|
||||
❌ 캐릭터 OOC (Out Of Character)
|
||||
❌ 설정 모순
|
||||
❌ Deus Ex Machina (신의 개입)
|
||||
❌ 타임라인 오류
|
||||
❌ 과도한 설명 (Tell)
|
||||
❌ 감정 직접 서술
|
||||
|
||||
---
|
||||
|
||||
## 📌 참고
|
||||
|
||||
- **플롯:** plots/plot-XXX-YYY.md
|
||||
- **캐릭터:** volumes/vol-XX/characters.md
|
||||
- **타임라인:** volumes/vol-XX/timeline.md
|
||||
- **작성 규칙:** settings/writing-guide.md
|
||||
- **챕터 형식:** settings/chapter-format-standard.md
|
||||
|
||||
---
|
||||
|
||||
**작성일:** YYYY-MM-DD
|
||||
**버전:** 1.0
|
||||
307
templates/project-structure.md
Normal file
307
templates/project-structure.md
Normal file
@@ -0,0 +1,307 @@
|
||||
# 소설 프로젝트 폴더 구조
|
||||
|
||||
> **버전:** 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
|
||||
Reference in New Issue
Block a user