본문으로 건너뛰기

구현 체크리스트 — 새 콘텐츠 생성 시스템 구축 시

새 AI 콘텐츠 생성 시스템을 만들 때 그때그때 생각나는 대로의 누락을 막는 점검표입니다. 순서대로 진행하고, 미적용 항목은 "왜 생략했는지" 기록해 두면 다음 시스템에서 같은 누락을 막을 수 있습니다.

배경 개념은 방법론 개요를 참고하세요.

A. 분류 먼저 (무엇을 만드나)​

  • 산출물이 텍스트인가 **시각·순차(이미지/음성)**인가?
    • 텍스트 → 조합 프롬프트로 말단 독립(상태 기계 불요)
    • 시각·순차 → 일관성 상태(정본·드리프트) 필요
  • commodity 식별: 파일 변환 → 변환 서비스 / 생성·요약 → AI / 도메인 의미 → 프로젝트. 직접 만들지 말 것.

B. 계층 프롬프트 (망각 방지 = 설계 단계에서)​

  • 전역 → 중간 → 말단 계층 스코프를 정의하고 단계별 프롬프트를 저장(+버전).
  • 말단이 조합 프롬프트(composed prompt)로 self-contained 한지 확인(세션 독립·재현 가능).
  • 출력 스키마·검수 규칙을 공통 footer로 자동 부착.

C. 작업 관리 (장기·다세션)​

  • worklist: 다음 작업 도출 + 진행률 집계.
  • 멱등 ingest: 재실행해도 중복 생성 없음, 검수 완료본 덮어쓰기 금지.
  • claim/lease: 여러 세션이 같은 단위를 중복 작업하지 않도록 점유 관리.
  • 의존성 게이트: 선행 단계 없이 다음 단계 실행 금지.
  • lineage: (프롬프트 버전 × 모델 × 입력) → 산출물 기록 — 재현·감사.

D. 일관성 (시각·순차 콘텐츠만)​

  • 정본(canonical) 관리: (엔티티 × 스타일 × 변형) 기준 "현재 정본" + 버전·롤백.
  • 컨텍스트 선별: 이전 등장·직전 회차·정본을, 레퍼런스 개수 한계 안에서 우선순위로 주입.
  • 드리프트 측정: 임베딩 유사도 등으로 정본 이탈 점수화 → 정본 승격 게이트 + 재기준(re-anchor).

E. 다국어·라이선스·검수​

  • 사용자 콘텐츠 다국어 저장({locale: value} + 폴백).
  • 출처·라이선스·AI 생성 표기(특히 외부 자료, 외부 공급 시 필수).
  • 검수 상태 흐름(초안 → 검토 → 승인) + 검수 메모.

F. 실행자·표면​

  • 실행을 직접 / 위임 에이전트 / 직접 API 중 무엇으로 할지 결정(품질 = 에이전트, 스케일 = API).
  • 모니터링용 경량 화면(진행률·검수 큐)을 필요 시 제공.

G. 자가 개선​

  • 작업 중 발견한 지침 개선을 저위험은 즉시 반영 / 고위험은 승인 게이트 + 버전으로 관리.

이 체크리스트는 도구·프레임워크 중립적입니다. 텍스트 콘텐츠라면 A·B·C·E·F·G만으로 충분하고, 시각·순차 콘텐츠라면 D(일관성 상태)가 추가됩니다.