Ex2-novel-agent/CLAUDE.md

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화 훅 법칙

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

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

---

집필 체크리스트

매 화 집필 전 확인:

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

매 화 집필 후 확인:

• 본문에 메타데이터 포함 안 됨
• 호감도 단계에 맞는 호칭 사용
• 감정 직접 서술 없음 (신체 반응으로)
• 분량 3,500자 ± 500자

---

참고 문서

문서	설명
웹소설 창작	전체 창작 워크플로우
집필/퇴고 가이드	집필 프로세스 상세
캐릭터 설정	캐릭터 설계 가이드

---

빠른 시작

1. 레퍼런스 확인

ls content/references/novelpia/

2. 신규 작품 생성

/rovel.create 383609 새작품명

3. 1화 집필

/rovel.write 새작품명 1화

4. 연속 연재

/rovel.complete 새작품명