# task-1254.1 완료 보고서: 이미지 워크플로우 v2.5 문서화 + 코드화

**팀**: dev1-team (헤르메스)
**레벨**: Lv.2
**일시**: 2026-03-29

---

## SCQA

**S**: 이미지 제작 QC 게이트 워크플로우가 v2.2에서 v2.5로 업그레이드되었으며, 제이회장님 7개 피드백 + 노하우 학습 시스템 + 디자인 QC 3사이클이 반영된 최종안(`image-workflow-v2.5-final.md`)이 확정되었다.

**C**: 기존 `image_workflow.py` 코드와 관련 문서가 v2.2 기준이어서, Phase 1.5/3.5 QC 담당자(마아트+아마테라스), Phase -1/5 부재, DQ 항목 미구현, 학습 기록 시스템 미반영 등 v2.5 사양과 불일치 상태였다.

**Q**: image_workflow.py, dispatch.py, v2.2 문서를 v2.5 최종안에 맞게 업데이트하여 pyright 에러 0건, 기존 테스트 회귀 0건을 달성할 수 있는가?

**A**: 8개 주요 변경 완료. 신규 함수 3개(build_phase_minus1_prompt, build_phase3_5_prompt, build_phase5_prompt) 추가, Phase 1.5 담당자/항목 변경, PIPELINE_TOKENS/ESCALATION_RULES 업데이트, dispatch.py 경고 로직 추가, v2.2 문서 3개에 deprecation 경고 삽입. pytest 51건 전체 통과(기존 17건 + 신규 34건), pyright 에러 0건.

---

## 작업 내용

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

- **Phase 1.5 QC 담당 변경**: "마아트+아마테라스" → "마아트+로키" (3자 평가), 항목4/7 텍스트 "아마테라스" → "로키"
- **Phase 1.5 항목7 변경**: "사이클 목적 부합" → "세계 최고 전문가/프로 수준 (PQ-07)"
- **Phase 1.5 학습 기록 추가**: 실패/성공/체크리스트 3종 → knowhow-marketing.md
- **Phase 1.5 즉시 PASS**: 12점 이상 = 어떤 사이클이든 즉시 PASS
- **Phase 3.5 신규 함수**: `build_phase3_5_prompt()` — DQ-01~DQ-05, 사이클별 임계값(6/7/9점), 9점↑ 즉시 PASS, 학습 기록 → knowhow-design.md
- **Phase -1 신규 함수**: `build_phase_minus1_prompt()` — 3개 노하우 파일 필독, KNOWHOW_PRELOAD_OK 토큰
- **Phase 5 신규 함수**: `build_phase5_prompt()` — 종합 검토 + 누락 보충 + 교차 인사이트
- **PIPELINE_TOKENS**: KNOWHOW_PRELOAD_OK (Phase -1), DESIGN_QC_OK (Phase 3.5) 추가
- **ESCALATION_RULES**: plan_qc_immediate_pass=12, design_qc_immediate_pass=9 추가
- **build_workflow_overview_prompt**: 시작 조건("제이회장님 승인 필수") + Phase -1~5 전체 목록
- **build_image_workflow_prompt 라우터**: Phase -1, 3.5, 5 분기 추가

### 2. dispatch.py 경고 로직

- task_desc에 "이미지"/"광고"/"배너"/"디자인" 키워드 + `--workflow` 미사용 시 logger.warning 출력
- 차단하지 않음 (아누 판단에 맡김)

### 3. v2.2 문서 deprecation 경고

- 3개 파일 상단에 `> ⚠️ 이 문서는 v2.2입니다. 최신 정본은 image-workflow-v2.5-final.md를 참조하세요.` 추가

---

## 산출물 파일 목록

- `/home/jay/workspace/prompts/image_workflow.py` (수정)
- `/home/jay/workspace/dispatch.py` (수정)
- `/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/tests/test_image_workflow_v25.py` (신규)

---

## 테스트 결과

- pytest: **51건 전체 통과** (0.32s)
  - 기존 test_dispatch_workflow.py: 17 PASS (회귀 0건)
  - 신규 test_image_workflow_v25.py: 34 PASS
- 기존 test_dispatch.py: 141 PASS (QC test_runner에서 확인)
- pyright: 에러 0건, 경고 0건

---

## 발견 이슈 및 해결

### 자체 해결 (3건)

1. **Phase 1.5 항목4/검증결과에 "아마테라스" 잔존** — 불칸 서브에이전트가 항목4 판정기준과 검증결과 출력 형식의 "아마테라스"를 누락. 팀장이 직접 Edit으로 "로키"로 교체 (`image_workflow.py:606`, `image_workflow.py:627`)
2. **black/isort 포매팅 불일치** — 신규 코드가 black 기준 미준수. `black + isort` 실행으로 3개 파일 포매팅 완료
3. **KNOWHOW 경로 상수 누락** — 기존 KNOWHOW_PATH만 있고 marketing/design 경로 없음. KNOWHOW_MARKETING_PATH, KNOWHOW_DESIGN_PATH 상수 추가

---

## 검증 항목 체크

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

---

## QC 자동 검증 결과

```json
{
  "pyright_check": "PASS (0 errors, 0 warnings)",
  "test_runner": "PASS (141 passed in 0.77s)",
  "data_integrity": "PASS",
  "style_check": "PASS (black+isort 적용 완료)",
  "spec_compliance": "PASS"
}
```