# task-1421.1 완료 보고서: 디자인팀 워크플로우 PNG 렌더링 필수 게이트 추가

**S**: 디자인팀 이미지 제작 워크플로우(image_workflow.py)와 hybrid-image 스킬을 통해 HTML 배너를 생성하고 Playwright로 PNG 렌더링하는 파이프라인이 운영 중이다.

**C**: task-1415.1에서 디자인팀이 HTML 템플릿만 생성하고 PNG 렌더링을 수행하지 않은 채 완료 보고하는 프로세스 누락이 발생했다. 워크플로우, QC 체크리스트, 스킬 문서 모두에 "최종 산출물 = PNG" 검증 단계가 없어 강제할 수 없었다.

**Q**: 디자인팀 워크플로우 전반에 PNG 렌더링 필수 게이트를 추가하여 HTML만 생성하고 PNG 없이 완료 보고하는 것을 방지할 수 있는가?

**A**: 5개 파일에 PNG 렌더링 필수 게이트를 추가하여 다중 방어 체계를 구축했다. (1) design.md에 프로세스 규칙 추가, (2) QC-RULES.md에 셀프 QC 항목 9 신설, (3) image_workflow.py Phase 3 완료 기준에 PNG 필수 조건 추가, (4) hybrid-image SKILL.md에 렌더링 강제 힌트 추가, (5) qc_verify.py에 png_check verifier 신규 추가로 자동 검증 가능. 총 5개 파일 수정, 1개 파일 신규 생성.

---

## 수정/생성 파일 목록

1. `/home/jay/workspace/prompts/teams/design.md` — PNG 렌더링 필수 게이트 섹션 + 체크리스트 추가
2. `/home/jay/workspace/teams/shared/QC-RULES.md` — 셀프 QC 항목 9 신설 + 변경이력 v3.7 추가
3. `/home/jay/workspace/prompts/image_workflow.py` — Phase 3 작업절차(5단계→6단계) + 완료기준에 PNG 필수 3항목 추가
4. `/home/jay/.claude/skills/hybrid-image/SKILL.md` — PNG 렌더링 필수 섹션 + 품질 체크리스트 항목 추가
5. `/home/jay/workspace/teams/dev6/qc/verifiers/png_check.py` — 신규 생성 (HTML↔PNG 대응 검증 verifier)
6. `/home/jay/workspace/teams/dev6/qc/qc_verify.py` — png_check import + ALL_CHECKS 등록 + run_check 분기 추가

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **shared/qc_verify.py 미존재** — 작업 지시의 shared 경로에 qc_verify.py가 없음. dev6팀 자체 qc_verify.py (`teams/dev6/qc/qc_verify.py`)에 png_check verifier를 추가하여 해결
2. **image_workflow.py 작업절차 번호 재조정** — PNG 렌더링 단계(5번) 삽입으로 기존 5번을 6번으로 밀어야 함. 정상 반영 완료
3. **pyright 경고: _dirs 미사용** — png_check.py의 os.walk 반환값 중 dirs를 `_dirs`로 명명하여 미사용 의도를 명시. Python 관례이므로 수정 불필요 (Suppression 목록 항목 5 해당)

### 범위 외 미해결 (0건)
없음.

## 테스트 결과

- png_check verifier: 3개 경로 (SKIP/SKIP/PASS·FAIL) 로직 코드 리뷰 완료
- 기존 verifier 영향 없음: png_check는 ALL_CHECKS 끝에 추가되어 기존 순서 무영향
- image_workflow.py: Python 문법 오류 없음 (f-string 구조 유지)
- 이미지 작업이 아닌 일반 태스크에서는 output_dir 미존재로 SKIP 처리되어 기존 QC 플로우 무영향

## 모델 사용 기록

- 팀원: 스바로그 / 작업: image_workflow.py + qc_verify.py + png_check.py 수정 / 사용 모델: sonnet
- 팀원: 모코시 / 작업: design.md + QC-RULES.md + SKILL.md 문서 수정 / 사용 모델: sonnet