# harness-main — Claude Code 가이드

> **2026-07-21: 4개 플러그인(harness·zio-harness·proposal-builder·zioinfo)을 `plugins/zioinfo/` 단일 플러그인 v2.0.0으로 통합.**
> 마켓플레이스(`ythong`)에는 zioinfo 하나만 게시된다. 스킬·에이전트·커맨드 이름은 전부 유지 — 아래 트랙별 트리거는 그대로 유효하다.

## 통합 플러그인: zioinfo (ZIO INFOTECH Suite, v2.0.0)

**위치:** `plugins/zioinfo/` — 스킬 5(zio-harness·harness·proposal-builder-orchestrator·pm-pmo-orchestrator·hermes-delivery) · 커맨드 3(`/zioinfo:pmo`·`/zioinfo:proposal`·`/zioinfo:wiki`) · 에이전트 16(**hermes** 번들 포함) · SessionStart graphify 훅 · ZIO WISE 테마 · knowledge/(kintex·guardia)

**변경 이력:**
| 날짜 | 변경 내용 | 대상 | 사유 |
|------|----------|------|------|
| 2026-07-21 | **v2.0.0 — 4개 플러그인 단일 통합 + 최신 플러그인 기술 적용**: ①git mv로 히스토리 보존 통합(루트 skills/harness→plugins/zioinfo/skills/harness, zio-harness 스킬·훅·scripts·knowledge, proposal-builder 에이전트7·커맨드·스킬) ②manifest 최신화 — `$schema`·`displayName`("ZIO INFOTECH Suite")·`experimental.themes` ③**LLM wiki 커맨드 신설**(`/zioinfo:wiki` — graphify --wiki → graphify-out/wiki/ 커뮤니티별 아티클) ④**ZIO WISE 테마** 동봉(themes/zioinfo.json — 시안 #11c3ff·블루 #1f29fc) ⑤marketplace.json 단일 엔트리·docs/README/설치가이드 재구성 | 전체 | "플러그인 4개를 zioinfo로 통합 + 최신 플러그인 기술 크롤링 추가(예: LLM wiki)" 요청. 공식 plugins-reference 조사 — 최신 컴포넌트(themes·monitors·LSP·channels·userConfig·displayName·$schema) 중 테마·wiki 채택, monitors/channels는 실험적·상시 프로세스라 보류 |
| 2026-07-21 | **v2.1.0 — hermes 4대 특징 탑재(Nous Hermes Agent 이식)**: 번들 에이전트 `agents/hermes.md` 신설 — ①**memory: user**(채널 레지스트리·전달 이력·실패→해결 학습 패턴 영속, 자격증명 저장 금지) ②**skill**(`skills/hermes-delivery/` 신설·사전 로드 + 반복 절차 2회 시 자가 스킬화 Observe→Plan→Act→Learn) ③**cron**(CronCreate/List/Delete·/schedule — 정기 헬스체크·주간 릴리즈 노트·정기 wiki) ④**External APIs**(Gitea REST `GITEA_TOKEN` env·userConfig `notify_webhook_url` 알림 webhook). zio-harness SKILL 스폰을 `zioinfo:hermes`로 전환(미설치 폴백 general-purpose), references/hermes.md 4대 특징 표 추가 | plugins/zioinfo | "헤르메스 4대 특징(memory·skill·cron·External APIs) 플러그인 반영 확인" 질의 — 미반영 상태 확인 후 즉시 이식 |

---

## 트랙 1: zio-harness (React + Spring Boot + Mobile 풀스택 개발)

**목표:** React 프론트엔드 + Spring Boot 백엔드 + 모바일 앱 풀스택 개발을 에이전트 팀이 자동 조율한다.

**트리거:** 기능 개발, 버그 수정, 테스트, 코드 분석, 폴더 구조 파악, 배포/push/전달/알림 요청 시 `zio-harness` 스킬을 사용하라. 단순 질문은 직접 응답 가능.

**변경 이력:**
| 날짜 | 변경 내용 | 대상 | 사유 |
|------|----------|------|------|
| 2026-06-17 | zio-harness 초기 구성 | 전체 | React+SpringBoot+Mobile 풀스택 하네스 신규 생성 |
| 2026-06-17 | zio-harness 독립 플러그인 분리 (`plugins/zio-harness/`, v1.0.1) | 마켓플레이스·폴더 구조 | 단독 설치 지원, harness 플러그인과 스킬 소유권 분리 |
| 2026-06-17 | Agent Teams API 사용법 정정 (SKILL.md Phase 2–3 + 오케스트레이터 템플릿) | zio-harness·harness | `TeamCreate(members[])`/`TaskCreate(tasks[])`가 실제 실험 API와 불일치 → 빈 팀+Agent spawn / 개별 TaskCreate+TaskUpdate로 수정 |
| 2026-07-17 | **v1.2.0 — designer 에이전트 추가(4→5인 파이프라인)**: analyst→designer(UI 작업 시)→agent→bot. `references/designer.md` 신설 — UI/UX 스펙(01_design_spec.md)·디자인 토큰·선 SVG 아이콘 + **스티치(Stitch) 의뢰 design.md 생성·MCP 연결 시 직접 요청**. zioinfo_team.png(5인 다이어그램)와 실제 동작 일치화 | plugins/zio-harness | "팀 이미지에 Designer 빠짐 → 실제 플러그인도 그렇게 동작하게" + "디자이너 md에 스티치 MCP design.md 생성 추가" 요청 |
| 2026-07-21 | **v1.3.0 — hermes(전령) 에이전트 추가(5→6인 파이프라인)**: analyst→designer(UI 시)→agent→bot→hermes(전달 시). `references/hermes.md` 신설 — ①메시지·알림 전파 ②에이전트 간 산출물 중계(핸드오프 요약·`_workspace/` 인덱스) ③배포·전달(Gitea commit/push·배포 확인·릴리즈 노트, `03_delivery.md`). bot PASS 게이트 필수·force push/`--no-verify` 금지·자격증명 마스킹. SKILL.md 배선(작업 유형 Deploy·t5 태스크·bot→hermes 통신·에러 핸들링)·zioinfo_team.png 6인 일치화 | plugins/zio-harness | "플러그인에 헤르메스 에이전트 추가" 요청 — 역할 3종(알림·중계·배포) 모두 채택 |
| 2026-07-21 | zioinfo v2.0.0으로 통합 이동 (`plugins/zioinfo/skills/zio-harness/`) | 통합 | 4개 플러그인 단일화 |

---

## 트랙 2: harness (하네스 팩토리 메타 스킬)

**목표:** 새 도메인에 맞는 에이전트 팀과 스킬을 자동 생성하는 팩토리.

**트리거:** "하네스 구성해줘", "에이전트 팀 설계해줘", 새 도메인 하네스 생성 요청 시 `harness` 스킬을 사용하라.

---

## 트랙 3: proposal-builder (제안서 자동완성)

**목표:** RFP + PPT 디자인 템플릿을 읽어 제안서를 자동 완성. 시스템 구축(SI)·유지보수(SM) 제안 주력. "제안서를 작성해줘" 한 마디에 오케스트레이터가 7인 전문가 + 아키텍처 전문가 풀을 **총지휘**.

**트리거:** 제안서 작성, RFP 분석, PPT 제안서, 수주/기술 제안서, 구축/유지보수 제안, 나라장터 제안 요청 시 `proposal-builder-orchestrator` 스킬을 사용하라. `/zioinfo:proposal` 커맨드 포함.

**구성:** 에이전트 7(rfp-analyst·strategist·tech-advisor·writer·visual-designer·deck-designer·qa) + 오케스트레이터 + 번들 스크립트(inspect_template·build_deck). tech-advisor가 아키텍처 전문가 풀 동원 허브.

**변경 이력:**
| 날짜 | 변경 내용 | 대상 | 사유 |
|------|----------|------|------|
| 2026-06-20 | proposal-builder 플러그인 신규(에이전트7·오케스트레이터1·스크립트2) + marketplace 등록 | plugins/proposal-builder | RFP+템플릿→제안서 자동완성, 디자인(선아이콘)·기술자문·아키텍처 총동원 요청 |
| 2026-07-21 | zioinfo v2.0.0으로 통합 이동 (에이전트→`plugins/zioinfo/agents/`, 커맨드 `/zioinfo:proposal`) | 통합 | 4개 플러그인 단일화 |

---

## 트랙 4: PM·PMO (프로젝트 관리)

**목표:** 수주 후 프로젝트 수행(PM)·조직 총괄(PMO) 업무 자동화 — 계획(사업수행계획서·WBS·M/M)·리스크/이슈/변경·진척보고(EVM)·감리 대응(모의감리·지적조치)·PMO 표준/품질게이트·포트폴리오 총괄. 제안 단계는 proposal-builder 트랙 담당(경계).

**트리거:** 프로젝트 계획, WBS, 사업수행계획서, 주간/월간/완료 보고, 리스크 관리, 변경 영향분석, 감리 대응, 모의감리, 지적사항 조치, 검수 준비, PMO 표준, 품질게이트, 포트폴리오 현황, 자원 배분, 디자인 의뢰(스티치 design.md), 젠스파크 의뢰서, AI 의뢰서, graphify-out 생성 요청 시 `pm-pmo-orchestrator` 스킬을 사용하라. `/zioinfo:pmo` 커맨드 포함.

**구성:** 에이전트 8(pm-planner·pm-risk-manager·pm-reporter·pm-auditor·pmo-governance·pmo-portfolio·pm-ai-commissioner·pm-qa) + 오케스트레이터 + `/zioinfo:pmo` 커맨드. 설치: `/plugin install zioinfo@ythong` → `/reload-plugins`.

**변경 이력:**
| 날짜 | 변경 내용 | 대상 | 사유 |
|------|----------|------|------|
| 2026-07-17 | pm-pmo 플러그인 신규(에이전트7·오케스트레이터1·커맨드1) + marketplace 등록 | plugins/zioinfo | 플러그인에 PM·PMO 추가 요청. 작업 중 "감리 추가" 요청으로 pm-auditor 전담 에이전트 추가(6→7인), pmo-governance의 감리 실무는 pm-auditor로 이관(중복 제거) |
| 2026-07-17 | v1.1.0 — pm-ai-commissioner 추가(7→8인): 외부 AI 의뢰 트랙(스티치 design.md·젠스파크 조사/슬라이드 의뢰 md·graphify 지식그래프 graphify-out/ 생성) + 오케스트레이터 Phase5 신설 | plugins/zioinfo | "플러그인에 design.md 생성·graphify-out 생성·젠스파크 AI 의뢰 md 작성 추가" 요청 |
| 2026-07-17 | **개명: pm-pmo → zioinfo, 마켓플레이스 ythong-harness → ythong** — 설치 식별자 `zioinfo@ythong`. 디렉터리 git mv + 전 문서 참조 갱신 + 로컬 마켓플레이스 재등록·기존 4플러그인 재설치(harness·zio-harness·proposal-builder·zioinfo @ythong). 스킬(pm-pmo-orchestrator)·에이전트 이름은 유지 | 전체 | "플러그인 이름을 zioinfo@ythong로 변경 + 마켓플레이스 게시" 요청 |
| 2026-07-17 | **브랜드 에셋 교체** — harness_*.png(크랩) 4종 삭제 → logo_thumb.png(ZIO INFOTECH) 기반 zioinfo_{banner,icon,social,team}.png 재생성(SVG 코드 드로잉→헤드리스 Chrome 렌더). README 3종·gen_intro_deck.py·PROJECT_MAP·design.md 참조 갱신. **사내전용 설치가이드 재구성** — 구 pptx 2종 삭제, `docs/gen_install_guide.py`(진실원천) 신설 → `docs/zioinfo_사내전용_설치가이드.pptx`(10슬라이드) | 브랜드·docs | "이미지를 logo_thumb 참조 재생성 + 파일명 zioinfo 교체·기존 삭제 + 설치가이드 재구성" 요청 |

---

## 폴더 구조 빠른 참조

```
harness-main/
├── .claude-plugin/
│   └── marketplace.json        # ythong 마켓플레이스 (zioinfo 단일 엔트리)
├── plugins/
│   └── zioinfo/                # ★ 통합 플러그인 v2.0.0 (ZIO INFOTECH Suite)
│       ├── .claude-plugin/plugin.json   # $schema·displayName·experimental.themes
│       ├── agents/             # 15인 (proposal 7 + pm·pmo 8)
│       ├── commands/           # pmo.md · proposal.md · wiki.md(LLM wiki)
│       ├── skills/
│       │   ├── zio-harness/    # 풀스택 개발 오케스트레이터 (+references 11종: hermes.md 포함)
│       │   ├── harness/        # 하네스 팩토리 메타 스킬 (+references 6종)
│       │   ├── proposal-builder-orchestrator/  # +scripts(inspect_template·build_deck)
│       │   └── pm-pmo-orchestrator/
│       ├── hooks/hooks.json    # SessionStart → graphify 자동 분석
│       ├── scripts/graphify_setup.py
│       ├── themes/zioinfo.json # ZIO WISE 테마
│       ├── knowledge/          # kintex/ · guardia/ 지식베이스
│       └── docs/INSTALL.md
├── docs/                       # plugins.md(카탈로그)·설치가이드 pptx·gen_*.py
└── graphify-out/               # 이 저장소의 지식그래프
```

## 핵심 파일 역할

| 파일 | 역할 |
|------|------|
| `PROJECT_MAP.md` (프로젝트 루트) | 폴더 구조 메모리 — 에이전트가 세션마다 읽는 기준 파일 |
| `plugins/zioinfo/skills/zio-harness/SKILL.md` | zio-harness 오케스트레이터 진입점 |
| `plugins/zioinfo/skills/harness/SKILL.md` | harness 메타 스킬 진입점 |
| `plugins/zioinfo/.claude-plugin/plugin.json` | 통합 플러그인 매니페스트 (버전·컴포넌트 경로의 단일 출처) |
| `.claude-plugin/marketplace.json` | ythong 마켓플레이스 매니페스트 (zioinfo 단일 엔트리) |
