Guide v3.1: 메인 문서 대폭 업데이트
주요 변경: - 문서 계층 구조 섹션 추가 (섹션 1) - 모드 시스템 본문에 상세 추가 (섹션 3) - Phase 5 수정 모드 섹션 신설 (8유형) - Phase 6 검증 모드 섹션 신설 (6단계) - 바텀 금지 규칙 명시 (섹션 10.3) - CURRENT-TASK.md 시스템 설명 - 파일 구조에 standards/ 폴더 반영 - 전체 섹션 번호 재정리 (19개 섹션) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Alex
@@ -1,6 +1,6 @@
|
|||||||
# 현재 작업 상태
|
# 현재 작업 상태
|
||||||
|
|
||||||
**최종 업데이트:** 2026-01-18 10:15
|
**최종 업데이트:** 2026-01-18 11:30
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -8,7 +8,7 @@
|
|||||||
문서 보완 작업
|
문서 보완 작업
|
||||||
|
|
||||||
## 작업
|
## 작업
|
||||||
Guide v3.0 템플릿 정리 및 1945 프로젝트 적용
|
Guide v3.1 메인 문서 업데이트 완료, 1945 프로젝트 적용 대기
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -23,22 +23,23 @@ Guide v3.0 템플릿 정리 및 1945 프로젝트 적용
|
|||||||
- [x] templates/standards/chapter-format.md (바텀 금지)
|
- [x] templates/standards/chapter-format.md (바텀 금지)
|
||||||
- [x] templates/standards/writing-guide.md
|
- [x] templates/standards/writing-guide.md
|
||||||
- [x] templates/standards/renaming-protocol.md
|
- [x] templates/standards/renaming-protocol.md
|
||||||
- [x] Git 커밋/푸시 완료 (3ce44ec)
|
|
||||||
|
### Guide 메인 문서 업데이트 (완료)
|
||||||
|
- [x] 버전 v3.1로 업데이트
|
||||||
|
- [x] 문서 계층 구조 섹션 추가 (섹션 1)
|
||||||
|
- [x] 폴더 구조 반영 (standards vs settings 분리)
|
||||||
|
- [x] 모드 시스템 본문에 상세 추가 (섹션 3)
|
||||||
|
- [x] CURRENT-TASK.md 시스템 설명 추가
|
||||||
|
- [x] 바텀 금지 규칙 반영 (섹션 10.3)
|
||||||
|
- [x] Phase 5 수정 모드 섹션 추가 (섹션 11)
|
||||||
|
- [x] Phase 6 검증 모드 섹션 추가 (섹션 12)
|
||||||
|
- [x] 변경 이력 v3.1 추가
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## ⏳ 남은 작업
|
## ⏳ 남은 작업
|
||||||
|
|
||||||
### 1. Guide 메인 문서 업데이트
|
### 1945 프로젝트 적용
|
||||||
**파일:** Novel Writing Project Guide.md
|
|
||||||
**내용:**
|
|
||||||
- 문서 계층 구조 섹션 추가 (Guide vs 프로젝트)
|
|
||||||
- 폴더 구조 반영 (standards vs settings 분리)
|
|
||||||
- 모드 시스템 본문에 상세 추가 (현재 변경이력에만 있음)
|
|
||||||
- CURRENT-TASK.md 설명 추가
|
|
||||||
- 바텀 금지 규칙 반영
|
|
||||||
|
|
||||||
### 2. 1945 프로젝트 적용
|
|
||||||
**작업:**
|
**작업:**
|
||||||
- [ ] 폴더 리팩토링: settings/ → standards/ + settings/ 분리
|
- [ ] 폴더 리팩토링: settings/ → standards/ + settings/ 분리
|
||||||
- standards/로 이동: writing-mode.md, modification-mode.md, verification-mode.md, chapter-format-standard.md, renaming-protocol.md, writing-guide.md
|
- standards/로 이동: writing-mode.md, modification-mode.md, verification-mode.md, chapter-format-standard.md, renaming-protocol.md, writing-guide.md
|
||||||
@@ -46,7 +47,7 @@ Guide v3.0 템플릿 정리 및 1945 프로젝트 적용
|
|||||||
- [ ] CLAUDE.md 새 구조로 업데이트
|
- [ ] CLAUDE.md 새 구조로 업데이트
|
||||||
- [ ] characters-master.md에 호칭 규칙 섹션 추가
|
- [ ] characters-master.md에 호칭 규칙 섹션 추가
|
||||||
|
|
||||||
### 3. 기존 챕터 바텀 제거 (선택)
|
### 기존 챕터 바텀 제거 (선택)
|
||||||
- 검증 모드에서 처리 예정
|
- 검증 모드에서 처리 예정
|
||||||
- 작성/수정 완료 후 검증 모드 돌릴 때 일괄 제거
|
- 작성/수정 완료 후 검증 모드 돌릴 때 일괄 제거
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,8 @@
|
|||||||
# 소설 작성 프로젝트 표준 가이드 (v2.0)
|
# 소설 작성 프로젝트 표준 가이드 (v3.1)
|
||||||
|
|
||||||
> **작성일:** 2026-01-15
|
> **작성일:** 2026-01-15
|
||||||
> **버전:** 2.0
|
> **버전:** 3.1
|
||||||
|
> **최종 수정:** 2026-01-18
|
||||||
> **목적:** AI와 협업하여 장편 소설(10권 이상)을 체계적으로 작성하기 위한 표준 가이드
|
> **목적:** AI와 협업하여 장편 소설(10권 이상)을 체계적으로 작성하기 위한 표준 가이드
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -69,27 +70,132 @@ CLAUDE.md = 내비게이션 (매번 운전할 때마다)
|
|||||||
|
|
||||||
**⚠️ [이 문서의 역할](#%EF%B8%8F-이-문서의-역할)** ← 먼저 읽기!
|
**⚠️ [이 문서의 역할](#%EF%B8%8F-이-문서의-역할)** ← 먼저 읽기!
|
||||||
|
|
||||||
1. [핵심 컨셉](#1-핵심-컨셉)
|
1. [문서 계층 구조](#1-문서-계층-구조) ⭐ NEW
|
||||||
2. [전체 워크플로우](#2-전체-워크플로우)
|
2. [핵심 컨셉](#2-핵심-컨셉)
|
||||||
3. [프로젝트 위치 선택](#3-프로젝트-위치-선택)
|
3. [모드 시스템](#3-모드-시스템) ⭐ NEW
|
||||||
4. [파일 구조](#4-파일-구조)
|
4. [전체 워크플로우](#4-전체-워크플로우)
|
||||||
5. [Phase 1: 설계 (큰 틀)](#5-phase-1-설계-큰-틀)
|
5. [프로젝트 위치 선택](#5-프로젝트-위치-선택)
|
||||||
6. [Phase 2: 권별 플롯](#6-phase-2-권별-플롯)
|
6. [파일 구조](#6-파일-구조)
|
||||||
7. [Phase 3: 실행 준비](#7-phase-3-실행-준비)
|
7. [Phase 1: 설계 (큰 틀)](#7-phase-1-설계-큰-틀)
|
||||||
8. [Phase 4: 작성](#8-phase-4-작성)
|
8. [Phase 2: 권별 플롯](#8-phase-2-권별-플롯)
|
||||||
9. [Phase 5: 권 완료](#9-phase-5-권-완료)
|
9. [Phase 3: 실행 준비](#9-phase-3-실행-준비)
|
||||||
10. [Phase 6: 다음 권](#10-phase-6-다음-권)
|
10. [Phase 4: 작성 모드](#10-phase-4-작성-모드)
|
||||||
11. [CLAUDE.md 템플릿](#11-claudemd-템플릿)
|
11. [Phase 5: 수정 모드](#11-phase-5-수정-모드) ⭐ NEW
|
||||||
12. [Git 자동화](#12-git-자동화)
|
12. [Phase 6: 검증 모드](#12-phase-6-검증-모드) ⭐ NEW
|
||||||
13. [토큰 효율 관리](#13-토큰-효율-관리)
|
13. [Phase 7: 권 완료](#13-phase-7-권-완료)
|
||||||
14. [파일 명명 규칙](#14-파일-명명-규칙)
|
14. [Phase 8: 다음 권](#14-phase-8-다음-권)
|
||||||
15. [부록](#15-부록)
|
15. [CLAUDE.md 템플릿](#15-claudemd-템플릿)
|
||||||
|
16. [Git 자동화](#16-git-자동화)
|
||||||
|
17. [토큰 효율 관리](#17-토큰-효율-관리)
|
||||||
|
18. [파일 명명 규칙](#18-파일-명명-규칙)
|
||||||
|
19. [부록](#19-부록)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 1. 핵심 컨셉
|
## 1. 문서 계층 구조
|
||||||
|
|
||||||
### 1.1 설계와 실행의 완전 분리
|
### 1.1 3단계 문서 체계
|
||||||
|
|
||||||
|
```
|
||||||
|
┌─────────────────────────────────────────────────────────┐
|
||||||
|
│ 🏛️ Guide (본 저장소) │
|
||||||
|
│ └─ 소설 작성의 표준/원칙/템플릿 │
|
||||||
|
│ └─ 어떻게 소설을 쓸 것인가? │
|
||||||
|
└─────────────────────────────────────────────────────────┘
|
||||||
|
│
|
||||||
|
│ 템플릿 제공
|
||||||
|
▼
|
||||||
|
┌─────────────────────────────────────────────────────────┐
|
||||||
|
│ 📚 프로젝트 (1945-novel 등) │
|
||||||
|
│ ├─ standards/ → 작업 방법론 (Guide에서 복사) │
|
||||||
|
│ ├─ settings/ → 소설 고유 콘텐츠 (캐릭터, 플롯 등) │
|
||||||
|
│ └─ volumes/ → 실제 원고 │
|
||||||
|
└─────────────────────────────────────────────────────────┘
|
||||||
|
```
|
||||||
|
|
||||||
|
### 1.2 Guide vs 프로젝트
|
||||||
|
|
||||||
|
| 구분 | Guide 저장소 | 프로젝트 저장소 |
|
||||||
|
|------|-------------|----------------|
|
||||||
|
| **용도** | 표준 정의 | 소설 작성 |
|
||||||
|
| **내용** | 템플릿, 가이드 | 실제 원고, 설정 |
|
||||||
|
| **변경** | 드물게 | 자주 |
|
||||||
|
| **예시** | 이 문서 | 1945-novel |
|
||||||
|
|
||||||
|
### 1.3 프로젝트 내 폴더 분리
|
||||||
|
|
||||||
|
```
|
||||||
|
프로젝트/
|
||||||
|
├── standards/ # 🔧 작업 방법론 (Guide에서 복사)
|
||||||
|
│ ├── writing-mode.md # 작성 모드 절차
|
||||||
|
│ ├── modification-mode.md # 수정 모드 절차 (8유형)
|
||||||
|
│ ├── verification-mode.md # 검증 모드 절차 (6단계)
|
||||||
|
│ ├── chapter-format.md # 챕터 형식 표준
|
||||||
|
│ ├── writing-guide.md # 문체/분량 규칙
|
||||||
|
│ └── renaming-protocol.md # 리네임 안전 절차
|
||||||
|
│
|
||||||
|
├── settings/ # 📖 소설 고유 콘텐츠
|
||||||
|
│ ├── characters-master.md # 전체 캐릭터 설정
|
||||||
|
│ ├── timeline-master.md # 전체 타임라인
|
||||||
|
│ └── plot-master.md # 전체 플롯
|
||||||
|
│
|
||||||
|
└── volumes/ # 📚 권별 원고
|
||||||
|
└── vol-XX/
|
||||||
|
├── chapters/
|
||||||
|
├── summaries/
|
||||||
|
└── plots/
|
||||||
|
```
|
||||||
|
|
||||||
|
**핵심:**
|
||||||
|
- `standards/` = "어떻게" (방법론, 모든 소설 공통)
|
||||||
|
- `settings/` = "무엇을" (이 소설만의 내용)
|
||||||
|
|
||||||
|
### 1.4 CURRENT-TASK.md 시스템
|
||||||
|
|
||||||
|
**목적:** 컴팩팅 후 맥락 복구
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# 현재 작업 상태
|
||||||
|
|
||||||
|
**최종 업데이트:** YYYY-MM-DD HH:MM
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 모드
|
||||||
|
[WRITING / MODIFICATION / VERIFICATION]
|
||||||
|
|
||||||
|
## 작업
|
||||||
|
[현재 진행 중인 작업 설명]
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ✅ 완료된 작업
|
||||||
|
- [x] 완료 항목
|
||||||
|
|
||||||
|
## ⏳ 남은 작업
|
||||||
|
- [ ] 미완료 항목
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 다음 세션에서 할 일
|
||||||
|
1. 구체적 명령어
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*이 파일은 컴팩팅 후 맥락 복구용입니다.*
|
||||||
|
```
|
||||||
|
|
||||||
|
**사용법:**
|
||||||
|
1. 세션 시작 시 AI가 CURRENT-TASK.md 확인
|
||||||
|
2. 작업 진행 중 상태 업데이트
|
||||||
|
3. 세션 종료/컴팩팅 전 최신화
|
||||||
|
4. 다음 세션에서 이 파일 기반으로 작업 재개
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. 핵심 컨셉
|
||||||
|
|
||||||
|
### 2.1 설계와 실행의 완전 분리
|
||||||
|
|
||||||
```
|
```
|
||||||
설계 단계 (마스터 파일):
|
설계 단계 (마스터 파일):
|
||||||
@@ -104,7 +210,7 @@ CLAUDE.md = 내비게이션 (매번 운전할 때마다)
|
|||||||
→ 매 세션마다 읽음
|
→ 매 세션마다 읽음
|
||||||
```
|
```
|
||||||
|
|
||||||
### 1.2 토큰 효율성 최우선
|
### 2.2 토큰 효율성 최우선
|
||||||
|
|
||||||
**문제:**
|
**문제:**
|
||||||
```
|
```
|
||||||
@@ -129,7 +235,7 @@ CLAUDE.md = 내비게이션 (매번 운전할 때마다)
|
|||||||
→ 작성 여유: 187,000 토큰 (충분!)
|
→ 작성 여유: 187,000 토큰 (충분!)
|
||||||
```
|
```
|
||||||
|
|
||||||
### 1.3 5화 = 1작업 단위
|
### 2.3 5화 = 1작업 단위
|
||||||
|
|
||||||
```
|
```
|
||||||
사용자 관점:
|
사용자 관점:
|
||||||
@@ -143,7 +249,7 @@ AI 관점:
|
|||||||
- summary-001-005.md (5화 결과)
|
- summary-001-005.md (5화 결과)
|
||||||
```
|
```
|
||||||
|
|
||||||
### 1.4 누적 서머리로 일관성 유지
|
### 2.4 누적 서머리로 일관성 유지
|
||||||
|
|
||||||
```
|
```
|
||||||
문제:
|
문제:
|
||||||
@@ -160,7 +266,100 @@ AI 관점:
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 2. 전체 워크플로우
|
## 3. 모드 시스템
|
||||||
|
|
||||||
|
### 3.1 개요
|
||||||
|
|
||||||
|
AI 협업 시 **3가지 작업 모드**를 명확히 구분합니다.
|
||||||
|
|
||||||
|
| 모드 | 용도 | 진입 명령 |
|
||||||
|
|------|------|----------|
|
||||||
|
| **WRITING** | 새 챕터 작성 | "1~5화 작성해" |
|
||||||
|
| **MODIFICATION** | 기존 내용 수정 | "수정해" / "수정 모드" |
|
||||||
|
| **VERIFICATION** | 전체 검증 | "검증해" / "점검 모드" |
|
||||||
|
|
||||||
|
### 3.2 작성 모드 (WRITING)
|
||||||
|
|
||||||
|
**목적:** 플롯 기반 신규 챕터 작성
|
||||||
|
|
||||||
|
```
|
||||||
|
진입: "1~5화 작성해" / "ch-XXX 써줘"
|
||||||
|
↓
|
||||||
|
파일 읽기 (자동):
|
||||||
|
- CLAUDE.md
|
||||||
|
- standards/writing-mode.md
|
||||||
|
- settings/characters-master.md (해당 권)
|
||||||
|
- volumes/vol-XX/timeline.md
|
||||||
|
- plots/plot-XXX-YYY.md
|
||||||
|
- summaries/summary-이전.md
|
||||||
|
↓
|
||||||
|
5화 연속 작성
|
||||||
|
↓
|
||||||
|
summary 누적 업데이트
|
||||||
|
↓
|
||||||
|
Git 커밋
|
||||||
|
```
|
||||||
|
|
||||||
|
**핵심 규칙:**
|
||||||
|
- 플롯 기반 작성
|
||||||
|
- 매 화마다 summary 업데이트
|
||||||
|
- 바텀 금지 (헤더만 화수 표시)
|
||||||
|
|
||||||
|
### 3.3 수정 모드 (MODIFICATION)
|
||||||
|
|
||||||
|
**목적:** 기존 내용 변경 (8가지 유형)
|
||||||
|
|
||||||
|
| 유형 | 설명 | 복잡도 |
|
||||||
|
|------|------|--------|
|
||||||
|
| **A. 단순 수정** | 오타, 문장 다듬기 | ⭐ |
|
||||||
|
| **B. 내용 수정** | 한 화 내용 변경 | ⭐⭐ |
|
||||||
|
| **C. 다중 수정** | 여러 화 같은 변경 | ⭐⭐ |
|
||||||
|
| **D. 플롯 수정** | 플롯 변경 → 본문 반영 | ⭐⭐⭐ |
|
||||||
|
| **E. 삽입** | 중간에 새 화 추가 | ⭐⭐⭐⭐ |
|
||||||
|
| **F. 삭제** | 기존 화 삭제 | ⭐⭐⭐ |
|
||||||
|
| **G. 분할** | 한 화 → 두 화 | ⭐⭐⭐⭐ |
|
||||||
|
| **H. 병합** | 두 화 → 한 화 | ⭐⭐⭐ |
|
||||||
|
|
||||||
|
**핵심 규칙:**
|
||||||
|
- 수정된 챕터 이후 **모든 summary 재생성** 필수
|
||||||
|
- 화수 변경 시 리네임 프로토콜 준수 (역순/정순)
|
||||||
|
- Git 커밋 전 타임라인 검증
|
||||||
|
|
||||||
|
### 3.4 검증 모드 (VERIFICATION)
|
||||||
|
|
||||||
|
**목적:** 6단계 통합 검증
|
||||||
|
|
||||||
|
```
|
||||||
|
1단계: 구조 검증 (파일 존재/연속성)
|
||||||
|
2단계: 형식 검증 (헤더/타임라인/바텀)
|
||||||
|
3단계: 타임라인 검증 (날짜 순서/역행)
|
||||||
|
4단계: 내용 검증 (플롯 일치/호칭)
|
||||||
|
5단계: 일관성 검증 (앞뒤 연결/복선)
|
||||||
|
6단계: 보고서 생성
|
||||||
|
```
|
||||||
|
|
||||||
|
**부분 검증 명령:**
|
||||||
|
- "타임라인만 검증해"
|
||||||
|
- "호칭 검증해"
|
||||||
|
- "바텀 검증해" → "바텀 일괄 제거해"
|
||||||
|
|
||||||
|
### 3.5 모드별 파일 읽기
|
||||||
|
|
||||||
|
| 파일 | WRITING | MODIFICATION | VERIFICATION |
|
||||||
|
|------|---------|--------------|--------------|
|
||||||
|
| CLAUDE.md | ✅ | ✅ | ✅ |
|
||||||
|
| standards/writing-mode.md | ✅ | - | - |
|
||||||
|
| standards/modification-mode.md | - | ✅ | - |
|
||||||
|
| standards/verification-mode.md | - | - | ✅ |
|
||||||
|
| settings/characters-master.md | ✅ | ✅ | ✅ |
|
||||||
|
| volumes/vol-XX/timeline.md | ✅ | ✅ | ✅ |
|
||||||
|
| volumes/vol-XX/plot-master.md | - | ✅ | ✅ |
|
||||||
|
| plots/plot-XXX-YYY.md | ✅ | - | - |
|
||||||
|
| summaries/* | ✅ | ✅ | ✅ |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 4. 전체 워크플로우
|
||||||
|
|
||||||
### Phase 1: 설계 (큰 틀)
|
### Phase 1: 설계 (큰 틀)
|
||||||
```
|
```
|
||||||
@@ -228,9 +427,9 @@ AI: vol-02 자동 설정
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 3. 프로젝트 위치 선택
|
## 5. 프로젝트 위치 선택
|
||||||
|
|
||||||
### 3.1 권장 위치: Google Drive
|
### 5.1 권장 위치: Google Drive
|
||||||
|
|
||||||
**경로:**
|
**경로:**
|
||||||
```
|
```
|
||||||
@@ -243,7 +442,7 @@ L:\내 드라이브\Writing\1945-novel\
|
|||||||
L:\내 드라이브\Writing\my-fantasy-story\
|
L:\내 드라이브\Writing\my-fantasy-story\
|
||||||
```
|
```
|
||||||
|
|
||||||
### 3.2 이중 백업 전략
|
### 5.2 이중 백업 전략
|
||||||
|
|
||||||
**로컬 (Google Drive):**
|
**로컬 (Google Drive):**
|
||||||
```
|
```
|
||||||
@@ -266,7 +465,7 @@ git.digien25.co.kr/Alex/1945-novel.git
|
|||||||
→ 독립적인 백업
|
→ 독립적인 백업
|
||||||
```
|
```
|
||||||
|
|
||||||
### 3.3 장점
|
### 5.3 장점
|
||||||
|
|
||||||
1. **Google Drive:**
|
1. **Google Drive:**
|
||||||
- 실시간 클라우드 백업
|
- 실시간 클라우드 백업
|
||||||
@@ -285,7 +484,7 @@ git.digien25.co.kr/Alex/1945-novel.git
|
|||||||
- Git 서버 장애 시 Google Drive에서 복구
|
- Git 서버 장애 시 Google Drive에서 복구
|
||||||
- 최대 안정성
|
- 최대 안정성
|
||||||
|
|
||||||
### 3.4 Git 작동 방식
|
### 5.4 Git 작동 방식
|
||||||
|
|
||||||
**자동 커밋/푸시:**
|
**자동 커밋/푸시:**
|
||||||
```
|
```
|
||||||
@@ -306,7 +505,7 @@ git.digien25.co.kr/Alex/1945-novel.git
|
|||||||
❌ 여러 PC 동시 작업 금지
|
❌ 여러 PC 동시 작업 금지
|
||||||
```
|
```
|
||||||
|
|
||||||
### 3.5 프로젝트명 규칙
|
### 5.5 프로젝트명 규칙
|
||||||
|
|
||||||
**권장:**
|
**권장:**
|
||||||
```
|
```
|
||||||
@@ -326,24 +525,32 @@ git.digien25.co.kr/Alex/1945-novel.git
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 4. 파일 구조
|
## 6. 파일 구조
|
||||||
|
|
||||||
### 4.1 전체 구조
|
### 6.1 전체 구조
|
||||||
|
|
||||||
```
|
```
|
||||||
novel-project/
|
novel-project/
|
||||||
│
|
│
|
||||||
├── CLAUDE.md # AI 협업 프로토콜
|
├── CLAUDE.md # AI 협업 프로토콜
|
||||||
|
├── CURRENT-TASK.md # 현재 작업 상태 (컴팩팅 대응)
|
||||||
├── README.md # 프로젝트 소개
|
├── README.md # 프로젝트 소개
|
||||||
├── CHANGELOG.md # 변경 이력
|
├── CHANGELOG.md # 변경 이력
|
||||||
├── .gitignore
|
├── .gitignore
|
||||||
├── .gitattributes
|
├── .gitattributes
|
||||||
│
|
│
|
||||||
├── settings/ # 🎨 마스터 파일 (설계용)
|
├── standards/ # 🔧 작업 방법론 (Guide에서 복사)
|
||||||
│ ├── characters-master.md # 전체 10권 통합 캐릭터
|
│ ├── writing-mode.md # 작성 모드 절차
|
||||||
│ ├── timeline-master.md # 1945-2024 전체 타임라인
|
│ ├── modification-mode.md # 수정 모드 절차 (8유형)
|
||||||
│ ├── plot-master.md # 전체 10권 줄거리
|
│ ├── verification-mode.md # 검증 모드 절차 (6단계)
|
||||||
│ └── writing-guide.md # 전체 공통 작성 규칙
|
│ ├── chapter-format.md # 챕터 형식 표준
|
||||||
|
│ ├── writing-guide.md # 문체/분량 규칙
|
||||||
|
│ └── renaming-protocol.md # 리네임 안전 절차
|
||||||
|
│
|
||||||
|
├── settings/ # 📖 소설 고유 콘텐츠
|
||||||
|
│ ├── characters-master.md # 전체 캐릭터 + 호칭 규칙
|
||||||
|
│ ├── timeline-master.md # 전체 타임라인
|
||||||
|
│ └── plot-master.md # 전체 플롯
|
||||||
│
|
│
|
||||||
├── volumes/ # 📚 권별 폴더
|
├── volumes/ # 📚 권별 폴더
|
||||||
│ ├── vol-01/
|
│ ├── vol-01/
|
||||||
@@ -382,26 +589,33 @@ novel-project/
|
|||||||
└── .git/ # Git 저장소
|
└── .git/ # Git 저장소
|
||||||
```
|
```
|
||||||
|
|
||||||
### 4.2 파일 역할
|
### 6.2 파일 역할
|
||||||
|
|
||||||
| 파일 | 용도 | 크기 | 읽기 시점 | 업데이트 |
|
| 파일 | 용도 | 크기 | 읽기 시점 | 업데이트 |
|
||||||
|------|------|------|----------|----------|
|
|------|------|------|----------|----------|
|
||||||
| **마스터 파일** | | | | |
|
| **프로젝트 루트** | | | | |
|
||||||
| `characters-master.md` | 전체 설계 | 큼 | 설계 시만 | 작성 중 필요 시 |
|
| `CLAUDE.md` | AI 작업 지시 | 작음 | 매 세션 | 설정 변경 시 |
|
||||||
| `timeline-master.md` | 전체 설계 | 큼 | 설계 시만 | 작성 중 필요 시 |
|
| `CURRENT-TASK.md` | 작업 상태 추적 | 작음 | 매 세션 | 작업 중 수시 |
|
||||||
| `plot-master.md` | 전체 설계 | 큼 | 설계 시만 | 거의 없음 |
|
| **standards/** | | | | |
|
||||||
| `writing-guide.md` | 작성 규칙 | 중간 | 매 세션 | 거의 없음 |
|
| `writing-mode.md` | 작성 절차 | 작음 | 작성 모드 | 거의 없음 |
|
||||||
|
| `modification-mode.md` | 수정 절차 | 작음 | 수정 모드 | 거의 없음 |
|
||||||
|
| `verification-mode.md` | 검증 절차 | 작음 | 검증 모드 | 거의 없음 |
|
||||||
|
| `chapter-format.md` | 챕터 형식 | 작음 | 작성/검증 | 거의 없음 |
|
||||||
|
| **settings/** | | | | |
|
||||||
|
| `characters-master.md` | 전체 캐릭터 | 큼 | 설계/작성 | 캐릭터 추가 시 |
|
||||||
|
| `timeline-master.md` | 전체 타임라인 | 큼 | 설계/수정 | 수정 시 |
|
||||||
|
| `plot-master.md` | 전체 플롯 | 큼 | 설계 시만 | 거의 없음 |
|
||||||
| **작업 파일** | | | | |
|
| **작업 파일** | | | | |
|
||||||
| `vol-XX/characters.md` | 작성 | 작음 | 매 세션 | 작성 중 필요 시 |
|
| `vol-XX/characters.md` | 권별 캐릭터 | 작음 | 매 세션 | 캐릭터 추가 시 |
|
||||||
| `vol-XX/timeline.md` | 작성 | 작음 | 매 세션 | 작성 중 필요 시 |
|
| `vol-XX/timeline.md` | 권별 타임라인 | 작음 | 매 세션 | 수정 시 |
|
||||||
| `plots/plot-XXX-YYY.md` | 작성 | 작음 | 매 세션 | 없음 |
|
| `plots/plot-XXX-YYY.md` | 5화 플롯 | 작음 | 작성 세션 | 없음 |
|
||||||
| `summaries/summary-XXX-YYY.md` | 작성 | 작음-중간 | 매 세션 | 매 화마다 |
|
| `summaries/summary-XXX-YYY.md` | 누적 요약 | 작음-중간 | 매 세션 | 매 화마다 |
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 5. Phase 1: 설계 (큰 틀)
|
## 7. Phase 1: 설계 (큰 틀)
|
||||||
|
|
||||||
### 5.1 시작 명령
|
### 7.1 시작 명령
|
||||||
|
|
||||||
```
|
```
|
||||||
사용자: "큰 틀 정하자"
|
사용자: "큰 틀 정하자"
|
||||||
@@ -409,7 +623,7 @@ novel-project/
|
|||||||
또는: "/design start"
|
또는: "/design start"
|
||||||
```
|
```
|
||||||
|
|
||||||
### 5.2 AI 질문 프로세스
|
### 7.2 AI 질문 프로세스
|
||||||
|
|
||||||
AI가 순차적으로 질문:
|
AI가 순차적으로 질문:
|
||||||
|
|
||||||
@@ -450,9 +664,9 @@ AI가 순차적으로 질문:
|
|||||||
- "금지 사항은?"
|
- "금지 사항은?"
|
||||||
```
|
```
|
||||||
|
|
||||||
### 5.3 생성 파일
|
### 7.3 생성 파일
|
||||||
|
|
||||||
#### 5.3.1 characters-master.md
|
#### 7.3.1 characters-master.md
|
||||||
|
|
||||||
```markdown
|
```markdown
|
||||||
# 등장인물 통합 사전
|
# 등장인물 통합 사전
|
||||||
@@ -499,7 +713,7 @@ AI가 순차적으로 질문:
|
|||||||
### (다른 캐릭터들...)
|
### (다른 캐릭터들...)
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.3.2 timeline-master.md
|
#### 7.3.2 timeline-master.md
|
||||||
|
|
||||||
```markdown
|
```markdown
|
||||||
# 전체 타임라인 (1945-2024)
|
# 전체 타임라인 (1945-2024)
|
||||||
@@ -568,7 +782,7 @@ AI가 순차적으로 질문:
|
|||||||
...
|
...
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.3.3 plot-master.md
|
#### 7.3.3 plot-master.md
|
||||||
|
|
||||||
```markdown
|
```markdown
|
||||||
# 전체 줄거리 (10권)
|
# 전체 줄거리 (10권)
|
||||||
@@ -603,7 +817,7 @@ AI가 순차적으로 질문:
|
|||||||
### 2권: ...
|
### 2권: ...
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.3.4 writing-guide.md
|
#### 7.3.4 writing-guide.md
|
||||||
|
|
||||||
```markdown
|
```markdown
|
||||||
# 작성 가이드 (전체 공통)
|
# 작성 가이드 (전체 공통)
|
||||||
@@ -660,7 +874,7 @@ AI가 순차적으로 질문:
|
|||||||
| 15,000-20,000자 | ⚠️ 너무 김 |
|
| 15,000-20,000자 | ⚠️ 너무 김 |
|
||||||
```
|
```
|
||||||
|
|
||||||
### 5.4 검토 및 확정
|
### 7.4 검토 및 확정
|
||||||
|
|
||||||
```
|
```
|
||||||
AI: "마스터 파일 생성 완료. 검토를 시작합니다."
|
AI: "마스터 파일 생성 완료. 검토를 시작합니다."
|
||||||
@@ -678,16 +892,16 @@ AI: "마스터 파일 확정. 권별 플롯 작성 가능합니다."
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 6. Phase 2: 권별 플롯
|
## 8. Phase 2: 권별 플롯
|
||||||
|
|
||||||
### 6.1 시작 명령
|
### 8.1 시작 명령
|
||||||
|
|
||||||
```
|
```
|
||||||
사용자: "1권 플롯 작성"
|
사용자: "1권 플롯 작성"
|
||||||
또는: "/plot vol-01"
|
또는: "/plot vol-01"
|
||||||
```
|
```
|
||||||
|
|
||||||
### 6.2 플롯 작성
|
### 8.2 플롯 작성
|
||||||
|
|
||||||
AI가 plot-master.md 기반으로 1권 50화 플롯 작성:
|
AI가 plot-master.md 기반으로 1권 50화 플롯 작성:
|
||||||
|
|
||||||
@@ -746,7 +960,7 @@ AI가 plot-master.md 기반으로 1권 50화 플롯 작성:
|
|||||||
...
|
...
|
||||||
```
|
```
|
||||||
|
|
||||||
### 6.3 검토 및 확정
|
### 8.3 검토 및 확정
|
||||||
|
|
||||||
```
|
```
|
||||||
AI: "1권 플롯 완성. 50화 구조 검토해주세요."
|
AI: "1권 플롯 완성. 50화 구조 검토해주세요."
|
||||||
@@ -763,9 +977,9 @@ AI: "1권 플롯 확정. 실행 준비 가능합니다."
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 7. Phase 3: 실행 준비
|
## 9. Phase 3: 실행 준비
|
||||||
|
|
||||||
### 7.1 시작 명령
|
### 9.1 시작 명령
|
||||||
|
|
||||||
```
|
```
|
||||||
사용자: "실행 준비"
|
사용자: "실행 준비"
|
||||||
@@ -773,7 +987,7 @@ AI: "1권 플롯 확정. 실행 준비 가능합니다."
|
|||||||
또는: "/setup vol-01"
|
또는: "/setup vol-01"
|
||||||
```
|
```
|
||||||
|
|
||||||
### 7.2 자동 실행 프로세스
|
### 9.2 자동 실행 프로세스
|
||||||
|
|
||||||
AI가 자동으로:
|
AI가 자동으로:
|
||||||
|
|
||||||
@@ -966,7 +1180,7 @@ git branch -M main
|
|||||||
git push -u origin main
|
git push -u origin main
|
||||||
```
|
```
|
||||||
|
|
||||||
### 7.3 완료 메시지
|
### 9.3 완료 메시지
|
||||||
|
|
||||||
```
|
```
|
||||||
AI: "✅ 실행 준비 완료!
|
AI: "✅ 실행 준비 완료!
|
||||||
@@ -984,9 +1198,9 @@ AI: "✅ 실행 준비 완료!
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 8. Phase 4: 작성
|
## 10. Phase 4: 작성 모드
|
||||||
|
|
||||||
### 8.1 시작 명령
|
### 10.1 시작 명령
|
||||||
|
|
||||||
```
|
```
|
||||||
사용자: "1~5화 작성해"
|
사용자: "1~5화 작성해"
|
||||||
@@ -994,7 +1208,7 @@ AI: "✅ 실행 준비 완료!
|
|||||||
또는: "/write 1-5"
|
또는: "/write 1-5"
|
||||||
```
|
```
|
||||||
|
|
||||||
### 8.2 세션 시작 (자동)
|
### 10.2 세션 시작 (자동)
|
||||||
|
|
||||||
AI가 자동으로 파일 읽기:
|
AI가 자동으로 파일 읽기:
|
||||||
|
|
||||||
@@ -1013,7 +1227,30 @@ AI가 자동으로 파일 읽기:
|
|||||||
준비 완료. ch-001부터 시작합니다.
|
준비 완료. ch-001부터 시작합니다.
|
||||||
```
|
```
|
||||||
|
|
||||||
### 8.3 작성 프로세스
|
### 10.3 챕터 형식 (바텀 금지!)
|
||||||
|
|
||||||
|
**헤더 형식:**
|
||||||
|
```markdown
|
||||||
|
# [권수]권 [화수]화: [제목]
|
||||||
|
|
||||||
|
> **타임라인:** YYYY.M.D-M.D
|
||||||
|
> **장소:** 장소1, 장소2
|
||||||
|
```
|
||||||
|
|
||||||
|
**바텀 절대 금지:**
|
||||||
|
```
|
||||||
|
❌ [29화 끝]
|
||||||
|
❌ [2권 29화 끝]
|
||||||
|
❌ 다음 30화: 제목
|
||||||
|
❌ --- 끝 ---
|
||||||
|
```
|
||||||
|
|
||||||
|
**이유:**
|
||||||
|
1. 헤더에 이미 화수 있음 (중복)
|
||||||
|
2. 리넘버링 시 전부 수정 필요 (유지보수 지옥)
|
||||||
|
3. 파일명/헤더와 불일치 위험
|
||||||
|
|
||||||
|
### 10.4 작성 프로세스
|
||||||
|
|
||||||
#### ch-001 작성:
|
#### ch-001 작성:
|
||||||
```
|
```
|
||||||
@@ -1090,7 +1327,7 @@ summaries/summary-001-005.md 업데이트:
|
|||||||
(반복)
|
(반복)
|
||||||
```
|
```
|
||||||
|
|
||||||
### 8.4 5화 완료
|
### 10.5 5화 완료
|
||||||
|
|
||||||
```
|
```
|
||||||
AI: "✅ 1-5화 작성 완료!
|
AI: "✅ 1-5화 작성 완료!
|
||||||
@@ -1128,7 +1365,7 @@ Gitea 푸시 완료.
|
|||||||
다음: '6~10화 작성해'"
|
다음: '6~10화 작성해'"
|
||||||
```
|
```
|
||||||
|
|
||||||
### 8.5 작성 중 변경 사항
|
### 10.6 작성 중 변경 사항
|
||||||
|
|
||||||
#### 예: 새 캐릭터 추가
|
#### 예: 새 캐릭터 추가
|
||||||
```
|
```
|
||||||
@@ -1166,9 +1403,140 @@ AI 자동 업데이트:
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 9. Phase 5: 권 완료
|
## 11. Phase 5: 수정 모드
|
||||||
|
|
||||||
### 9.1 50화 완료 시
|
### 11.1 개요
|
||||||
|
|
||||||
|
기존 챕터 수정 시 사용하는 모드입니다. 수정 유형에 따라 8가지 절차가 있습니다.
|
||||||
|
|
||||||
|
### 11.2 수정 유형별 절차
|
||||||
|
|
||||||
|
| 유형 | 절차 | Summary |
|
||||||
|
|------|------|---------|
|
||||||
|
| **A. 단순 수정** | 오타/문장 수정 → Git | 불필요 |
|
||||||
|
| **B. 내용 수정** | 해당 화 수정 → 해당 summary만 재생성 | 해당만 |
|
||||||
|
| **C. 다중 수정** | 여러 화 수정 → 각 summary 재생성 | 각각 |
|
||||||
|
| **D. 플롯 수정** | 플롯 수정 → 본문 반영 → summary 재생성 | 전체 |
|
||||||
|
| **E. 삽입** | 역순 리네임 → 새 화 추가 → summary 재생성 | 전체 |
|
||||||
|
| **F. 삭제** | 정순 리네임 → summary 재생성 | 전체 |
|
||||||
|
| **G. 분할** | 한 화 → 두 화 → 역순 리네임 → summary 재생성 | 전체 |
|
||||||
|
| **H. 병합** | 두 화 → 한 화 → 정순 리네임 → summary 재생성 | 전체 |
|
||||||
|
|
||||||
|
### 11.3 핵심 규칙
|
||||||
|
|
||||||
|
**Summary 재생성 규칙:**
|
||||||
|
```
|
||||||
|
수정된 챕터 N이 있을 때:
|
||||||
|
→ N 이후의 모든 summary 재생성 필수!
|
||||||
|
→ summary-001-010에서 ch-005 수정
|
||||||
|
→ summary-001-005, summary-001-010, ... 모두 재생성
|
||||||
|
```
|
||||||
|
|
||||||
|
**리네임 안전 규칙:**
|
||||||
|
```
|
||||||
|
삽입/분할 (번호 +1) → 역순 리네임!
|
||||||
|
ch-060 → ch-061
|
||||||
|
ch-059 → ch-060
|
||||||
|
...
|
||||||
|
ch-030 → ch-031
|
||||||
|
|
||||||
|
삭제/병합 (번호 -1) → 정순 리네임!
|
||||||
|
ch-030 → ch-029
|
||||||
|
ch-031 → ch-030
|
||||||
|
...
|
||||||
|
ch-060 → ch-059
|
||||||
|
```
|
||||||
|
|
||||||
|
### 11.4 작업 절차
|
||||||
|
|
||||||
|
```
|
||||||
|
1. 영향 분석
|
||||||
|
- 수정 유형 파악 (A~H 중)
|
||||||
|
- 영향 범위 결정
|
||||||
|
- Summary 재생성 범위 결정
|
||||||
|
|
||||||
|
2. 백업 (Git 커밋)
|
||||||
|
|
||||||
|
3. 수정 실행
|
||||||
|
- 리네임 필요 시 프로토콜 준수
|
||||||
|
- 헤더 화수 수정
|
||||||
|
|
||||||
|
4. Summary 재생성
|
||||||
|
|
||||||
|
5. 타임라인 검증
|
||||||
|
|
||||||
|
6. Git 커밋
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 12. Phase 6: 검증 모드
|
||||||
|
|
||||||
|
### 12.1 개요
|
||||||
|
|
||||||
|
작성/수정 완료 후 전체 일관성을 점검하는 모드입니다.
|
||||||
|
|
||||||
|
### 12.2 6단계 통합 검증
|
||||||
|
|
||||||
|
```
|
||||||
|
[1/6] 구조 검증
|
||||||
|
- 파일 존재/연속성
|
||||||
|
- 빠진 번호/중복 체크
|
||||||
|
|
||||||
|
[2/6] 형식 검증
|
||||||
|
- 헤더 형식 (# X권 Y화: 제목)
|
||||||
|
- 타임라인 형식 (YYYY.M.D-M.D)
|
||||||
|
- 바텀 있는지 체크 ⭐
|
||||||
|
|
||||||
|
[3/6] 타임라인 검증
|
||||||
|
- 시간 순서 확인
|
||||||
|
- 역행 체크
|
||||||
|
- 날짜 겹침 확인
|
||||||
|
|
||||||
|
[4/6] 내용 검증
|
||||||
|
- 플롯 일치도
|
||||||
|
- 호칭 일관성 ⭐
|
||||||
|
- 캐릭터 등장/퇴장
|
||||||
|
|
||||||
|
[5/6] 일관성 검증
|
||||||
|
- 앞뒤 연결
|
||||||
|
- 복선 추적
|
||||||
|
- 설정 충돌
|
||||||
|
|
||||||
|
[6/6] 보고서 생성
|
||||||
|
- 전체 점수
|
||||||
|
- 문제점 (심각도별)
|
||||||
|
- 권장 조치
|
||||||
|
```
|
||||||
|
|
||||||
|
### 12.3 부분 검증
|
||||||
|
|
||||||
|
| 명령 | 실행 내용 |
|
||||||
|
|------|----------|
|
||||||
|
| "타임라인만 검증해" | 3단계만 |
|
||||||
|
| "호칭 검증해" | 4단계 호칭만 |
|
||||||
|
| "바텀 검증해" | 2단계 바텀만 |
|
||||||
|
| "바텀 일괄 제거해" | 바텀 자동 제거 |
|
||||||
|
|
||||||
|
### 12.4 호칭 검증 기준
|
||||||
|
|
||||||
|
```
|
||||||
|
characters-master.md에 호칭 규칙 정의:
|
||||||
|
|
||||||
|
## 호칭 규칙
|
||||||
|
### 강민준 ↔ 서윤희
|
||||||
|
| 시점 | 민준→윤희 | 윤희→민준 |
|
||||||
|
|------|----------|----------|
|
||||||
|
| 첫 만남 | 서 선생님 | 강 선생님 |
|
||||||
|
| 친밀해진 후 | 윤희 씨 | 민준 씨 |
|
||||||
|
| 결혼 후 | 당신/윤희 | 당신/민준 |
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 13. Phase 7: 권 완료
|
||||||
|
|
||||||
|
### 13.1 50화 완료 시
|
||||||
|
|
||||||
```
|
```
|
||||||
사용자: "46~50화 작성해"
|
사용자: "46~50화 작성해"
|
||||||
@@ -1183,7 +1551,7 @@ AI: (작성 완료 후)
|
|||||||
자동 압축 시작..."
|
자동 압축 시작..."
|
||||||
```
|
```
|
||||||
|
|
||||||
### 9.2 압축 서머리 생성
|
### 13.2 압축 서머리 생성
|
||||||
|
|
||||||
AI가 `summary-001-050.md`를 읽고 압축:
|
AI가 `summary-001-050.md`를 읽고 압축:
|
||||||
|
|
||||||
@@ -1284,7 +1652,7 @@ AI가 `summary-001-050.md`를 읽고 압축:
|
|||||||
- 주요 사건: 47개
|
- 주요 사건: 47개
|
||||||
```
|
```
|
||||||
|
|
||||||
### 9.3 Git 커밋
|
### 13.3 Git 커밋
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git add .
|
git add .
|
||||||
@@ -1299,7 +1667,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
|
|||||||
git push origin main
|
git push origin main
|
||||||
```
|
```
|
||||||
|
|
||||||
### 9.4 완료 메시지
|
### 13.4 완료 메시지
|
||||||
|
|
||||||
```
|
```
|
||||||
AI: "🎉 1권 완료!
|
AI: "🎉 1권 완료!
|
||||||
@@ -1327,9 +1695,9 @@ Git 푸시 완료.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 10. Phase 6: 다음 권
|
## 14. Phase 8: 다음 권
|
||||||
|
|
||||||
### 10.1 2권 플롯 작성
|
### 14.1 2권 플롯 작성
|
||||||
|
|
||||||
```
|
```
|
||||||
사용자: "2권 플롯 작성"
|
사용자: "2권 플롯 작성"
|
||||||
@@ -1343,7 +1711,7 @@ AI: plot-master.md 참조
|
|||||||
검토 → 확정
|
검토 → 확정
|
||||||
```
|
```
|
||||||
|
|
||||||
### 10.2 2권 실행 준비
|
### 14.2 2권 실행 준비
|
||||||
|
|
||||||
```
|
```
|
||||||
사용자: "2권 실행 준비"
|
사용자: "2권 실행 준비"
|
||||||
@@ -1357,7 +1725,7 @@ AI 자동:
|
|||||||
완료!
|
완료!
|
||||||
```
|
```
|
||||||
|
|
||||||
### 10.3 2권 1-5화 작성
|
### 14.3 2권 1-5화 작성
|
||||||
|
|
||||||
```
|
```
|
||||||
사용자: "1~5화 작성해"
|
사용자: "1~5화 작성해"
|
||||||
@@ -1377,13 +1745,13 @@ ch-001~005
|
|||||||
✅ summary-001-005.md (2권)
|
✅ summary-001-005.md (2권)
|
||||||
```
|
```
|
||||||
|
|
||||||
### 10.4 반복
|
### 14.4 반복
|
||||||
|
|
||||||
Phase 4 반복...
|
Phase 4 반복...
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 11. CLAUDE.md 템플릿
|
## 15. CLAUDE.md 템플릿
|
||||||
|
|
||||||
```markdown
|
```markdown
|
||||||
# CLAUDE.md - AI 협업 프로토콜
|
# CLAUDE.md - AI 협업 프로토콜
|
||||||
@@ -1612,9 +1980,9 @@ Phase 4 반복...
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 12. Git 자동화
|
## 16. Git 자동화
|
||||||
|
|
||||||
### 12.1 Gitea 설정 정보
|
### 16.1 Gitea 설정 정보
|
||||||
|
|
||||||
```
|
```
|
||||||
주소: git.digien25.co.kr
|
주소: git.digien25.co.kr
|
||||||
@@ -1622,7 +1990,7 @@ Phase 4 반복...
|
|||||||
토큰: d2ae36cb862375aaab2575fcad5268d276798b2b
|
토큰: d2ae36cb862375aaab2575fcad5268d276798b2b
|
||||||
```
|
```
|
||||||
|
|
||||||
### 12.2 자동 초기화 (Phase 3)
|
### 16.2 자동 초기화 (Phase 3)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# 저장소 초기화
|
# 저장소 초기화
|
||||||
@@ -1673,7 +2041,7 @@ git branch -M main
|
|||||||
git push -u origin main
|
git push -u origin main
|
||||||
```
|
```
|
||||||
|
|
||||||
### 12.3 자동 커밋 규칙
|
### 16.3 자동 커밋 규칙
|
||||||
|
|
||||||
#### 5화 완료 시:
|
#### 5화 완료 시:
|
||||||
```
|
```
|
||||||
@@ -1708,7 +2076,7 @@ Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>"
|
|||||||
git push origin main
|
git push origin main
|
||||||
```
|
```
|
||||||
|
|
||||||
### 12.4 브랜치 전략
|
### 16.4 브랜치 전략
|
||||||
|
|
||||||
**단순 전략 (권장):**
|
**단순 전략 (권장):**
|
||||||
```
|
```
|
||||||
@@ -1724,9 +2092,9 @@ main
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 13. 토큰 효율 관리
|
## 17. 토큰 효율 관리
|
||||||
|
|
||||||
### 13.1 토큰 계산
|
### 17.1 토큰 계산
|
||||||
|
|
||||||
#### 한글 토큰 비효율:
|
#### 한글 토큰 비효율:
|
||||||
```
|
```
|
||||||
@@ -1750,7 +2118,7 @@ main
|
|||||||
| summary-001-005.md | ~3,000자 | ~2,000 |
|
| summary-001-005.md | ~3,000자 | ~2,000 |
|
||||||
| summary-vol-01-final.md | ~5,000자 | ~3,000 |
|
| summary-vol-01-final.md | ~5,000자 | ~3,000 |
|
||||||
|
|
||||||
### 13.2 세션별 토큰
|
### 17.2 세션별 토큰
|
||||||
|
|
||||||
#### 1권 첫 세션 (1-5화):
|
#### 1권 첫 세션 (1-5화):
|
||||||
```
|
```
|
||||||
@@ -1804,7 +2172,7 @@ main
|
|||||||
총: 89,000 토큰 (OK!)
|
총: 89,000 토큰 (OK!)
|
||||||
```
|
```
|
||||||
|
|
||||||
### 13.3 최적화 전략
|
### 17.3 최적화 전략
|
||||||
|
|
||||||
#### 서머리 압축:
|
#### 서머리 압축:
|
||||||
```
|
```
|
||||||
@@ -1838,9 +2206,9 @@ characters.md (1권만):
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 14. 파일 명명 규칙
|
## 18. 파일 명명 규칙
|
||||||
|
|
||||||
### 14.1 기본 원칙
|
### 18.1 기본 원칙
|
||||||
|
|
||||||
**모든 파일/폴더명은 영문 소문자 + 하이픈**
|
**모든 파일/폴더명은 영문 소문자 + 하이픈**
|
||||||
|
|
||||||
@@ -1852,7 +2220,7 @@ characters.md (1권만):
|
|||||||
| **플롯 파일** | `plot-NNN-MMM.md` | `plot-001-005.md` |
|
| **플롯 파일** | `plot-NNN-MMM.md` | `plot-001-005.md` |
|
||||||
| **서머리 파일** | `summary-NNN-MMM.md` | `summary-001-005.md` |
|
| **서머리 파일** | `summary-NNN-MMM.md` | `summary-001-005.md` |
|
||||||
|
|
||||||
### 14.2 권별 폴더명
|
### 18.2 권별 폴더명
|
||||||
|
|
||||||
```
|
```
|
||||||
vol-01 (1권)
|
vol-01 (1권)
|
||||||
@@ -1862,7 +2230,7 @@ vol-03 (3권)
|
|||||||
vol-10 (10권)
|
vol-10 (10권)
|
||||||
```
|
```
|
||||||
|
|
||||||
### 14.3 챕터 파일명
|
### 18.3 챕터 파일명
|
||||||
|
|
||||||
```
|
```
|
||||||
ch-001.md (1화)
|
ch-001.md (1화)
|
||||||
@@ -1872,7 +2240,7 @@ ch-050.md (50화)
|
|||||||
ch-100.md (100화, 2권 50화)
|
ch-100.md (100화, 2권 50화)
|
||||||
```
|
```
|
||||||
|
|
||||||
### 14.4 주의사항
|
### 18.4 주의사항
|
||||||
|
|
||||||
```
|
```
|
||||||
❌ 한글 파일명: 1권_16화_새로운_가능성.md
|
❌ 한글 파일명: 1권_16화_새로운_가능성.md
|
||||||
@@ -1890,9 +2258,9 @@ ch-100.md (100화, 2권 50화)
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 15. 부록
|
## 19. 부록
|
||||||
|
|
||||||
### 15.1 전체 명령어 목록
|
### 19.1 전체 명령어 목록
|
||||||
|
|
||||||
#### 설계:
|
#### 설계:
|
||||||
```
|
```
|
||||||
@@ -1931,7 +2299,7 @@ ch-100.md (100화, 2권 50화)
|
|||||||
"/check characters"
|
"/check characters"
|
||||||
```
|
```
|
||||||
|
|
||||||
### 15.2 FAQ
|
### 19.2 FAQ
|
||||||
|
|
||||||
**Q: 5화 작성 중 컴팩팅 발생하면?**
|
**Q: 5화 작성 중 컴팩팅 발생하면?**
|
||||||
A: 세션 종료 후 재시작. summary 덕분에 일관성 유지.
|
A: 세션 종료 후 재시작. summary 덕분에 일관성 유지.
|
||||||
@@ -1948,7 +2316,7 @@ A: 해당 챕터만 수정 → summary 재생성 → final 재생성.
|
|||||||
**Q: Git 충돌 발생하면?**
|
**Q: Git 충돌 발생하면?**
|
||||||
A: 수동 해결 후 AI에게 "/git status" 보고.
|
A: 수동 해결 후 AI에게 "/git status" 보고.
|
||||||
|
|
||||||
### 15.3 트러블슈팅
|
### 19.3 트러블슈팅
|
||||||
|
|
||||||
**문제: 토큰 초과**
|
**문제: 토큰 초과**
|
||||||
해결:
|
해결:
|
||||||
@@ -1972,28 +2340,44 @@ A: 수동 해결 후 AI에게 "/git status" 보고.
|
|||||||
|
|
||||||
## 변경 이력
|
## 변경 이력
|
||||||
|
|
||||||
|
### v3.1 (2026-01-18)
|
||||||
|
- ✅ **문서 계층 구조 정립**
|
||||||
|
- Guide (표준) vs 프로젝트 (실행) 분리
|
||||||
|
- standards/ (방법론) vs settings/ (콘텐츠) 분리
|
||||||
|
- ✅ **CURRENT-TASK.md 시스템**
|
||||||
|
- 컴팩팅 후 맥락 복구용
|
||||||
|
- 세션 시작 시 자동 확인
|
||||||
|
- ✅ **바텀 금지 표준화**
|
||||||
|
- 헤더만 화수 표시
|
||||||
|
- 바텀 완전 제거
|
||||||
|
- 검증 모드에서 자동 감지/제거
|
||||||
|
- ✅ **수정 모드 8유형 체계화**
|
||||||
|
- A~H 유형별 절차 명확화
|
||||||
|
- Summary 재생성 규칙 강화
|
||||||
|
- ✅ **검증 모드 6단계 통합**
|
||||||
|
- 호칭/바텀 검증 포함
|
||||||
|
- 부분 검증 명령 지원
|
||||||
|
- ✅ **템플릿 폴더 구조**
|
||||||
|
- templates/standards/ 생성
|
||||||
|
- 각 모드별 독립 문서
|
||||||
|
|
||||||
### v3.0 (2026-01-17)
|
### v3.0 (2026-01-17)
|
||||||
- ✅ **모드 시스템 구축** (핵심!)
|
- ✅ **모드 시스템 구축** (핵심!)
|
||||||
- WRITING: 신규 작성
|
- WRITING: 신규 작성
|
||||||
- MODIFICATION: 기존 수정
|
- MODIFICATION: 기존 수정
|
||||||
- VERIFICATION: 전체 점검
|
- VERIFICATION: 전체 점검
|
||||||
- DISCUSSION: 협의/논의
|
|
||||||
- ✅ **수정 프로토콜 체계화**
|
- ✅ **수정 프로토콜 체계화**
|
||||||
- Summary 재생성 강제화
|
- Summary 재생성 강제화
|
||||||
- 타임라인 검증 자동화
|
- 타임라인 검증 자동화
|
||||||
- CHANGELOG 의무화
|
- CHANGELOG 의무화
|
||||||
- ✅ **챕터 형식 표준 문서화**
|
- ✅ **챕터 형식 표준 문서화**
|
||||||
- chapter-format-standard.md
|
- chapter-format.md
|
||||||
- 헤더 형식 규칙
|
- 헤더 형식 규칙
|
||||||
- 타임라인 연속성 검증
|
- 타임라인 연속성 검증
|
||||||
- ✅ **안전한 리네임 절차**
|
- ✅ **안전한 리네임 절차**
|
||||||
- renaming-protocol.md
|
- renaming-protocol.md
|
||||||
- 2단계 리네임
|
- 2단계 리네임
|
||||||
- 자동화 스크립트
|
- 자동화 스크립트
|
||||||
- ✅ **WORK-MODE.txt 시스템**
|
|
||||||
- 모드 전환 메커니즘
|
|
||||||
- 맥락 손실 방지
|
|
||||||
- 컴팩팅 대응
|
|
||||||
|
|
||||||
### v2.0 (2026-01-15)
|
### v2.0 (2026-01-15)
|
||||||
- ✅ 완전 재작성
|
- ✅ 완전 재작성
|
||||||
@@ -2068,6 +2452,6 @@ volumes/vol-XX/
|
|||||||
---
|
---
|
||||||
|
|
||||||
**작성자:** Alex
|
**작성자:** Alex
|
||||||
**최종 수정:** 2026-01-17
|
**최종 수정:** 2026-01-18
|
||||||
**버전:** 3.0
|
**버전:** 3.1
|
||||||
**라이선스:** 개인 프로젝트
|
**라이선스:** 개인 프로젝트
|
||||||
|
|||||||
Reference in New Issue
Block a user