# ythong 마켓플레이스 — 플러그인 카탈로그

이 저장소(`ythong` 마켓플레이스)가 제공하는 Claude Code 플러그인 목록과 설치·검증 방법.

> 마켓플레이스 매니페스트: [`.claude-plugin/marketplace.json`](../.claude-plugin/marketplace.json)
> 최종 업데이트: 2026-07-21 (4개 플러그인 → zioinfo v2.0.0 단일 통합)

---

## 플러그인 목록

| 플러그인 | 버전 | 설명 |
|----------|------|------|
| **zioinfo** (ZIO INFOTECH Suite) | 2.1.0 | 구 4개 플러그인(harness·zio-harness·proposal-builder·zioinfo) 단일 통합판. ①풀스택 개발 6인 팀 — **hermes(전령) 번들 에이전트: Hermes Agent 4대 특징(memory·skill 자가 축적·cron·External APIs) 탑재** ②하네스 팩토리 메타 스킬 ③제안서 자동완성 7인 팀(`/zioinfo:proposal`) ④PM·PMO 8인 팀(`/zioinfo:pmo`) + graphify 지식그래프 SessionStart 훅·**LLM wiki**(`/zioinfo:wiki`)·ZIO WISE 테마·KINTEX/GUARDiA 지식베이스. |

구 harness(1.3.1)·zio-harness(1.3.0)·proposal-builder(1.0.0)·zioinfo(1.1.0)는 2026-07-21 zioinfo v2.0.0으로 통합되어 개별 배포가 종료됐다.

---

## 설치 (검증된 명령)

### 1. 마켓플레이스 등록
```bash
# 로컬 디렉토리에서
claude plugin marketplace add /경로/harness
# 또는 Git 원격에서
claude plugin marketplace add <git-url>
```
→ `Successfully added marketplace: ythong`

### 2. 플러그인 설치
```bash
claude plugin install zioinfo@ythong
```
→ `Successfully installed plugin: zioinfo@ythong`

구버전 4개를 개별 설치했던 환경은 먼저 제거한다:
```bash
claude plugin uninstall harness@ythong
claude plugin uninstall zio-harness@ythong
claude plugin uninstall proposal-builder@ythong
```

### 3. 설치·로드 검증
```bash
claude plugin list                    # 설치 목록·enabled 상태
claude plugin details zioinfo@ythong  # 컴포넌트 인벤토리·토큰 비용
```

기대 인벤토리: Skills 5(zio-harness·harness·proposal-builder-orchestrator·pm-pmo-orchestrator·hermes-delivery) ·
Commands 3(pmo·proposal·wiki) · Agents 16(hermes 포함) · Hooks 1(SessionStart graphify) · Themes 1(ZIO WISE)

> Agent Teams 기능을 쓰는 하네스는 `export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`이 필요하다. 상세: [`experimental-dependency.md`](./experimental-dependency.md).

---

## 트랙별 사용

### 풀스택 개발 (구 zio-harness)
```
사용자 로그인 기능 추가해줘 (React 화면 + API + 모바일)   # 6인 파이프라인
이번 변경 Gitea에 push하고 배포 확인해줘                  # hermes(전령) Deploy 트랙
```

### 하네스 팩토리 (구 harness)
```
하네스 구성해줘: <도메인 한 문장>
```

### 제안서 자동완성 (구 proposal-builder)
```
/zioinfo:proposal ○○시스템 구축 사업 제안서
```
**입력**: ① RFP 문서(PDF·DOCX·나라장터 공고; HWP는 텍스트 변환) ② PPT 디자인 템플릿(.pptx) ③ 발주처·사업명
**사전 요구사항**: `pip install python-pptx`

### PM·PMO
```
/zioinfo:pmo 이번 주 주간보고 만들어줘
/zioinfo:pmo 종료 감리 준비 (모의감리 포함)
```

### LLM wiki (신규, v2.0.0)
```
/zioinfo:wiki [경로]     # graphify 지식그래프 → graphify-out/wiki/ 커뮤니티별 아티클
```

**상세 가이드**: [`plugins/zioinfo/docs/INSTALL.md`](../plugins/zioinfo/docs/INSTALL.md)

전 과정 온프레미스(외부 API·온라인 디자인 서비스 호출 없음). 선 아이콘은 외부 라이브러리 금지·직접 SVG 제작.

---

## 제거
```bash
claude plugin uninstall zioinfo@ythong
```

## 설치 오류 대응
| 증상 | 해결 |
|------|------|
| `plugin not found` | 마켓플레이스를 먼저 `add` 했는지 확인. Git 설치 시 `plugins/zioinfo/`가 커밋됐는지 확인. |
| `invalid manifest` | `plugins/zioinfo/.claude-plugin/plugin.json` 존재·JSON 유효성, 루트 `marketplace.json`의 `plugins[]` 등록 확인. BOM 없는 UTF-8인지 확인. |
| 컴포넌트 로드 누락 | `claude plugin details zioinfo@ythong`로 인벤토리 점검(에이전트 frontmatter `name`/`description` 필수). |
| 구 플러그인과 충돌 | 구 4개 플러그인을 uninstall — 동일 스킬 중복 로드 시 트리거 불안정. |
