# 노하우 피드백 루프 강제화: QC 결과 → 노하우 파일 자동 환류

## 배경
로키 QC(Phase 3.5)가 평가는 수행하지만 결과를 노하우 파일에 기록하지 않고 있음. knowhow-design.md가 3일째 업데이트 안 됨. 프롬프트에 "기록하세요"라고 텍스트 지시만 있고 강제 메커니즘 없음.

**목표**: 로키 QC 결과가 반드시 노하우 파일에 반영되고, 다음 작업 시 팀이 이를 읽고 시작하여 1회 통과율을 높임.

## 변경 사항

### 1. Phase 3.5 (디자인 QC) — 노하우 업데이트 강제

파일: `/home/jay/workspace/prompts/image_workflow.py`
Phase 3.5 함수 내 "학습 기록" 섹션 강화:

**기존** (텍스트 지시만):
```
## 학습 기록 (매 사이클 반드시 수행)
아래 항목을 knowhow-design.md에 즉시 기록하세요
```

**변경** (검증 가능한 강제 규칙):
```
## 학습 기록 (PASS/FAIL 무관 필수 — 미수행 시 .done 발급 불가)

### 기록 대상 파일
1. `{KNOWHOW_DESIGN_PATH}` — 디자인 성공/실패 패턴
2. `{KNOWHOW_PATH}` — QC 성공/실패 패턴

### 필수 기록 항목
각 배너별로:
- 실패 패턴: "이건 해서 점수 떨어졌다" (구체적 행동 + DQ 항목 + 감점 점수)
- 성공 패턴: "이렇게 개선했더니 올랐다" (구체적 행동 + DQ 항목 + 점수 변화)
- 체크리스트 추가: 반복 FAIL 항목을 체크리스트에 추가

### 검증 규칙
보고서에 아래 섹션 필수 포함:
## 노하우 업데이트 기록
- knowhow-design.md: 추가 패턴 N건 (성공 X건, 실패 Y건)
- design-qc-knowhow.md: 추가 패턴 N건
- 체크리스트 추가: N항목

이 섹션이 없거나 "0건"이면 보고서 불합격 처리.
```

### 2. Phase -1 (노하우 프리로딩) — freshness 체크 추가

Phase -1 함수에 아래 규칙 추가:
```
## 노하우 freshness 확인
노하우 파일을 읽은 후, 파일 마지막 수정일을 확인하세요.
- 7일 이상 경과: ⚠️ 경고 — "노하우가 오래됐습니다. 최근 QC 결과가 미반영일 수 있습니다."
- 보고서에 "노하우 최종 수정일: YYYY-MM-DD" 명시
```

### 3. 마케팅팀 노하우도 동일 적용

Phase 1.5 (기획 QC) + Phase 2 (카피 QC)에도 동일 패턴 적용:
- QC 후 `knowhow-marketing.md` 업데이트 강제
- 보고서에 "노하우 업데이트 기록" 섹션 필수

### 4. LOGICAL-TEAM-WORKFLOW.md에 노하우 읽기 규칙 추가

파일: `/home/jay/workspace/prompts/LOGICAL-TEAM-WORKFLOW.md`
워크플로우 섹션에 추가:
```
## 노하우 읽기 규칙 (디자인/마케팅 작업 필수)
디자인 또는 마케팅 관련 작업 시작 전 반드시 아래 파일을 읽으세요:
- 디자인 작업: {WORKSPACE_ROOT}/memory/specs/knowhow-design.md + design-qc-knowhow.md
- 마케팅 작업: {WORKSPACE_ROOT}/memory/specs/knowhow-marketing.md
목표: 과거 실수를 반복하지 않고 1회 QC 통과
```

### 5. 팀 카드 파일에 노하우 참조 추가

`prompts/teams/design.md`에 추가:
```
## 필수 프리로딩 (작업 시작 전)
- 디자인 노하우: {WORKSPACE_ROOT}/memory/specs/knowhow-design.md
- QC 노하우: {WORKSPACE_ROOT}/memory/specs/design-qc-knowhow.md
→ 과거 실패 패턴을 숙지하고 작업 시작. 1회 QC 통과 목표.
```

`prompts/teams/marketing.md`에 추가:
```
## 필수 프리로딩 (작업 시작 전)
- 마케팅 노하우: {WORKSPACE_ROOT}/memory/specs/knowhow-marketing.md
→ 과거 실패 패턴을 숙지하고 작업 시작. 1회 QC 통과 목표.
```

## 테스트
```bash
cd /home/jay/workspace && python3 -m pytest tests/ -k "image_workflow or team_prompts" -v
```

## 변경 대상 파일
- 수정: `prompts/image_workflow.py` (Phase 3.5 학습 기록 강화, Phase -1 freshness 체크)
- 수정: `prompts/LOGICAL-TEAM-WORKFLOW.md` (노하우 읽기 규칙 추가)
- 수정: `prompts/teams/design.md` (필수 프리로딩 섹션 추가)
- 수정: `prompts/teams/marketing.md` (필수 프리로딩 섹션 추가)

## 절대 변경 금지
- DQ 10항목 100점 체계 (task-1328.1에서 작업 중)
- Phase 3.5 로키 단독 설정
- dispatch.py, team_prompts.py