v4.0: Single Source of Truth 시스템 확립

- 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>
This commit is contained in:
Alex
2026-01-23 12:41:35 +09:00
parent 854ff7d1f5
commit 271c11d6fc
10 changed files with 1768 additions and 190 deletions

View File

@@ -1,10 +1,10 @@
# 검증 모드 프로토콜
> **버전:** 2.4.1
> **최종 수정:** 2026-01-20
> **버전:** 2.4.2
> **최종 수정:** 2026-01-21
> **호환:** CWS Writing Guide v4.2.0+
> **용도:** 전체 검증 및 기록 (수정 없음)
> **주요 변경:** 날씨/계절 일관성 검증 추가 (명시적)
> **주요 변경:** 오류 카운트 원칙 추가 (중복 카운트 방지)
---
@@ -345,6 +345,206 @@ FIX = 수정
---
## 📏 오류 카운트 원칙 (v2.4.2 신규)
**목적:** 중복 카운트 방지 및 정확한 오류 개수 산출
### ⚠️ 주의: 중복 카운트 금지
**문제 상황:**
```
타임라인 헤더 오류: 7건
챕터 간 연결 오류: 3건
---
합계: 10건 ❌ 잘못된 카운트!
```
**왜 잘못되었나?**
- "챕터 간 연결 오류" 3건이 **타임라인 문제에서 발생**
- 실제로는 **같은 오류**를 두 번 센 것!
- 정확한 합계: 7건 (타임라인 헤더만)
---
### ✅ 정확한 카운트 방식
#### 1. 유형별 카운트 (Primary)
**각 오류를 정확히 하나의 카테고리에만 분류:**
```markdown
1. 타임라인 헤더 오류: 7건
- ch-002, 003, 004, 005, 006, 007, 008
- 헤더 날짜 ≠ 본문 날짜
2. 챕터 간 연결 오류: 3건
- ch-002→003, ch-003→004, ch-004→005
- 날짜 건너뜀, 본문 표현 문제
- ⚠️ 타임라인 오류와 **별개**
3. 호칭 복수/단수 오류: 2건
- ch-002:139, ch-011:511
4. 설정 모순: 2건
- ch-003:417 (나이), ch-003:427 (신분)
---
총 오류: 7+3+2+2 = 14건 ✅
```
#### 2. 챕터별 카운트 (Verification)
**각 챕터에서 발견된 오류를 개별로 세기:**
```markdown
- ch-002: 2건 (타임라인 1 + 호칭 1)
- ch-003: 2건 (타임라인 1 + 설정 1)
- ch-004: 3건 (타임라인 1 + 연결 1 + 설정 1)
- ch-005: 2건 (타임라인 1 + 연결 1)
- ch-006: 1건 (타임라인 1)
- ch-007: 1건 (타임라인 1)
- ch-008: 1건 (타임라인 1)
- ch-011: 2건 (타임라인 1 + 호칭 1)
---
챕터별 합계: 2+2+3+2+1+1+1+2 = 14건 ✅
```
#### 3. 검증 (Mandatory)
**두 방식의 합계가 반드시 일치해야 함:**
```
유형별 합계: 14건
챕터별 합계: 14건
---
✅ 일치! 정확한 카운트
```
**불일치 시:**
```
유형별 합계: 17건
챕터별 합계: 12건
---
❌ 불일치! 중복 카운트 발생
→ 재확인 필수
```
---
### 🚨 중복 카운트가 발생하는 패턴
#### 패턴 1: 연결 문제를 두 번 세기
**잘못된 방식:**
```markdown
타임라인 오류 (10건):
- 헤더 오류: ch-002~008 (7건)
- 연결 문제: ch-002→003, ch-003→004, ch-004→005 (3건)
챕터 간 연결 오류 (3건):
- ch-002→003, ch-003→004, ch-004→005
---
합계: 10 + 3 = 13건 ❌ (연결 3건 중복!)
```
**올바른 방식:**
```markdown
타임라인 헤더 오류 (7건):
- ch-002~008
챕터 간 연결 오류 (3건):
- ch-002→003, ch-003→004, ch-004→005
---
합계: 7 + 3 = 10건 ✅
```
#### 패턴 2: 하위 카테고리를 상위와 중복
**잘못된 방식:**
```markdown
설정 오류 (5건):
- 나이 불일치: 2건
- 신분 모순: 1건
- 위치 충돌: 2건
나이 불일치 (2건):
- ch-003, ch-015
---
합계: 5 + 2 = 7건 ❌ (나이 2건 중복!)
```
**올바른 방식:**
```markdown
설정 오류 (5건):
- 나이 불일치: 2건 (ch-003, ch-015)
- 신분 모순: 1건
- 위치 충돌: 2건
---
합계: 5건만 ✅
```
---
### 📋 보고서 작성 체크리스트
**보고서 완성 전 필수 확인:**
- [ ] 1. 유형별 오류 합계 계산
- [ ] 2. 챕터별 오류 합계 계산
- [ ] 3. 두 합계가 일치하는지 확인
- [ ] 4. 불일치 시 중복 카운트 찾기
- [ ] 5. 중복 제거 후 재계산
- [ ] 6. 최종 합계 확정
- [ ] 7. "총 X건" 표기
**예시:**
```markdown
## 검증 요약
### 유형별
- 타임라인: 7건
- 연결: 3건
- 호칭: 2건
- 설정: 2건
**합계: 14건**
### 챕터별
- ch-002: 2건
- ch-003: 2건
- ...
**합계: 14건**
✅ 검증 완료 (일치)
**총 발견 오류: 14건**
```
---
### 🔧 보완 권장 사항
1. **validation 작성 시**
- 각 오류를 정확히 하나의 카테고리에만 할당
- 중복 가능성이 있는 항목은 명시적으로 분리
- 예: "타임라인 헤더" vs "챕터 간 연결"
2. **최종 보고 전**
- 유형별/챕터별 합계 검증 필수
- 불일치 발생 시 중복 카운트 재확인
- 정확한 숫자 확정 후 보고
3. **카운트 방식 표준화**
- 명확한 카테고리 정의
- 중복 방지 원칙 적용
- 검증 절차 준수
---
## 📊 검증 보고서 형식
```markdown

View File

@@ -1,10 +1,143 @@
# 작성 가이드 (문체/분량 규칙)
> **버전:** 2.3.0
> **최종 수정:** 2026-01-20
> **버전:** 2.5.0
> **최종 수정:** 2026-01-21
> **호환:** CWS Writing Guide v4.2.0+
> **용도:** 소설 작성 시 문체, 분량, 표현 규칙
> **주요 변경:** 작성 중 흔한 실수 예시 추가 (OOC, 능력 모순, 정보 모순)
> **주요 변경 (v2.5):** 작가 스타일 적용 기능 추가 (Multi-작가 시스템)
---
## 🎨 작가 스타일 적용 (v2.5 신규)
### 개요
**작가 스타일(Author Style)**: 프로젝트별로 정의된 문체 기준
```
프로젝트마다 다른 작가 스타일 사용 가능:
- 1945 소설 → author-01 (짧고 강렬한 문장)
- 로맨스 소설 → author-02 (부드럽고 긴 문장)
```
### 작성 전 필수: 작가 파일 읽기
```
작성 모드 진입 시 반드시 읽을 파일:
✅ authors/author-XX.md (프로젝트 작가 스타일)
작가 파일에는 다음 10가지 항목이 정의되어 있음:
1. 문장 길이 패턴
2. 어미 패턴
3. 문장 구조
4. 어휘 특성
5. 묘사 스타일
6. 대화 스타일
7. 단락 구조
8. 리듬감
9. 시제 사용
10. 관점 (POV)
```
### 작성 중 체크포인트
**Part 작성 후 즉시 확인:**
```
✅ 문장 길이가 작가 기준 범위 내인가?
- author-XX.md에서: "평균 15~25자"
→ 작성한 문장들이 이 범위에 있는가?
✅ 어미 비율이 맞는가?
- author-XX.md에서: "과거형 90%, 현재형 10%"
→ 현재형 너무 많이 쓰지 않았는가?
✅ 묘사 스타일 준수했는가?
- author-XX.md에서: "Show Don't Tell 철저"
→ "슬펐다" 같은 감정 단어 안 썼는가?
✅ 단락 구조 일관되는가?
- author-XX.md에서: "1단락 = 1~3문장"
→ 너무 긴 단락 없는가?
```
### 작가 스타일 핵심 원칙 (Top 5)
**각 작가마다 "핵심 원칙 Top 5"가 정의되어 있음.**
예시 (author-01):
```
1. 짧게 쓴다: 한 문장 = 한 정보
2. 과거형 "-었다": 90% 이상
3. Show Don't Tell: 감정 단어 금지
4. 리듬감: 짧은 문장 연타 + 삼박자
5. 직설적: 부사 최소화, 핵심만
```
**작성 시 이 5가지를 최우선으로 준수!**
### 문체 일탈 감지
**작성 중 문체가 벗어났다고 느껴지면:**
```
1. 즉시 author-XX.md 다시 읽기
2. 해당 Part 문체 체크리스트 실행
3. 문제 문장 수정 후 계속 작성
→ Part 끝날 때까지 기다리지 말고 즉시 수정!
```
### 작가 전환 (Multi-프로젝트)
**다른 프로젝트 작성 시:**
```
프로젝트 A (author-01) 작성 중
→ 프로젝트 B (author-02) 전환
필수:
1. project-config.md 확인 → 작가 확인
2. authors/author-02.md 읽기
3. 핵심 원칙 Top 5 숙지
4. 문체 전환 완료 후 작성 시작
→ 이전 프로젝트 문체 혼동 방지!
```
### 체크리스트: 작가 스타일 준수
**작성 완료 후 최종 확인:**
```
문장:
- [ ] 문장 길이 범위 내
- [ ] 어미 비율 준수
- [ ] 문장 구조 일관
어휘:
- [ ] 어휘 특성 준수
- [ ] 금지 표현 미사용
묘사:
- [ ] 묘사 스타일 준수
- [ ] 5감 비율 적절
대화:
- [ ] 대화 길이/비율 적절
- [ ] 호칭 일관
구조:
- [ ] 단락 구조 일관
- [ ] 리듬감 적절
시제/관점:
- [ ] 시제 일관
- [ ] POV 일탈 없음
핵심 원칙:
- [ ] Top 5 원칙 모두 준수
```
---
@@ -383,7 +516,121 @@ characters-master.md의 호칭 규칙 참조
---
## 🚫 작성 중 흔한 실수 (신규)
## 🚫 미완성 방지 규칙 (v2.4.0 신규)
### 1. 헤더 작성 시 주의
**규칙:** 헤더를 만들면 즉시 최소 3줄 내용 작성!
```markdown
❌ 나쁜 예:
## 오후 3시, 회의실
---
[여기서 멈춤 - 내용 0줄!]
✅ 좋은 예:
## 오후 3시, 회의실
민준이 회의실 문을 열었다. 안에는 이미 여러 사람이 앉아 있었다.
"늦어서 죄송합니다." 그가 말했다.
(최소 3줄 내용 즉시 작성!)
```
**왜 중요한가?**
- 헤더만 만들고 멈추면 "빈 섹션"
- ch-046 실패 사례: "## 9월 30일 저녁" 헤더만 있고 내용 0줄
- validation v2.0도 못 잡음 → v3.0에서야 발견
### 2. 대화 완결 규칙
**규칙:** 대화를 시작하면 최소 3왕복 완결!
```markdown
❌ 나쁜 예:
"형님, 뭐 하세요?"
"응?"
[여기서 멈춤 - 질문만 하고 답 없음!]
✅ 좋은 예:
"형님, 뭐 하세요?"
"응? 아, 보고서 쓰고 있어."
"도와드릴까요?"
"아니야, 거의 다 됐어."
(질문-답변-반응 최소 3왕복!)
```
**왜 중요한가?**
- 대화 중간에 멈추면 독자 혼란
- ch-032 실패 사례: "근데 형님." "응?" [파일 끝]
- 질문만 하고 대답 없으면 미완성
### 3. 장면 마무리 규칙
**규칙:** 장면을 시작하면 전개-절정-마무리 완성!
```markdown
❌ 나쁜 예:
민준이 문을 열고 들어갔다.
[여기서 멈춤 - 무슨 일이 일어났는지 모름!]
✅ 좋은 예:
민준이 문을 열고 들어갔다. (시작)
안에는 여운형이 서류를 보고 있었다. (전개)
"기다리고 있었네." 여운형이 말했다. (전개)
민준은 고개를 끄덕이고 자리에 앉았다. (마무리)
(시작-전개-마무리 완성!)
```
**왜 중요한가?**
- 장면 시작만 하고 끝내지 않으면 미완성
- ch-034 실패 사례: "따라오세요." [파일 끝]
- 독자가 "그래서 어떻게 됐는데?"라고 궁금해함
### 4. Part 완성 체크
**규칙:** Part를 끝내기 전 자가 질문 3개!
```markdown
Part 작성 완료 전 체크:
- [ ] 이 Part에서 의도한 내용을 다 썼는가?
- [ ] 대화가 중간에 끊기지 않았는가?
- [ ] 장면이 자연스럽게 마무리됐는가?
→ 하나라도 "아니오"면 계속 작성!
→ 모두 "예"면 Part 완료!
```
**왜 중요한가?**
- Part 중간에 멈추면 다음 작성 시 맥락 끊김
- 작성 중 자가 검증으로 즉시 발견 가능
- 미완성 챕터 7건 모두 이 체크로 방지 가능
### 5. 최소 내용 분량
**규칙:** 각 섹션 최소 분량 준수!
```markdown
✅ 헤더 이후: 최소 3줄 (약 150자)
✅ 대화 블록: 최소 3왕복 (약 200자)
✅ 장면 묘사: 최소 5줄 (약 250자)
✅ 각 Part: 최소 30줄 (약 1,500자)
✅ 각 화: 최소 8,000자
→ 분량이 너무 짧으면 미완성 의심!
```
**왜 중요한가?**
- 분량이 기준보다 현저히 적으면 뭔가 빠짐
- 간이 검증에서 자동으로 체크
- 작성 중에도 육감으로 알 수 있음
---
## 🚫 작성 중 흔한 실수
### 1. 캐릭터 OOC (Out Of Character)

View File

@@ -1,10 +1,10 @@
# 작성 모드 프로토콜
> **버전:** 2.2.0
> **최종 수정:** 2026-01-20
> **버전:** 2.3.0
> **최종 수정:** 2026-01-21
> **호환:** CWS Writing Guide v4.2.0+
> **용도:** 신규 챕터 작성 (3/5/7화 유연)
> **주요 변경:** 각 Part 작성 후 즉시 자가 검증 추가 (문제 조기 발견)
> **주요 변경:** 완성도 체크 강화 (미완성 챕터 재발 방지)
---
@@ -76,7 +76,7 @@
- 분량: 8,000-12,000자
- file-formats.md 형식 준수
⚠️ **각 Part 작성 후 즉시 자가 검증! (신규)**
⚠️ **각 Part 작성 후 즉시 자가 검증!**
```
Part 1 작성 완료 → 즉시 체크:
@@ -95,8 +95,14 @@
- [ ] 무기/아이템 연속성 유지되는가?
- [ ] 날씨/계절이 날짜와 맞는가?
→ 문제 발견 시: 즉시 수정 후 다음 Part
→ 통과 시: Part 2 작성
🔴 **v2.3.0 신규: 완성도 체크**
- [ ] Part가 완전히 끝났는가? (중간에 안 끊김)
- [ ] 대화가 중간에 끊기지 않았는가? (질문만 하고 답 없음 X)
- [ ] 장면이 마무리됐는가? (시작만 하고 안 끝남 X)
- [ ] 헤더 만들었으면 내용도 3줄 이상 작성했는가?
→ 하나라도 "아니오"면: 즉시 완성 후 다음 Part!
→ 모두 "예"면: Part 2 작성
(Part 2, 3, 4도 동일하게 각각 작성 후 체크!)
```
@@ -139,7 +145,7 @@
- 캐릭터 상태
- 복선 추적
3. 🔍 즉시 간이 검증 (1-2분)
3. 🔍 즉시 간이 검증 (2-3분)
✅ 타임라인 연속성
- 이전 화 종료일 ≤ 현재 화 시작일
@@ -149,7 +155,7 @@
- characters.md 호칭 규칙 기준
- 갑작스러운 호칭 변화 없는지
✅ 호칭 복수/단수 정확성 (신규!)
✅ 호칭 복수/단수 정확성
- characters.md 나이 관계 테이블 기준
- "형님들" vs "형님" 체크
- 예: 박현우 → 강민준(1명) = "형님" (단수)
@@ -166,6 +172,17 @@
- 파일명 번호 = 헤더 화수
- 타임라인 형식 (YYYY.M.D-M.D)
🔴 **v2.3.0 신규: 완성도 검증**
- [ ] 빈 섹션 0건
- Grep: "^## " 검색 → 각 헤더 이후 10줄 체크
- 실제 내용 (빈 줄/구분선 제외) 3줄 미만 = ❌
- [ ] 대화 완결성
- 마지막 대화가 질문으로 끝나지 않는지
- "?" 또는 불완전한 대화 패턴 체크
- [ ] 최소 분량
- 각 챕터 8,000자 이상
- 마지막 Part가 너무 짧지 않은지 (300자 이상)
→ 문제 발견 시: 즉시 수정 후 다시 검증
→ 통과 시: 다음 단계
@@ -208,8 +225,16 @@
- [ ] 분량 8,000자 이상
- [ ] Show, Don't Tell
- [ ] 캐릭터 말투/호칭 일관성
- [ ] ⭐ 각 Part 작성 후 즉시 자가 검증! (신규)
- [ ] ⭐ 각 Part 작성 후 즉시 자가 검증!
- 플롯 준수, 캐릭터 일관성, 설정 일관성
- 🔴 v2.3.0: 완성도 체크 (Part 완료, 대화 완결, 장면 마무리)
🔴 **v2.3.0 신규: 작성 완료 전 최종 체크**
- [ ] 모든 섹션 헤더 이후 내용 3줄 이상 존재
- [ ] 마지막 대화가 완결됨 (질문으로 안 끝남)
- [ ] 마지막 장면이 마무리됨 (중간에 안 끊김)
- [ ] 최소 분량 8,000자 이상
- [ ] 각 Part가 완전히 끝남
작성 후:
- [ ] 바텀 없음 확인!