# zioinfo 설치 & 사용 가이드 (v2.0.0 통합판)

## 설치 (2단계)

```
/plugin install zioinfo@ythong
/reload-plugins
```

설치되는 것:
- 플러그인: `zioinfo` (ZIO INFOTECH Suite) — 구 harness·zio-harness·proposal-builder·zioinfo 4개 통합
- 스킬 5종: `zio-harness`(풀스택 개발) · `harness`(하네스 팩토리) · `proposal-builder-orchestrator` · `pm-pmo-orchestrator` · `hermes-delivery`(전령 절차)
- 커맨드 3종: `/zioinfo:pmo` · `/zioinfo:proposal` · `/zioinfo:wiki`(LLM wiki)
- 에이전트 16종: **hermes**(전령 — memory·skill·cron·External APIs 4대 특징) + proposal 7 + pm·pmo 8
- (선택) userConfig `notify_webhook_url` — enable 시 입력하면 hermes가 전달 완료 알림 POST
- 훅: SessionStart → graphify 지식그래프 자동 구축/갱신
- 테마: ZIO WISE (`/theme`에서 선택, experimental)
- 지식베이스: `knowledge/kintex/` · `knowledge/guardia/`

## 구버전에서 이관

구 4개 플러그인을 개별 설치한 경우 제거 후 통합판 하나만 설치한다:

```
claude plugin uninstall harness@ythong
claude plugin uninstall zio-harness@ythong
claude plugin uninstall proposal-builder@ythong
claude plugin uninstall zioinfo@ythong   # 구 1.x
claude plugin install zioinfo@ythong     # v2.0.0
```

## 마켓플레이스가 등록되지 않은 경우

```
/plugin marketplace add https://git.zioinfo.co.kr/ythong/harness.git
/plugin install zioinfo@ythong
/reload-plugins
```

로컬 개발 환경(이 저장소가 있는 PC)에서는 디렉터리 마켓플레이스로 등록해도 된다:

```
/plugin marketplace add C:\GUARDiA\workspace\harness
```

## 확인

```
claude plugin list                    # 설치 목록
claude plugin details zioinfo@ythong  # 컴포넌트 인벤토리 (스킬 4·커맨드 3·에이전트 15·훅·테마)
```

## 사용

```
사용자 로그인 기능 추가해줘             # zio-harness 6인 파이프라인 (hermes 전령 포함)
이번 변경 push하고 배포 확인해줘        # hermes Deploy 트랙
하네스 구성해줘: <도메인 설명>          # harness 메타 스킬
/zioinfo:proposal RFP와 템플릿으로 제안서 작성
/zioinfo:pmo 이번 주 주간보고
/zioinfo:wiki                           # 코드베이스 LLM wiki 생성 (graphify-out/wiki/)
```

## 트러블슈팅

| 증상 | 조치 |
|------|------|
| `plugin not found` | 마켓플레이스를 먼저 add 했는지 확인(`/plugin marketplace add ...`). 저장소에 `plugins/zioinfo/`가 커밋됐는지 확인(git 기반 설치 시). |
| `invalid manifest` | `plugins/zioinfo/.claude-plugin/plugin.json` JSON 유효성 확인. 루트 `.claude-plugin/marketplace.json`의 `plugins[]`에 zioinfo만 등록돼 있는지 확인. |
| 설치 후 커맨드 안 보임 | `/reload-plugins` 실행 또는 세션 재시작. 커맨드는 `/zioinfo:pmo`처럼 네임스페이스가 붙는다. |
| 구 플러그인과 스킬 중복 | 구 harness·zio-harness·proposal-builder를 uninstall — 동일 스킬이 두 곳에서 로드되면 트리거가 불안정해진다. |
| graphify 훅이 안 돎 | Python·pip 설치 확인. 끄려면 환경변수 `ZIO_HARNESS_NO_GRAPHIFY=1`. |
| 테마 안 보임 | 테마는 experimental 컴포넌트 — Claude Code 최신 버전 확인 후 `/theme`에서 "ZIO WISE" 선택. |