# task-1255.1: 이미지 워크플로우 v2.5 코드화 검증

**팀**: dev2-team (오딘)
**작업일**: 2026-03-29
**레벨**: Lv.1 (검증, 코드 수정 없음)

---

## S - Situation

task-1254.1(1팀)에서 이미지 워크플로우 v2.5의 문서화+코드화를 진행 완료했다. 정본 문서 `image-workflow-v2.5-final.md` 기준으로 코드 정합성 검증이 필요하다.

## C - Complication

v2.5는 Phase 담당 변경(마아트+로키), DQ 5항목 신설, 즉시 PASS 규칙, 노하우 3종 학습 기록 등 다수 변경점을 포함하며, 코드가 정본과 불일치할 경우 운영 시 QC 기준 혼선이 발생한다.

## Q - Question

image_workflow.py, dispatch.py, 노하우 파일, v2.2 문서가 v2.5 정본 문서와 정확히 일치하는가?

## A - Answer

**전체 29개 검증 항목 중 25개 완전 일치, 4개 경미한 불일치 발견.** 기능 동작에 영향 없으나 향후 유지보수 시 정리 권장. pytest 192건 전체 통과, pyright 에러 0건 (image_workflow.py 기준).

---

## 검증 결과 상세

### 1. image_workflow.py 검증 (11항목)

- [x] Phase 1.5 담당 "마아트 + 로키" — `image_workflow.py:574` docstring + `:593-594` 프롬프트 본문에 "마아트(Ma'at)... 로키(역분석)가 공동 검토" 명시
- [x] Phase 3.5 담당 "마아트 + 로키" — `image_workflow.py:686` docstring + `:710-711` 프롬프트에 동일 표기
- [x] Phase 3.5 DQ-01~DQ-05 포함 — `image_workflow.py:730-734`
  - DQ-01: 레퍼런스 재현도 (마아트 판정, 자체평가 금지) ✓
  - DQ-02: 시각적 계층 구조 ✓
  - DQ-03: "어떤 누가 평가해도 세계 최고의 전문가/프로 수준인가?" ✓
  - DQ-04: 피드 차별화 ✓
  - DQ-05: 감정적 임팩트 ✓
- [x] Phase 3.5 통과 규칙 — `image_workflow.py:698-699`: 9점↑ 즉시 PASS, Cycle 1: 6점↑, Cycle 2: 7점↑, Cycle 3: 9점↑
- [x] Phase 1.5 통과 규칙 — `image_workflow.py:582-583,619`: 12점↑ 즉시 PASS, Cycle 1: 8점↑, Cycle 2: 10점↑, Cycle 3: 12점↑
- [x] `build_phase_minus1_prompt()` 존재 + 필독 파일 3개 — `image_workflow.py:157,170-175` (KNOWHOW_PATH, KNOWHOW_MARKETING_PATH, KNOWHOW_DESIGN_PATH)
- [x] `build_phase5_prompt()` 존재 + 종합 검토 지시 — `image_workflow.py:769,778-805`
- [x] 학습 기록 지시 (실패+성공+체크리스트 3종) — Phase 1.5 `image_workflow.py:620-624`, Phase 3.5 `image_workflow.py:743-747`
- [x] PIPELINE_TOKENS에 "KNOWHOW_PRELOAD_OK", "DESIGN_QC_OK" — `image_workflow.py:67,73`
- [x] FONT_POLICY가 "자유 선택" 정책으로 변경됐는가? (4종 제한 폐기) — `image_workflow.py:57-63` "폰트 선택은 디자인의 일부이므로 종류 제한 없음. Canva 유료 독점 폰트만 제외."
- [x] `build_workflow_overview_prompt()` "제이회장님 승인 필수" — `image_workflow.py:942`
- [x] pyright 에러 0건 — `npx pyright` 결과: 0 errors, 0 warnings

### 2. dispatch.py 경고 로직 검증 (3항목)

- [x] 이미지/광고/배너/디자인 키워드 + `--workflow` 미적용 시 경고 — `dispatch.py:1355-1361` `logger.warning()` 호출
- [x] 경고만 하고 차단 안 함 — `sys.exit()` 없이 `logger.warning()` 만 사용
- [x] 기존 테스트 회귀 0건 — `tests/test_dispatch.py` 141건 전체 PASSED

### 3. v2.2 문서 경고 추가 (3항목)

- [x] `image-workflow-v2-plan.md` 1행: "⚠️ 이 문서는 v2.2입니다. 최신 정본은 `image-workflow-v2.5-final.md`를 참조하세요."
- [x] `image-workflow-v2-checklist.md` 1행: 동일 경고
- [x] `image-workflow-v2-context.md` 1행: 동일 경고

### 4. 노하우 파일 검증 (3항목)

