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 CLI 설치 필요
• Claude Pro/Team 구독 권장 (긴 컨텍스트 활용)

라이선스

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