트렌드 조사부터 세로 스크롤 뷰어 완성까지, 웹툰 한 회차를 AI 에이전트 팀이 단계별로 만들어내는 Claude Code 하네스.

27개 전문 에이전트와 6개 스킬로 구성되며, 인기 웹툰 트렌드 조사 → 대사 위주·고긴장·매 회차 반전 시나리오 작성 → 캐릭터 레퍼런스 시트 선행 렌더 → 회차당 50+ 패널을 말풍선·한글 대사 in-image 베이크로 병렬 렌더 → 생성-검증 루프로 재생성 → 세로 스크롤 뷰어 조립까지 전 과정을 자동화합니다.

• 27 에이전트 / 4 단계 팀: 리서치 → 시나리오 → 비주얼 → 조립검수. 각 Phase마다 팀을 재구성하며 운영합니다.
• 레퍼런스 시트 선행 렌더: 캐릭터 다각도·표정 레퍼런스를 먼저 렌더해 회차 간 외형 일관성의 단일 진실원천(SSOT)을 확보합니다.
• in-image 말풍선 베이크: 말풍선과 한글 대사를 이미지 생성 시 함께 그려, 별도 텍스트 오버레이 없이 조립합니다.
• 병렬 렌더 + 생성-검증 루프: codex-image로 동시 5장씩 배치 렌더하고, panel-validator가 6축 검증 후 기준 미달 패널만 재생성합니다.
• 연속성 관리: 회차를 넘어 캐릭터 외형·설정·떡밥(복선)을 누적 추적합니다.

.claude/
├── agents/                      # 27개 전문 에이전트 정의
│   ├── trend-scout.md           # 리서치팀
│   ├── concept-architect.md     # 시나리오팀
│   ├── art-director.md          # 비주얼팀
│   ├── panel-validator.md       # 생성-검증 게이트키퍼
│   ├── episode-compositor.md    # 조립검수팀
│   └── ... (총 27개)
└── skills/                      # 6개 방법론 스킬
    ├── webtoon-orchestrator/    # ⭐ 메인 오케스트레이터 (진입점)
    ├── webtoon-trend-research/  # 트렌드 리서치 방법론
    ├── webtoon-scenario/        # 시나리오·대본 집필
    ├── webtoon-panel-breakdown/ # 패널 분해·스타일/일관성 토큰
    ├── webtoon-panel-render/    # codex-image 병렬 렌더
    └── webtoon-assembly/        # 세로 스크롤 조립·검수·패키징

4명의 조사자(트렌드·플랫폼 랭킹·독자 반응·후킹/반전)가 병렬로 조사하고, synthesizer가 하나의 기획 브리프로 종합합니다.

하이콘셉트에서 출발해 세계관·캐릭터·시리즈 아크를 거쳐 반전 계획과 긴장 곡선을 병렬 설계하고, 비트시트→대본→최종본으로 수렴합니다. 매 회차 반전과 50+ 패널 분량을 보장합니다.

아트 디렉터의 스타일 바이블 → 캐릭터 레퍼런스 시트 선행 렌더 → 샷리스트·레터링 → 프롬프트 합성 → 3명의 아티스트가 codex로 동시 5장 병렬 렌더 → panel-validator가 6축 검증·재생성 루프를 돌립니다. 말풍선은 이미지에 함께 그려집니다(in-image 베이크).

말풍선이 베이크된 패널을 세로 스크롤 뷰어로 조립하고, QA 검수·연속성 관리를 거쳐 showrunner가 최종 사인오프 후 RELEASE로 패키징합니다.

trend-brief.md
   └→ concept → world → characters → series-arc → {twist-plan, tension-curve}
                                                      └→ beatsheet → script → script_final
script_final + characters
   └→ style-bible(+장소토큰, 말풍선 규약) / character-sheets
        └→ refs/*.png (레퍼런스 시트, 패널 전 선행)
        └→ shotlist(scene_id/location) + lettering(in-image 말풍선 명세)
              └→ prompts(스타일+장소+레퍼런스앵커+말풍선 베이크, scene A/B/C)
                    └→ panel_*.png ⇄ panel-validator 6축 검증-재생성 루프
                          └→ validation.md (전 패널 통과)
panel_*.png(말풍선 포함) → index.html(오버레이 없음) → qa_report → RELEASE/ep{NN}/

6단계 실행: Phase 0(컨텍스트 확인) → 1(준비) → 2(리서치) → 3(시나리오) → 4(비주얼) → 5(조립·검수) → 6(마무리).

이 저장소는 Claude Code 하네스입니다. .claude/ 디렉토리를 작업 프로젝트 루트에 두고 Claude Code를 실행하세요.

# 1) 하네스를 프로젝트에 배치
git clone https://github.com/revfactory/webtoon-harness.git
cp -r webtoon-harness/.claude /path/to/your-project/

# 2) 해당 프로젝트에서 Claude Code 실행 후

그다음 Claude Code 세션에서 자연어로 요청합니다:

• "트렌드 반영해서 웹툰 1화 만들어줘" — 전체 파이프라인 실행
• "다음 화 만들어" — 세계관/스타일/연속성 재사용, 새 회차 생성
• "이 회차 반전 더 강하게" — 시나리오팀 부분 재실행
• "패널 23번 다시 그려" — 해당 패널만 재렌더 + 재검증

webtoon-orchestrator 스킬이 자동으로 트리거되어 단계별 에이전트 팀을 조율합니다.

• Claude Code (에이전트·스킬 실행 환경)
• codex CLI (codex exec의 image_generation 툴) — 패널 이미지 병렬 렌더. ChatGPT OAuth 인증 필요. codex 전역 동시 세션은 최대 5개를 지킵니다.
  • codex CLI 사용 방법은 codex-cli 스킬을 참고하세요.

💡 이 저장소의 인포그래픽들은 codex-image로 16:9 비율 5장을 동시 병렬 렌더해 제작했습니다.

• 대사 위주·고긴장·매 회차 반전: 내레이션을 최소화하고 캐릭터 대사·행동으로 긴장과 정보, 반전을 전달합니다.
• 회차당 50+ 패널: 세로 스크롤 리듬에 맞춰 비트를 충분히 쪼갭니다.
• 일관성 우선: 레퍼런스 시트 → 일관성 토큰 → 장소 토큰을 모든 프롬프트에 주입하고, md5 중복·배경 급변·한글 깨짐을 검증 루프로 잡습니다.
• 감사 추적: 모든 중간 산출물을 _workspace/에 보존합니다.

MIT