# proposal-builder 설치 & 사용 가이드

## 1. 설치

### 마켓플레이스로 설치 (권장)
```
/plugin marketplace add <이 저장소 경로 또는 URL>
/plugin install proposal-builder@ythong-harness
```
- 마켓플레이스 이름: `ythong-harness` (저장소 `.claude-plugin/marketplace.json`)
- 플러그인 이름: `proposal-builder`

### 로컬 경로로 설치
저장소를 클론한 뒤:
```
/plugin marketplace add /경로/harness
/plugin install proposal-builder@ythong-harness
```

설치 후 다음이 등록된다:
- 스킬: `proposal-builder-orchestrator`
- 커맨드: `/proposal`
- 에이전트 7: rfp-analyst · proposal-strategist · proposal-tech-advisor · proposal-writer · proposal-visual-designer · deck-designer · proposal-qa

## 2. 사용

### 가장 간단한 방법
```
제안서를 작성해줘
```
또는 슬래시 커맨드:
```
/proposal ○○시스템 구축 사업 제안서
```
→ 오케스트레이터가 전 전문가를 총지휘해 Phase1~6을 자동 진행한다.

### 필요한 입력
1. **RFP 문서** — 경로 또는 텍스트 (PDF·DOCX·나라장터 공고). HWP/HWPX는 텍스트로 변환해 제공(외부 업로드 안 함).
2. **PPT 디자인 템플릿** — `.pptx` 파일 (표지·간지·본문 마스터가 든 디자인). 없으면 디자인 시스템 기반 중립 마스터로 생성.
3. 발주처·사업명.

## 3. 사전 요구사항

```bash
pip install python-pptx        # PPTX 생성에 필요
```
- 미설치 시 deck-designer가 설치를 안내한다.
- 전부 **로컬/온프레미스 처리** — 외부 API·온라인 디자인 서비스 호출 없음.

## 4. 설치 오류 해결

| 증상 | 원인 / 해결 |
|------|------------|
| `plugin not found` | 마켓플레이스를 먼저 add 했는지 확인(`/plugin marketplace add ...`). 저장소에 `plugins/proposal-builder/`가 커밋됐는지 확인(git 기반 설치 시). |
| `invalid manifest` | `plugins/proposal-builder/.claude-plugin/plugin.json` 존재·JSON 유효성 확인. 저장소 루트 `.claude-plugin/marketplace.json`의 `plugins[]`에 proposal-builder 등록 확인. |
| 스킬이 트리거 안 됨 | "제안서 작성"·"RFP 분석" 등 키워드 사용, 또는 `/proposal` 커맨드 사용. |
| PPTX 생성 실패 | `pip install python-pptx`. 템플릿 PPTX 경로 확인. |
| HWP RFP 못 읽음 | HWP→텍스트(또는 PDF) 변환 후 제공. |

## 5. 산출물
- 중간물: `_workspace/` (rfp_analysis·rtm·strategy·outline·tech_advisory·content·design_system·assets/icons·visual_concepts·template_spec·proposal_qa)
- 최종: `proposal.pptx` (+ 본문, 재생성 스크립트 `build_deck.py`)
