# task-1329.1 완료 보고서: 노하우 피드백 루프 강제화

## SCQA

**S**: 이미지 제작 QC 워크플로우(image_workflow.py)에서 Phase 3.5 로키 QC가 평가를 수행하지만, 결과를 노하우 파일에 기록하지 않고 있다. knowhow-design.md가 3일째 업데이트 안 됨.

**C**: 프롬프트에 "기록하세요"라는 텍스트 지시만 있고 강제 메커니즘이 없어, QC 결과가 노하우 파일에 반영되지 않는다. 이로 인해 다음 작업 시 과거 실수가 반복되고 1회 QC 통과율이 낮아진다.

**Q**: QC 결과를 노하우 파일에 강제 반영하고, 다음 작업 시 팀이 이를 읽고 시작하도록 시스템을 개선할 수 있는가?

**A**: 4개 파일에 6가지 변경을 적용하여 노하우 피드백 루프를 강제화했다. (1) Phase 3.5/1.5/2의 학습 기록 섹션을 "검증 가능한 강제 규칙"으로 강화 — 기록 대상 파일 2개 명시, 검증 규칙 추가, "0건이면 보고서 불합격" 처리. (2) Phase -1에 노하우 freshness 체크 추가 — 7일 경과 시 경고. (3) LOGICAL-TEAM-WORKFLOW.md에 노하우 읽기 규칙 추가. (4) design.md/marketing.md에 필수 프리로딩 섹션 추가. pytest 170건 통과, 1건 기존 실패(본 작업 범위 외).

## 변경 내역

### 수정 파일
- `/home/jay/workspace/prompts/image_workflow.py`
  - Phase 3.5 (line 838-855): 학습 기록 → 강제 검증 규칙으로 강화 (KNOWHOW_DESIGN_PATH + KNOWHOW_PATH 2파일, DQ 항목 + 감점 점수 명시, 보고서 검증 규칙)
  - Phase -1 (line 220-223): 노하우 freshness 확인 섹션 추가 (7일 경과 경고, 최종 수정일 명시)
  - Phase 1.5 (line 697-714): 학습 기록 → 강제 검증 규칙으로 강화 (KNOWHOW_MARKETING_PATH + KNOWHOW_PATH 2파일, PQ 항목 + 감점 점수 명시)
  - Phase 2 (line 405-422): 학습 기록 섹션 신규 추가 (기존에 없었음, B 항목 + 감점 점수 명시)
- `/home/jay/workspace/prompts/LOGICAL-TEAM-WORKFLOW.md` (line 116-120): 노하우 읽기 규칙 섹션 추가
- `/home/jay/workspace/prompts/teams/design.md` (line 31-34): 필수 프리로딩 섹션 추가
- `/home/jay/workspace/prompts/teams/marketing.md` (line 34-36): 필수 프리로딩 섹션 추가

## 테스트 결과
- `python3 -m pytest tests/ -k "image_workflow or team_prompts"`: **170 passed, 1 failed**
- 실패 테스트: `TestDispatchWarning::test_warning_logic_exists` — dispatch.py 관련, 본 작업 범위 외 기존 실패
- Python import 검증: `import prompts.image_workflow` 성공

## 발견 이슈 및 해결

### 자체 해결 (1건)
1. **Phase 2에 학습 기록 섹션 부재** — 태스크 지시에 따라 Phase 2 카피 QC에도 학습 기록 강제 섹션을 신규 추가함

### 범위 외 미해결 (1건)
1. **⚠️ 기존 테스트 실패 1건 (본 작업 범위 외)**: `TestDispatchWarning::test_warning_logic_exists` — dispatch.py 관련 테스트, 본 작업에서 dispatch.py는 변경 금지 대상

## 셀프 QC (8항목)
- [x] 1. 영향 파일: 함수 시그니처 불변, 반환 문자열 내용만 변경 → 영향 없음
- [x] 2. 엣지 케이스: f-string 내 중첩 코드블록, 따옴표 이스케이프 정상 처리 확인
- [x] 3. 작업 지시 일치: 5개 변경 사항 정확히 구현
- [x] 4. 에러 처리/보안: 프롬프트 문자열 변경만, 보안 이슈 해당 없음
- [x] 5. 테스트 커버리지: 170/171 통과 (1건 기존 실패)
- [x] 6. 이슈 자체 해결: Phase 2 학습 기록 부재 → 추가 완료
- [x] 7. 코드 아키텍처: 기존 f-string 프롬프트 패턴 유지, SOLID/DRY 위반 없음
- [x] 8. 인터페이스 변경 없음: 함수 시그니처 불변

## 모델 사용 기록
- 팀원: 토르 / 작업 내용: image_workflow.py 4개 Phase 수정 / 사용 모델: sonnet
- 팀원: 프레이야 / 작업 내용: 마크다운 파일 3개 수정 / 사용 모델: sonnet