Initial commit: Novel Agent setup

- Add 3 AI agents (writing, revision, story-continuity specialists) - Add 4 slash commands (rovel.create, write, complete, seed) - Add novel creation/writing rules - Add Novelpia reference data (115 works, 3328 chapters) - Add CLAUDE.md and README.md 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-14 21:31:57 +09:00
commit f66fe445bf
3341 changed files with 1271187 additions and 0 deletions
--- a/.claude/commands/rovel.write.md
+++ b/.claude/commands/rovel.write.md
@@ -0,0 +1,415 @@
+---
+description: 웹소설 다음화 집필 - 이전화 다음 챕터를 작성하고 퇴고까지 자동 수행
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+User input **must** be considered (if not empty).
+
+## Overview
+
+The text following `/rovel.write` is the chapter path or instructions. Assume `$ARGUMENTS` is always available.
+
+**Examples:**
+- `/rovel.write content/rovel/협회 소속 양호선생님 다음화`
+- `/rovel.write 협회 소속 양호선생님 4화 루나 치료 에피소드`
+- `/rovel.write 003.md 다음화` (현재 작업 중인 작품 기준)
+
+**This is a 2-Agent workflow**:
+```
+┌─────────────────────────────────────────────────────────┐
+│  Phase 1: 준비                                           │
+│  - 연재상태.md 파악                                       │
+│  - 다음 화 설계                                          │
+│  - 참조 파일 수집                                        │
+└─────────────────────────────────────────────────────────┘
+                           ↓
+┌─────────────────────────────────────────────────────────┐
+│  Phase 2: 집필 (writing-specialist 에이전트)              │
+│  - 문체.md + 스토리구성.md 기반 집필                      │
+│  - 호감도 기반 말투/호칭 적용                             │
+│  - drafts/ 폴더에 초안 저장                              │
+└─────────────────────────────────────────────────────────┘
+                           ↓
+┌─────────────────────────────────────────────────────────┐
+│  Phase 3: 퇴고 (revision-specialist 에이전트)            │
+│  - 설정/캐릭터/문체 일관성 검토                           │
+│  - CRITICAL 자동 수정                                    │
+│  - chapters/ 폴더에 최종본 저장                          │
+└─────────────────────────────────────────────────────────┘
+                           ↓
+┌─────────────────────────────────────────────────────────┐
+│  Phase 4: 갱신                                           │
+│  - 연재상태.md 업데이트                                   │
+│  - 호감도/복선/타임라인 갱신                              │
+└─────────────────────────────────────────────────────────┘
+```
+
+---
+
+## Execution Flow
+
+### Phase 1: 파일 경로 파싱
+
+1. **입력 분석**:
+   - 절대 경로가 주어지면 그대로 사용
+   - 상대 경로나 화수만 주어지면 현재 작품 폴더에서 탐색
+   - "다음화", "다음 화" 키워드 → 마지막 화 번호 + 1
+
+2. **작품 폴더 결정**:
+   ```
+   기본: content/rovel/{작품명}/
+   예시: content/rovel/협회 소속 양호선생님/
+   ```
+
+3. **다음 화 번호 계산**:
+   - chapters/ 폴더의 가장 큰 번호 확인
+   - 예: 003.md가 마지막이면 → 004.md 생성
+
+---
+
+### Phase 2: 연재상태 파악 (⚠️ 최우선)
+
+> **가장 먼저 연재상태.md를 읽어 현재 상황을 파악합니다.**
+
+```yaml
+필수 읽기 파일:
+  1. 연재상태.md: ⚠️ 최우선
+     - 경로: {작품폴더}/연재상태.md
+     - 추출:
+       - 마지막 화/장면 (어디서 이어쓸지)
+       - 작중 시간 (타임라인 연속성)
+       - 호감도 테이블 (말투/호칭 결정)
+       - 활성 복선 목록 (회수/배치할 복선)
+       - 다음 화 예정 설계 (이미 계획된 내용)
+
+  2. 기획안.md:
+     - 경로: {작품폴더}/기획안.md
+     - 추출: 핵심 규칙, 세계관 설정, 당직 체계, 캐릭터별 말투
+
+  3. 문체.md: ⚠️ 필수
+     - 경로: {작품폴더}/문체.md
+     - 추출: 문장 호흡(15-30자), 감정 표현 패턴, 시스템창 스타일, 금지 패턴
+
+  4. 스토리구성.md: ⚠️ 필수
+     - 경로: {작품폴더}/스토리구성.md
+     - 추출: 화 타입(A/B/C/D), 장면 구성 규칙, 복선 관리, 시스템창 배치
+
+  5. 인물목록.md:
+     - 경로: {작품폴더}/인물목록.md
+     - 추출: 외형 설정, 말투 패턴, 호칭 체계, 호감도 테이블
+
+  6. 아웃라인.md:
+     - 경로: {작품폴더}/아웃라인.md
+     - 추출: TODO, 복선 관리, 다음화 예정 내용
+
+  7. 이전 2~3화:
+     - 경로: {작품폴더}/chapters/{이전화들}.md
+     - 추출: 연속성 확인, 마지막 장면, 시간 흐름
+```
+
+---
+
+### Phase 3: 다음 화 설계 (스토리구성.md 기반)
+
+집필 전 반드시 화 설계를 먼저 수행합니다:
+
+1. **화 타입 결정**:
+   ```yaml
+   A타입: 신규 환자 첫 등장 (도입→등장→갈등→치료→마무리)
+   B타입: 단골 환자 심화 (일상→정기치료→새발견→감정진전→마무리)
+   C타입: 복수 캐릭터 등장 (A장면→전환→B장면→연결)
+   D타입: 이벤트/클라이맥스 (긴장→사건→능력발휘→여파→새국면)
+   ```
+
+2. **호감도 기반 캐릭터 설정 확인**:
+   ```yaml
+   연재상태.md의 호감도 테이블 확인:
+     - 현재 호감도 → 현재 단계 결정
+     - 단계에 맞는 호칭/말투 적용
+     - 이번 화에서 호감도 변화 계획
+
+   예시:
+     자화연 현재 호감도: 18 (초면)
+     → 호칭: "필부", "네 놈"
+     → 이번 화 이벤트: 온기 느낌 (+5)
+     → 예상 종료 호감도: 23 → "한시우" 호칭 해금!
+   ```
+
+3. **화 설계 체크리스트 작성**:
+   ```yaml
+   기본 정보:
+     - 화수: ___화
+     - 타입: A/B/C/D
+     - 예상 분량: ___자
+
+   등장 인물:
+     - 메인: (이름, 현재 호감도, 단계)
+     - 서브:
+     - 언급만:
+
+   시간/공간:
+     - 시작 시간: (연재상태.md 타임라인 이어서)
+     - 종료 시간:
+     - 장소:
+
+   핵심 이벤트:
+     1.
+     2.
+     3.
+
+   복선 관리:
+     - 회수할 복선: (연재상태.md 활성 복선에서)
+     - 새로 심을 복선:
+
+   호감도 변화:
+     - 누가: 현재 → 예상 종료
+     - 트리거 이벤트:
+
+   연결:
+     - 이전 화 끝: (연재상태.md 마지막 장면)
+     - 다음 화 예정:
+   ```
+
+---
+
+### Phase 4: 집필 (writing-specialist 에이전트 호출)
+
+> **중요**: Task 도구로 writing-specialist 에이전트를 호출하여 집필 수행
+
+**에이전트 호출 방식**:
+
+```yaml
+Task 도구 사용:
+  subagent_type: writing-specialist
+  prompt: |
+    다음 정보를 기반으로 {N}화를 집필해주세요.
+
+    ## 작품 정보
+    - 작품명: {작품명}
+    - 화수: {N}화
+    - 화 타입: {A/B/C/D/E}
+
+    ## 참조 파일 내용
+    [연재상태.md 내용]
+    [문체.md 내용]
+    [스토리구성.md 내용]
+    [기획안.md 내용]
+    [인물목록.md 내용]
+    [이전화 마지막 부분]
+
+    ## 화 설계
+    [Phase 3에서 작성한 화 설계 체크리스트]
+
+    ## 출력
+    - 파일 경로: {작품폴더}/drafts/{화수}_draft.md
+    - 분량: 3,500자
+```
+
+**에이전트가 참조할 가이드**:
+- `.claude/agents/writing-specialist.md` - 집필 전문가 가이드
+- `rules/novel-writer.md` - 집필 규칙
+
+**초안 저장 위치**: `{작품폴더}/drafts/{화수}_draft.md`
+
+---
+
+### Phase 5: 퇴고 (revision-specialist 에이전트 호출)
+
+> **중요**: Task 도구로 revision-specialist 에이전트를 호출하여 퇴고 수행
+
+**에이전트 호출 방식**:
+
+```yaml
+Task 도구 사용:
+  subagent_type: revision-specialist
+  prompt: |
+    다음 초안을 퇴고해주세요.
+
+    ## 작품 정보
+    - 작품명: {작품명}
+    - 화수: {N}화
+    - 초안 경로: {작품폴더}/drafts/{화수}_draft.md
+
+    ## 참조 파일 내용
+    [연재상태.md 내용 - 호감도 테이블 필수]
+    [문체.md 내용]
+    [인물목록.md 내용]
+    [기획안.md 내용]
+
+    ## 퇴고 후 작업
+    1. CRITICAL 오류 자동 수정
+    2. 최종본을 {작품폴더}/chapters/{화수}.md에 저장
+    3. 퇴고 보고서 출력
+```
+
+**에이전트가 참조할 가이드**:
+- `.claude/agents/revision-specialist.md` - 퇴고 전문가 가이드
+
+**퇴고 체크리스트** (에이전트가 자동 수행):
+
+| 우선순위 | 검토 항목 | 설명 |
+|----------|----------|------|
+| ⚠️ 최우선 | 호감도/호칭 | 현재 호감도에 맞는 호칭만 사용 |
+| CRITICAL | 캐릭터 외형 | 눈동자, 머리카락 색상 등 |
+| CRITICAL | 말투 패턴 | 캐릭터별 말투 규칙 |
+| WARNING | 문체 일관성 | 문장 호흡, 감정 표현 |
+| WARNING | 설정 일관성 | 세계관, 시간 흐름 |
+
+**최종본 저장 위치**: `{작품폴더}/chapters/{화수}.md`
+
+---
+
+### Phase 6: 퇴고 보고서 출력
+
+```markdown
+# 퇴고 보고서: {화수}
+
+## 🔴 CRITICAL (즉시 수정 필요)
+| 라인 | 문제 | 현재 | 수정안 |
+|------|------|------|--------|
+
+## 🟡 WARNING (검토 권장)
+| 라인 | 문제 | 설명 |
+|------|------|------|
+
+## 🟢 SUGGESTION (선택적 개선)
+
+## 📊 요약
+- Critical: N건
+- Warning: N건
+- Suggestion: N건
+```
+
+---
+
+### Phase 7: 자동 수정 및 갱신
+
+1. **CRITICAL 자동 수정**:
+   - 설정 오류 (눈동자 색상 등) → 즉시 수정
+   - 말투/호칭 오류 → 즉시 수정
+   - 호감도 단계 불일치 → 즉시 수정
+
+2. **인물목록.md 갱신**:
+   - 호감도 테이블 업데이트 (새 화수 추가)
+   - 관계 변화 이력 추가
+   - 호칭 변화 기록 (단계 변화 시)
+   - 새 인물 추가 (등장 시)
+
+3. **아웃라인.md TODO 갱신**:
+   - 해당 화 완료 처리 `[x]`
+   - 새 복선 기록
+   - 다음 화 TODO 추가
+
+---
+
+### Phase 8: 연재상태.md 갱신 (⚠️ 필수)
+
+> **중요**: 매 화 집필 완료 후 반드시 연재상태.md를 갱신해야 함
+
+```yaml
+갱신 항목:
+
+1. 현재 진행 상황:
+   - 마지막 화: N화 → N+1화
+   - 작중 시간: 업데이트
+   - 마지막 장면: 이번 화 마지막 장면
+   - 다음 화 예정: 예상 내용
+
+2. 호감도 테이블:
+   - 등장한 인물의 호감도 업데이트
+   - 변화 트리거 기록
+   - 단계 변화 시 호칭 해금 기록
+
+3. 활성 복선 목록:
+   - 회수한 복선: 상태 → ✅ 회수
+   - 새로 심은 복선: 추가
+   - 진행 중 복선: 상태 업데이트
+
+4. 타임라인:
+   - 이번 화 시간대/이벤트 추가
+
+5. 최근 화 요약:
+   - 이번 화 행 추가 (오래된 화 삭제하여 5화 유지)
+
+6. 다음 화 예정 설계:
+   - 다음 화 기본 설계 업데이트
+
+7. 갱신 로그:
+   - 날짜, 화수, 갱신 내용 기록
+```
+
+---
+
+## Output Format
+
+집필 완료 후 다음 형식으로 요약 출력:
+
+```markdown
+## ✅ 집필 완료
+
+**파일**: `content/rovel/{작품명}/chapters/{화수}.md`
+**분량**: N자
+
+### 주요 내용
+- [장면 1 요약]
+- [장면 2 요약]
+- ...
+
+### 호감도 변화
+| 인물 | 이전 | 이후 | 단계 변화 |
+|------|------|------|----------|
+| 자화연 | 18 | 23 | 초면 → 관심 ("한시우" 해금) |
+| 루나 | 3 | 15 | 초면 유지 |
+
+### 복선 관리
+- 회수: [복선 내용]
+- 배치: [새 복선 내용]
+
+### 퇴고 결과
+- 🔴 Critical 수정: N건 → 모두 수정 완료
+- 🟡 Warning: N건 (검토 권장)
+- 🟢 Suggestion: N건
+
+### 갱신된 파일
+- [x] 연재상태.md
+- [x] 인물목록.md (호감도 업데이트)
+- [x] 아웃라인.md (TODO 갱신)
+
+### 다음 화 예정
+- [다음 화 예상 내용]
+```
+
+---
+
+## Reference Files
+
+| 유형 | 경로 | 용도 |
+|------|------|------|
+| 연재상태 | `content/rovel/{작품명}/연재상태.md` | 진행상황/호감도/복선 ⚠️ 최우선 |
+| 집필 가이드 | `rules/novel-writer.md` | 집필 + 퇴고 프로세스 |
+| **집필 에이전트** | `.claude/agents/writing-specialist.md` | **집필 전문가 가이드** |
+| **퇴고 에이전트** | `.claude/agents/revision-specialist.md` | **퇴고 전문가 가이드** |
+| 기획안 | `content/rovel/{작품명}/기획안.md` | 핵심 규칙 |
+| 문체 가이드 | `content/rovel/{작품명}/문체.md` | 문체 DNA ⚠️ 필수 |
+| 스토리구성 | `content/rovel/{작품명}/스토리구성.md` | 화 구성/복선 ⚠️ 필수 |
+| 인물목록 | `content/rovel/{작품명}/인물목록.md` | 캐릭터 설정/호감도 |
+| 아웃라인 | `content/rovel/{작품명}/아웃라인.md` | TODO, 복선 |
+
+## Agent Workflow
+
+```
+┌──────────────────┐     초안      ┌──────────────────┐     최종본     ┌──────────────┐
+│ writing-specialist│ ──────────→ │revision-specialist│ ──────────→ │  chapters/   │
+│   (집필 전문가)    │   drafts/   │   (퇴고 전문가)    │              │   {N}.md     │
+└──────────────────┘              └──────────────────┘              └──────────────┘
+        ↑                                  ↑
+        │                                  │
+   문체.md                            연재상태.md
+   스토리구성.md                       인물목록.md
+   기획안.md                           문체.md
+```