# CWS v2.0 - 파일 구조 및 명명 규칙

> 프로젝트 내 모든 파일의 고유성 보장

**버전:** 2.0.0
**최종 수정:** 2026-02-01

---

## 📁 프로젝트 디렉토리 구조

```
프로젝트-루트/
├── settings/                    # 전체 프로젝트 설정
│   ├── project-config.md
│   ├── worldview.md
│   ├── characters-master.md
│   ├── timeline-master.md
│   ├── plot-master.md
│   └── reports/                 # 전체 프로젝트 검증 보고서
│       └── p1-4v-plot-master-YYYYMMDD-HHMM.md
│
├── authors/                     # 작가 문체
│   ├── author-01.md
│   └── author-02.md
│
├── volumes/
│   ├── vol-01/
│   │   ├── vol-01-timeline.md        # 권별 타임라인
│   │   ├── vol-01-characters.md      # 권별 캐릭터
│   │   ├── vol-01-plot.md            # 권별 플롯
│   │   │
│   │   ├── plots/                    # 5화별 상세 플롯
│   │   │   ├── vol-01-plot-001-005.md
│   │   │   ├── vol-01-plot-006-010.md
│   │   │   └── ...
│   │   │
│   │   ├── chapters/                 # 챕터
│   │   │   ├── vol-01-ch-001.md
│   │   │   ├── vol-01-ch-002.md
│   │   │   ├── vol-01-ch-010A.md     # 분할 챕터
│   │   │   ├── vol-01-ch-010B.md
│   │   │   └── ...
│   │   │
│   │   ├── summaries/                # 서머리
│   │   │   ├── vol-01-summary-001-005.md
│   │   │   ├── vol-01-summary-001-010.md
│   │   │   ├── vol-01-summary-001-050.md
│   │   │   └── vol-01-summary-final.md
│   │   │
│   │   ├── reports/                  # 권별 리포트
│   │   │   ├── design/               # 설계 검증
│   │   │   │   ├── vol-01-p1-9-quality-YYYYMMDD-HHMM.md
│   │   │   │   └── vol-01-p1-10-consistency-YYYYMMDD-HHMM.md
│   │   │   │
│   │   │   ├── writing/              # 작성 관련
│   │   │   │   ├── vol-01-p2-2-ch001-selfcheck-YYYYMMDD-HHMM.md
│   │   │   │   ├── vol-01-p2-2-ch002-selfcheck-YYYYMMDD-HHMM.md
│   │   │   │   └── ...
│   │   │   │
│   │   │   ├── verification/         # 검증 관련
│   │   │   │   └── vol-01-p3-1-verification-YYYYMMDD-HHMM.md
│   │   │   │
│   │   │   └── artistic/             # 예술성 검토 (선택)
│   │   │       └── vol-01-p3-6-artistic-YYYYMMDD-HHMM.md
│   │   │
│   │   └── logs/                     # 완료 기록
│   │       ├── vol-01-p1-5-timeline-YYYYMMDD-HHMM.md
│   │       ├── vol-01-p1-6-characters-YYYYMMDD-HHMM.md
│   │       ├── vol-01-p2-1-ch001-YYYYMMDD-HHMM.md
│   │       ├── vol-01-p3-1-verification-YYYYMMDD-HHMM.md
│   │       └── ...
│   │
│   ├── vol-02/
│   │   └── (동일 구조)
│   │
│   └── ...
│
├── logs/                        # 전체 프로젝트 로그
│   ├── p0-0-init-YYYYMMDD-HHMM.md
│   ├── p0-1-concept-YYYYMMDD-HHMM.md
│   ├── p0-2-author-YYYYMMDD-HHMM.md
│   ├── p1-1-worldview-YYYYMMDD-HHMM.md
│   ├── p1-2-characters-YYYYMMDD-HHMM.md
│   └── ...
│
├── claude.md                    # Claude 작업 규칙
├── WORK-MODE.txt                # 현재 작업 상태
├── README.md
└── .git/
```

---

## 📝 파일명 규칙

### 기본 패턴

