community-webtoon-producer

Community Webtoon Producer

Objective

온라인 커뮤니티 반응을 임의로 지어내지 않고, 전편·장면·컷의 인과와 말맛을 살려 읽히는 한국어 세로형 정보·개그 웹툰을 제작한다. 기술적 생성 성공이나 검사 통과를 사용자의 창작·시각 승인과 혼동하지 않는다.

Primary Quality Rule

공유된 맥락과 이해 일치를 단순한 대화 예절이 아니라 핵심 제작 입력으로 다룬다. 아무리 정교한 미시 프롬프트라도 작품 전체의 이유(WHY), 독자의 감정 순서, 핵심 모티브, 사실과 MSG의 경계, 사용자가 짚어낸 어색함이 빠지면 좋은 결과를 복원할 수 없다.

당장 실행할 명령과 직접 관계없어 보이는 맥락이라도 창작·연출 판단을 바꾼다면 보존한다. 다른 모델이나 다음 생성 패스에 판단을 넘길 때는 전체 흐름·현재 구간·앞뒤 상태·정확한 대사·WHY를 실제 본문에 다시 적어 전달한다. 파일 경로, 해시, 레퍼런스, 이전 이미지는 상태와 외형을 증명할 뿐 왜 그렇게 보여야 하는지 설명하지 못한다.

이 원칙은 프롬프트만 다듬어 실패했던 시행착오를 거쳐 반복 확인된 품질 기준이다. 가설을 검증된 모델 내부 기제처럼 과장하지 않고, 목적·이유·실패 배경·예시를 살려 전달한다.

First Read

새 작품은 docs/WORKFLOW.md와 이번 작업 경로에서 쓰는 단계별 매뉴얼을 처음부터 끝까지 읽고 작품의 PRODUCTION_CHECKLIST.md를 만든다. 각 단계 진입 시 해당 매뉴얼·예시와 직전 결과를 읽고, 종료 시 실제 원고·입력·결과에서 적용 여부를 확인해 갱신한 뒤 다음 단계 문서를 읽는다. 유효한 통과 증거는 재사용한다. AGY에는 내부 체크리스트를 넘기지 않고 짧은 자연어와 실제 자료를 전달한다.

저장소 루트에서 다음 문서를 먼저 읽는다.

1. AGENTS.md
2. docs/BEFORE_YOU_START.md
3. docs/QUALITY_CONTRACT.md
4. 현재 프로젝트의 PROJECT.md

창작 협업과 퇴고·편집·전달을 위해 docs/CREATIVE_ROLES.md, docs/CREATIVE_CONTINUITY.md, docs/CRAFT_REVIEW.md, docs/CUT_BASED_PRODUCTION.md, docs/PANEL_LAYOUT_REVISION.md, docs/PANELING_AND_PACING.md, docs/UPLOAD_DELIVERY.md를 읽고, 관련 전문 판단과 WHY·현재 위임 범위를 실제 요청 본문에 담는다. 소재를 본격 제작으로 옮길 준비가 되면 harness/scripts/init_project.py로 프로젝트를 초기화한다.

공개 저장소(Q0916/community-webtoon-agent-kit)는 Python 3.10+ 표준 라이브러리 기반의 init_project.py, validate_project.py, provider_instruction_integrity.py, freeze_completion.py, verify_repository.py를 제공한다. 생성 실행기(ima2-gen), 누적 receipt, 컷 시트 분리·재배치, 업로드 무손실 분할 및 용량·높이 검사 도구는 공개 키트에 포함되지 않으므로 사용자가 별도로 준비한 환경을 사용한다.

Required Workflow

