b9351db95e
컴팩트 복구 절차 개선: - 리커버리 코드 섹션 제거 (테스트용이었음) - 컴팩트 복구 절차 간소화 - 모드 진입 자동 준비 프로토콜 추가 - 표준 파일 위치 및 버전 정보 추가 - PLOT/WRITING/VERIFICATION 모드 예시 추가 - 프로젝트 특화 내용은 플레이스홀더로 변경 새 프로젝트 세팅 시 이 템플릿 사용 가능 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
436 lines
13 KiB
Plaintext
436 lines
13 KiB
Plaintext
# 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 업데이트 없이 진행
|
|
```
|
|
|
|
---
|
|
|
|
## 📂 표준 파일 위치 (Single Source of Truth)
|
|
|
|
### ⚠️ 중요: 표준 파일은 Guide에서만 읽기
|
|
|
|
모든 모드(VERIFICATION, FIX, POLISH, MODIFICATION 등) 진입 시, 표준 파일은 **반드시** 아래 위치에서 읽어야 합니다:
|
|
|
|
```
|
|
l:\내 드라이브\Writing\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화 타임라인 검증 (필수!)
|
|
|
|
**이 절차를 생략하면:**
|
|
- 타임라인 불일치
|
|
- 캐릭터 오류 (존재하지 않는 인물 등장)
|
|
- 주요 사건 누락
|
|
- 전체 파일 삭제 후 재작성
|
|
|
|
---
|
|
|
|
## 🚫 금지 사항
|
|
|
|
### ❌ 절대 하지 말 것
|
|
|
|
1. **프로젝트 내 standards/ 파일 읽기 금지**
|
|
- [프로젝트명]/standards/ ❌ (구버전이거나 삭제 예정)
|
|
- 반드시 Guide/templates/standards/ 사용
|
|
|
|
2. **권별 standards 생성 금지**
|
|
- volumes/vol-01/standards/ ❌
|
|
- volumes/vol-02/standards/ ❌
|
|
- 표준은 프로젝트 전체에 통일
|
|
|
|
3. **권별 검증 기준 파일 생성 금지**
|
|
- volumes/vol-XX/validation-standards.md ❌
|
|
- Guide/templates/standards/verification-mode.md 사용
|
|
|
|
---
|
|
|
|
## ✅ 올바른 작업 절차
|
|
|
|
**⚠️ 모든 절차는 위 "모드 진입 자동 준비 프로토콜"을 따릅니다!**
|
|
|
|
### POLISH 모드 예시
|
|
|
|
```
|
|
사용자: "POLISH 모드로 ch-001~010 다듬어줘"
|
|
|
|
Claude 자동 준비:
|
|
1. ✅ POLISH 모드 인식
|
|
2. ✅ polish-mode.md 읽기
|
|
3. ✅ writing-guide.md 읽기
|
|
4. ✅ characters-master.md 읽기
|
|
5. ✅ WORK-MODE.txt 업데이트
|
|
6. 🛑 준비 완료 보고:
|
|
"준비 완료했습니다.
|
|
|
|
모드: 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 모드 예시 🔴 중요!
|
|
|
|
```
|
|
사용자: "X권 1-5화 플롯 작성해"
|
|
|
|
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. 🛑 준비 완료 보고:
|
|
"준비 완료했습니다.
|
|
|
|
모드: 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. ✅ 검증 보고서 생성
|
|
```
|
|
|
|
**통합 검증이란?**
|
|
- 배치 검증 완료 후 **전체 구조** 확인
|
|
- 배치는 "나무", 통합은 "숲" 보기
|
|
- 예: 중간 회고 챕터 ≠ 권 마지막 확인
|
|
|
|
---
|
|
|
|
## 📝 버전 관리
|
|
|
|
표준 파일 버전은 `Guide/templates/standards/`에서만 관리됩니다.
|
|
|
|
**최신 버전 확인:**
|
|
- `Guide/templates/standards/` 디렉토리 참조
|
|
- 각 파일 헤더의 버전 정보 확인
|
|
|
|
---
|
|
|
|
## 💡 왜 이렇게 하는가?
|
|
|
|
**문제:**
|
|
- 표준 파일이 여러 곳에 복사되면 버전 불일치 발생
|
|
- Guide 업데이트가 프로젝트에 반영 안됨
|
|
- 권별로 기준이 달라지면 일관성 깨짐
|
|
|
|
**해결:**
|
|
- Single Source of Truth: Guide만 관리
|
|
- 모든 프로젝트가 Guide 참조
|
|
- 버전 불일치 원천 차단
|
|
|
|
---
|
|
|
|
## 📌 프로젝트별 설정
|
|
|
|
### 이 프로젝트만의 특별한 규칙
|
|
|
|
**[프로젝트명] 프로젝트:**
|
|
- 시대 배경: [예: 1945년 한반도 / 현대 한국 / 판타지 세계]
|
|
- 특별 규칙: [예: 역사 고증 필수 / 마법 체계 준수 등]
|
|
- 캐릭터 호칭: `settings/characters-master.md` 참조
|
|
- 타임라인 엄수: `settings/timeline-master.md` 참조
|
|
|
|
### 프로젝트 구조 정보 (예시)
|
|
|
|
**권별 구조:**
|
|
- 총 X권
|
|
- 각 권: Y화 구성
|
|
- 분할 챕터: (있다면 명시)
|
|
- 타임라인: YYYY.M.D ~ YYYY.M.D (YY년)
|
|
|
|
**주의사항:**
|
|
- [프로젝트 특화 주의사항]
|
|
- [예: 중간 회고 챕터 위치, 특수 구조 등]
|
|
|
|
---
|
|
|
|
**⚠️ 이 규칙을 위반하면 기준 불일치로 작업 오류 발생!**
|