# 오늘의 AI 한입 툴 사용 실패 RCA 및 안정 운영 대안

- 작성일: 2026-05-03
- Paperclip 이슈: DAL-14 중심, DAL-10~15 연계
- 진단 원칙: **성공 선언은 산출물 검증 후에만 한다. 실패는 재시도보다 원인 분류가 먼저다.**

## Executive Summary
반복 실패의 본질은 “툴 하나가 나빴다”가 아니라 **검증 없는 자동화 연쇄 실행**입니다. YouTube Studio, TTS, 이미지 생성, CapCut/ffmpeg, Cloudflare, Paperclip, Telegram, Windows/WSL 경로가 각각 다른 실패 모드를 갖는데, 이를 하나의 자동 흐름으로 묶으면서 불확실 상태를 성공처럼 넘긴 문제가 있었습니다.

## 새 운영 원칙
1. API가 있으면 API 우선, 브라우저 자동화는 최후 수단.
2. YouTube 게시/공개/채널 외관 변경은 대표님 승인 전 자동 실행 금지.
3. 각 단계는 입력 확인 → 실행 → 산출물 검증 → 품질 검수 → 승인 → 외부 반영 순서로 진행.
4. AI 이미지에 한글/로고/브랜드 텍스트를 직접 맡기지 않는다. 텍스트는 별도 레이어로 합성.
5. 파일 경로는 WSL 절대경로를 기준으로 통일하고, 필요 시 Windows 접근용 사본을 별도로 만든다.
6. Telegram에는 복잡한 HTML/표를 본문으로 보내지 않고, 요약 + 링크/첨부 방식으로 전달한다.

## 실패 영역별 RCA

### 1. YouTube Studio 브라우저 자동화
- 증상: 버튼 클릭/파일 업로드/크롭 UI/게시 버튼 반영이 불안정.
- 근본원인: YouTube Studio DOM과 로그인/채널 세션이 변동적이며 자동화 친화적 API가 아님.
- 대안: 업로드/메타데이터/썸네일/상태 변경은 YouTube Data API 우선. Studio 자동화는 저위험 보조작업만 1~2회 제한 시도.
- 검증: API 재조회, videoId/visibility/title/thumbnail 상태 확인, private 링크 확인.

### 2. TTS
- 증상: 음성이 정보 낭독처럼 들리고 감정/호흡/강조가 약함.
- 근본원인: 텍스트를 그대로 TTS에 넣고, 화자 캐릭터/문장 길이/쉼표/강조 지시를 별도 설계하지 않음.
- 대안: TTS 전처리, 2개 이상 음성 후보 비교, ffprobe 메타 검증, 청취 QA 후 영상 조립.
- 검증: 길이, 샘플레이트, 무음, 오독, 강조, 피로도 체크.

### 3. 이미지 생성/썸네일
- 증상: 한글/브랜드 텍스트 왜곡, 대략적 삽화 느낌.
- 근본원인: 생성형 이미지에 최종 텍스트/브랜드 정확성을 기대함.
- 대안: AI는 배경/분위기만 생성, 한글 제목/로고는 PIL/HTML/SVG/Canva 등으로 후합성.
- 검증: 모바일 크기 가독성, OCR/육안 텍스트 확인, 승인 로고 원본 사용.

### 4. 영상 조립/CapCut/ffmpeg
- 증상: 싱크/길이/자막/해상도 문제가 뒤늦게 드러남.
- 근본원인: 입력 파일 검증과 15~30초 프리뷰 게이트 없이 최종 렌더링까지 진행.
- 대안: ffprobe 입력 검증 → 30초 프리뷰 → 전체 렌더링 → private 업로드 순서.
- 검증: 해상도, fps, 오디오 코덱, 길이, 자막 잘림, 모바일 시청.

### 5. Cloudflare/대시보드
- 대안: 배포 후 curl HTTP 200 + 키워드 + JSON 유효성 + 대표 deep link 검증.

### 6. Paperclip 에이전트 status error
- 대안: Paperclip은 운영 레코드/역할분담 기준으로 유지하되, 실제 산출물은 Hermes가 검증. status error는 “불확실”로 분류.

### 7. Windows/WSL/Z드라이브 경로
- 대안: 내부 원본은 `/home/jinkidi/...`, 공유/보관은 `/mnt/z/...`, 브라우저 수동 업로드용은 `C:\Users\jinki\...`로 분리 기록.

### 8. Telegram/HTML 첨부 제한
- 대안: HTML은 Cloudflare 링크 또는 zip/txt/pdf로 전달. 본문은 bullet 중심.

## 툴 사용 의사결정표
- YouTube 업로드/메타데이터: Data API 우선, Studio는 수동 확인용.
- TTS: 후보 비교 + 청취 QA 필수.
- 이미지/썸네일: AI 생성 배경 + 별도 텍스트 합성.
- 영상 조립: ffmpeg 자동 프리뷰 + CapCut 수동 polish.
- 대시보드: Cloudflare Pages + curl 검증.
- Paperclip: 역할/이슈/운영기록, 실제 산출물은 별도 검증.

## 중단 기준
- 같은 자동화 경로 2회 실패 시 중단하고 RCA 작성.
- 공개 채널 외관/게시 관련 자동화가 UI 반응 불확실하면 즉시 수동 승인 경로로 전환.
- API 401/403은 재시도보다 인증/권한/scope 확인이 우선.