# task-1047.1 완료 보고서: 보험저널 기반 텍스트 Threads 업로드

**작업 ID**: task-1047.1
**레벨**: Lv.1
**팀**: dev2-team (오딘)
**프로젝트**: ThreadAuto
**작업일**: 2026-03-26

---

## SCQA

**S**: ThreadAuto 파이프라인의 기존 run_text_post.py는 에버그린 토픽풀에서 랜덤 선택하여 텍스트 포스트를 생성한다. 뉴스캐시에 보험저널 기사 10건(relevance_score 1~3)이 캐싱되어 있다.

**C**: 보험저널 뉴스캐시에서 직접 기사를 선택하여 text_insight 타입으로 Threads 텍스트 포스트를 생성·업로드해야 하나, 전용 스크립트가 없고 Claude CLI의 수치 환각으로 fact_guard 통과율이 낮다(재실행 시 3회 연속 실패).

**Q**: 보험저널 뉴스 기반 text_insight 포스트를 fact_guard 검증을 통과하여 Threads에 정상 업로드할 수 있는가?

**A**: 전용 스크립트 작성 + text_generator.py 종결어미 버그 수정으로 업로드 성공 (post_id: 18076449767563584, 141자). fact_guard 수치 환각 문제는 description에 수치 생성 자제 지시 삽입으로 임시 해결. 콘텐츠 품질 이슈 3건 발견 (경쟁사명 직접 노출, 날짜 부정확, fact_guard 불안정).

---

## 실행 결과

### Threads 업로드

- **성공 여부**: 성공
- **post_id**: `18076449767563584`
- **text_type**: text_insight
- **글자수**: 141자

### 사용된 뉴스 기사

- **제목**: "설계사 늘고 계약 품질은 최고 수준… 에이플러스에셋의 질주"
- **URL**: https://www.insjournal.co.kr/news/articleView.html?idxno=30665
- **relevance_score**: 3 (뉴스캐시 내 최고)
- **primary keyword**: 리크루팅

### 업로드된 텍스트 전문

```
오늘 나온 기사인데
에이플러스에셋이
대규모 리크루팅
워크숍을 열었습니다.

창립 이래 매년
이어온 핵심 행사로
GA의 인재 확보 전쟁이
갈수록 치열해지고 있죠.

서울대보험쌤 분석으로는
설계사 수 경쟁보다
계약 품질로 승부하는
GA가 결국 살아남습니다.

#GA시장 #보험설계사
```

---

## 파이프라인 검증 데이터

- fact_guard validate_numbers: PASS (수치 0건, 정성적 텍스트)
- AI 냄새 블랙리스트: PASS (시작어/접속사/메타코멘트 미포함)
- 문장 완결성: PASS ("살아남습니다" → 종결어미 "다")
- Threads API 발행: PASS (post_id 반환)
- 백그라운드 재실행 안정성: FAIL (3회 모두 fact_guard 차단: 65만명, 12.5%, 7.8%)

---

## 발견 이슈 및 해결

### 자체 해결 (2건)

1. **text_generator.py 이모지/한국어 종결어미 검증 실패** — `_validate()` 메서드가 `.?!。`만 종결 문자로 인식하여 한국어 종결어미("다","요","죠" 등)를 모두 거부. 이모지 제거 후 한국어 종결어미 14종 허용 목록 추가.
   - 수정: `text_generator.py:249-259`

2. **fact_guard 수치 환각 반복 차단** — Claude CLI가 뉴스 맥락에서 fact_db에 없는 임의 수치(65만명, 12.5%, 7.8%)를 반복 생성. topic description에 "수치 생성 자제" 지시문 삽입으로 정성적 표현 유도.
   - 수정: `run_insjournal_text.py:47-50`

### 범위 외 미해결 (3건)

1. **경쟁사명(에이플러스에셋) 직접 노출** — master_brief "타사 직접 언급 금지" 위반. TextContentGenerator의 `_validate()`에 경쟁사명 필터 부재. 별도 기능 개선 작업 필요.
   - 범위 외 사유: text_generator.py 경쟁사 블랙리스트 추가는 설계 변경 수반

2. **날짜 부정확 표현** — "오늘 나온 기사인데"라고 작성했으나 실제 발행일은 2026-03-19 (7일 전). Claude CLI에 현재 날짜 정보 미전달.
   - 범위 외 사유: text_prompts.py 시스템 프롬프트에 날짜 정보 주입 로직 필요

3. **fact_guard 수치 환각 근본 원인 미해결** — description 지시문 삽입은 임시 방편. 재실행 시 3회 연속 실패 (안정성 약 33%). text_prompts.py 시스템 프롬프트 레벨에서 수치 생성 억제 강화 필요.
   - 범위 외 사유: 프롬프트 엔지니어링 개선 별도 작업

---

## 생성/수정 파일 목록

- **생성**: `/home/jay/.cokacdir/workspace/2AF76B79/run_insjournal_text.py` (보험저널 전용 실행 스크립트)
- **수정**: `/home/jay/projects/ThreadAuto/content/text_generator.py` (이모지/한국어 종결어미 검증 개선)

---

## 비고

- 이전 실행(post_id: 17915066154340667)도 존재함 — 2건 모두 Threads에 게시됨
- 텍스트 삭제는 제이회장님 확인 후 판단 필요 (외부 서비스 테스트 규칙)

---

## QC 자동 검증

- **Overall**: WARN (Gate PASS)
- **결과**: 6 PASS, 4 SKIP, 2 WARN
- file_check: PASS (6923 + 10749 bytes)
- data_integrity: PASS
- test_runner: PASS (70 passed in 0.11s)
- tdd_check: SKIP (Lv.1 작업)
- pyright_check: WARN — sys.path.insert 기반 import라 정적 분석 미해석 (런타임 정상)
- style_check: WARN — isort 미세 차이 (기능 무관)
- critical_gap: PASS
- spec_compliance: PASS
- duplicate_check: PASS (최대 유사도 7.8%)
- .done 파일: Gate PASS로 자동 생성