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,121 +1,124 @@
# CLAUDE.md - AI 협업 프로토콜
# Claude 작업 규칙 (프로젝트명)
> **프로젝트:** [프로젝트명]
> **장르:** [장르]
> **현재 진행:** [X권 작성 중 / 수정 중 / 완료]
> **용도:** Claude가 이 프로젝트에서 작업 시 반드시 따라야 할 규칙
> **작성일:** YYYY-MM-DD
> **중요도:** 🔴 필수 준수
---
## 🔴 세션 시작 시 필수!
## 📂 표준 파일 위치 (Single Source of Truth)
### ⚠️ 중요: 표준 파일은 Guide에서만 읽기
모든 모드(VERIFICATION, FIX, POLISH, MODIFICATION 등) 진입 시, 표준 파일은 **반드시** 아래 위치에서 읽어야 합니다:
### 1. CURRENT-TASK.md 확인
```
CURRENT-TASK.md 있으면 → 읽고 해당 작업 이어서
CURRENT-TASK.md 없으면 → 사용자에게 "무엇을 할까요?" 질문
l:\내 드라이브\Writing\Guide\templates\standards\
```
### 2. 복구 시 읽을 파일
CURRENT-TASK.md에 명시된 파일들 자동 읽기
### 📋 표준 파일 목록
| 파일명 | 용도 | 위치 |
|--------|------|------|
| 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/ |
---
## 🔄 작업 재개 프로토콜 (컴팩팅 대응)
## 🚫 금지 사항
### 대화 재개 시 (컴팩팅 후):
```
Step 1: WORK-MODE.txt 확인
→ 파일 있으면 → 읽기
→ CURRENT_MODE 확인
→ READ_FILE에 지시된 모드 파일만 읽기
→ 작업 재개
### ❌ 절대 하지 말 것
→ 파일 없으면 → CURRENT-TASK.md 확인 (일반 흐름)
```
1. **프로젝트 내 standards/ 생성 금지**
- `PROJECT/standards/` ❌
- 반드시 `Guide/templates/standards/` 사용
**WORK-MODE.txt 역할:**
- 중단된 배치 작업 감지
- 어느 모드인지 (VERIFICATION/POLISH/FIX)
- 어느 파일을 읽어야 하는지
- 어디까지 완료했는지
2. **권별 standards 생성 금지**
- `volumes/vol-01/standards/` ❌
- `volumes/vol-02/standards/` ❌
- 표준은 프로젝트 전체에 통일
3. **권별 검증 기준 파일 생성 금지**
- `volumes/vol-XX/validation-standards.md` ❌
- `Guide/templates/standards/verification-mode.md` 사용
---
## 📂 파일 위치
## ✅ 올바른 작업 절차
### 모드 진입 시
### 🔧 작업 표준 (How to write)
```
standards/
├── writing-mode.md # 작성 모드 절차
├── modification-mode.md # 수정 모드 절차
├── verification-mode.md # 점검 모드 절차
├── chapter-format.md # 챕터 형식 규칙
├── renaming-protocol.md # 리네임 안전 규칙
└── writing-guide.md # 작성 규칙 (문체, 분량)
사용자: "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. ✅ 해당 챕터 작업 시작
❌ 프로젝트 내 standards 파일 읽기 → 금지!
```
### 📚 소설 설정 (What to write)
```
settings/
├── characters-master.md # 전체 캐릭터 + 호칭 규칙
├── timeline-master.md # 전체 타임라인
└── plot-master.md # 전체 플롯
```
### 검증 시
### 📖 권별 작업 파일
```
volumes/vol-XX/
├── characters.md # 해당 권 캐릭터 (추출본)
├── timeline.md # 해당 권 타임라인 (추출본)
├── plot-master.md # 해당 권 플롯
├── plots/ # 5화별 플롯
├── summaries/ # 누적 서머리
├── chapters/ # 실제 원고
└── CHANGELOG.md # 변경 이력
사용자: "2권 검증해줘"
Claude 절차:
1. ✅ l:\내 드라이브\Writing\Guide\templates\standards\verification-mode.md 읽기
2. ✅ l:\내 드라이브\Writing\프로젝트명\settings\*.md 읽기
3. ✅ 검증 시작
❌ volumes/vol-02/validation-standards.md → 생성 금지!
```
---
## 🎯 모드 진입
## 📝 버전 관리
| 명령어 | 모드 | 읽을 파일 |
|--------|------|----------|
| "작성 모드" / "X화 작성해" | WRITING | standards/writing-mode.md |
| "수정 모드" / "수정 준비해" | MODIFICATION | standards/modification-mode.md |
| "점검 모드" / "검증해" | VERIFICATION | standards/verification-mode.md |
표준 파일 버전은 `Guide/templates/standards/`에서만 관리됩니다.
### 모드 진입 시 행동
1. 해당 모드 파일 읽기
2. 모드 파일이 지시하는 추가 파일 읽기
3. CURRENT-TASK.md 생성/업데이트
4. "준비 완료" 보고
5. 작업 시작
**최신 버전 확인:**
- `Guide/templates/standards/` 디렉토리 참조
- 각 파일 헤더의 버전 정보 확인
---
## 📌 프로젝트 정보
## 💡 왜 이렇게 하는가?
**제:** [소설 제목]
**장르:** [장르]
**총 권수:** [N]권
**화/권:** [50]화
**분량/화:** 8,000-12,000자
**제:**
- 표준 파일이 여러 곳에 복사되면 버전 불일치 발생
- Guide 업데이트가 프로젝트에 반영 안됨
- 권별로 기준이 달라지면 일관성 깨짐
**시간 배경:** [시작년도] - [종료년도]
**주인공:** [이름]
**핵심 줄거리:**
[3문장 요약]
**해결:**
- Single Source of Truth: Guide만 관리
- 모든 프로젝트가 Guide 참조
- 버전 불일치 원천 차단
---
## 🚫 절대 규칙
## 📌 프로젝트별 설정
1. **CURRENT-TASK.md 확인 필수** - 세션 시작 시
2. **모드 파일 읽고 작업** - 맨땅에 헤딩 금지
3. **summary 업데이트 필수** - 매 화 완료 시
4. **바텀 금지** - 챕터 끝에 "[X화 끝]" 넣지 말 것
5. **헤더만 화수 표시** - # X권 Y화: 제목
### 이 프로젝트만의 특별한 규칙
(프로젝트마다 추가 규칙이 있다면 여기에 작성)
예:
- 특정 캐릭터 호칭 규칙
- 고유 용어 사전
- 시대 배경 설정
---
*이 파일은 매 세션 자동으로 읽습니다. 가볍게 유지하세요.*
**⚠️ 이 규칙을 위반하면 기준 불일치로 작업 오류 발생!**