From b9351db95e607bb305df114d44327777c06b5587 Mon Sep 17 00:00:00 2001 From: Alex Date: Mon, 26 Jan 2026 00:41:10 +0900 Subject: [PATCH] CLAUDE.md.template: Update to v2.2 - Remove recovery code MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 컴팩트 복구 절차 개선: - 리커버리 코드 섹션 제거 (테스트용이었음) - 컴팩트 복구 절차 간소화 - 모드 진입 자동 준비 프로토콜 추가 - 표준 파일 위치 및 버전 정보 추가 - PLOT/WRITING/VERIFICATION 모드 예시 추가 - 프로젝트 특화 내용은 플레이스홀더로 변경 새 프로젝트 세팅 시 이 템플릿 사용 가능 Co-Authored-By: Claude Sonnet 4.5 --- templates/CLAUDE.md.template | 391 +++++++++++++++++++++++++++++++---- 1 file changed, 351 insertions(+), 40 deletions(-) diff --git a/templates/CLAUDE.md.template b/templates/CLAUDE.md.template index 4cea664..d917d30 100644 --- a/templates/CLAUDE.md.template +++ b/templates/CLAUDE.md.template @@ -1,8 +1,191 @@ -# Claude 작업 규칙 (프로젝트명) +# Claude 작업 규칙 ([프로젝트명]) > **용도:** Claude가 이 프로젝트에서 작업 시 반드시 따라야 할 규칙 > **작성일:** YYYY-MM-DD +> **최종 수정:** YYYY-MM-DD +> **버전:** 2.2 > **중요도:** 🔴 필수 준수 +> **주요 변경:** 리커버리 코드 제거, 컴팩트 복구 절차 간소화 + +--- + +## 🔄 컴팩트 후 자동 복구 절차 (v2.2 - 필수!) + +### ⚠️ claude.md를 읽었다면 반드시 다음을 실행하세요! + +**컴팩트 후 또는 세션 시작 시:** + +``` +Step 1: ✅ claude.md 읽기 (WORK-MODE.txt에서 자동 지시) + +Step 2: 🔴 WORK-MODE.txt 읽기 (자동!) + l:\내 드라이브\Writing\[프로젝트명]\WORK-MODE.txt + (또는 volumes/vol-XX/WORK-MODE.txt) + + → CURRENT_MODE 확인 (PLOT / WRITING / VERIFICATION / FIX / POLISH) + → READ_FILE 확인 (읽어야 할 프로토콜 파일) + → 현재 작업 상태 파악 + +Step 3: 🔴 현재 모드 프로토콜 읽기 (자동!) + WORK-MODE.txt의 READ_FILE 또는: + - PLOT → l:\내 드라이브\Writing\Guide\templates\standards\plot-mode.md + - WRITING → l:\내 드라이브\Writing\Guide\templates\standards\writing-mode.md + - VERIFICATION → l:\내 드라이브\Writing\Guide\templates\standards\verification-mode.md + - FIX → l:\내 드라이브\Writing\Guide\templates\standards\fix-mode.md + - POLISH → l:\내 드라이브\Writing\Guide\templates\standards\polish-mode.md + +Step 4: 📋 프로토콜에 명시된 필수 파일 읽기 + (각 모드별로 다름 - 프로토콜 파일 참조) + +Step 5: ✅ 복구 완료 보고 및 대기 + "컴팩트 복구 완료했습니다. + + 현재 모드: [모드명] + 작업 상태: [WORK-MODE.txt 내용] + 읽은 파일: [목록] + + 계속 진행할까요?" +``` + +### ❌ WORK-MODE.txt가 없으면? + +``` +⚠️ WORK-MODE.txt 파일이 없습니다. + +사용자에게 질문: +"작업 상태 파일이 없습니다. 어떤 작업을 진행 중이셨나요? + +1. 플롯 작성 (PLOT) +2. 챕터 작성 (WRITING) +3. 검증 (VERIFICATION) +4. 수정 (FIX) +5. 다듬기 (POLISH) +6. 새 작업 시작" + +→ 사용자 답변 후 WORK-MODE.txt 생성 +→ 해당 모드 프로토콜 읽기 +→ 준비 완료 +``` + +--- + +## 🎯 모드 진입 자동 준비 프로토콜 (v2.1 - 강제!) + +### ⚠️ 모든 작업 요청 시 필수 절차 + +**사용자가 작업 요청 시 자동 실행:** + +#### 1. 모드 식별 (키워드 매칭) + +``` +PLOT 모드: +- "플롯 작성", "X-Y화 플롯", "plot-XXX-YYY.md 작성" +- 예: "5권 1-5화 플롯 작성해" + +WRITING 모드: +- "작성", "X화 작성", "챕터 작성", "쓰기" +- 예: "1화 작성해", "ch-001 작성" + +VERIFICATION 모드: +- "검증", "확인", "체크", "점검" +- 예: "2권 검증해", "타임라인 확인해줘" + +FIX 모드: +- "수정", "고치기", "fix" +- 예: "검증 결과 수정해", "타임라인 역행 고쳐줘" + +POLISH 모드: +- "다듬기", "polish", "문장 개선" +- 예: "ch-001~010 다듬어줘" +``` + +#### 2. 자동 준비 (🛑 사용자 확인 전까지 작업 시작 금지!) + +``` +Step 1: 모드 프로토콜 읽기 + l:\내 드라이브\Writing\Guide\templates\standards\[모드]-mode.md + +Step 2: 프로토콜에 명시된 필수 파일 읽기 + 예) PLOT 모드: + - volumes/vol-XX/volume-plot.md + - volumes/vol-XX/timeline.md + - volumes/vol-XX/characters.md + 예) WRITING 모드: + - volumes/vol-XX/plots/plot-XXX-YYY.md + - volumes/vol-XX/characters.md + - volumes/vol-XX/timeline.md + +Step 3: WORK-MODE.txt 업데이트 + l:\내 드라이브\Writing\[프로젝트명]\WORK-MODE.txt + (또는 volumes/vol-XX/WORK-MODE.txt) + + --- + CURRENT_MODE: [모드] + READ_FILE: l:\내 드라이브\Writing\Guide\templates\standards\[모드]-mode.md + --- + TASK: [작업 내용] + STATUS: READY + STARTED: [현재 날짜] + --- + +Step 4: 준비 완료 보고 및 대기 + "준비 완료했습니다. + + 모드: [모드명] + 작업: [내용] + 읽은 파일: + - [모드]-mode.md vX.X.X + - volume-plot.md ([권]: [기간], [화수]) + - timeline.md + - characters.md + + 확인 사항: + - [주요 정보] + + 시작할까요?" +``` + +#### 3. 🛑 대기 (필수!) + +``` +사용자 확인 없이 절대 작업 시작 금지! + +사용자: "응" / "시작" / "yes" / "ok" +→ Claude: 작업 시작 + +사용자: 다른 질문 / 수정 요청 +→ Claude: 질문 답변 후 다시 대기 +``` + +### 📌 예외: 같은 모드 연속 작업 + +``` +상황: 이미 PLOT 모드 진행 중 + +사용자: "1-5화 플롯 작성해" +Claude: [작업 완료] + +사용자: "6-10화도" +Claude: "같은 PLOT 모드 연속 작업입니다. + 필요한 파일만 확인합니다. + + - volume-plot.md 확인 ✓ + - 이전 플롯(plot-001-005.md) 확인 ✓ + + 6-10화 플롯 작성을 시작할까요?" + +→ 전체 준비 절차 생략 가능 +``` + +### ❌ 절대 금지 + +``` +❌ 모드 프로토콜 읽지 않고 작업 시작 +❌ 필수 파일 건너뛰고 진행 +❌ 준비 완료 보고 없이 바로 작성 +❌ 사용자 확인 없이 작업 시작 +❌ WORK-MODE.txt 업데이트 없이 진행 +``` --- @@ -18,19 +201,76 @@ l:\내 드라이브\Writing\Guide\templates\standards\ ### 📋 표준 파일 목록 -| 파일명 | 용도 | 위치 | -|--------|------|------| -| verification-mode.md | 검증 모드 프로토콜 | Guide/templates/standards/ | -| fix-mode.md | 수정 모드 프로토콜 | Guide/templates/standards/ | -| polish-mode.md | 다듬기 모드 프로토콜 | Guide/templates/standards/ | -| modification-mode.md | 수정 모드 프로토콜 | Guide/templates/standards/ | -| writing-mode.md | 작성 모드 프로토콜 | Guide/templates/standards/ | -| writing-guide.md | 문체/분량 규칙 | Guide/templates/standards/ | -| file-formats.md | 파일 형식 표준 | Guide/templates/standards/ | -| chapter-format.md | 챕터 형식 | Guide/templates/standards/ | -| creative-writing.md | 창작 가이드 | Guide/templates/standards/ | -| retouch-mode.md | 재작성 모드 | Guide/templates/standards/ | -| renaming-protocol.md | 이름 변경 규칙 | Guide/templates/standards/ | +| 파일명 | 용도 | 버전 | 위치 | +|--------|------|------|------| +| **plot-mode.md** | **5화씩 상세 플롯 작성** | **v2.1.0** 🔴 | **Guide/templates/standards/** | +| verification-mode.md | 검증 모드 프로토콜 | v2.8.0 ⭐ | Guide/templates/standards/ | +| fix-mode.md | 수정 모드 프로토콜 | v1.1.0 | Guide/templates/standards/ | +| polish-mode.md | 다듬기 모드 프로토콜 | v2.3.0 | Guide/templates/standards/ | +| modification-mode.md | 수정 모드 프로토콜 | v2.1.0 | Guide/templates/standards/ | +| writing-mode.md | 작성 모드 프로토콜 | v2.4.0 | Guide/templates/standards/ | +| writing-guide.md | 문체/분량 규칙 | v2.5.0 | Guide/templates/standards/ | +| file-formats.md | 파일 형식 표준 | v1.1.0 | Guide/templates/standards/ | +| chapter-format.md | 챕터 형식 | - | Guide/templates/standards/ | +| creative-writing.md | 창작 가이드 | - | Guide/templates/standards/ | +| retouch-mode.md | 재작성 모드 | - | Guide/templates/standards/ | +| renaming-protocol.md | 이름 변경 규칙 | - | Guide/templates/standards/ | + +**최신 업데이트:** +- 🔴 v2.2 (2026-01-26): 리커버리 코드 제거, 컴팩트 복구 절차 간소화 +- 🔴 v2.1 (2026-01-26): 모드 진입 자동 준비 프로토콜 추가 (모든 작업 요청 시 자동 절차) +- 🔴 v2.1 (2026-01-26): WORK-MODE.txt 자동 읽기 규칙 추가 (컴팩트 복구) +- 🔴 v2.1 (2026-01-26): 모드별 키워드 매칭 및 대기 상태 강제 +- 🔴 v2.0 (2026-01-25): plot-mode.md v2.1.0 추가: 5화씩 상세 플롯 작성 표준 절차 +- 🔴 v2.0 (2026-01-25): 컴팩트 후 필수 읽기 규칙 추가 +- ⭐ verification-mode.md v2.8.0: 강제 워크플로우 추가 - 검증→FIX→재검증 사이클 필수화 + +--- + +## 🚨 컴팩트 후 필수 읽기 (CRITICAL!) + +### ⚠️ 세션이 컴팩트되면 절차를 잊어버립니다! + +**문제:** +- 컴팩트 후 표준 절차를 기억하지 못함 +- plot-mode.md를 모르는 상태로 플롯 작성 +- 상위 플롯(volume-plot.md)를 무시하고 임의 창작 +- 결과: 타임라인, 캐릭터, 사건 전부 불일치 + +**해결:** +- ✅ WORK-MODE.txt 자동 읽기 (시스템 지원) +- ✅ claude.md 읽기 (WORK-MODE.txt에서 지시) +- ✅ 현재 모드 프로토콜 자동 읽기 (위 "모드 진입 자동 준비 프로토콜" 참조) + +**이 섹션은 문제 설명용입니다. 실제 절차는 위 섹션들을 따르세요!** + +--- + +### 🔴 플롯 작성 시 필수 절차 (재발 방지!) + +**이 절차는 위 "모드 진입 자동 준비 프로토콜"에 통합되었습니다!** + +**사용자가 "X-Y화 플롯 작성" 요청 시:** + +``` +→ 자동으로 PLOT 모드 인식 +→ plot-mode.md 읽기 +→ volume-plot.md, timeline.md, characters.md 읽기 +→ WORK-MODE.txt 업데이트 +→ 준비 완료 보고 및 대기 +→ 사용자 확인 후 작업 시작 +``` + +**플롯 작성 중 필수 사항 (plot-mode.md 참조):** +- Phase 1: 준비 (상위 플롯 읽기, 타임라인 확인) +- Phase 2: 각 화 작성 (타임라인 검증 포함!) +- Phase 3: 5화 타임라인 검증 (필수!) + +**이 절차를 생략하면:** +- 타임라인 불일치 +- 캐릭터 오류 (존재하지 않는 인물 등장) +- 주요 사건 누락 +- 전체 파일 삭제 후 재작성 --- @@ -38,50 +278,110 @@ l:\내 드라이브\Writing\Guide\templates\standards\ ### ❌ 절대 하지 말 것 -1. **프로젝트 내 standards/ 생성 금지** - - `PROJECT/standards/` ❌ - - 반드시 `Guide/templates/standards/` 사용 +1. **프로젝트 내 standards/ 파일 읽기 금지** + - [프로젝트명]/standards/ ❌ (구버전이거나 삭제 예정) + - 반드시 Guide/templates/standards/ 사용 2. **권별 standards 생성 금지** - - `volumes/vol-01/standards/` ❌ - - `volumes/vol-02/standards/` ❌ + - volumes/vol-01/standards/ ❌ + - volumes/vol-02/standards/ ❌ - 표준은 프로젝트 전체에 통일 3. **권별 검증 기준 파일 생성 금지** - - `volumes/vol-XX/validation-standards.md` ❌ - - `Guide/templates/standards/verification-mode.md` 사용 + - volumes/vol-XX/validation-standards.md ❌ + - Guide/templates/standards/verification-mode.md 사용 --- ## ✅ 올바른 작업 절차 -### 모드 진입 시 +**⚠️ 모든 절차는 위 "모드 진입 자동 준비 프로토콜"을 따릅니다!** + +### POLISH 모드 예시 ``` 사용자: "POLISH 모드로 ch-001~010 다듬어줘" -Claude 절차: -1. ✅ l:\내 드라이브\Writing\Guide\templates\standards\polish-mode.md 읽기 -2. ✅ l:\내 드라이브\Writing\Guide\templates\standards\writing-guide.md 읽기 -3. ✅ l:\내 드라이브\Writing\프로젝트명\settings\characters-master.md 읽기 -4. ✅ 해당 챕터 작업 시작 +Claude 자동 준비: +1. ✅ POLISH 모드 인식 +2. ✅ polish-mode.md 읽기 +3. ✅ writing-guide.md 읽기 +4. ✅ characters-master.md 읽기 +5. ✅ WORK-MODE.txt 업데이트 +6. 🛑 준비 완료 보고: + "준비 완료했습니다. -❌ 프로젝트 내 standards 파일 읽기 → 금지! + 모드: POLISH + 범위: ch-001~010 + 읽은 파일: polish-mode.md v2.4.0, writing-guide.md, characters-master.md + + 다듬기를 시작할까요?" + +사용자: "응" +7. ✅ 작업 시작 + +❌ l:\내 드라이브\Writing\[프로젝트명]\standards\polish-mode.md → 금지! (구버전) +✅ l:\내 드라이브\Writing\Guide\templates\standards\polish-mode.md → 정답! ``` -### 검증 시 +### PLOT 모드 예시 🔴 중요! ``` -사용자: "2권 검증해줘" +사용자: "X권 1-5화 플롯 작성해" -Claude 절차: -1. ✅ l:\내 드라이브\Writing\Guide\templates\standards\verification-mode.md 읽기 -2. ✅ l:\내 드라이브\Writing\프로젝트명\settings\*.md 읽기 -3. ✅ 검증 시작 +Claude 자동 준비: +1. ✅ PLOT 모드 인식 +2. ✅ plot-mode.md v2.1.0 읽기 +3. ✅ volumes/vol-XX/volume-plot.md 읽기 +4. ✅ volumes/vol-XX/timeline.md 읽기 +5. ✅ volumes/vol-XX/characters.md 읽기 +6. ✅ WORK-MODE.txt 업데이트 +7. 🛑 준비 완료 보고: + "준비 완료했습니다. -❌ volumes/vol-02/validation-standards.md → 생성 금지! + 모드: PLOT + 권: X권 (YYYY-YYYY, YY화) + 작업: 1-5화 플롯 작성 + 읽은 파일: plot-mode.md v2.1.0, volume-plot.md, timeline.md, characters.md + + 확인 사항: + - 타임라인: YYYY.M.D ~ YYYY.M.D (YY년) + - 주요 캐릭터: [이름], [이름] + - 총 YY화 + + 플롯 작성을 시작할까요?" + +사용자: "응" +8. ✅ plot-mode.md Phase 1~3 실행 + - Phase 1: 준비 (타임라인, 사건, 캐릭터) + - Phase 2: 각 화 작성 (타임라인 검증!) + - Phase 3: 5화 타임라인 검증 (필수!) +9. ✅ plots/plot-001-005.md 저장 ``` +### VERIFICATION 모드 예시 + +``` +사용자: "X권 검증해줘" + +Claude 자동 준비: +1. ✅ VERIFICATION 모드 인식 +2. ✅ verification-mode.md v2.8.0 읽기 +3. ✅ settings/*.md 읽기 +4. ✅ WORK-MODE.txt 업데이트 +5. 🛑 준비 완료 보고 및 대기 + +사용자: "응" +6. ✅ 배치 1~N 검증 +7. ✅ 통합 검증 (전체 구조 확인) +8. ✅ 검증 보고서 생성 +``` + +**통합 검증이란?** +- 배치 검증 완료 후 **전체 구조** 확인 +- 배치는 "나무", 통합은 "숲" 보기 +- 예: 중간 회고 챕터 ≠ 권 마지막 확인 + --- ## 📝 버전 관리 @@ -112,12 +412,23 @@ Claude 절차: ### 이 프로젝트만의 특별한 규칙 -(프로젝트마다 추가 규칙이 있다면 여기에 작성) +**[프로젝트명] 프로젝트:** +- 시대 배경: [예: 1945년 한반도 / 현대 한국 / 판타지 세계] +- 특별 규칙: [예: 역사 고증 필수 / 마법 체계 준수 등] +- 캐릭터 호칭: `settings/characters-master.md` 참조 +- 타임라인 엄수: `settings/timeline-master.md` 참조 -예: -- 특정 캐릭터 호칭 규칙 -- 고유 용어 사전 -- 시대 배경 설정 +### 프로젝트 구조 정보 (예시) + +**권별 구조:** +- 총 X권 +- 각 권: Y화 구성 +- 분할 챕터: (있다면 명시) +- 타임라인: YYYY.M.D ~ YYYY.M.D (YY년) + +**주의사항:** +- [프로젝트 특화 주의사항] +- [예: 중간 회고 챕터 위치, 특수 구조 등] ---