---
task_id: task-2222
type: plan
scope: task
created: 2026-04-27
updated: 2026-04-27
status: completed
---

# 계획서: task-2222

**task**: task-2222
**목표**: AI 콘텐츠 생성 V2 — claude CLI subprocess + 스킬 프롬프트 + 큐 시스템으로 교체
**승인**: 제이회장님 브레인스토밍 확정 (대안 C)
**근거**: task 파일 내 브레인스토밍 결과

---

## 목표

1. 기존 anthropic SDK 기반 SSE 스트리밍을 claude CLI subprocess로 교체 (Max200 플랜 내 처리, API 키 불필요)
2. 스킬별 프롬프트 모듈 6종 생성 (base, naver_seo, geo, viral_hook, pro_blog, cro_copy)
3. asyncio 세마포어 기반 큐 시스템 (동시 10건) 도입
4. 프론트엔드: 프리셋 4종 + 개별 스킬 선택 UI + 대기 UX (polling)
5. 플랜별 스킬 매핑 설정 (Free~Hidden)

## 범위

### 포함
- server/main.py의 generate-content 엔드포인트 → CLI + 큐로 교체
- server/skill_prompts/ 디렉토리 신규 생성 (6개 프롬프트 파일)
- server/generation_queue.py 신규 생성
- src/pages/Generate.tsx 수정 (스킬 선택 UI + 폴링 기반 대기 UX)
- src/config/planSkillMap.ts 신규 생성

### 제외 (다음 페이즈 이후)
- 콘텐츠 관리에서 백그라운드 결과 확인 (별도 작업)
- 토스트 알림 시스템 (별도 작업)

## 위임 계획

- 백엔드 (큐 시스템 + CLI 엔진 + 엔드포인트): **카르티케야** — Python 서버 로직
- 프론트엔드 (스킬 UI + 폴링 UX + planSkillMap): **사라스바티** — React/TypeScript
- 스킬 프롬프트 파일 작성: **카르티케야** — 서버 리소스 파일

## 검증 기준

- npm run build: 빌드 성공
- 서버 재시작 후 /api/insuro/generate-queue-status 응답: `{"active":0,"waiting":0}`
- /api/insuro/generate-content POST → job_id 반환 확인
- planSkillMap.ts import 에러 없음