Alex/novel-writing-guide
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Guide 저장소 초기화 (v3.0)

Browse Source 
**생성 파일:**
- 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
2026-01-17 09:38:06 +09:00
commit 91d3715737
6 changed files with 3085 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

307
templates/project-structure.md Normal file
View 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