```
vol-XX-{type}-{identifier}-{timestamp}.md

vol-XX:      권 번호 (항상 포함, 2자리)
type:        파일 타입 (p1-5v, p2-2, ch, plot 등)
identifier:  대상 식별 (001, batch01, final 등)
timestamp:   YYYYMMDD-HHMM (리포트/로그에 필수)
```

### 예시

**설계 파일:**
- `vol-01-timeline.md`
- `vol-01-characters.md`
- `vol-01-plot.md`
- `vol-01-plot-001-005.md`

**챕터:**
- `vol-01-ch-001.md`
- `vol-01-ch-002.md`
- `vol-01-ch-010A.md` (분할)
- `vol-01-ch-010B.md` (분할)

**서머리:**
- `vol-01-summary-001-005.md` (1~5화)
- `vol-01-summary-001-010.md` (1~10화 누적)
- `vol-01-summary-final.md` (전체 압축)

**리포트:**
- `vol-01-p1-9-quality-20260201-1430.md`
- `vol-01-p2-2-ch001-selfcheck-20260201-1600.md`
- `vol-01-p3-1-verification-20260201-1700.md`

**로그:**
- `vol-01-p1-5-timeline-20260201-1430.md`
- `vol-01-p2-1-ch001-20260201-1600.md`

**전체 프로젝트 로그:**
- `p0-0-init-20260115-1000.md`
- `p1-1-worldview-20260116-1100.md`

---

## 🎯 파일명 원칙

### 1. 고유성 보장
- 모든 파일명에 `vol-XX` 포함 (권별 파일)
- 타임스탬프로 시간별 고유성 보장
- 프로젝트 전체에서 절대 중복 없음

### 2. 검색 가능성
```bash
# 1권 관련 모든 파일
vol-01-*

# 모든 즉시 검증 리포트
*-p2-2-*

# 1화 관련 모든 파일
*-ch-001*

# 오늘 생성된 모든 파일
*-20260201-*
```

### 3. 정렬 가능성
- 알파벳 순서 = 논리적 순서
- vol-01-ch-001.md → vol-01-ch-002.md → ...
- 타임스탬프로 시간순 정렬

### 4. 가독성
- 파일명만 보고 내용 파악 가능
- `vol-01-p2-2-ch001-selfcheck-20260201-1600.md`
  - 1권, P2-2 프로세스, 1화 즉시 검증, 2월 1일 16시

---

## 📂 디렉토리별 역할

### settings/
- 전체 프로젝트 마스터 설정
- 모든 권이 공유하는 기본 설정
- Git으로 버전 관리

### authors/
- 작가 문체 프로필
- 프로젝트마다 다른 작가 사용 가능

### volumes/vol-XX/
- 권별 독립적 관리
- 각 권마다 동일한 구조

### reports/
- 프로세스별 검증/작업 보고서
- design/writing/verification/polish 등으로 분류
- 타임스탬프로 버전 관리

### logs/
- 프로세스 완료 기록
- 히스토리 추적용
- 오류 발생 시 과거 기록 참조

---

## 🔍 파일 찾기 예시

**시나리오 1: 1권 1화 관련 모든 파일 찾기**
```bash
find . -name "*vol-01*ch-001*"
```

**결과:**
- vol-01-ch-001.md (챕터)
- vol-01-p2-1-ch001-20260201-1600.md (작성 완료 로그)
- vol-01-p2-2-ch001-selfcheck-20260201-1630.md (즉시 검증)
- vol-01-p3-1-verification-20260201-1700.md (전체 검증)

**시나리오 2: 2월 1일 작업 내역 확인**
```bash
find . -name "*20260201*"
```

**시나리오 3: 모든 검증 보고서 찾기**
```bash
find . -name "*-p3-1-*"
```

---

## ✅ 장점

1. **고유성**: 파일명 충돌 절대 없음
2. **추적성**: 타임스탬프로 히스토리 관리
3. **검색성**: 패턴으로 쉽게 찾기
4. **정렬성**: 논리적 순서 자동 유지
5. **명확성**: 파일명만 보고 내용 파악

---

**Created:** 2026-02-01
**Author:** Alex & Claude Sonnet 4.5