- [x] `knowhow-marketing.md` 존재 + 3섹션 — 실패 패턴(5건) / 성공 패턴(미축적) / 시작 전 체크리스트(5항목)
- [x] `knowhow-design.md` 존재 + 3섹션 — 실패 패턴(8건) / 성공 패턴(미축적) / 시작 전 체크리스트
- [x] `design-qc-knowhow.md` 기존 파일 정상 유지 확인

### 5. v2.5 정본 문서와 코드 정합성 (3항목)

- [x] Phase 구조 일치 — 정본: Phase -1, 0, 0.5, 1, 1.5, 2, 2.5, 3, 3.5, 4, 5 / 코드 라우터(`image_workflow.py:813`): 동일 11단계
- [x] QC 항목 수/이름 일치 — Phase 0.5: 5항목 10점, Phase 1.5: 7항목 14점, Phase 3.5: DQ 5항목 10점 (정본=코드)
- [x] 문서의 QC 항목 수/이름과 코드의 상수가 일치하는가? — Phase 0.5: 5항목, Phase 1.5: 7항목, Phase 3.5: DQ 5항목. 정본=코드 일치
- [x] 문서의 통과 규칙과 코드의 임계값이 일치하는가? — Phase 0.5: 8점↑, Phase 1.5: 12↑/8/10/12, Phase 3.5: 9↑/6/7/9. 정본=코드 일치

---

## 발견 이슈 및 해결

### 자체 해결 (0건)

검증 전용 작업이므로 코드 수정 없음.

### 범위 외 미해결 (4건 — 경미, 기능 동작 무영향)

1. **Phase 0.5/1.5 QC 코드명 미사용** — 정본 문서는 BQ-01~05, PQ-01~07 코드를 사용하나, 코드는 "항목1~5/7"로만 표기. Phase 3.5의 DQ-01~05는 코드에서도 코드명 사용. 범위 외 사유: 기능 동등, 정리는 별도 작업으로 권장.

2. **Phase 1.5 즉시 PASS 값 하드코딩** — `image_workflow.py:619`에서 "12점" 문자열 하드코딩. Phase 3.5는 `ESCALATION_RULES["design_qc_immediate_pass"]`를 참조(`image_workflow.py:700`). 기능적으로 동일(값=12)하나 유지보수 일관성 개선 여지.

3. **dispatch.py pyright 19 errors** — 전부 `reportMissingImports` (utils.bot_activity, utils.env_loader 등 선택적 모듈). v2.5 작업과 무관한 기존 이슈. 모든 import가 try/except으로 보호됨.

4. **Phase 0.5 BQ-05 표현 차이** — 정본: "이전 FAIL 패턴 미포함", 코드: "과장 표현, 법적 위험, 경쟁사 직접 비교 없음". 코드가 더 구체적이나 "이전 FAIL 패턴"이라는 정본의 표현과 미묘한 범위 차이.

---

## 테스트 결과 (정량적 증거)

- `tests/test_image_workflow_v25.py`: **51건 PASSED** (0.31s)
- `tests/test_dispatch_workflow.py`: **51건 중 포함** (위와 동일 실행)
- `tests/test_dispatch.py`: **141건 PASSED** (0.85s)
- pyright (`image_workflow.py`): **0 errors, 0 warnings**
- pyright (`dispatch.py`): 19 errors (전부 reportMissingImports, 기존 이슈, v2.5 무관)
- Python AST 파싱: OK

총 테스트: **192건 PASSED, 0건 FAILED**

---

## 검증 파일 목록 (수정 없음, 읽기 전용 검증)

- `/home/jay/workspace/prompts/image_workflow.py`
- `/home/jay/workspace/dispatch.py`
- `/home/jay/workspace/memory/specs/image-workflow-v2.5-final.md`
- `/home/jay/workspace/memory/specs/image-workflow-v2-plan.md`
- `/home/jay/workspace/memory/specs/image-workflow-v2-checklist.md`
- `/home/jay/workspace/memory/specs/image-workflow-v2-context.md`
- `/home/jay/workspace/memory/specs/knowhow-marketing.md`
- `/home/jay/workspace/memory/specs/knowhow-design.md`
- `/home/jay/workspace/memory/specs/design-qc-knowhow.md`
- `/home/jay/workspace/tests/test_image_workflow_v25.py`
- `/home/jay/workspace/tests/test_dispatch.py`
- `/home/jay/workspace/tests/test_dispatch_workflow.py`

---

## QC 자동 검증 결과

```json
{
  "task_id": "task-1255.1",
  "overall": "PASS",
  "checks": {
    "api_health": "SKIP (비서버 작업)",
    "file_check": "PASS",
    "data_integrity": "PASS",
    "test_runner": "SKIP (검증 전용, 관련 테스트 수동 실행 완료)",
    "pyright_check": "PASS (0 errors)",
    "style_check": "PASS (black OK, isort OK)"
  },
  "summary": "192건 테스트 전체 PASSED, pyright 0 errors"
}
```