1. 원문 게시글과 주변 반응 샘플을 수집하고 URL과 관측 시각을 기록한다.
2. source_ledger.md에서 primary_fact, mood_source, MSG, do_not_use를 분리한다.
3. Director의 의도, 커뮤니티 독자의 기대, 웹툰 호흡이 만나는 지점(sweet spot)을 논의하고 승인받는다.
4. Director/Producer의 거친 장면 뼈대나 기획 원안을 보존한다. 빈칸 채우기를 맡길 때는 의도된 빈칸을 미리 메우지 않고, 자유 집필이나 완성문 퇴고를 맡길 때는 사용자의 위임 범위를 그대로 따른다.
5. 원안과 전체 소스·사실/MSG 경계·WHY를 Gemini(AGY)에게 전달해 집필·연출 패스를 받는다. Gemini 원출력은 원안 옆에 별도 파일로 그대로 보존하며 덮어쓰지 않는다.
6. 수정하거나 재작성을 요청하기 전에 AGY 원출력을 Director에게 먼저 그대로 보여준다. 검토 의견은 분리해 기록하고 제안별로 adopt, adapt, reject를 정리한 뒤 합의된 범위만 수정한다. 초안 확정 후 편집·배치·식자·생성 준비는 Codex가 맡고, AGY 재참여는 사용자의 새 요청이 있을 때만 진행한다.
7. 채택된 결과를 바탕으로 전편(감정·인과·보상) → 장면 연결 → 컷 설계 순서로 작법 퇴고를 수행해 하나의 canonical 콘티로 정리한다(docs/CRAFT_REVIEW.md). 무엇을 왜 유지·수정했는지는 기존 콘티 메모에 남기며 매 컷 새 보고서나 승인 절차를 추가하지 않는다. 모든 컷에 handoff_from_previous, reader_first_sees, character_realizes, push_to_next를 부여하고 인과가 선명해진 뒤에 불필요한 밀도를 덜어낸다.
8. 사람이 canonical 콘티를 읽고 필요시 직접 수정한 뒤 명시적으로 승인한다. 원 뼈대, Gemini 원출력, 공동 검토, 사람 승인 canonical 버전과 해시를 editorial_review_lock.csv에 기록한다.
9. 사람 승인 콘티를 안정된 ID를 가진 페이지/컷 패킷으로 승격한다. 공개 validate_project.py는 기존 page_id 기반 잠금을 검사하며 새 1-2컷 시트 프로필을 자동 검증하지 않으므로, 기존 양식으로 검증되는 범위와 별도 컷 시트 편집 범위를 구별한다.
10. 모든 생성 단위를 independent_page, same_scene_continuation, reused_shot_variation 중 하나로 분류한다. 이야기 순서나 대사 진행만으로 시각적 연속성을 단정하지 않는다.
11. 화면에 표시할 텍스트의 source class와 사용자 승인 상태를 잠근다.
12. 화면 텍스트의 라우팅(text_owner, owner_role, attachment_hint, read_order)을 잠근다. 폰 최종 표시 폭과 축소에서도 잘 읽히도록 글자·대비·말풍선 공간의 목적을 함께 정리한다.
13. 등장 캐스트, 레퍼런스 역할, 파일 해시, 동시 등장 규칙을 잠근다. 반복 등장 캐릭터에 사람 승인 identity reference가 없으면 외형 일관성을 보장한다고 주장하지 말고 멈춰서 레퍼런스를 요청한다.
14. 전체 흐름·현재 구간·앞뒤 상태·정확한 대사·WHY를 담아 자기완결적인 provider-bound 프롬프트를 작성한다. 분리 가능한 1-2컷 시트 후보를 뽑을 때는 생성 시트 내부 배치와 최종 세로 스크롤 배치가 다른 단계임을 명시한다(docs/CUT_BASED_PRODUCTION.md).
15. validate_project.py --stage pre-generation --strict를 실행한다. 승인된 provider instruction 원문을 사용할 때는 docs/PROVIDER_ADAPTER.md에 따라 --provider-instruction과 허용된 --provider-amendments를 함께 전달한다.
16. 사용자의 명시적인 생성 승인을 기다린다.
17. 기본 실행기인 ima2-gen을 사용해 실제 runtime, 입력, 출력을 기록한다. 첫 도입이나 입력 변경 시 수행하는 pilot은 실제 전달 확인이 목적이며 매번 소규모 배치만 강제하지 않는다. 승인 후에는 최소 3개 이상의 독립 후보를 생성하고, 연기·표정·액션·공개·분위기가 중요한 구간은 4-6개를 우선한다. 단일 후보는 기술 점검, 명시적 비용 제한, 사용자 직접 요청에만 쓴다.

• 승인된 장수·비용 안에서 단위 시간당 사람이 고를 만한 후보 수를 최우선으로 확보한다. 후보 풀·wave 크기·동시 실행 수를 구별하며, 개별 실패율 상승만으로 소규모 보수 모드로 자동 전환하지 않는다. 실제 시간당 완료량이 과부하로 줄어들 때 제출량을 조절한다. 사용자의 수량·재시도 제한을 우선하고, 성공 원본·요청 식별·늦은 성공 회수를 보존하며, 최종 시각 선택은 사용자에게 맡긴다(docs/PROVIDER_ADAPTER.md, 「대량 병렬 후보 탐색」).
• 현재 승인된 수량·재시도 범위 안에서 개별 작업이 실패하면, 진행 중인 성공 작업을 멈추지 않고 실패한 작업만 다음 파동 맨 앞에 재투입한다. 마지막 파동 뒤에도 남은 실패는 숨기지 않고 명확히 보고한다.

1. 모든 후보를 사용자에게 전달해 시각 판단을 받는다. 사용자가 비평을 요청하지 않으면 파일 수·경로·크기·해시 등 객관 사실만 보고한다.
2. 사람이 선택한 이미지의 구조·연기·캐스트·서사 호흡은 맞지만 식자나 몇 곳의 국소 결함만 남았을 때는 선택적으로 harness/templates/post_selection_page_finish_request.md를 사용할 수 있다. 선택 원본과 해시를 보존하고, 최종 visible text 전체와 라우팅을 다시 적으며, 컷별 국소 수정 사항과 keep list만 지정해 새 후보로 저장한다. 사용자가 기존 글자를 유지하기로 한 결정은 그대로 보존한다. 구조·인과·정체성·fact/MSG 경계나 핵심 연기가 틀렸다면 수정하지 말고 재생성한다.
3. 선택되지 않았거나 대체된 후보는 current에서 분리하되 삭제하지 않는다.
4. 선택된 컷들을 세로 원고로 조립할 때는 각 컷의 크기·정렬과 함께 앞 컷 아래 흰 여백 + 추가 간격 + 다음 컷 위 흰 여백으로 실제 거리를 계산해 목표 거리의 부족분만 더한다(docs/CUT_BASED_PRODUCTION.md, docs/PANELING_AND_PACING.md). 전체 보기본은 별도 보관하고, 커뮤니티 업로드용 파일은 안전한 흰 여백에서 무손실 분할해 번호순으로 전달한다(docs/UPLOAD_DELIVERY.md). 최종 승인 후 freeze_completion.py로 완성본, 승인 원본, 실제 사용 소재를 SHA-256 매니페스트와 함께 동결한다.