# Novel Agent

> **AI 웹소설 창작 에이전트**

---

## 서비스 정체성

### Novel Agent란?

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

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

---

## 프로젝트 구조

```
Ex2-novel-agent/
├── .claude/
│   ├── agents/              # AI 에이전트 정의
│   │   ├── writing-specialist.md      # 집필 전문가
│   │   ├── revision-specialist.md     # 퇴고 전문가
│   │   └── story-continuity-specialist.md  # 연재 일관성 전문가
│   └── commands/            # 슬래시 명령어
│       ├── rovel.create.md  # /rovel.create - 신규 작품 생성
│       ├── rovel.write.md   # /rovel.write - 다음화 집필
│       ├── rovel.complete.md # /rovel.complete - 완결까지 연재
│       └── rovel.seed.md    # /rovel.seed - 시드 데이터 생성
├── rules/                   # 개발 지침
│   ├── novel-creation.md    # 웹소설 창작 가이드
│   ├── novel-writer.md      # 집필/퇴고 가이드
│   └── novel-character.md   # 캐릭터 설정 가이드
├── content/
│   ├── references/          # 레퍼런스 작품 (크롤 데이터)
│   │   └── novelpia/        # Novelpia 작품들
│   └── rovel/               # 생성된 작품들
│       └── {작품명}/
│           ├── 기획안.md
│           ├── 아웃라인.md
│           ├── 인물목록.md
│           ├── 문체.md
│           ├── 스토리구성.md
│           ├── 연재상태.md
│           ├── chapters/
│           └── drafts/
└── CLAUDE.md                # 이 파일
```

---

## 핵심 워크플로우

### 신규 작품 생성

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

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

### 다음화 집필

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

**2-Agent 워크플로우:**
1. 준비: 연재상태.md 파악, 화 설계
2. 집필: writing-specialist 에이전트
3. 퇴고: revision-specialist 에이전트
4. 갱신: 연재상태.md 업데이트

### 완결까지 연재

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

**Multi-Agent Loop:**
- 5화마다 일관성 검토 (story-continuity-specialist)
- 매 화: 집필 → 퇴고 → 갱신 자동 반복
- 마감 회차 도달 시 완료 보고서 출력

---

## 에이전트 설명

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

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

**핵심 원칙:**
1. 연재상태.md가 최우선 (호감도, 복선, 타임라인)
2. 문체.md가 문장의 기준
3. 스토리구성.md가 구조의 기준
4. 호감도 기반 말투/호칭 적용

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

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

**퇴고 체크리스트:**
- 호감도/호칭 일관성 (최우선)
- 캐릭터 외형/말투 일관성
- 설정/타임라인 일관성
- 문체 일관성

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

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

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

---

## 핵심 파일 설명

### 작품별 파일 구조

| 파일 | 용도 | 갱신 빈도 |
|------|------|----------|
| 기획안.md | 핵심 규칙, 설정 (변경 최소화) | 드물게 |
| 아웃라인.md | 전체 줄거리, TODO | 자주 |
| 인물목록.md | 캐릭터 설정, 호감도 | 매 화 |
| 문체.md | 문장 DNA, 금지 패턴 | 드물게 |
| 스토리구성.md | 화 타입, 장면 구성 규칙 | 드물게 |
| 연재상태.md | 진행 상황, 호감도, 복선 | 매 화 (자동) |

---

## 화 타입 정의

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

---

## 3화 훅 법칙

```yaml
웹소설의 황금률:
  - 독자는 보통 3화까지 무료로 읽음
  - 3화 끝에서 "다음이 궁금하다"를 느껴야 결제함
  - 따라서 3화는 반드시 강력한 훅으로 끝나야 함

카드 사용 타이밍:
  0화 (프롤로그): 티저 - 가장 임팩트 있는 장면
  1화: 주인공 일상 + 세계관 자연 노출
  2화: 능력 암시 + 3화 준비
  3화: S급 첫 등장! (메인 히로인)
```

---

## 집필 체크리스트

매 화 집필 전 확인:
- [ ] 연재상태.md 호감도 테이블 확인
- [ ] 문체.md 문장 호흡 규칙 확인
- [ ] 이전 화 마지막 장면 확인
- [ ] 화 타입에 맞는 구조 계획

매 화 집필 후 확인:
- [ ] 본문에 메타데이터 포함 안 됨
- [ ] 호감도 단계에 맞는 호칭 사용
- [ ] 감정 직접 서술 없음 (신체 반응으로)
- [ ] 분량 3,500자 ± 500자

---

## 참고 문서

| 문서 | 설명 |
|------|------|
| [웹소설 창작](rules/novel-creation.md) | 전체 창작 워크플로우 |
| [집필/퇴고 가이드](rules/novel-writer.md) | 집필 프로세스 상세 |
| [캐릭터 설정](rules/novel-character.md) | 캐릭터 설계 가이드 |

---

## 빠른 시작

### 1. 레퍼런스 확인

```bash
ls content/references/novelpia/
```

### 2. 신규 작품 생성

```
/rovel.create 383609 새작품명
```

### 3. 1화 집필

```
/rovel.write 새작품명 1화
```

### 4. 연속 연재

```
/rovel.complete 새작품명
```
