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>
323 lines
8.9 KiB
Markdown
323 lines
8.9 KiB
Markdown
# Novel Writing Guide
|
|
|
|
> **버전:** 4.0
|
|
> **최종 수정:** 2026-01-23
|
|
> **용도:** AI 협업 장편 소설 작성 시스템
|
|
> **주요 변경:** Single Source of Truth - claude.md 시스템 (필수)
|
|
|
|
---
|
|
|
|
## 📚 이 저장소는
|
|
|
|
AI(Claude)와 협업하여 **장편 소설**(10권 이상)을 체계적으로 작성하기 위한 **공통 가이드 및 템플릿 모음**입니다.
|
|
|
|
각 소설 프로젝트는 독립적인 Git 저장소로 관리되며, 이 Guide 저장소의 표준과 템플릿을 참조하여 구축됩니다.
|
|
|
|
---
|
|
|
|
## 📖 주요 문서
|
|
|
|
### **Novel Writing Project Guide.md**
|
|
메인 가이드 문서입니다.
|
|
|
|
**포함 내용:**
|
|
- 전체 워크플로우 (Phase 1~6)
|
|
- 파일 구조 및 명명 규칙
|
|
- 토큰 효율 관리 전략
|
|
- 5화 단위 작성 시스템
|
|
- 누적 서머리 시스템
|
|
- Git 자동화
|
|
- **v3.0 모드 시스템:**
|
|
- WRITING: 신규 작성 모드
|
|
- MODIFICATION: 기존 수정 모드
|
|
- VERIFICATION: 전체 점검 모드
|
|
- DISCUSSION: 협의/논의 모드
|
|
|
|
### **validation-standards.md** (v3.1 신규)
|
|
검증 모드 전용 가이드 문서입니다.
|
|
|
|
**포함 내용:**
|
|
- **3가지 검증 모드:**
|
|
- 본문 검증: 챕터 자체 완결성 확인
|
|
- 플롯 검증: 플롯과 본문 일치성 확인
|
|
- 요약본 검증: 2종 요약본 크로스체크
|
|
- **배치 검증 시스템:**
|
|
- 10개씩 6개 배치로 나눠 검증
|
|
- 각 배치마다 검증 요약본 생성
|
|
- 컴팩팅 대응 프로토콜
|
|
- **검증 요약본 형식:**
|
|
- 챕터별 상세 정보
|
|
- 제목-내용 일치 확인
|
|
- 타임라인 검증
|
|
- 캐릭터 일관성 체크
|
|
- **검증 보고서 템플릿:**
|
|
- 본문 검증 보고서
|
|
- 플롯 검증 보고서
|
|
- 요약본 검증 보고서
|
|
|
|
---
|
|
|
|
## 📁 템플릿 폴더 (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
|
|
# ⭐ claude.md (필수!) - Claude 작업 규칙
|
|
cp ../Guide/templates/claude.md.template ./claude.md
|
|
|
|
# 프로젝트 구조 참고용
|
|
cp ../Guide/templates/project-structure.md ./docs/
|
|
|
|
# CLAUDE.md (선택, deprecated)
|
|
cp ../Guide/templates/CLAUDE.md.template ./CLAUDE.md
|
|
```
|
|
|
|
**⚠️ 중요:**
|
|
- `claude.md`는 **반드시** 생성해야 함!
|
|
- Claude가 표준 파일을 Guide에서 읽도록 강제
|
|
- standards 파일들은 프로젝트에 복사하지 않음!
|
|
|
|
### 4. claude.md 수정
|
|
```markdown
|
|
# Claude 작업 규칙 (my-novel-project) ← 프로젝트명 수정
|
|
|
|
...
|
|
|
|
## 📌 프로젝트별 설정
|
|
|
|
### 이 프로젝트만의 특별한 규칙
|
|
|
|
- 특정 캐릭터 호칭 규칙
|
|
- 고유 용어 사전
|
|
- 시대 배경 설정
|
|
```
|
|
|
|
### 5. 프로젝트 설정
|
|
AI와 함께 "큰 틀 정하자" 명령으로 설계 시작:
|
|
- Phase 1: 설계 (마스터 파일 생성)
|
|
- Phase 2: 권별 플롯 작성
|
|
- Phase 3: 실행 준비 (자동화)
|
|
- Phase 4: 작성 시작
|
|
|
|
---
|
|
|
|
## 🎯 핵심 컨셉
|
|
|
|
### 1. **Single Source of Truth (v4.0 신규)**
|
|
- **표준 파일 위치**: `Guide/templates/standards/` (유일한 소스)
|
|
- **프로젝트 규칙**: `claude.md`로 표준 위치 명시 (필수!)
|
|
- **금지**: 프로젝트별/권별 standards 복사 ❌
|
|
- **목적**: 버전 불일치 원천 차단, 기준 통일
|
|
|
|
### 2. **설계와 실행의 분리**
|
|
- **마스터 파일**: 전체 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 # ⭐ Claude 작업 규칙 (필수!)
|
|
├── CLAUDE.md # AI 협업 프로토콜 (선택)
|
|
├── README.md
|
|
├── CHANGELOG.md
|
|
│
|
|
├── settings/ # 마스터 파일 (설계용)
|
|
│ ├── characters-master.md
|
|
│ ├── timeline-master.md
|
|
│ ├── plot-master.md
|
|
│ └── writing-guide.md
|
|
│
|
|
│ # ⚠️ standards 파일들은 Guide/templates/standards/에서 읽기!
|
|
│ # 프로젝트별로 복사하지 않음!
|
|
│
|
|
├── 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**: 버전 관리 및 원격 백업
|
|
- **이중 백업**: 최대 안정성 확보
|
|
|
|
---
|
|
|
|
## 📝 버전 히스토리
|
|
|
|
### v4.0 (2026-01-23)
|
|
- ✅ **Single Source of Truth 시스템 확립**
|
|
- ✅ `claude.md` 파일 도입 (프로젝트별 필수)
|
|
- ✅ `templates/claude.md.template` 추가
|
|
- ✅ standards 파일 Guide 중앙 관리 (복사 금지)
|
|
- ✅ 프로젝트/권별 standards 생성 금지
|
|
- ✅ 버전 불일치 원천 차단
|
|
|
|
### v3.1 (2026-01-17)
|
|
- ✅ **validation-standards.md 추가** (검증 모드 전용 가이드)
|
|
- ✅ 배치 검증 시스템 (10개씩 분할, 컴팩팅 대응)
|
|
- ✅ 검증 요약본 시스템 (validation-batch-XX.md)
|
|
- ✅ 2종 요약본 크로스체크 (작성 요약본 vs 검증 요약본)
|
|
- ✅ 검증 보고서 템플릿 3종
|
|
|
|
### 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-23
|
|
**버전**: 4.0
|
|
**라이선스**: 개인 프로젝트
|