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>
5.5 KiB
5.5 KiB
P3-2 Guide: 문제 수정
작업할 때마다 읽는 실행 가이드
버전: 2.0.0 프로세스: P3-2 (PROBLEM-FIX) 목표: P3-1 검증에서 발견된 문제 수정
📋 작업 순서
1. 검증 보고서 읽기
대상 파일:
volumes/vol-XX/reports/verification/vol-XX-p3-1-verification-YYYYMMDD-HHMM.md
파악할 내용:
- 발견된 문제 목록
- 심각도별 분류 (🔴/🟡/🟢)
- 문제가 있는 챕터
- 권장 수정 방법
2. 우선순위 결정
수정 순서:
- 🔴 긴급: 반드시 즉시 수정
- 🟡 중요: 우선 수정
- 🟢 경미: 여유 있을 때
긴급 문제 예시:
- 플롯 불일치 (설계와 다름)
- 타임라인 오류 (날짜/시간 계산 틀림)
- 캐릭터 나이 오류
- 세계관 법칙 위반
- 시점/시제 불일치
중요 문제 예시:
- 성격 불일치
- 말투 불일치
- 금지 표현 사용
- 감정선 부자연스러움
- 전개 논리 문제
경미 문제 예시:
- 오타
- 표현 개선 여지
- 세부 묘사 부족
3. 문제 수정
수정 절차:
A. 🔴 긴급 문제 수정
1. 문제 확인:
- 보고서에서 문제 위치 확인
- 해당 챕터 읽기
- 정확한 문제 지점 파악
2. 원인 분석:
- 왜 문제가 발생했는가?
- 설계 파일 확인 (필요시)
- 다른 챕터에도 같은 문제 있는지 확인
3. 수정:
- Edit 도구로 챕터 파일 수정
- 수정 내용 간략히 기록
- 연관된 부분도 함께 수정
4. 검증:
- 수정 후 재확인
- 다른 문제 발생 안 했는지 확인
B. 🟡 중요 문제 수정
(동일 절차)
C. 🟢 경미 문제
- 일괄 수정 또는 P3-5 (퇴고)에서 처리
- 긴급/중요 문제 모두 수정 후
4. 수정 기록 작성
파일명:
volumes/vol-XX/logs/vol-XX-p3-2-fixes-YYYYMMDD-HHMM.md
구조:
# P3-2 완료 기록: [X]권 문제 수정
**날짜:** YYYY-MM-DD HH:MM
**프로세스:** P3-2 (PROBLEM-FIX)
**대상:** [X]권
**담당:** Claude Sonnet 4.5
---
## 수행 내용
- 검증 보고서 분석
- 발견된 문제 수정
- 수정 내용 기록
---
## 수정 통계
**총 문제:** [N]건
- 🔴 긴급: [A]건 → 수정 완료: [A']건
- 🟡 중요: [B]건 → 수정 완료: [B']건
- 🟢 경미: [C]건 → 수정 완료: [C']건
**수정된 챕터:** [M]개
---
## 수정 내역
### 🔴 긴급 문제
**1. [문제 제목]**
- 위치: vol-XX-ch-YYY.md:[라인/섹션]
- 문제: [원래 내용/문제점]
- 수정: [수정한 내용]
- 이유: [왜 이렇게 수정했는가]
**2. [문제 제목]**
- (동일 형식)
---
### 🟡 중요 문제
**1. [문제 제목]**
- (동일 형식)
---
### 🟢 경미 문제
- [처리 여부 및 방법]
---
## 미수정 문제
**남은 문제:** [N]건
- 이유: [왜 수정 안 했는가]
- 계획: [언제/어떻게 처리할 것인가]
---
## 발견된 패턴
**반복되는 문제:**
- [패턴 1]: [몇 건] - [원인]
- [패턴 2]: [몇 건] - [원인]
**개선 방안:**
- [앞으로 주의할 점]
---
## 다음 Phase
- P3-1: 재검증 (수정 확인)
---
**작성:** Claude Sonnet 4.5
**완료:** YYYY-MM-DD HH:MM
✅ 최종 체크리스트
작업 완료 전 확인:
- 검증 보고서 읽기 완료
- 🔴 긴급 문제 모두 수정
- 🟡 중요 문제 모두 수정
- 수정 내역 기록
- 수정된 챕터 확인
- 완료 기록 작성
- Git 커밋
- WORK-MODE.txt STATUS → COMPLETED
🔍 작업 원칙
이 단계의 목적:
- 발견된 문제 해결
- 품질 기준 충족
- 다음 단계 준비
수정 vs 개선:
- P3-2 (문제 수정): 틀린 것 고침
- P3-3 (품질 개선): 좋은 것 더 좋게
수정 기준:
- 🔴 긴급: 절대 넘어갈 수 없음
- 🟡 중요: 가능하면 모두 수정
- 🟢 경미: 시간 보고 결정
재검증 필요:
- 🔴/🟡 문제 수정 후 → P3-1 재실행
- PASS 확인 후 → P3-3 진행
🔍 수정 가이드
플롯 불일치 수정
문제: 챕터 내용이 설계와 다름
절차:
- vol-XX-plot-NNN-MMM.md 확인
- 어느 쪽이 맞는지 판단
- 설계가 맞으면: 챕터 수정
- 챕터가 맞으면: 설계 수정 (단, 사용자 확인)
- 수정 후 일관성 재확인
타임라인 오류 수정
문제: 날짜/시간 계산 틀림
절차:
- vol-XX-timeline.md 확인
- 정확한 날짜 계산
- 챕터의 날짜 표기 수정
- 관련된 다른 챕터도 확인
캐릭터 일관성 수정
문제: 성격/말투/나이 불일치
절차:
- characters-master.md 확인
- vol-XX-characters.md 확인
- 어느 쪽이 맞는지 판단
- 챕터 내용 수정
- 해당 캐릭터 등장하는 다른 부분도 확인
세계관 법칙 위반 수정
문제: 설정된 규칙 어김
절차:
- worldview.md 확인
- 위반 내용 정확히 파악
- 챕터 내용 수정
- 다른 챕터에도 같은 위반 있는지 확인
🔍 문제 해결
Q: 수정하다 보니 플롯이 많이 바뀌는데? A: 설계 파일도 함께 업데이트. 큰 변화면 사용자에게 확인.
Q: 같은 문제가 여러 챕터에 반복되는데? A: 패턴 파악. 모두 수정. 완료 기록에 패턴 명시. 앞으로 주의.
Q: 수정이 어려운 문제는? A: 사용자에게 질문. 판단 애매하면 무리하게 수정 금지.
Q: 경미 문제는 언제 수정? A: P3-5 (퇴고)에서. 지금은 긴급/중요만.
Created: 2026-02-01 Author: Alex & Claude Sonnet 4.5