# 이미지 워크플로우 v2.5 문서화 + 코드화

## 레벨: Lv.2
## 한정승인: 끝까지 진행

---

## 배경

이미지 제작 QC 게이트 워크플로우가 v2.2에서 v2.5로 업그레이드되었다.
제이회장님 7개 피드백 + 노하우 학습 시스템 + 디자인 QC 3사이클이 반영된 최종안이다.
문서와 코드를 v2.5에 맞게 업데이트해야 한다.

**최종안 문서**: `/home/jay/workspace/memory/specs/image-workflow-v2.5-final.md` ← 이 파일이 정본. 반드시 먼저 읽을 것.

---

## 작업 내용

### 1. image_workflow.py 코드 업데이트

파일: `/home/jay/workspace/prompts/image_workflow.py`

**변경 사항:**

#### a. Phase 1.5 QC 담당 변경
- 기존: 마아트 + 아마테라스
- 변경: **마아트 + 로키** (3자 평가, 만든 팀 ≠ 평가 팀)
- `build_phase1_5_prompt()` 함수에서 담당자 텍스트 수정

#### b. Phase 3.5 QC 담당 변경 (Phase 1.5와 동일 구조)
- 기존: 마아트 단독
- 변경: **마아트 + 로키** (Phase 1.5와 동일)
- `build_phase3_5_prompt()` 함수(있으면 수정, 없으면 생성)에서 담당자 텍스트 수정

#### c. 디자인 퀄리티 QC 항목 추가
- Phase 3.5 프롬프트에 DQ-01~DQ-05 항목 포함:
  - DQ-01: 레퍼런스 재현도 (마아트 판정, 자체평가 금지)
  - DQ-02: 시각적 계층 구조
  - DQ-03: "어떤 누가 평가해도 세계 최고의 전문가/프로 수준인가?"
  - DQ-04: 피드 차별화
  - DQ-05: 감정적 임팩트
- 통과 규칙: 9점↑ 즉시 PASS, Cycle 1: 6점↑, Cycle 2: 7점↑, Cycle 3: 9점↑

#### d. 학습 기록 프롬프트 추가
- Phase 1.5, Phase 3.5 프롬프트에 학습 기록 지시 포함:
  - 실패 패턴: "이건 해서 점수 떨어졌다"
  - 성공 패턴: "이렇게 개선했더니 올랐다"
  - 시작 전 체크리스트: 반복 FAIL 항목 추가
- 기록 대상 파일: knowhow-marketing.md (Phase 1.5) / knowhow-design.md (Phase 3.5)

#### e. Phase -1 노하우 프리로딩 프롬프트
- `build_phase_minus1_prompt()` 함수 신규 생성
- 필독 파일 3개 경로 포함: design-qc-knowhow.md, knowhow-marketing.md, knowhow-design.md
- 노하우 핵심 요약 기재 요구

#### f. Phase 5 노하우 종합 검토 프롬프트
- `build_phase5_prompt()` 함수 신규 생성
- Phase 1.5/3.5 학습 기록 종합 검토 + 누락 보충 + Phase 간 교차 인사이트

#### g. 사이클 즉시 PASS 규칙
- 기획 QC: 12점 이상 = 즉시 PASS
- 디자인 QC: 9점 이상 = 즉시 PASS
- ESCALATION_RULES 또는 별도 상수로 정의

#### h. 시작 조건 텍스트
- `build_workflow_overview_prompt()`에 "제이회장님 승인 필수" 시작 조건 포함

### 2. 기존 v2.2 문서 정리

- `/home/jay/workspace/memory/specs/image-workflow-v2-plan.md` 파일 상단에 "⚠️ 이 문서는 v2.2입니다. 최신 정본은 image-workflow-v2.5-final.md를 참조하세요." 경고 추가
- `/home/jay/workspace/memory/specs/image-workflow-v2-checklist.md` 동일 경고 추가
- `/home/jay/workspace/memory/specs/image-workflow-v2-context.md` 동일 경고 추가

### 3. dispatch.py 경고 로직 추가

- task_desc에 "이미지", "광고", "배너", "디자인" 키워드가 있고 `--workflow` 옵션이 없으면:
  - 경고 로그 출력: "⚠️ 이미지/광고 작업인데 --workflow image-qc-gate가 미적용됩니다. 제이회장님 승인 확인 필요."
  - 차단하지는 않음 (아누 판단에 맡김)

### 4. PIPELINE_TOKENS 업데이트

image_workflow.py의 PIPELINE_TOKENS 리스트에 추가:
- "KNOWHOW_PRELOAD_OK" — Phase -1 완료
- "DESIGN_QC_OK" — Phase 3.5 완료

---

## 참고 파일
- v2.5 최종안 (정본): `/home/jay/workspace/memory/specs/image-workflow-v2.5-final.md`
- 현재 코드: `/home/jay/workspace/prompts/image_workflow.py`
- dispatch.py: `/home/jay/workspace/dispatch.py`
- 노하우 파일들:
  - `/home/jay/workspace/memory/specs/design-qc-knowhow.md`
  - `/home/jay/workspace/memory/specs/knowhow-marketing.md`
  - `/home/jay/workspace/memory/specs/knowhow-design.md`

## 검증
- image_workflow.py: Phase 1.5/3.5 담당이 "마아트+로키"인지 확인
- Phase 3.5에 DQ-01~DQ-05 항목 + 사이클별 임계값 포함 확인
- build_phase_minus1_prompt(), build_phase5_prompt() 함수 존재 확인
- 학습 기록 지시(실패+성공+체크리스트 3종)가 Phase 1.5, 3.5에 포함 확인
- dispatch.py 경고 로직 작동 확인
- 기존 v2.2 문서에 경고 추가 확인
- pyright 에러 0건
- 기존 테스트 회귀 0건