# task-628.2 완료 보고서 — ThreadAuto 5단계 파이프라인 사전 준비물 구축 + 프롬프트 고도화

**S**: ThreadAuto 5단계 파이프라인(task-628.1)이 기본 구조로 구현되어 41건 테스트 통과 상태로 운영 중이다. 프롬프트 템플릿 5종과 pipeline_prompts.py 로더가 정상 동작한다.

**C**: 원본 프롬프트(@ai__frontier)에서 정의한 사전 준비물 3종(MASTER_BRIEF, HOOK_BANK, LOGIC_MAP)이 미구현되어, 프롬프트에 브랜드 톤/후킹 레퍼런스/논리 근거가 주입되지 않는 상태이다. 또한 01_angle, 04_hooking, 05_review의 출력 구조가 원본 대비 단순화되어 있다.

**Q**: 사전 준비물 3종 데이터를 구축하고 프롬프트 출력 구조를 원본 수준으로 고도화하여, AI 콘텐츠 품질을 개선할 수 있는가?

**A**: 사전 준비물 3종(master_brief.json, hook_bank.json, logic_map.json) 구축 완료. pipeline_prompts.py에 로딩/주입 로직 추가. 프롬프트 3종 고도화(각도 7필드, 후킹 5대안+CTA/댓글/인용, 검수 7대 항목). pytest 70건 전체 통과, pyright 0 errors.

---

## 생성/수정 파일 목록

### 신규 생성 (3건)
- `/home/jay/projects/ThreadAuto/data/master_brief.json` — 브랜드 2종(서울대보험쌤/서울대연금쌤) 톤/대상/목적/금지표현
- `/home/jay/projects/ThreadAuto/data/hook_bank.json` — 후킹 문구 12종, 5기법 × 5카테고리 분류, 성과 축적 구조
- `/home/jay/projects/ThreadAuto/data/logic_map.json` — 6주제(수수료/자유도/성장/이직절차/정착지원/AI마케팅) 논리구조

### 수정 (4건)
- `/home/jay/projects/ThreadAuto/content/pipeline_prompts.py` — 로딩 함수 3개 + 포맷 헬퍼 3개 + 빌드 함수 4개 수정
- `/home/jay/projects/ThreadAuto/prompts/pipeline/01_angle.md` — 출력 구조 7필드 확장 (angle_name, first_line_hook, why_this_angle_works, target_action, risk, hook_potential, recommendation_reason)
- `/home/jay/projects/ThreadAuto/prompts/pipeline/04_hooking.md` — 첫줄 5대안 + CTA 3대안 + 댓글유도 3개 + 인용유도 3개 구조
- `/home/jay/projects/ThreadAuto/prompts/pipeline/05_review.md` — 7대 검수 항목(첫줄정지력/타깃명확성/손실전달력/반전강도/신뢰감/저장가능성/댓글유도력) + weakest_3

### 테스트 수정 (1건)
- `/home/jay/projects/ThreadAuto/tests/test_five_stage_pipeline.py` — 4개 테스트 클래스 29건 추가 (총 70건)

## 테스트 결과
- pytest: **70/70 PASSED** (0.14s)
  - 기존 41건 통과 유지 (회귀 0건)
  - 신규 29건: TestDataLoading(10), TestFormatHelpers(9), TestPromptInjection(8), TestIntegrationWithPreps(2)
- pyright: **0 errors, 0 warnings** (content/pipeline_prompts.py)
- black + isort: 적용 완료

## 머지 판단
- **머지 필요**: Yes (자동 머지 완료)
- **브랜치**: task/task-628.2-dev2
- **머지 의견**: 체인 중간 Phase이므로 자동 머지 완료. 기존 41건 테스트 회귀 없음, 신규 29건 전체 통과.

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **pyright 절대경로 실행 시 import resolution 실패** — worktree 디렉토리 내에서 상대경로 실행으로 해결
2. **lru_cache 테스트 간 간섭** — setup_method에서 cache_clear() 호출로 해결
3. **_format_hook_bank 필터 결과 없을 때 빈 출력** — fallback으로 상위 5개 반환하도록 구현

### 범위 외 미해결 (1건)
1. **⚠️ 기존 테스트 실패 1건 (본 작업 범위 외)**: `test_cta_linebreak.py::TestFactDbContainsBusinessPage::test_fact_db_contains_business_page` — fact_db.md에 '사업단 페이지' 표기 미포함 이슈. 본 작업에서 fact_db.md는 수정 대상이 아님.

## QC 검증 결과 (3회 시도)
- file_check: PASS (6/6)
- data_integrity: PASS
- test_runner: 본 작업 대상 70건 PASSED (전체 426 passed, 1 failed)
  - ⚠️ 기존 테스트 실패 1건 (본 작업 범위 외): `test_cta_linebreak.py::TestFactDbContainsBusinessPage::test_fact_db_contains_business_page` — fact_db.md에 '사업단 페이지' 표기 미포함 (이번 작업에서 fact_db.md는 수정 대상 아님)
- tdd_check: PASS
- pyright_check: WARN (기존 import resolution — CWD 의존, 프로젝트 디렉토리에서 실행 시 0 errors)
- style_check: PASS (black + isort)
- critical_gap: PASS
- overall: QC FAIL (사유: 범위 외 기존 테스트 1건 — 에스컬레이션)

## 커밋 내역
1. `d24c998` — [task-628.2] 사전 준비물 데이터 파일 3종 생성
2. `7577728` — [task-628.2] pipeline_prompts.py에 사전 준비물 로딩/주입 로직 추가
3. `c349505` — [task-628.2] 프롬프트 고도화 — 01_angle/04_hooking/05_review 출력 구조 확장
4. `a060d38` — [task-628.2] 사전 준비물 로딩/주입 테스트 보강

## 다음 Phase 지시서
- 경로: `/home/jay/workspace/memory/tasks/task-628.3.md`
- 내용: five_stage_pipeline.py 결과 처리 로직을 고도화된 출력 구조에 맞게 업데이트 + E2E 검증