harness/plugins/zioinfo/docs/INSTALL.md
DESKTOP-TKLFCPR\ython 6caf43e1ed feat!: v2.0.0 — 4개 플러그인 zioinfo 단일 통합 + 최신 플러그인 기술 적용
- harness·zio-harness·proposal-builder·zioinfo → plugins/zioinfo (git mv 히스토리 보존)
- 스킬 4·커맨드 3(/zioinfo:pmo·proposal·wiki)·에이전트 15·graphify 훅·knowledge 통합
- 신규: /zioinfo:wiki (graphify LLM wiki — graphify-out/wiki/ 커뮤니티별 아티클)
- 신규: ZIO WISE 테마 (themes/zioinfo.json, experimental)
- manifest 최신화: $schema·displayName(ZIO INFOTECH Suite)·experimental.themes
- marketplace.json 단일 엔트리, 루트 plugin.json 제거
- CLAUDE.md·PROJECT_MAP·docs/plugins.md·README 3종·CHANGELOG·설치가이드 pptx 재구성

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-21 20:16:36 +09:00

73 lines
3.1 KiB
Markdown

# zioinfo 설치 & 사용 가이드 (v2.0.0 통합판)
## 설치 (2단계)
```
/plugin install zioinfo@ythong
/reload-plugins
```
설치되는 것:
- 플러그인: `zioinfo` (ZIO INFOTECH Suite) — 구 harness·zio-harness·proposal-builder·zioinfo 4개 통합
- 스킬 4종: `zio-harness`(풀스택 개발) · `harness`(하네스 팩토리) · `proposal-builder-orchestrator` · `pm-pmo-orchestrator`
- 커맨드 3종: `/zioinfo:pmo` · `/zioinfo:proposal` · `/zioinfo:wiki`(LLM wiki)
- 에이전트 15종: proposal 7(rfp-analyst 등) + pm·pmo 8(pm-planner 등)
- 훅: 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" 선택. |