Alex/novel-writing-guide
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
novel-writing-guide/v2/FILE-STRUCTURE.md
Alex 45bc3face4 CWS v2.0 완성: 25개 프로세스 가이드 완성 
- 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>
2026-02-01 20:38:16 +09:00

6.7 KiB
Raw Permalink Blame History

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. 검색 가능성

# 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화 관련 모든 파일 찾기

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일 작업 내역 확인

find . -name "*20260201*"

시나리오 3: 모든 검증 보고서 찾기

find . -name "*-p3-1-*"

✅ 장점

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

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

Reference in New Issue View Git Blame Copy Permalink