From cdbcc7db405989bdae4dd07df457edde8372d4c5 Mon Sep 17 00:00:00 2001 From: Alex Date: Sun, 25 Jan 2026 10:40:27 +0900 Subject: [PATCH] =?UTF-8?q?writing-mode.md=20v2.5.0:=20=ED=98=B8=EC=B9=AD?= =?UTF-8?q?=20=EA=B7=9C=EC=B9=99=20=ED=95=84=EC=88=98=20=EC=B2=B4=ED=81=AC?= =?UTF-8?q?=ED=8F=AC=EC=9D=B8=ED=8A=B8=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 배경: - 문제: VERIFICATION에서 호칭 오류 다수 발견 - 원인: characters.md에 호칭 규칙은 있지만, WRITING 시 확인하지 않음 - 결과: VERIFICATION 부담 증가, 수정 비효율 추가: - Phase 1: characters.md 호칭 규칙 필수 숙지 강조 - Phase 2: 호칭 규칙 확인 3단계 필수 체크포인트 - Phase 3: 간이 검증 강화 (Git 커밋 전 필수) 예상 효과: - VERIFICATION 호칭 오류 발견 90% 감소 - 문제를 작성 단계에서 원천 차단 관련 파일: - writing-mode.md: v2.4.0 → v2.5.0 - CWS Design Guide.md: Phase 11 강화 (v1.2.0) - README.md: 프로토콜 인덱스 업데이트 Co-Authored-By: Claude Sonnet 4.5 --- CWS Design Guide.md | 21 ++- templates/standards/README.md | 28 ++-- templates/standards/writing-mode.md | 198 +++++++++++++++++++++++----- 3 files changed, 201 insertions(+), 46 deletions(-) diff --git a/CWS Design Guide.md b/CWS Design Guide.md index 82b425e..908f55a 100644 --- a/CWS Design Guide.md +++ b/CWS Design Guide.md @@ -21,6 +21,10 @@ - Phase 4 완료 조건에 타임라인 검증 추가 - Phase 5-2 일관성 검증에 플롯 타임라인 검증 추가 - plot-master.md 템플릿에 타임라인 검증 필드 추가 +- 📌 Phase 11 (핸드오프): 권별 characters.md 호칭 규칙 필수 + - 내용 확인에 호칭 체계 검증 추가 + - 권별 characters.md 생성 시 호칭 규칙 포함 명시 + - 마스터 파일 vs 권별 파일 역할 명확화 **철학:** ``` @@ -1699,11 +1703,16 @@ authors/author-XX.md worldbuilding.md ◀────────── - [ ] 1권 5화 단위 플롯이 작성되어 있는가? - [ ] 1권 등장 캐릭터가 모두 설계되어 있는가? - [ ] 1권 타임라인이 상세히 작성되어 있는가? +- [ ] 🚨 호칭 체계가 정립되어 있는가? ⭐ v1.2 신규 ### CWS Writing Guide 연동 - [ ] CLAUDE.md 생성/업데이트 - [ ] standards/ 폴더에 방법론 파일 복사 - [ ] volumes/vol-01/ 폴더 구조 생성 +- [ ] 🚨 volumes/vol-01/characters.md 생성 (마스터에서 추출) ⭐ v1.2 신규 + - [ ] 1권 등장인물만 추출 + - [ ] 호칭 체계 포함 (필수!) + - [ ] 복수/단수 규칙 명시 ### 준비 완료 - [ ] 작성 모드 진입 가능! @@ -1716,15 +1725,23 @@ authors/author-XX.md worldbuilding.md ◀────────── ✅ CLAUDE.md ✅ authors/author-XX.md ⭐ v1.1 신규 (문체 준수) -✅ settings/characters-master.md (해당 권 부분) -✅ settings/timeline-master.md (해당 권 부분) +✅ volumes/vol-XX/characters.md ⭐ v1.2 수정 (권별 추출, 호칭 규칙 포함!) +✅ volumes/vol-XX/timeline.md (권별 추출) ✅ volumes/vol-XX/plots/plot-XXX-YYY.md ✅ volumes/vol-XX/summaries/summary-이전.md ✅ standards/writing-guide.md +❌ settings/characters-master.md (마스터 파일, 너무 큼, 읽지 않음) +❌ settings/timeline-master.md (마스터 파일, 너무 큼, 읽지 않음) ❌ project-config.md (이미 반영됨) ❌ worldbuilding.md (characters-master에 반영) ❌ design-verification.md (검증용) + +📌 중요: +- 마스터 파일은 설계용 (10권 전체, 무거움) +- 권별 파일은 작성용 (해당 권만, 가벼움) +- 권별 파일은 마스터 파일에서 추출하여 생성 +- 🚨 characters.md에 호칭 규칙 반드시 포함! ``` ### 11.4 핸드오프 후 설계 수정 diff --git a/templates/standards/README.md b/templates/standards/README.md index d102e8f..b90043d 100644 --- a/templates/standards/README.md +++ b/templates/standards/README.md @@ -180,26 +180,32 @@ ### 9. WRITING 모드 ✍️ **파일:** `writing-mode.md` -**버전:** v2.4.0 +**버전:** v2.5.0 **최종 수정:** 2026-01-25 -**용도:** 새로운 챕터 작성 가이드 (타임라인 역행 예방) +**용도:** 새로운 챕터 작성 가이드 (타임라인 + 호칭 규칙 필수) **주요 기능:** - 작성 프로세스 (3/5/7화 유연) - 플롯 반영 -- 캐릭터 일관성 -- 타임라인 역행 방지 필수 체크포인트 ⭐ NEW (v2.4.0) -- 작성 전 이전 화 종료일 vs 현재 화 시작일 강제 비교 +- 호칭 규칙 필수 체크포인트 ⭐ NEW (v2.5.0) +- 타임라인 역행 방지 필수 체크포인트 (v2.4.0) +- 간이 검증 강화 (Git 커밋 전 필수) **워크플로우:** ``` -플롯 확인 → 타임라인 체크 → 작성 → 간이 검증 → 커밋 +플롯 + 호칭 규칙 확인 → 타임라인 체크 → 작성 → 간이 검증 (필수!) → 커밋 ``` -**최근 변경 (v2.4.0):** -- 📌 타임라인 역행 방지 4단계 필수 체크포인트 추가 -- 역행 감지 시 즉시 중단 및 사용자 보고 -- 철학 전환: WRITING = 예방, VERIFICATION = 최후의 보루 +**최근 변경 (v2.5.0):** +- 📌 호칭 규칙 확인 3단계 필수 체크포인트 추가 + - 이번 화 등장인물 확인 + - characters.md 호칭 테이블 확인 + - 복수/단수 규칙 확인 +- 📌 간이 검증 강화 (Git 커밋 전 필수) + - 호칭 복수/단수 자동 체크 + - 시기별 호칭 정확성 체크 + - 형식 자동 체크 +- 철학: WRITING = 호칭 오류 원천 차단 --- @@ -303,7 +309,7 @@ | 프로토콜 | 버전 | 주요 변경 | |----------|------|-----------| | PLOT | v1.0.0 | 플롯 타임라인 검증 (설계 단계 품질 보증) | -| WRITING | v2.4.0 | 타임라인 역행 방지 필수 체크포인트 | +| WRITING | v2.5.0 | 호칭 규칙 + 타임라인 필수 체크포인트, 간이 검증 강화 | | VERIFICATION | v2.9.0 | 리포트 유효성 검증 | | FIX | v2.0.0 | 재배치 프로토콜, 롤백 메커니즘 | | POLISH | v2.4.0 | 리포트 유효성 검증 | diff --git a/templates/standards/writing-mode.md b/templates/standards/writing-mode.md index f7765ec..fce8593 100644 --- a/templates/standards/writing-mode.md +++ b/templates/standards/writing-mode.md @@ -1,15 +1,45 @@ # 작성 모드 프로토콜 -> **버전:** 2.4.0 +> **버전:** 2.5.0 > **최종 수정:** 2026-01-25 > **호환:** CWS Writing Guide v4.2.0+ > **용도:** 신규 챕터 작성 (3/5/7화 유연) -> **주요 변경:** 타임라인 역행 방지 강화 - 작성 전 필수 체크포인트 추가 +> **주요 변경:** 호칭 규칙 필수 체크포인트 추가 - 작성 전/후 검증 강화 --- ## 📋 CHANGELOG +### v2.5.0 (2026-01-25) + +**배경:** +- 문제: VERIFICATION에서 호칭 오류 다수 발견 +- 원인: characters.md에 호칭 규칙은 있지만, WRITING 시 확인하지 않음 +- 결과: VERIFICATION 부담 증가, 수정 비효율 + +**추가:** +- 📌 Phase 1: characters.md 호칭 규칙 필수 숙지 강조 +- 📌 Phase 2: 호칭 규칙 확인 3단계 필수 체크포인트 + - Step 1: 이번 화 등장인물 확인 + - Step 2: characters.md 호칭 테이블 확인 + - Step 3: 복수/단수 규칙 확인 +- 📌 Phase 3: 간이 검증 강화 + - 호칭 복수/단수 자동 체크 (bash 명령) + - 시기별 호칭 정확성 체크 + - 검증 통과 필수 (Git 커밋 전) + +**철학:** +``` +WRITING 모드 = 호칭 오류 원천 차단 +VERIFICATION 모드 = 최후 확인만 + +→ 작성 단계에서 호칭 규칙 준수! +``` + +**예상 효과:** +- VERIFICATION 호칭 오류 발견 90% 감소 +- 작성 시간 소폭 증가하지만 전체 효율 향상 + ### v2.4.0 (2026-01-25) **배경:** @@ -82,9 +112,14 @@ VERIFICATION 모드 = 최후의 보루 (검증) 1. 진행 상황 파악 - 마지막 작성 챕터 확인 - 다음 5화 범위 계산 - + 2. 필수 파일 읽기 (위 목록) + 🚨 특히 중요: + - characters.md → 호칭 규칙 필수 숙지! ⭐ + - timeline.md → 타임라인 흐름 파악 + - plot-XXX-YYY.md → 이번 화 플롯 + 3. CURRENT-TASK.md 생성 - 모드: WRITING - 작업: X권 N-M화 작성 @@ -100,7 +135,55 @@ VERIFICATION 모드 = 최후의 보루 (검증) - 날짜, 장소, 등장인물 - 핵심 내용, 주요 장면 -2. 🚨 타임라인 역행 방지 (v2.4.0 필수 체크포인트!) +2. 🚨 호칭 규칙 확인 (v2.5.0 필수 체크포인트!) ⭐ 신규 + + ❌ **이 절차를 건너뛰면 호칭 오류가 발생합니다!** + ✅ **반드시 아래 3단계를 순서대로 확인하세요:** + + --- + + **Step 1: 이번 화 등장인물 확인** + ```bash + # 플롯에서 등장인물 추출 + grep "등장인물" plot-XXX.md + + # 예시 출력: 강민준, 서윤희, 박현우 + ``` + + **Step 2: characters.md 호칭 테이블 확인** + ```bash + # 호칭 규칙 섹션 읽기 + grep -A 30 "## 📋 호칭 규칙" characters.md + ``` + + **호칭 테이블 숙지:** + ``` + 예시 (1권 1946.5월 이후): + + | 화자 | 청자 | 호칭 | 비고 | + |------|------|------|------| + | 강민준 | 서윤희 | 윤희 씨 | ch-031 이후 | + | 서윤희 | 강민준 | 민준 씨 | ch-031 이후 | + | 박현우 | 강민준 | 민준 형 | 현대 감각 | + | 최태준 | 강민준 | 형님 | 1명 단수 | + | 최태준 | 강민준+박현우 | 형님들 | 2명 복수 | + ``` + + **Step 3: 복수/단수 규칙 확인** + ``` + 복수형 사용 조건: + - 대상이 2명 이상일 때만 "~들" 사용 + - 예: "형님들" (강민준 + 박현우 = 2명) + - 예: "형님" (강민준만 = 1명) + + 단수형 사용: + - 대상이 1명일 때 + - 예: "형님", "선생님", "씨" + ``` + + --- + +3. 🚨 타임라인 역행 방지 (v2.4.0 필수 체크포인트!) ❌ **이 절차를 건너뛰면 타임라인 역행이 발생합니다!** ✅ **반드시 아래 4단계를 순서대로 확인하세요:** @@ -255,7 +338,12 @@ VERIFICATION 모드 = 최후의 보루 (검증) 7. 다음 화로 이동 ``` -### Phase 3: 작성 완료 + 간이 검증 +### Phase 3: 작성 완료 + 간이 검증 (필수!) + +``` +⚠️ Git 커밋 전 필수 단계! +⚠️ 이 검증을 통과하지 못하면 커밋 금지! +``` ``` 1. N개 챕터 파일 확인 @@ -266,46 +354,90 @@ VERIFICATION 모드 = 최후의 보루 (검증) - 캐릭터 상태 - 복선 추적 -3. 🔍 즉시 간이 검증 (2-3분) +3. 🔍 즉시 간이 검증 실행 (필수!) + + **3-1. 자동 검증 (Bash 명령)** ✅ 타임라인 연속성 - - 이전 화 종료일 ≤ 현재 화 시작일 - - 역행 체크 + ```bash + # 이전 화 종료일 확인 + sed -n '3p' ch-027.md | grep -oP '\d{4}\.\d+\.\d+' | tail -1 - ✅ 호칭 일관성 - - characters.md 호칭 규칙 기준 - - 갑작스러운 호칭 변화 없는지 + # 현재 화 시작일 확인 + sed -n '3p' ch-028.md | grep -oP '\d{4}\.\d+\.\d+' | head -1 - ✅ 호칭 복수/단수 정확성 - - characters.md 나이 관계 테이블 기준 - - "형님들" vs "형님" 체크 - - 예: 박현우 → 강민준(1명) = "형님" (단수) - - 예: 최태준 → 강민준+박현우(2명) = "형님들" (복수) - - 검색 패턴: "형님들", "형들", "선배님들" 등 - - 발견 시 화자가 누구인지 확인 → 대상 수 체크 + # 비교: 종료일 ≤ 시작일 확인 + ``` + + ✅ 호칭 일관성 ⭐ 강화! (v2.5.0) + ```bash + # 복수형 검색 + grep -n "형님들\|형들\|선배님들\|씨들" ch-XXX.md + + # 각 발견 건마다: + # 1. 화자 확인 (누가 말했는가?) + # 2. 청자 확인 (누구에게?) + # 3. 청자 수 확인 (1명? 2명 이상?) + # 4. 복수/단수 일치 확인 + + 예시: + - "형님들" 발견 → 화자: 최태준 → 청자: 강민준+박현우(2명) ✅ + - "형님" 발견 → 화자: 최태준 → 청자: 강민준(1명) ✅ + - "형님들" 발견 → 화자: 최태준 → 청자: 강민준(1명) ❌ 오류! + ``` + + ✅ 시기별 호칭 정확성 (v2.5.0 신규) + ```bash + # 강민준-서윤희 호칭 체크 (예시) + grep -n "윤희 씨\|민준 씨" ch-XXX.md + + # 확인 사항: + # - ch-031 (1946.5월) 이전인가? → "윤희 씨" 사용 금지! + # - ch-031 이후인가? → "윤희 씨" 사용 가능 + + # characters.md 호칭 변화 시점 참조 + ``` ✅ 바텀 존재 여부 - - [X화 끝] 패턴 검색 - - "다음 X화:" 패턴 검색 + ```bash + grep -n "\[.*화 끝\]\|다음.*화:" ch-XXX.md + + # 발견 시 → 즉시 삭제 + ``` ✅ 헤더 형식 - - # X권 Y화: 제목 형식 - - 파일명 번호 = 헤더 화수 - - 타임라인 형식 (YYYY.M.D-M.D) + ```bash + # 첫 줄 체크 + head -1 ch-028.md + # 기대값: # 1권 28화: 제목 + # 파일명 028 = 헤더 28화 일치 확인 + ``` - 🔴 **v2.3.0 신규: 완성도 검증** + ✅ 타임라인 형식 + ```bash + # 3번째 줄 체크 + sed -n '3p' ch-028.md + # 기대값: > **타임라인:** YYYY.M.D-M.D + # 형식 검증 + ``` + + 🔴 **v2.3.0: 완성도 검증** - [ ] 빈 섹션 0건 - - Grep: "^## " 검색 → 각 헤더 이후 10줄 체크 - - 실제 내용 (빈 줄/구분선 제외) 3줄 미만 = ❌ - [ ] 대화 완결성 - - 마지막 대화가 질문으로 끝나지 않는지 - - "?" 또는 불완전한 대화 패턴 체크 - - [ ] 최소 분량 - - 각 챕터 8,000자 이상 - - 마지막 Part가 너무 짧지 않은지 (300자 이상) + - [ ] 최소 분량 8,000자 - → 문제 발견 시: 즉시 수정 후 다시 검증 - → 통과 시: 다음 단계 + --- + + **3-2. 검증 결과 판정** + ``` + ✅ 문제 0건 → 4단계로 진행 + ❌ 문제 발견 → 즉시 수정 → 3-1 재실행 + + ⚠️ 문제가 있는데 커밋하지 마세요! + ⚠️ 반드시 검증 통과 후 커밋! + ``` + + --- 4. foreshadows.md 업데이트 - 설치된 복선 추가