45bc3face4
- 54개 파일 작성 완료 (setup 25개 + guides 25개 + 메타 4개) - 프로세스 체계: P0(3) + P1(10) + P2(3) + P3(6) + P4(3) = 25개 - Claude 가독성: 5-10KB 가이드로 읽기 가능 - 파일명 고유성: vol-XX 접두사 보장 - 히스토리 강제화: logs/ 시스템 - 메타 문서: README, PROCESS-CATALOG, FILE-STRUCTURE, CHANGELOG Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
240 lines
6.7 KiB
Markdown
240 lines
6.7 KiB
Markdown
# 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
|