# task-618.1 완료 보고서

## SCQA

**S**: 출판팀(토트 센터장) 체계가 구축되어 6명 팀원이 등록되어 있으나, `_build_publishing_prompt()`에 팀원 역할이 한 줄 설명만 존재하고 전문 프롬프트가 없으며, 3대 엔진 합의도출 워크플로우가 토트 프롬프트에 연결되지 않은 상태다.

**C**: 토트가 Task tool로 팀원 소환 시 general-purpose 에이전트에 텍스트 지시만 내리게 되어, 기존 스킬(book-writer, human-writer)과 팀원이 연결되지 않고, 비너스/아틀라스 3대 엔진 협업 경로가 부재하다.

**Q**: 팀원별 전문 역할 프롬프트를 부여하고 3대 엔진 합의도출 워크플로우를 연결하여, 토트의 오케스트레이션 품질을 구조적으로 높일 수 있는가?

**A**: 6개 역할 프롬프트 파일 생성 + `_build_publishing_prompt()` 개선 + PUBLISHING-WORKFLOW.md 작성으로 완료. pyright 에러 0건, docx 스킬 설치 확인 완료.

---

## 작업 내용

### 1. 팀원별 역할 프롬프트 파일 6개 생성
경로: `/home/jay/workspace/prompts/publishing/`

- `calliope.md` (2,309 bytes) — 구성작가/아웃라인 설계. 반환각 1법칙 수호자, Story Bible 관리, Phase 1 담당
- `erato.md` (3,255 bytes) — 초안 작가. book-writer + human-writer 스킬 필수 연동, Phase 2 담당
- `clio.md` (2,060 bytes) — 팩트 체커/리서치. 반환각 2법칙 수호자, 2소스 교차검증, Phase 3-1 담당
- `terpsichore.md` (3,613 bytes) — 퇴고/편집. human-writer 스킬 + 인간 냄새 심화 기법, 3패스 편집, Phase 3-2 담당
- `polyhymnia.md` (2,466 bytes) — 마무리/마케팅 카피. 액션 스텝/정리 질문, 제목 10안, 판매 카피, Phase 4-5 담당
- `seshat.md` (2,279 bytes) — 문서 편집/DOCX. docx 스킬 연동, Book Memory Bank 동기화, Phase 6 담당

### 2. `_build_publishing_prompt()` 개선
파일: `/home/jay/workspace/prompts/team_prompts.py` (215-291행)

변경 4건:
- 팀원 목록에 역할 프롬프트 파일 경로 추가 (6명 × "→ 소환 시 ... 를 읽어 프롬프트에 포함")
- 필수 참조 문서 1개 → 6개로 확장 (three-engine-consensus, book-writer, human-writer, human-scent, PUBLISHING-WORKFLOW)
- 3대 엔진 합의도출 모드 섹션 신설 (역할 배분 + 5단계 요약)
- 워크플로우 섹션 개선 (PUBLISHING-WORKFLOW.md 참조 + 역할 프롬프트 포함 의무 명시)

### 3. PUBLISHING-WORKFLOW.md 작성
경로: `/home/jay/workspace/prompts/publishing/PUBLISHING-WORKFLOW.md` (5,707 bytes)

- 기본 모드: Claude 단독 파이프라인 6 Phase (칼→에→클→테→폴→세)
- 3대 엔진 합의도출 모드: 7단계 워크플로우 (기본 Phase 1-2 + 비너스/아틀라스 교차 + Phase 3-6)
- 팀원 소환 규칙: 역할 프롬프트 파일 읽기 필수, 모델 선택 가이드, 소환 예시
- Phase 간 핸드오프: 산출물 경로 규칙, 전달 정보 명세
- 품질 게이트: Phase별 6차원 검토 항목 매트릭스

### 4. docx 스킬 설치 확인
`/home/jay/workspace/skills/docx/` 에 이미 설치 확인 (SKILL.md, scripts/, LICENSE.txt)

---

## 생성/수정 파일 목록

- 생성: `prompts/publishing/calliope.md`
- 생성: `prompts/publishing/erato.md`
- 생성: `prompts/publishing/clio.md`
- 생성: `prompts/publishing/terpsichore.md`
- 생성: `prompts/publishing/polyhymnia.md`
- 생성: `prompts/publishing/seshat.md`
- 생성: `prompts/publishing/PUBLISHING-WORKFLOW.md`
- 수정: `prompts/team_prompts.py` (215-291행, _build_publishing_prompt 함수)

---

## 검증 결과

- pyright: 에러 0건, 경고 0건 (`team_prompts.py`)
- docx 스킬: 설치 확인 완료
- 코드 레벨 확인: `_build_publishing_prompt()` → 팀원 소환 시 역할 프롬프트 파일 경로를 f-string으로 정확히 출력. `build_prompt()` 호출 체인에서 `team["type"] == "publishing"` 분기를 통해 정상 도달. 기존 인터페이스(파라미터 시그니처) 변경 없음.

---

## 발견 이슈 및 해결

### 자체 해결 (3건)
1. **task-618.1.md 보고서 경로 오타** — task 파일 내 보고서 경로가 `task-617.1.md`로 잘못 기재됨. 실제 task_id인 `task-618.1`로 보고서 생성
2. **publishing 디렉토리 부재** — `prompts/publishing/` 디렉토리가 존재하지 않아 `mkdir -p`로 생성
3. **finish-task.sh 호출 오타** — task 파일 내 `finish-task.sh task-617.1`로 잘못 기재. 실제 task_id `task-618.1`로 실행 예정

### 범위 외 미해결 (0건)
없음

---

## QC 자동 검증

```
task_id: task-618.1
verified_at: 2026-03-16T16:37:39
overall: CONDITIONAL PASS (2 FAIL은 비해당)

- api_health: SKIP (서버 작업 아님)
- file_check: FAIL → .done 미생성은 finish-task.sh 실행 전이므로 정상
- data_integrity: PASS
- test_runner: SKIP (테스트 디렉토리 미지정)
- tdd_check: FAIL → Lv.1 문서/설정 작업. team_prompts.py 변경은 f-string 텍스트 추가만 (로직 변경 없음)
- schema_contract: SKIP
- pyright_check: PASS (에러 0건)
- style_check: PASS (black OK, isort OK)
- scope_check: SKIP
- critical_gap: PASS
```

**FAIL 항목 설명**:
- file_check: .done 파일은 finish-task.sh 실행 시 생성됨 (QC → finish-task.sh 순서)
- tdd_check: QC-RULES.md 기준 "Lv.2+ 코딩 작업에만 의미 있음. Lv.1 단순 수정/설정/문서 작업은 SKIP 처리" 해당. 이 작업은 프롬프트 텍스트 파일 7개 생성 + f-string 텍스트 라인 추가가 전부로, 로직 변경이 없는 Lv.1 설정 작업임.