Major protocol update: fix-mode v2.0.0, CHANGELOG, and protocol index
Problems addressed: 1. fix-mode.md lacked chapter repositioning protocol 2. No CHANGELOG tracking for protocol revisions 3. No centralized protocol index/documentation Changes: 1. fix-mode.md (v1.1.0 → v2.0.0) - Major Update Added: - Chapter repositioning protocol (3-stage safe process) - Rollback mechanism and error recovery - Report validity check integration - Git workflow clarification (commit timing) - Affected batch auto-invalidation Changed: - Workflow improved (backup → fix → verify → commit) - Checklist detailed 2. verification-mode.md (v2.9.0) Added: - CHANGELOG section 3. polish-mode.md (v2.4.0) Added: - CHANGELOG section 4. report-management.md (v1.0.0) Added: - CHANGELOG section 5. README.md (NEW) - Complete protocol index - Version tracking table - Workflow diagrams - FAQ section - Usage guide Protocol standardization: - All protocols now have CHANGELOG sections - Version history tracked - Changes documented - Centralized documentation Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
This commit is contained in:
Alex
345
templates/standards/README.md
Normal file
345
templates/standards/README.md
Normal file
@@ -0,0 +1,345 @@
|
||||
# CWS Writing Standards - 프로토콜 인덱스
|
||||
|
||||
> **최종 업데이트:** 2026-01-25
|
||||
> **CWS Writing Guide 버전:** v4.2.0+
|
||||
|
||||
이 디렉토리는 Creative Writing System (CWS)의 표준 프로토콜을 담고 있습니다.
|
||||
|
||||
---
|
||||
|
||||
## 📚 코어 프로토콜 (검증 & 수정)
|
||||
|
||||
### 1. VERIFICATION 모드 ✅
|
||||
|
||||
**파일:** `verification-mode.md`
|
||||
**버전:** v2.9.0
|
||||
**최종 수정:** 2026-01-25
|
||||
**용도:** 전체 검증 및 문제 발견 (수정하지 않음)
|
||||
|
||||
**주요 기능:**
|
||||
- 6단계 통합 검증 (구조, 형식, 타임라인, 내용, 일관성, 보고서)
|
||||
- 배치 검증 (10개 챕터씩)
|
||||
- 통합 검증 (전체 권 구조 확인)
|
||||
- 리포트 유효성 검증 ⭐ NEW (v2.9.0)
|
||||
- 소설 특성 반영 (병렬 서사, 다중 시점)
|
||||
|
||||
**워크플로우:**
|
||||
```
|
||||
배치 1~N 검증 → 통합 검증 → FIX 모드 필수 진입
|
||||
```
|
||||
|
||||
**최근 변경 (v2.9.0):**
|
||||
- 리포트 유효성 검증 추가
|
||||
- 파일 수정 시 리포트 자동 무효화
|
||||
|
||||
---
|
||||
|
||||
### 2. FIX 모드 🔧
|
||||
|
||||
**파일:** `fix-mode.md`
|
||||
**버전:** v2.0.0
|
||||
**최종 수정:** 2026-01-25
|
||||
**용도:** 검증 보고서 기반 일괄 수정 (타임라인 역행 재배치 포함)
|
||||
|
||||
**주요 기능:**
|
||||
- 심각도별 수정 (🔴 → 🟡 → 🟢)
|
||||
- 챕터 재배치 프로토콜 ⭐ NEW (3-stage 안전 프로세스)
|
||||
- 롤백 메커니즘 ⭐ NEW
|
||||
- 리포트 유효성 검증 ⭐ NEW
|
||||
- Git 워크플로우 명확화 ⭐ NEW
|
||||
- 영향받는 배치 자동 무효화 ⭐ NEW
|
||||
|
||||
**워크플로우:**
|
||||
```
|
||||
리포트 체크 → 재배치 → 형식/호칭 수정 → 커밋 → 재검증(자동)
|
||||
```
|
||||
|
||||
**최근 변경 (v2.0.0 - Major Update):**
|
||||
- 챕터 재배치 프로토콜 추가
|
||||
- 롤백 및 에러 복구 메커니즘
|
||||
- Git 커밋 타이밍 명확화
|
||||
|
||||
---
|
||||
|
||||
### 3. POLISH 모드 ✨
|
||||
|
||||
**파일:** `polish-mode.md`
|
||||
**버전:** v2.4.0
|
||||
**최종 수정:** 2026-01-25
|
||||
**용도:** 문장 품질 다듬기 (내용 수정 없음)
|
||||
|
||||
**주요 기능:**
|
||||
- 문장 가독성 (길이, 문단)
|
||||
- 반복 표현 제거
|
||||
- 대화/묘사 비율
|
||||
- 문체 일관성
|
||||
- 플랫폼 가독성 (문피아 최적화)
|
||||
- 리포트 유효성 검증 ⭐ NEW (v2.4.0)
|
||||
|
||||
**워크플로우:**
|
||||
```
|
||||
배치 검토 → 빈 줄 패턴 통일 → 문장 다듬기 → 커밋
|
||||
```
|
||||
|
||||
**최근 변경 (v2.4.0):**
|
||||
- 리포트 유효성 검증 추가
|
||||
- MODIFICATION 경계 명확화 (v2.3.0)
|
||||
|
||||
---
|
||||
|
||||
## 🛠️ 지원 프로토콜
|
||||
|
||||
### 4. 리포트 관리 📋
|
||||
|
||||
**파일:** `report-management.md`
|
||||
**버전:** v1.0.0
|
||||
**최종 수정:** 2026-01-25
|
||||
**용도:** 모든 검증/POLISH 리포트의 유효성 관리
|
||||
|
||||
**주요 기능:**
|
||||
- 리포트 유효성 검증 로직
|
||||
- 파일 수정 시간 vs 리포트 날짜 비교
|
||||
- 무효화 조건 명확화
|
||||
- 리포트 관리 Best Practices
|
||||
|
||||
**적용 범위:**
|
||||
- VERIFICATION 모드 v2.9.0
|
||||
- FIX 모드 v2.0.0
|
||||
- POLISH 모드 v2.4.0
|
||||
|
||||
---
|
||||
|
||||
### 5. 챕터 포맷 📄
|
||||
|
||||
**파일:** `chapter-format.md`
|
||||
**용도:** 챕터 파일 형식 표준
|
||||
|
||||
**주요 내용:**
|
||||
- 헤더 형식: `# X권 Y화: 제목`
|
||||
- 타임라인 형식: `> **타임라인:** YYYY.M.D-M.D`
|
||||
- Part 구분 방법
|
||||
- 바텀 금지 사항
|
||||
|
||||
---
|
||||
|
||||
### 6. 파일 포맷 📁
|
||||
|
||||
**파일:** `file-formats.md`
|
||||
**용도:** 프로젝트 전체 파일 구조 및 명명 규칙
|
||||
|
||||
**주요 내용:**
|
||||
- 디렉토리 구조
|
||||
- 파일명 규칙 (ch-XXX.md)
|
||||
- 메타데이터 파일 (plot-master.md, timeline.md 등)
|
||||
|
||||
---
|
||||
|
||||
### 7. 재명명 프로토콜 🔄
|
||||
|
||||
**파일:** `renaming-protocol.md`
|
||||
**용도:** 챕터 번호 변경 시 안전 절차
|
||||
|
||||
**주요 내용:**
|
||||
- 3-stage 프로세스
|
||||
- temp 파일 사용
|
||||
- 헤더 업데이트
|
||||
- 검증 절차
|
||||
|
||||
---
|
||||
|
||||
## 📝 작성 모드
|
||||
|
||||
### 8. WRITING 모드 ✍️
|
||||
|
||||
**파일:** `writing-mode.md`
|
||||
**용도:** 새로운 챕터 작성 가이드
|
||||
|
||||
**주요 내용:**
|
||||
- 작성 프로세스
|
||||
- 플롯 반영
|
||||
- 캐릭터 일관성
|
||||
- 타임라인 체크
|
||||
|
||||
---
|
||||
|
||||
### 9. MODIFICATION 모드 🔨
|
||||
|
||||
**파일:** `modification-mode.md`
|
||||
**용도:** 기존 내용 수정 (플롯/캐릭터/장면)
|
||||
|
||||
**주요 내용:**
|
||||
- POLISH와의 경계
|
||||
- 플롯 변경 절차
|
||||
- 캐릭터 관계 수정
|
||||
- 장면 추가/삭제
|
||||
|
||||
---
|
||||
|
||||
### 10. RETOUCH 모드 🎨
|
||||
|
||||
**파일:** `retouch-mode.md`
|
||||
**용도:** 세밀한 문장 수정
|
||||
|
||||
---
|
||||
|
||||
### 11. Creative Writing 가이드 📖
|
||||
|
||||
**파일:** `creative-writing.md`
|
||||
**용도:** 창작 기법 및 문체 가이드
|
||||
|
||||
---
|
||||
|
||||
### 12. Writing Guide 총람 📚
|
||||
|
||||
**파일:** `writing-guide.md`
|
||||
**용도:** 전체 작문 가이드 통합 문서
|
||||
|
||||
---
|
||||
|
||||
## 🔄 프로토콜 워크플로우
|
||||
|
||||
### 전체 흐름
|
||||
|
||||
```
|
||||
1. WRITING 모드
|
||||
→ 새 챕터 작성
|
||||
|
||||
2. VERIFICATION 모드 (필수)
|
||||
→ 검증 및 문제 발견
|
||||
→ 검증 보고서 생성
|
||||
|
||||
3. FIX 모드 (필수 - 문제 발견 시)
|
||||
→ 문제 일괄 수정
|
||||
→ 재배치, 형식 수정 등
|
||||
|
||||
4. RE-VERIFICATION (자동)
|
||||
→ FIX 후 재검증
|
||||
→ 문제 0건 확인
|
||||
|
||||
5. POLISH 모드 (선택)
|
||||
→ 문장 품질 다듬기
|
||||
→ 가독성 최적화
|
||||
|
||||
6. 완료!
|
||||
```
|
||||
|
||||
### 필수 워크플로우 (v2.8.0+)
|
||||
|
||||
```
|
||||
⚠️ 강제 규칙:
|
||||
- VERIFICATION에서 문제 발견 → FIX 필수
|
||||
- FIX 완료 → RE-VERIFICATION 자동 실행
|
||||
- 문제 0건 확인 전까지 다른 모드 전환 금지
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 버전 관리
|
||||
|
||||
### 최신 버전 (2026-01-25)
|
||||
|
||||
| 프로토콜 | 버전 | 주요 변경 |
|
||||
|----------|------|-----------|
|
||||
| VERIFICATION | v2.9.0 | 리포트 유효성 검증 |
|
||||
| FIX | v2.0.0 | 재배치 프로토콜, 롤백 메커니즘 |
|
||||
| POLISH | v2.4.0 | 리포트 유효성 검증 |
|
||||
| Report Management | v1.0.0 | 초기 버전 |
|
||||
|
||||
### 호환성
|
||||
|
||||
모든 프로토콜은 **CWS Writing Guide v4.2.0+**와 호환됩니다.
|
||||
|
||||
---
|
||||
|
||||
## 📋 CHANGELOG 정책
|
||||
|
||||
### 버전 넘버링
|
||||
|
||||
**Semantic Versioning:**
|
||||
```
|
||||
MAJOR.MINOR.PATCH
|
||||
|
||||
MAJOR: 하위 호환성 깨지는 변경
|
||||
MINOR: 기능 추가 (하위 호환)
|
||||
PATCH: 버그 수정, 문서 개선
|
||||
```
|
||||
|
||||
**예시:**
|
||||
- v2.9.0 → v3.0.0: 프로토콜 구조 대폭 변경
|
||||
- v2.8.0 → v2.9.0: 리포트 검증 기능 추가
|
||||
- v2.9.0 → v2.9.1: 오타 수정, 예시 추가
|
||||
|
||||
### 변경 이력 기록
|
||||
|
||||
**모든 프로토콜은 CHANGELOG 섹션 포함:**
|
||||
```markdown
|
||||
## 📋 CHANGELOG
|
||||
|
||||
### vX.Y.Z (YYYY-MM-DD)
|
||||
|
||||
**추가:**
|
||||
- 새 기능 목록
|
||||
|
||||
**변경:**
|
||||
- 기존 기능 수정
|
||||
|
||||
**삭제:**
|
||||
- 제거된 기능
|
||||
|
||||
**수정:**
|
||||
- 버그 수정
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔗 관련 문서
|
||||
|
||||
### 프로젝트 구조
|
||||
- `/volumes/vol-XX/` - 각 권 챕터 및 메타데이터
|
||||
- `/settings/` - 캐릭터, 세계관 설정
|
||||
- `/standards/` - 이 디렉토리 (프로토콜)
|
||||
|
||||
### 외부 참조
|
||||
- Git Repository: [novel-writing-guide](https://git.digien25.co.kr/Alex/novel-writing-guide)
|
||||
- CWS Writing Guide v4.2.0
|
||||
|
||||
---
|
||||
|
||||
## 💡 사용 가이드
|
||||
|
||||
### 처음 사용하는 경우
|
||||
|
||||
1. **VERIFICATION 모드부터 시작**
|
||||
- `verification-mode.md` 읽기
|
||||
- 1권 전체 검증 실행
|
||||
|
||||
2. **문제 발견 시 FIX 모드**
|
||||
- `fix-mode.md` 읽기
|
||||
- 검증 보고서 기반 수정
|
||||
|
||||
3. **품질 개선은 POLISH 모드**
|
||||
- `polish-mode.md` 읽기
|
||||
- 문장 다듬기
|
||||
|
||||
### 자주 묻는 질문
|
||||
|
||||
**Q: 리포트가 무효화되는 이유는?**
|
||||
A: 리포트 작성 후 파일이 수정되면 리포트가 과거 상태를 반영하므로 재검증이 필요합니다. `report-management.md` 참조.
|
||||
|
||||
**Q: 재배치는 언제 하나요?**
|
||||
A: 타임라인 역행 발견 시 FIX 모드에서 자동으로 실행됩니다. `fix-mode.md` 참조.
|
||||
|
||||
**Q: POLISH와 MODIFICATION 차이는?**
|
||||
A: POLISH는 의미 동일하게 문장만 다듬기, MODIFICATION은 내용/플롯 변경. `polish-mode.md` 참조.
|
||||
|
||||
---
|
||||
|
||||
## 📧 문의 및 기여
|
||||
|
||||
프로토콜 개선 제안은 Git Issues로 등록해주세요.
|
||||
|
||||
---
|
||||
|
||||
*이 인덱스는 자동 업데이트되지 않습니다. 새 프로토콜 추가 시 수동으로 업데이트하세요.*
|
||||
|
||||
**최종 업데이트:** 2026-01-25
|
||||
Reference in New Issue
Block a user