From f3c4bf48fdba995fd199af7b82d5f758e9bc2002 Mon Sep 17 00:00:00 2001 From: Alex Date: Sun, 18 Jan 2026 10:39:34 +0900 Subject: [PATCH] =?UTF-8?q?Guide=20v3.1:=20=EB=A9=94=EC=9D=B8=20=EB=AC=B8?= =?UTF-8?q?=EC=84=9C=20=EB=8C=80=ED=8F=AD=20=EC=97=85=EB=8D=B0=EC=9D=B4?= =?UTF-8?q?=ED=8A=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 주요 변경: - 문서 계층 구조 섹션 추가 (섹션 1) - 모드 시스템 본문에 상세 추가 (섹션 3) - Phase 5 수정 모드 섹션 신설 (8유형) - Phase 6 검증 모드 섹션 신설 (6단계) - 바텀 금지 규칙 명시 (섹션 10.3) - CURRENT-TASK.md 시스템 설명 - 파일 구조에 standards/ 폴더 반영 - 전체 섹션 번호 재정리 (19개 섹션) Co-Authored-By: Claude Opus 4.5 --- CURRENT-TASK.md | 29 +- Novel Writing Project Guide.md | 596 +++++++++++++++++++++++++++------ 2 files changed, 505 insertions(+), 120 deletions(-) diff --git a/CURRENT-TASK.md b/CURRENT-TASK.md index 51e6046..b3b3719 100644 --- a/CURRENT-TASK.md +++ b/CURRENT-TASK.md @@ -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/writing-guide.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 메인 문서 업데이트 -**파일:** Novel Writing Project Guide.md -**내용:** -- 문서 계층 구조 섹션 추가 (Guide vs 프로젝트) -- 폴더 구조 반영 (standards vs settings 분리) -- 모드 시스템 본문에 상세 추가 (현재 변경이력에만 있음) -- CURRENT-TASK.md 설명 추가 -- 바텀 금지 규칙 반영 - -### 2. 1945 프로젝트 적용 +### 1945 프로젝트 적용 **작업:** - [ ] 폴더 리팩토링: settings/ → standards/ + settings/ 분리 - 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 새 구조로 업데이트 - [ ] characters-master.md에 호칭 규칙 섹션 추가 -### 3. 기존 챕터 바텀 제거 (선택) +### 기존 챕터 바텀 제거 (선택) - 검증 모드에서 처리 예정 - 작성/수정 완료 후 검증 모드 돌릴 때 일괄 제거 diff --git a/Novel Writing Project Guide.md b/Novel Writing Project Guide.md index 6aef707..595d85d 100644 --- a/Novel Writing Project Guide.md +++ b/Novel Writing Project Guide.md @@ -1,7 +1,8 @@ -# 소설 작성 프로젝트 표준 가이드 (v2.0) +# 소설 작성 프로젝트 표준 가이드 (v3.1) > **작성일:** 2026-01-15 -> **버전:** 2.0 +> **버전:** 3.1 +> **최종 수정:** 2026-01-18 > **목적:** AI와 협업하여 장편 소설(10권 이상)을 체계적으로 작성하기 위한 표준 가이드 --- @@ -69,27 +70,132 @@ CLAUDE.md = 내비게이션 (매번 운전할 때마다) **⚠️ [이 문서의 역할](#%EF%B8%8F-이-문서의-역할)** ← 먼저 읽기! -1. [핵심 컨셉](#1-핵심-컨셉) -2. [전체 워크플로우](#2-전체-워크플로우) -3. [프로젝트 위치 선택](#3-프로젝트-위치-선택) -4. [파일 구조](#4-파일-구조) -5. [Phase 1: 설계 (큰 틀)](#5-phase-1-설계-큰-틀) -6. [Phase 2: 권별 플롯](#6-phase-2-권별-플롯) -7. [Phase 3: 실행 준비](#7-phase-3-실행-준비) -8. [Phase 4: 작성](#8-phase-4-작성) -9. [Phase 5: 권 완료](#9-phase-5-권-완료) -10. [Phase 6: 다음 권](#10-phase-6-다음-권) -11. [CLAUDE.md 템플릿](#11-claudemd-템플릿) -12. [Git 자동화](#12-git-자동화) -13. [토큰 효율 관리](#13-토큰-효율-관리) -14. [파일 명명 규칙](#14-파일-명명-규칙) -15. [부록](#15-부록) +1. [문서 계층 구조](#1-문서-계층-구조) ⭐ NEW +2. [핵심 컨셉](#2-핵심-컨셉) +3. [모드 시스템](#3-모드-시스템) ⭐ NEW +4. [전체 워크플로우](#4-전체-워크플로우) +5. [프로젝트 위치 선택](#5-프로젝트-위치-선택) +6. [파일 구조](#6-파일-구조) +7. [Phase 1: 설계 (큰 틀)](#7-phase-1-설계-큰-틀) +8. [Phase 2: 권별 플롯](#8-phase-2-권별-플롯) +9. [Phase 3: 실행 준비](#9-phase-3-실행-준비) +10. [Phase 4: 작성 모드](#10-phase-4-작성-모드) +11. [Phase 5: 수정 모드](#11-phase-5-수정-모드) ⭐ NEW +12. [Phase 6: 검증 모드](#12-phase-6-검증-모드) ⭐ NEW +13. [Phase 7: 권 완료](#13-phase-7-권-완료) +14. [Phase 8: 다음 권](#14-phase-8-다음-권) +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 토큰 (충분!) ``` -### 1.3 5화 = 1작업 단위 +### 2.3 5화 = 1작업 단위 ``` 사용자 관점: @@ -143,7 +249,7 @@ AI 관점: - 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: 설계 (큰 틀) ``` @@ -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\ ``` -### 3.2 이중 백업 전략 +### 5.2 이중 백업 전략 **로컬 (Google Drive):** ``` @@ -266,7 +465,7 @@ git.digien25.co.kr/Alex/1945-novel.git → 독립적인 백업 ``` -### 3.3 장점 +### 5.3 장점 1. **Google Drive:** - 실시간 클라우드 백업 @@ -285,7 +484,7 @@ git.digien25.co.kr/Alex/1945-novel.git - Git 서버 장애 시 Google Drive에서 복구 - 최대 안정성 -### 3.4 Git 작동 방식 +### 5.4 Git 작동 방식 **자동 커밋/푸시:** ``` @@ -306,7 +505,7 @@ git.digien25.co.kr/Alex/1945-novel.git ❌ 여러 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/ │ ├── CLAUDE.md # AI 협업 프로토콜 +├── CURRENT-TASK.md # 현재 작업 상태 (컴팩팅 대응) ├── README.md # 프로젝트 소개 ├── CHANGELOG.md # 변경 이력 ├── .gitignore ├── .gitattributes │ -├── settings/ # 🎨 마스터 파일 (설계용) -│ ├── characters-master.md # 전체 10권 통합 캐릭터 -│ ├── timeline-master.md # 1945-2024 전체 타임라인 -│ ├── plot-master.md # 전체 10권 줄거리 -│ └── writing-guide.md # 전체 공통 작성 규칙 +├── 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-01/ @@ -382,26 +589,33 @@ novel-project/ └── .git/ # Git 저장소 ``` -### 4.2 파일 역할 +### 6.2 파일 역할 | 파일 | 용도 | 크기 | 읽기 시점 | 업데이트 | |------|------|------|----------|----------| -| **마스터 파일** | | | | | -| `characters-master.md` | 전체 설계 | 큼 | 설계 시만 | 작성 중 필요 시 | -| `timeline-master.md` | 전체 설계 | 큼 | 설계 시만 | 작성 중 필요 시 | -| `plot-master.md` | 전체 설계 | 큼 | 설계 시만 | 거의 없음 | -| `writing-guide.md` | 작성 규칙 | 중간 | 매 세션 | 거의 없음 | +| **프로젝트 루트** | | | | | +| `CLAUDE.md` | AI 작업 지시 | 작음 | 매 세션 | 설정 변경 시 | +| `CURRENT-TASK.md` | 작업 상태 추적 | 작음 | 매 세션 | 작업 중 수시 | +| **standards/** | | | | | +| `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/timeline.md` | 작성 | 작음 | 매 세션 | 작성 중 필요 시 | -| `plots/plot-XXX-YYY.md` | 작성 | 작음 | 매 세션 | 없음 | -| `summaries/summary-XXX-YYY.md` | 작성 | 작음-중간 | 매 세션 | 매 화마다 | +| `vol-XX/characters.md` | 권별 캐릭터 | 작음 | 매 세션 | 캐릭터 추가 시 | +| `vol-XX/timeline.md` | 권별 타임라인 | 작음 | 매 세션 | 수정 시 | +| `plots/plot-XXX-YYY.md` | 5화 플롯 | 작음 | 작성 세션 | 없음 | +| `summaries/summary-XXX-YYY.md` | 누적 요약 | 작음-중간 | 매 세션 | 매 화마다 | --- -## 5. Phase 1: 설계 (큰 틀) +## 7. Phase 1: 설계 (큰 틀) -### 5.1 시작 명령 +### 7.1 시작 명령 ``` 사용자: "큰 틀 정하자" @@ -409,7 +623,7 @@ novel-project/ 또는: "/design start" ``` -### 5.2 AI 질문 프로세스 +### 7.2 AI 질문 프로세스 AI가 순차적으로 질문: @@ -450,9 +664,9 @@ AI가 순차적으로 질문: - "금지 사항은?" ``` -### 5.3 생성 파일 +### 7.3 생성 파일 -#### 5.3.1 characters-master.md +#### 7.3.1 characters-master.md ```markdown # 등장인물 통합 사전 @@ -499,7 +713,7 @@ AI가 순차적으로 질문: ### (다른 캐릭터들...) ``` -#### 5.3.2 timeline-master.md +#### 7.3.2 timeline-master.md ```markdown # 전체 타임라인 (1945-2024) @@ -568,7 +782,7 @@ AI가 순차적으로 질문: ... ``` -#### 5.3.3 plot-master.md +#### 7.3.3 plot-master.md ```markdown # 전체 줄거리 (10권) @@ -603,7 +817,7 @@ AI가 순차적으로 질문: ### 2권: ... ``` -#### 5.3.4 writing-guide.md +#### 7.3.4 writing-guide.md ```markdown # 작성 가이드 (전체 공통) @@ -660,7 +874,7 @@ AI가 순차적으로 질문: | 15,000-20,000자 | ⚠️ 너무 김 | ``` -### 5.4 검토 및 확정 +### 7.4 검토 및 확정 ``` AI: "마스터 파일 생성 완료. 검토를 시작합니다." @@ -678,16 +892,16 @@ AI: "마스터 파일 확정. 권별 플롯 작성 가능합니다." --- -## 6. Phase 2: 권별 플롯 +## 8. Phase 2: 권별 플롯 -### 6.1 시작 명령 +### 8.1 시작 명령 ``` 사용자: "1권 플롯 작성" 또는: "/plot vol-01" ``` -### 6.2 플롯 작성 +### 8.2 플롯 작성 AI가 plot-master.md 기반으로 1권 50화 플롯 작성: @@ -746,7 +960,7 @@ AI가 plot-master.md 기반으로 1권 50화 플롯 작성: ... ``` -### 6.3 검토 및 확정 +### 8.3 검토 및 확정 ``` 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" ``` -### 7.2 자동 실행 프로세스 +### 9.2 자동 실행 프로세스 AI가 자동으로: @@ -966,7 +1180,7 @@ git branch -M main git push -u origin main ``` -### 7.3 완료 메시지 +### 9.3 완료 메시지 ``` AI: "✅ 실행 준비 완료! @@ -984,9 +1198,9 @@ AI: "✅ 실행 준비 완료! --- -## 8. Phase 4: 작성 +## 10. Phase 4: 작성 모드 -### 8.1 시작 명령 +### 10.1 시작 명령 ``` 사용자: "1~5화 작성해" @@ -994,7 +1208,7 @@ AI: "✅ 실행 준비 완료! 또는: "/write 1-5" ``` -### 8.2 세션 시작 (자동) +### 10.2 세션 시작 (자동) AI가 자동으로 파일 읽기: @@ -1013,7 +1227,30 @@ AI가 자동으로 파일 읽기: 준비 완료. 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 작성: ``` @@ -1090,7 +1327,7 @@ summaries/summary-001-005.md 업데이트: (반복) ``` -### 8.4 5화 완료 +### 10.5 5화 완료 ``` AI: "✅ 1-5화 작성 완료! @@ -1128,7 +1365,7 @@ Gitea 푸시 완료. 다음: '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화 작성해" @@ -1183,7 +1551,7 @@ AI: (작성 완료 후) 자동 압축 시작..." ``` -### 9.2 압축 서머리 생성 +### 13.2 압축 서머리 생성 AI가 `summary-001-050.md`를 읽고 압축: @@ -1284,7 +1652,7 @@ AI가 `summary-001-050.md`를 읽고 압축: - 주요 사건: 47개 ``` -### 9.3 Git 커밋 +### 13.3 Git 커밋 ```bash git add . @@ -1299,7 +1667,7 @@ Co-Authored-By: Claude Sonnet 4.5 " git push origin main ``` -### 9.4 완료 메시지 +### 13.4 완료 메시지 ``` AI: "🎉 1권 완료! @@ -1327,9 +1695,9 @@ Git 푸시 완료. --- -## 10. Phase 6: 다음 권 +## 14. Phase 8: 다음 권 -### 10.1 2권 플롯 작성 +### 14.1 2권 플롯 작성 ``` 사용자: "2권 플롯 작성" @@ -1343,7 +1711,7 @@ AI: plot-master.md 참조 검토 → 확정 ``` -### 10.2 2권 실행 준비 +### 14.2 2권 실행 준비 ``` 사용자: "2권 실행 준비" @@ -1357,7 +1725,7 @@ AI 자동: 완료! ``` -### 10.3 2권 1-5화 작성 +### 14.3 2권 1-5화 작성 ``` 사용자: "1~5화 작성해" @@ -1377,13 +1745,13 @@ ch-001~005 ✅ summary-001-005.md (2권) ``` -### 10.4 반복 +### 14.4 반복 Phase 4 반복... --- -## 11. CLAUDE.md 템플릿 +## 15. CLAUDE.md 템플릿 ```markdown # CLAUDE.md - AI 협업 프로토콜 @@ -1612,9 +1980,9 @@ Phase 4 반복... --- -## 12. Git 자동화 +## 16. Git 자동화 -### 12.1 Gitea 설정 정보 +### 16.1 Gitea 설정 정보 ``` 주소: git.digien25.co.kr @@ -1622,7 +1990,7 @@ Phase 4 반복... 토큰: d2ae36cb862375aaab2575fcad5268d276798b2b ``` -### 12.2 자동 초기화 (Phase 3) +### 16.2 자동 초기화 (Phase 3) ```bash # 저장소 초기화 @@ -1673,7 +2041,7 @@ git branch -M main git push -u origin main ``` -### 12.3 자동 커밋 규칙 +### 16.3 자동 커밋 규칙 #### 5화 완료 시: ``` @@ -1708,7 +2076,7 @@ Co-Authored-By: Claude Sonnet 4.5 " 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-vol-01-final.md | ~5,000자 | ~3,000 | -### 13.2 세션별 토큰 +### 17.2 세션별 토큰 #### 1권 첫 세션 (1-5화): ``` @@ -1804,7 +2172,7 @@ main 총: 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` | | **서머리 파일** | `summary-NNN-MMM.md` | `summary-001-005.md` | -### 14.2 권별 폴더명 +### 18.2 권별 폴더명 ``` vol-01 (1권) @@ -1862,7 +2230,7 @@ vol-03 (3권) vol-10 (10권) ``` -### 14.3 챕터 파일명 +### 18.3 챕터 파일명 ``` ch-001.md (1화) @@ -1872,7 +2240,7 @@ ch-050.md (50화) ch-100.md (100화, 2권 50화) ``` -### 14.4 주의사항 +### 18.4 주의사항 ``` ❌ 한글 파일명: 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" ``` -### 15.2 FAQ +### 19.2 FAQ **Q: 5화 작성 중 컴팩팅 발생하면?** A: 세션 종료 후 재시작. summary 덕분에 일관성 유지. @@ -1948,7 +2316,7 @@ A: 해당 챕터만 수정 → summary 재생성 → final 재생성. **Q: Git 충돌 발생하면?** 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) - ✅ **모드 시스템 구축** (핵심!) - WRITING: 신규 작성 - MODIFICATION: 기존 수정 - VERIFICATION: 전체 점검 - - DISCUSSION: 협의/논의 - ✅ **수정 프로토콜 체계화** - Summary 재생성 강제화 - 타임라인 검증 자동화 - CHANGELOG 의무화 - ✅ **챕터 형식 표준 문서화** - - chapter-format-standard.md + - chapter-format.md - 헤더 형식 규칙 - 타임라인 연속성 검증 - ✅ **안전한 리네임 절차** - renaming-protocol.md - 2단계 리네임 - 자동화 스크립트 -- ✅ **WORK-MODE.txt 시스템** - - 모드 전환 메커니즘 - - 맥락 손실 방지 - - 컴팩팅 대응 ### v2.0 (2026-01-15) - ✅ 완전 재작성 @@ -2068,6 +2452,6 @@ volumes/vol-XX/ --- **작성자:** Alex -**최종 수정:** 2026-01-17 -**버전:** 3.0 +**최종 수정:** 2026-01-18 +**버전:** 3.1 **라이선스:** 개인 프로젝트