# Novel Agent

AI 웹소설 창작 에이전트 - Claude Code 기반 자동 집필 시스템

## 개요

레퍼런스 웹소설을 분석하여 AI가 자동으로 새로운 작품을 기획하고 집필하는 에이전트입니다.

### 주요 기능

| 기능 | 설명 |
|------|------|
| **레퍼런스 분석** | Novelpia 크롤 데이터에서 문체/구조 분석 |
| **작품 기획** | 기획안, 아웃라인, 인물목록 자동 생성 |
| **자동 집필** | 문체.md 기반 일관된 문체로 원고 작성 |
| **자동 퇴고** | 설정/캐릭터/문체 일관성 검토 및 수정 |
| **연재 관리** | 호감도, 복선, 타임라인 자동 추적 |

## 프로젝트 구조

```
Ex2-novel-agent/
├── .claude/
│   ├── agents/                  # AI 에이전트 정의
│   │   ├── writing-specialist.md       # 집필 전문가
│   │   ├── revision-specialist.md      # 퇴고 전문가
│   │   └── story-continuity-specialist.md  # 연재 일관성 전문가
│   └── commands/                # 슬래시 명령어
│       ├── rovel.create.md      # 신규 작품 생성
│       ├── rovel.write.md       # 다음화 집필
│       ├── rovel.complete.md    # 완결까지 연재
│       └── rovel.seed.md        # 시드 데이터 생성
├── rules/                       # 개발 지침
│   ├── novel-creation.md        # 웹소설 창작 가이드
│   ├── novel-writer.md          # 집필/퇴고 가이드
│   └── novel-character.md       # 캐릭터 설정 가이드
├── content/
│   ├── references/novelpia/     # 레퍼런스 작품 (크롤 데이터)
│   └── rovel/                   # 생성된 작품들
├── CLAUDE.md                    # Claude Code 프로젝트 설명
└── README.md
```

## 사용법

### 1. 신규 작품 생성

```
/rovel.create {레퍼런스ID} {작품명}
```

**예시:**
```
/rovel.create 383609 나만의소설
```

8단계 인터랙티브 워크플로우:
1. 레퍼런스 분석 (문체 DNA 추출)
2. 아이디어 대화 → 컨셉 도출
3. 기획안 작성 (핵심 설정)
4. 아웃라인 작성 (전체 줄거리)
5. 인물목록 작성 (캐릭터 설정)
6. 문체 설계 (문장 DNA)
7. 스토리구성 설계 (화 구성 규칙)
8. 파일 생성 및 완료

### 2. 다음화 집필

```
/rovel.write {작품명} {화수}
```

**예시:**
```
/rovel.write 나만의소설 1화
```

### 3. 완결까지 연재

```
/rovel.complete {작품명}
```

**예시:**
```
/rovel.complete 나만의소설
```

## 에이전트 설명

### writing-specialist (집필 전문가)

웹소설 원고를 작성하는 전문가입니다.

- 연재상태.md 기반 호감도/복선/타임라인 관리
- 문체.md 기반 일관된 문장 스타일
- 스토리구성.md 기반 화 구조 설계
- 호감도 단계별 말투/호칭 자동 적용

### revision-specialist (퇴고 전문가)

원고의 일관성과 품질을 검토합니다.

- 호감도/호칭 일관성 검증 (최우선)
- 캐릭터 외형/말투 일관성
- 설정/타임라인 일관성
- 문체 일관성 (금지 패턴 탐지)

### story-continuity-specialist (연재 일관성 전문가)

장기 연재 시 스토리 일관성을 검토합니다.

- 5화마다 자동 일관성 점검
- 복선 회수 상태 추적
- 캐릭터 아크 관리
- 다음 화 설계 제안

## 작품별 파일 구조

```
content/rovel/{작품명}/
├── 기획안.md        # 핵심 규칙, 설정
├── 아웃라인.md      # 전체 줄거리, TODO
├── 인물목록.md      # 캐릭터 설정, 호감도 테이블
├── 문체.md          # 문장 DNA, 금지 패턴
├── 스토리구성.md    # 화 타입, 장면 구성 규칙
├── 연재상태.md      # 진행 상황 (자동 갱신)
├── chapters/        # 완성 원고
│   ├── 001.md
│   ├── 002.md
│   └── ...
└── drafts/          # 초안 (퇴고 전)
```

## 화 타입 정의

| 타입 | 용도 | 구조 |
|------|------|------|
| **A** | 신규 캐릭터 첫 등장 | 도입→등장→갈등→치료→마무리 |
| **B** | 단골 캐릭터 심화 | 일상→정기치료→발견→감정진전→마무리 |
| **C** | 복수 캐릭터 등장 | A장면→전환→B장면→연결 |
| **D** | 이벤트/클라이맥스 | 긴장→사건→능력발휘→여파→새국면 |
| **E** | 상처 서사 | 도입→진맥→플래시백→현재복귀→여운 |
| **I** | 도입부 (1~2화) | 주인공/세계관 소개 |
| **P** | 프롤로그 | 티저 |

## 3화 훅 법칙

웹소설의 핵심 전략:

```
0화 (프롤로그): 티저 - 가장 임팩트 있는 장면
1화: 주인공 일상 + 세계관 자연 노출
2화: 능력 암시 + 3화 준비
3화: S급 첫 등장! (메인 히로인) ← 결제 유도 훅
```

> 독자는 보통 3화까지 무료로 읽습니다.
> 3화 끝에서 "다음이 궁금하다"를 느껴야 결제합니다.

## 레퍼런스 데이터

`content/references/novelpia/` 폴더에 Novelpia에서 크롤링한 웹소설 데이터가 포함되어 있습니다.

- **115개 작품**
- **3,328개 챕터** (마크다운 파일)

레퍼런스 ID로 문체 분석 및 새 작품 생성에 활용할 수 있습니다.

## 요구사항

- [Claude Code](https://claude.com/claude-code) CLI 설치 필요
- Claude Pro/Team 구독 권장 (긴 컨텍스트 활용)

## 라이선스

이 프로젝트의 코드는 자유롭게 사용할 수 있습니다.
레퍼런스 데이터(novelpia 크롤 데이터)는 학습/연구 목적으로만 사용하세요.
