# task-1269.1 완료 보고서: 토큰 최적화 GREEN 4건 구현

## S - Situation
image_workflow.py와 team_prompts.py에서 토큰 비효율(노하우 전체 로딩, QC 이중 적재, 에스컬레이션 7곳 중복, 서브에이전트 결과 비구조화)이 task-1267.1 집대성에서 GREEN 4건으로 확정되었다.

## C - Complication
GREEN 항목은 퀄리티 위험 제로이나, 프롬프트 토큰 낭비가 매 워크플로우 실행마다 누적된다. 특히 에스컬레이션 섹션이 7곳에 인라인되어 약 ~280토큰/회 중복 소비.

## Q - Question
4건 GREEN 최적화를 기존 테스트 회귀 0건으로 구현할 수 있는가?

## A - Answer
4건 모두 구현 완료. 기존 156개 테스트 회귀 0건 + 신규 25개 테스트 전체 PASS (총 181개).

---

## 구현 상세

### G-1: 선택적 노하우 로딩
- `build_phase_minus1_prompt()`에 `phase_group` 파라미터 추가 (기본값 "final")
- "copy": knowhow-marketing.md + design-qc-knowhow.md (2개)
- "design": knowhow-design.md + design-qc-knowhow.md (2개)
- "final": 3개 전체 (기존 동작, 하위호환)
- 잘못된 값 입력 시 ValueError 발생
- 라우터 함수 `build_image_workflow_prompt()`에서 kwargs로 전달 가능

### G-2: build_workflow_overview_prompt() QC 이중 적재 해결
- `_build_category_a_section()`, `_build_category_b_section()`, `_build_fail_categories_section()`, `_build_escalation_section()` 4개 호출 제거
- "QC 기준(카테고리 A/B, FAIL 사유, 에스컬레이션)은 각 Phase에서 로딩됩니다." 안내 1줄 추가
- `campaign_type` 파라미터는 하위호환 위해 유지 (`_ = campaign_type` 패턴)

### G-3: 에스컬레이션 섹션 중복 제거
- 외부 파일 생성: `/home/jay/workspace/memory/specs/escalation-rules.md`
- 6곳의 `_build_escalation_section()` 인라인 호출을 "에스컬레이션 규칙: memory/specs/escalation-rules.md 참조" 1줄로 교체
- 7번째(overview)는 G-2에서 이미 제거
- `_build_escalation_section()` 함수 자체는 유지 (태스크 지시)

### G-4: Sub-agent 결과 구조화
- `_build_marketing_prompt()`: "## 보고서" 앞에 서브에이전트 결과 규칙 섹션 삽입
- `_build_design_prompt()`: 동일 위치에 삽��
- `_assemble_composite_prompt()`: s8b 변수로 섹션 8과 9 사이에 삽입

---

## 발견 이슈 및 해결

1. **G-2 campaign_type 미사용 경고**: QC 섹션 제거로 파라미터가 미사용 상태 → `_ = campaign_type` 인터페이스 호환 패턴 적용으로 해결
2. **_build_escalation_section not accessed 진단**: 7곳 호출 제거 후 함수 미참조 → 태스크 지시("함수 유지")에 따라 허용 (정보 레벨 진단, 에러 아님)
3. **라우터 함수 phase_group 전달**: `build_image_workflow_prompt`에서 kwargs 경유 전달 가능하도록 서브에이전트가 처리 완료

---

## 산출물 파일

- `/home/jay/workspace/prompts/image_workflow.py` (수정)
- `/home/jay/workspace/prompts/team_prompts.py` (수정)
- `/home/jay/workspace/memory/specs/escalation-rules.md` (신규)
- `/home/jay/workspace/tests/test_token_optimization_green.py` (신규)

## 테스트 결과

- **기존 테스트**: 156/156 PASS (회귀 0건)
- **신규 테스트**: 25/25 PASS
- **총계**: 181/181 PASS (0.28s)

## QC 검증

- **Overall**: PASS (Gate PASS → .done 자동 생성)
- **pyright_check**: PASS — 0 errors, 0 warnings
- **test_runner**: PASS — 111 passed (team_prompts 자동 추론)
- **file_check**: PASS — 4개 파일 모두 존재 및 유효
- **data_integrity**: PASS
- **style_check**: WARN → black/isort 적용 후 해소
- **critical_gap**: PASS
- **spec_compliance**: PASS
- **duplicate_check**: PASS (최대 유사도 8.3%)

총 181개 테스트 PASS (기존 156 + 신규 25), 회귀 0건.