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>
This commit is contained in:
DESKTOP-TKLFCPR\ython 2026-07-21 20:16:36 +09:00
parent 2517bc7489
commit 6caf43e1ed
114 changed files with 356 additions and 488 deletions

View File

@ -6,29 +6,11 @@
"url": "https://git.zioinfo.co.kr/ythong" "url": "https://git.zioinfo.co.kr/ythong"
}, },
"plugins": [ "plugins": [
{
"name": "harness",
"source": "./",
"description": "에이전트 팀 & 스킬 아키텍트. 도메인/프로젝트에 맞는 하네스를 구성하고, 전문 에이전트를 정의하며, 에이전트가 사용할 스킬을 생성하는 메타 스킬.",
"version": "1.3.1"
},
{
"name": "zio-harness",
"source": "./plugins/zio-harness",
"description": "React + Spring Boot + Mobile App 풀스택 개발 하네스. orchestrator·analyst·designer·agent·bot·hermes 에이전트 팀이 기능 개발·디자인(선 SVG 아이콘·디자인 토큰·Stitch 의뢰 design.md)·테스트·전달(전령 hermes — Gitea push·배포 확인·산출물 중계·알림)을 파이프라인으로 처리. PROJECT_MAP.md로 폴더 구조를 세션 간 기억. 설치만으로 graphify 지식 그래프가 소스를 자동 분석(SessionStart 훅)하고, KINTEX 도메인 md 지식 베이스를 내장.",
"version": "1.3.0"
},
{
"name": "proposal-builder",
"source": "./plugins/proposal-builder",
"description": "RFP 문서와 PowerPoint 디자인 템플릿을 읽어 제안서를 자동 완성하는 하네스. rfp-analyst·strategist·tech-advisor(아키텍처 전문가 총동원)·writer·visual-designer(선 아이콘 직접 제작)·deck-designer·qa 7인 팀이 요구사항 분석→수주전략→기술/아키텍처 설계→본문→비주얼→템플릿 기반 PPTX→규격 검증을 파이프라인으로 처리. 시스템 구축(SI)·유지보수(SM) 제안 주력.",
"version": "1.0.0"
},
{ {
"name": "zioinfo", "name": "zioinfo",
"source": "./plugins/zioinfo", "source": "./plugins/zioinfo",
"description": "PM(프로젝트 관리)·PMO(프로젝트 관리 조직) 하네스. pm-planner·pm-risk-manager·pm-reporter·pm-auditor·pmo-governance·pmo-portfolio·pm-ai-commissioner·pm-qa 8인 팀이 착수/계획(사업수행계획서·WBS·일정·M/M)→리스크/이슈/변경→진척보고(주간/월간/EVM)→감리 대응(점검항목 매핑·모의감리·지적조치)→PMO 거버넌스(방법론·표준·품질게이트)→포트폴리오 총괄→외부 AI 의뢰서(스티치 design.md·젠스파크 조사 의뢰·graphify 지식그래프)→정합성 검증을 파이프라인으로 처리. SI 구축·SM 유지보수 프로젝트 수행 단계 주력.", "description": "ZIO INFOTECH 통합 하네스 — 구 4개 플러그인(harness·zio-harness·proposal-builder·zioinfo) 단일 통합판. 풀스택 개발 6인 팀(hermes 전령 포함)+graphify 지식그래프·LLM wiki(/zioinfo:wiki)+하네스 팩토리 메타 스킬+제안서 자동완성(/zioinfo:proposal)+PM·PMO(/zioinfo:pmo)+KINTEX·GUARDiA 지식베이스+ZIO WISE 테마.",
"version": "1.1.0" "version": "2.0.0"
} }
] ]
} }

View File

@ -1,31 +0,0 @@
{
"name": "harness",
"description": "The team-architecture factory for Claude Code — a meta-skill that turns a domain description into an agent team and the skills they use, with six pre-defined team-architecture patterns (Pipeline, Fan-out/Fan-in, Expert Pool, Producer-Reviewer, Supervisor, Hierarchical Delegation). Claude Code용 팀 아키텍처 팩토리: 도메인 한 문장을 에이전트 팀과 스킬 세트로 변환하는 메타 스킬.",
"version": "1.3.1",
"author": {
"name": "ythong",
"url": "https://git.zioinfo.co.kr/ythong"
},
"homepage": "https://git.zioinfo.co.kr/ythong/harness",
"repository": "https://git.zioinfo.co.kr/ythong/harness",
"license": "Apache-2.0",
"keywords": [
"harness",
"harness-factory",
"team-architecture-factory",
"agent-team",
"skill-architect",
"meta-skill",
"orchestration",
"claude-code",
"claude-code-plugin",
"agent-scaffolding",
"multi-agent",
"pipeline",
"fan-out-fan-in",
"expert-pool",
"producer-reviewer",
"supervisor",
"hierarchical-delegation"
]
}

View File

@ -2,6 +2,18 @@
이 프로젝트는 [Semantic Versioning](https://semver.org/)을 따릅니다. 이 프로젝트는 [Semantic Versioning](https://semver.org/)을 따릅니다.
## [2.0.0] - 2026-07-21 (zioinfo 통합 플러그인)
### Changed
- **BREAKING: 4개 플러그인(harness 1.3.1 · zio-harness 1.3.0 · proposal-builder 1.0.0 · zioinfo 1.1.0)을 `plugins/zioinfo/` 단일 플러그인 v2.0.0으로 통합** — git mv 히스토리 보존. 마켓플레이스(`ythong`)는 zioinfo 단일 엔트리. 스킬·에이전트·커맨드 이름은 유지(커맨드는 `/zioinfo:pmo`·`/zioinfo:proposal` 네임스페이스)
- 루트 `.claude-plugin/plugin.json`(harness) 제거 — 저장소는 이제 마켓플레이스 전용 루트
### Added
- **`/zioinfo:wiki` 커맨드** — graphify 지식그래프에서 LLM wiki(`graphify-out/wiki/` 커뮤니티별 아티클) 생성/갱신
- **ZIO WISE 테마** (`themes/zioinfo.json`, experimental) — 시안 #11c3ff·블루 #1f29fc 팔레트
- manifest 최신화 — `$schema`(에디터 검증)·`displayName`("ZIO INFOTECH Suite")·`experimental.themes`
- (v1.3.0, zio-harness 트랙) **hermes(전령) 에이전트** — 알림 전파·산출물 중계·배포/전달(Gitea push·배포 확인), 6인 파이프라인
## [Unreleased] ## [Unreleased]
### Added ### Added

View File

@ -1,10 +1,24 @@
# harness-main — Claude Code 가이드 # harness-main — Claude Code 가이드
## 하네스: zio-harness (React + Spring Boot + Mobile) > **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/` — 스킬 4(zio-harness·harness·proposal-builder-orchestrator·pm-pmo-orchestrator) · 커맨드 3(`/zioinfo:pmo`·`/zioinfo:proposal`·`/zioinfo:wiki`) · 에이전트 15 · 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는 실험적·상시 프로세스라 보류 |
---
## 트랙 1: zio-harness (React + Spring Boot + Mobile 풀스택 개발)
**목표:** React 프론트엔드 + Spring Boot 백엔드 + 모바일 앱 풀스택 개발을 에이전트 팀이 자동 조율한다. **목표:** React 프론트엔드 + Spring Boot 백엔드 + 모바일 앱 풀스택 개발을 에이전트 팀이 자동 조율한다.
**트리거:** 기능 개발, 버그 수정, 테스트, 코드 분석, 폴더 구조 파악 요청 시 `zio-harness` 스킬을 사용하라. 단순 질문은 직접 응답 가능. **트리거:** 기능 개발, 버그 수정, 테스트, 코드 분석, 폴더 구조 파악, 배포/push/전달/알림 요청 시 `zio-harness` 스킬을 사용하라. 단순 질문은 직접 응답 가능.
**변경 이력:** **변경 이력:**
| 날짜 | 변경 내용 | 대상 | 사유 | | 날짜 | 변경 내용 | 대상 | 사유 |
@ -13,11 +27,12 @@
| 2026-06-17 | zio-harness 독립 플러그인 분리 (`plugins/zio-harness/`, v1.0.1) | 마켓플레이스·폴더 구조 | 단독 설치 지원, harness 플러그인과 스킬 소유권 분리 | | 2026-06-17 | zio-harness 독립 플러그인 분리 (`plugins/zio-harness/`, v1.0.1) | 마켓플레이스·폴더 구조 | 단독 설치 지원, harness 플러그인과 스킬 소유권 분리 |
| 2026-06-17 | Agent Teams API 사용법 정정 (SKILL.md Phase 23 + 오케스트레이터 템플릿) | zio-harness·harness | `TeamCreate(members[])`/`TaskCreate(tasks[])`가 실제 실험 API와 불일치 → 빈 팀+Agent spawn / 개별 TaskCreate+TaskUpdate로 수정 | | 2026-06-17 | Agent Teams API 사용법 정정 (SKILL.md Phase 23 + 오케스트레이터 템플릿) | 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-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 통신·에러 핸들링)·plugin/marketplace v1.3.0·zioinfo_team.png 6인 일치화 | plugins/zio-harness | "플러그인에 헤르메스 에이전트 추가" 요청 — 역할 3종(알림·중계·배포) 모두 채택 | | 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개 플러그인 단일화 |
--- ---
## 하네스: harness (메타 스킬) ## 트랙 2: harness (하네스 팩토리 메타 스킬)
**목표:** 새 도메인에 맞는 에이전트 팀과 스킬을 자동 생성하는 팩토리. **목표:** 새 도메인에 맞는 에이전트 팀과 스킬을 자동 생성하는 팩토리.
@ -25,28 +40,29 @@
--- ---
## 하네스: proposal-builder (제안서 자동완성) ## 트랙 3: proposal-builder (제안서 자동완성)
**목표:** RFP + PPT 디자인 템플릿을 읽어 제안서를 자동 완성. 시스템 구축(SI)·유지보수(SM) 제안 주력. "제안서를 작성해줘" 한 마디에 오케스트레이터가 7인 전문가 + 아키텍처 전문가 풀을 **총지휘**. **목표:** RFP + PPT 디자인 템플릿을 읽어 제안서를 자동 완성. 시스템 구축(SI)·유지보수(SM) 제안 주력. "제안서를 작성해줘" 한 마디에 오케스트레이터가 7인 전문가 + 아키텍처 전문가 풀을 **총지휘**.
**트리거:** 제안서 작성, RFP 분석, PPT 제안서, 수주/기술 제안서, 구축/유지보수 제안, 나라장터 제안 요청 시 `proposal-builder-orchestrator` 스킬을 사용하라. **트리거:** 제안서 작성, RFP 분석, PPT 제안서, 수주/기술 제안서, 구축/유지보수 제안, 나라장터 제안 요청 시 `proposal-builder-orchestrator` 스킬을 사용하라. `/zioinfo:proposal` 커맨드 포함.
**구성:** 독립 플러그인 `plugins/proposal-builder/`(v1.0.0) — 에이전트 7(rfp-analyst·strategist·tech-advisor·writer·visual-designer·deck-designer·qa) + 오케스트레이터 + 번들 스크립트(inspect_template·build_deck). tech-advisor가 아키텍처 전문가 풀 동원 허브. **구성:** 에이전트 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-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개 플러그인 단일화 |
--- ---
## 하네스: zioinfo (PM·PMO 프로젝트 관리) ## 트랙 4: PM·PMO (프로젝트 관리)
**목표:** 수주 후 프로젝트 수행(PM)·조직 총괄(PMO) 업무 자동화 — 계획(사업수행계획서·WBS·M/M)·리스크/이슈/변경·진척보고(EVM)·감리 대응(모의감리·지적조치)·PMO 표준/품질게이트·포트폴리오 총괄. 제안 단계는 proposal-builder 담당(경계). **목표:** 수주 후 프로젝트 수행(PM)·조직 총괄(PMO) 업무 자동화 — 계획(사업수행계획서·WBS·M/M)·리스크/이슈/변경·진척보고(EVM)·감리 대응(모의감리·지적조치)·PMO 표준/품질게이트·포트폴리오 총괄. 제안 단계는 proposal-builder 트랙 담당(경계).
**트리거:** 프로젝트 계획, WBS, 사업수행계획서, 주간/월간/완료 보고, 리스크 관리, 변경 영향분석, 감리 대응, 모의감리, 지적사항 조치, 검수 준비, PMO 표준, 품질게이트, 포트폴리오 현황, 자원 배분, 디자인 의뢰(스티치 design.md), 젠스파크 의뢰서, AI 의뢰서, graphify-out 생성 요청 시 `pm-pmo-orchestrator` 스킬을 사용하라. `/pmo` 커맨드 포함. **트리거:** 프로젝트 계획, WBS, 사업수행계획서, 주간/월간/완료 보고, 리스크 관리, 변경 영향분석, 감리 대응, 모의감리, 지적사항 조치, 검수 준비, PMO 표준, 품질게이트, 포트폴리오 현황, 자원 배분, 디자인 의뢰(스티치 design.md), 젠스파크 의뢰서, AI 의뢰서, graphify-out 생성 요청 시 `pm-pmo-orchestrator` 스킬을 사용하라. `/zioinfo:pmo` 커맨드 포함.
**구성:** 독립 플러그인 `plugins/zioinfo/`(v1.1.0) — 에이전트 8(pm-planner·pm-risk-manager·pm-reporter·pm-auditor·pmo-governance·pmo-portfolio·pm-ai-commissioner·pm-qa) + 오케스트레이터 + `/pmo` 커맨드. 설치: `/plugin install zioinfo@ythong``/reload-plugins`. **구성:** 에이전트 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`.
**변경 이력:** **변경 이력:**
| 날짜 | 변경 내용 | 대상 | 사유 | | 날짜 | 변경 내용 | 대상 | 사유 |
@ -54,7 +70,7 @@
| 2026-07-17 | pm-pmo 플러그인 신규(에이전트7·오케스트레이터1·커맨드1) + marketplace 등록 | plugins/zioinfo | 플러그인에 PM·PMO 추가 요청. 작업 중 "감리 추가" 요청으로 pm-auditor 전담 에이전트 추가(6→7인), pmo-governance의 감리 실무는 pm-auditor로 이관(중복 제거) | | 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 | 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 | **개명: 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슬라이드, ythong 마켓플레이스·플러그인 4종·2줄 설치·검증·트러블슈팅) | 브랜드·docs | "이미지를 logo_thumb 참조 재생성 + 파일명 zioinfo 교체·기존 삭제 + 설치가이드 재구성" 요청 | | 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 교체·기존 삭제 + 설치가이드 재구성" 요청 |
--- ---
@ -62,37 +78,25 @@
``` ```
harness-main/ harness-main/
├── .claude-plugin/ # 플러그인 매니페스트 ├── .claude-plugin/
├── .claude/ │ └── marketplace.json # ythong 마켓플레이스 (zioinfo 단일 엔트리)
│ ├── agents/ # 에이전트 정의 파일 (4종)
│ │ ├── orchestrator.md # 전체 조율
│ │ ├── analyst.md # 분석 + PROJECT_MAP 관리
│ │ ├── bot.md # 테스트·빌드·자동화
│ │ └── agent.md # 코드 구현
│ └── skills/ # (추가 스킬 위치)
├── skills/
│ └── harness/ # 메타 하네스 스킬 (harness 플러그인)
│ ├── SKILL.md
│ └── references/ # 패턴·템플릿·가이드
├── plugins/ ├── plugins/
│ └── zio-harness/ # 독립 플러그인: 풀스택 개발 하네스 │ └── zioinfo/ # ★ 통합 플러그인 v2.0.0 (ZIO INFOTECH Suite)
│ ├── .claude-plugin/ │ ├── .claude-plugin/plugin.json # $schema·displayName·experimental.themes
│ │ └── plugin.json │ ├── agents/ # 15인 (proposal 7 + pm·pmo 8)
│ └── skills/ │ ├── commands/ # pmo.md · proposal.md · wiki.md(LLM wiki)
│ └── zio-harness/ │ ├── skills/
│ ├── SKILL.md │ │ ├── zio-harness/ # 풀스택 개발 오케스트레이터 (+references 11종: hermes.md 포함)
│ └── references/ │ │ ├── harness/ # 하네스 팩토리 메타 스킬 (+references 6종)
│ ├── folder-map.md # PROJECT_MAP 생성 가이드 │ │ ├── proposal-builder-orchestrator/ # +scripts(inspect_template·build_deck)
│ ├── react.md # React 개발 패턴 │ │ └── pm-pmo-orchestrator/
│ ├── spring-boot.md # Spring Boot 패턴 │ ├── hooks/hooks.json # SessionStart → graphify 자동 분석
│ ├── mobile.md # 모바일 앱 패턴 │ ├── scripts/graphify_setup.py
│ ├── playwright.md # E2E 테스트 패턴 │ ├── themes/zioinfo.json # ZIO WISE 테마
│ ├── database.md # DB + MCP 패턴 │ ├── knowledge/ # kintex/ · guardia/ 지식베이스
│ ├── orchestrator.md # 오케스트레이터 에이전트 가이드 │ └── docs/INSTALL.md
│ ├── analyst.md # 분석가 에이전트 가이드 ├── docs/ # plugins.md(카탈로그)·설치가이드 pptx·gen_*.py
│ ├── bot.md # 봇 에이전트 가이드 └── graphify-out/ # 이 저장소의 지식그래프
│ └── agent.md # 개발 에이전트 가이드
└── _workspace/ # 에이전트 작업 중간 산출물
``` ```
## 핵심 파일 역할 ## 핵심 파일 역할
@ -100,6 +104,7 @@ harness-main/
| 파일 | 역할 | | 파일 | 역할 |
|------|------| |------|------|
| `PROJECT_MAP.md` (프로젝트 루트) | 폴더 구조 메모리 — 에이전트가 세션마다 읽는 기준 파일 | | `PROJECT_MAP.md` (프로젝트 루트) | 폴더 구조 메모리 — 에이전트가 세션마다 읽는 기준 파일 |
| `plugins/zio-harness/skills/zio-harness/SKILL.md` | zio-harness 오케스트레이터 진입점 (독립 플러그인) | | `plugins/zioinfo/skills/zio-harness/SKILL.md` | zio-harness 오케스트레이터 진입점 |
| `skills/harness/SKILL.md` | harness 메타 스킬 진입점 | | `plugins/zioinfo/skills/harness/SKILL.md` | harness 메타 스킬 진입점 |
| `.claude/agents/*.md` | 에이전트 역할·원칙·통신 프로토콜 정의 | | `plugins/zioinfo/.claude-plugin/plugin.json` | 통합 플러그인 매니페스트 (버전·컴포넌트 경로의 단일 출처) |
| `.claude-plugin/marketplace.json` | ythong 마켓플레이스 매니페스트 (zioinfo 단일 엔트리) |

View File

@ -1,17 +1,21 @@
# PROJECT_MAP # PROJECT_MAP
> 마지막 업데이트: 2026-06-23 > 마지막 업데이트: 2026-07-21
> 프로젝트: harness — Claude Code Plugin (Team-Architecture Factory) > 프로젝트: harness — Claude Code Plugin 저장소 (ythong 마켓플레이스)
> 버전: 1.3.1 (plugin.json 기준) > 버전: zioinfo v2.0.0 (plugins/zioinfo/.claude-plugin/plugin.json 기준)
> 업데이트 방법: "PROJECT_MAP 업데이트해줘" 또는 구조 변경 후 analyst 에이전트 자동 갱신 > 업데이트 방법: "PROJECT_MAP 업데이트해줘" 또는 구조 변경 후 analyst 에이전트 자동 갱신
--- ---
## 프로젝트 목적 ## 프로젝트 목적
Claude Code용 **팀 아키텍처 팩토리** 플러그인 저장소. Claude Code용 **ZIO INFOTECH 통합 하네스** 플러그인 저장소. 2026-07-21 구 4개 플러그인(harness·zio-harness·proposal-builder·zioinfo)을 `plugins/zioinfo/` 단일 플러그인 v2.0.0으로 통합.
- `zio-harness` 스킬: React + Spring Boot + Mobile 풀스택 개발 6인 팀 (hermes 전령 포함)
- `harness` 스킬: 도메인 설명 → 에이전트 팀 + 스킬 자동 생성 (메타 스킬) - `harness` 스킬: 도메인 설명 → 에이전트 팀 + 스킬 자동 생성 (메타 스킬)
- `zio-harness` 스킬: React + Spring Boot + Mobile 풀스택 개발 에이전트 팀 - `proposal-builder-orchestrator` 스킬: RFP+PPT 템플릿 → 제안서 자동완성 (`/zioinfo:proposal`)
- `pm-pmo-orchestrator` 스킬: PM·PMO 프로젝트 관리 (`/zioinfo:pmo`)
- `/zioinfo:wiki`: graphify LLM wiki 생성
--- ---
@ -19,53 +23,41 @@ Claude Code용 **팀 아키텍처 팩토리** 플러그인 저장소.
| 파일/폴더 | 용도 | | 파일/폴더 | 용도 |
|----------|------| |----------|------|
| `.claude-plugin/` | Claude Code 플러그인 매니페스트 | | `.claude-plugin/marketplace.json` | ythong 마켓플레이스 매니페스트 — **zioinfo 단일 엔트리** |
| `.claude/` | 이 저장소의 에이전트 정의 파일 |
| `.github/` | GitHub 이슈/PR 템플릿 | | `.github/` | GitHub 이슈/PR 템플릿 |
| `skills/` | 플러그인 스킬 정의 | | `plugins/zioinfo/` | ★ 통합 플러그인 v2.0.0 (아래 상세) |
| `docs/` | 장기 참조 문서 (퀵스타트, 실험적 의존성) | | `docs/` | 장기 참조 문서 (카탈로그·퀵스타트·설치가이드 pptx·gen_*.py) |
| `_workspace/` | 에이전트 작업 중간 산출물 (git 추적 제외 권장) | | `graphify-out/` | 이 저장소의 지식그래프 (SessionStart 훅 산출) |
| `CLAUDE.md` | Claude Code 세션 진입 포인터 + 하네스 트리거 규칙 | | `_workspace/` | 에이전트 작업 중간 산출물 |
| `CLAUDE.md` | Claude Code 세션 진입 포인터 + 트랙별 트리거 규칙 |
| `PROJECT_MAP.md` | 이 파일 — 폴더 구조 메모리 | | `PROJECT_MAP.md` | 이 파일 — 폴더 구조 메모리 |
| `README.md` | 영문 메인 설명 | | `README.md` / `README_KO.md` / `README_JA.md` | 다국어 설명 (동기화 필수) |
| `README_KO.md` | 한국어 설명 |
| `README_JA.md` | 일본어 설명 |
| `CHANGELOG.md` | 버전별 변경 이력 (Semantic Versioning) | | `CHANGELOG.md` | 버전별 변경 이력 (Semantic Versioning) |
| `CONTRIBUTING.md` | 기여 가이드 + SLA (PR 72h, Issue 48h) | | `CONTRIBUTING.md` | 기여 가이드 + SLA (PR 72h, Issue 48h) |
| `LICENSE` | Apache 2.0 | | `LICENSE` | Apache 2.0 |
| `index.html` | 플러그인 마켓플레이스 랜딩 | | `index.html` / `privacy.html` | 마켓플레이스 랜딩 / 개인정보처리방침 |
| `privacy.html` | 개인정보처리방침 | | `zioinfo_*.png` | 브랜드 이미지 (banner, icon, social, team — team은 6인 다이어그램) |
| `zioinfo_*.png` | 브랜드 이미지 (ZIO INFOTECH 로고 기반) (banner, icon, social, team) |
--- ---
## .claude-plugin/ (플러그인 매니페스트) ## plugins/zioinfo/ (통합 플러그인 v2.0.0)
| 파일 | 용도 | | 경로 | 용도 |
|------|------| |------|------|
| `plugin.json` | harness 플러그인 메타 (name, version, author, keywords) | | `.claude-plugin/plugin.json` | 매니페스트 — `$schema`·`displayName`("ZIO INFOTECH Suite")·`experimental.themes`·버전 단일 출처 |
| `marketplace.json` | 마켓플레이스(`ythong`) 등록 정보. 현재 등록 플러그인: `harness` (v1.3.1), `zio-harness` (v1.1.0), `proposal-builder` (v1.0.0), `zioinfo` (v1.1.0) | | `agents/` | 15인 — proposal 7종(rfp-analyst·proposal-strategist·proposal-tech-advisor·proposal-writer·proposal-visual-designer·deck-designer·proposal-qa) + pm·pmo 8종(pm-planner·pm-risk-manager·pm-reporter·pm-auditor·pmo-governance·pmo-portfolio·pm-ai-commissioner·pm-qa) |
| `commands/pmo.md` | `/zioinfo:pmo` — PM·PMO 팀 지휘 |
| `commands/proposal.md` | `/zioinfo:proposal` — 제안서 팀 지휘 |
| `commands/wiki.md` | `/zioinfo:wiki` — graphify LLM wiki 생성/갱신 (graphify-out/wiki/) |
| `hooks/hooks.json` | SessionStart → `scripts/graphify_setup.py` (지식그래프 자동 구축/갱신) |
| `scripts/graphify_setup.py` | graphifyy[sql] 설치 + extract/update |
| `themes/zioinfo.json` | ZIO WISE 테마 (시안 #11c3ff·블루 #1f29fc, experimental) |
| `knowledge/kintex/` | KINTEX 도메인 지식베이스 (기획·설계·백로그·분석 md 전체) |
| `knowledge/guardia/` | GUARDiA 전사 지식 (solutions-catalog·standard-framework·operations-cicd·lessons-learned) |
| `docs/INSTALL.md` | 설치·이관·트러블슈팅 가이드 |
| `README.md` | 플러그인 개요 (4개 트랙) |
--- ### skills/harness/ (하네스 팩토리 메타 스킬)
## .claude/agents/ (에이전트 정의)
zio-harness 풀스택 개발 에이전트 팀. 4종 에이전트가 파이프라인으로 협업.
| 파일 | 에이전트 타입 | 역할 |
|------|------------|------|
| `orchestrator.md` | general-purpose | 작업 분석, 팀 구성, 결과 종합. PROJECT_MAP 읽기 첫 번째 |
| `analyst.md` | Explore | 코드/구조 분석, PROJECT_MAP.md 생성·유지, 구현 계획 수립 |
| `bot.md` | general-purpose | 테스트·빌드·린트·Playwright E2E·DB 마이그레이션 자동화 |
| `agent.md` | general-purpose | React/Spring Boot/Mobile 코드 구현 |
**실행 순서**: orchestrator → analyst → agent → bot
---
## skills/ (플러그인 스킬)
### skills/harness/ (메타 하네스 — 핵심 플러그인)
| 파일 | 용도 | | 파일 | 용도 |
|------|------| |------|------|
@ -77,23 +69,34 @@ zio-harness 풀스택 개발 에이전트 팀. 4종 에이전트가 파이프라
| `references/skill-testing-guide.md` | 테스트/평가/반복 개선 방법론 | | `references/skill-testing-guide.md` | 테스트/평가/반복 개선 방법론 |
| `references/qa-agent-guide.md` | QA 에이전트 통합 가이드 + 7개 버그 패턴 | | `references/qa-agent-guide.md` | QA 에이전트 통합 가이드 + 7개 버그 패턴 |
### plugins/zio-harness/skills/zio-harness/ (풀스택 개발 하네스 — 독립 플러그인) ### skills/zio-harness/ (풀스택 개발 하네스)
| 파일 | 용도 | | 파일 | 용도 |
|------|------| |------|------|
| `SKILL.md` | 오케스트레이터 진입점. 팀 구성·워크플로우·에러 핸들링·테스트 시나리오 포함 | | `SKILL.md` | 오케스트레이터 진입점. 6인 팀 구성·워크플로우·에러 핸들링·테스트 시나리오 |
| `references/folder-map.md` | **PROJECT_MAP.md 생성·유지 시스템**. 폴더 구조 메모리 핵심 가이드 | | `references/folder-map.md` | **PROJECT_MAP.md 생성·유지 시스템** |
| `references/designer.md` | Designer 에이전트 — UI/UX 스펙·디자인 토큰·선 SVG 아이콘·Stitch 의뢰 design.md 생성(MCP 요청) | | `references/designer.md` | Designer — UI/UX 스펙·디자인 토큰·선 SVG 아이콘·Stitch 의뢰 design.md |
| `references/hermes.md` | Hermes 에이전트 — 전령: Gitea commit/push·배포 확인·에이전트 간 산출물 중계·최종 알림·릴리즈 노트 | | `references/hermes.md` | Hermes — 전령: Gitea commit/push·배포 확인·산출물 중계·알림·릴리즈 노트 |
| `references/react.md` | React 18 + TypeScript + TanStack Query + Zustand 패턴 | | `references/react.md` | React 18 + TypeScript + TanStack Query + Zustand 패턴 |
| `references/spring-boot.md` | Spring Boot 3.x 레이어 아키텍처 + JPA + JWT + Flyway | | `references/spring-boot.md` | Spring Boot 3.x 레이어 아키텍처 + JPA + JWT + Flyway |
| `references/mobile.md` | React Native + Expo + React Navigation + AsyncStorage | | `references/mobile.md` | React Native + Expo + React Navigation + AsyncStorage |
| `references/playwright.md` | E2E 테스트 + 페이지 오브젝트 패턴 + CI 통합 | | `references/playwright.md` | E2E 테스트 + 페이지 오브젝트 패턴 + CI 통합 |
| `references/database.md` | PostgreSQL/MySQL MCP 설정 + Flyway 마이그레이션 + JPA 최적화 | | `references/database.md` | PostgreSQL/MySQL MCP 설정 + Flyway 마이그레이션 + JPA 최적화 |
| `references/orchestrator.md` | Orchestrator 에이전트 상세 정의 템플릿 | | `references/orchestrator.md` / `analyst.md` / `bot.md` / `agent.md` | 에이전트 상세 정의 템플릿 |
| `references/analyst.md` | Analyst 에이전트 상세 정의 템플릿 |
| `references/bot.md` | Bot 에이전트 상세 정의 템플릿 | ### skills/proposal-builder-orchestrator/ (제안서 자동완성)
| `references/agent.md` | Dev Agent 에이전트 상세 정의 템플릿 |
| 파일 | 용도 |
|------|------|
| `SKILL.md` | 7인 팀 오케스트레이터 (분석→전략→기술→본문→비주얼→PPTX→검증) |
| `scripts/inspect_template.py` | PPT 템플릿 레이아웃 분석 |
| `scripts/build_deck.py` | python-pptx 결정적 덱 생성 |
### skills/pm-pmo-orchestrator/ (PM·PMO)
| 파일 | 용도 |
|------|------|
| `SKILL.md` | 8인 팀 오케스트레이터 (계획→리스크→보고→감리→거버넌스→포트폴리오→AI 의뢰→QA) |
--- ---
@ -101,36 +104,13 @@ zio-harness 풀스택 개발 에이전트 팀. 4종 에이전트가 파이프라
| 파일 | 용도 | | 파일 | 용도 |
|------|------| |------|------|
| `quickstart.md` | 5분 퀵스타트 (마켓플레이스 설치 → 하네스 생성 → 샘플 실행) | | `plugins.md` | 플러그인 카탈로그 (zioinfo v2.0.0 단일) + 설치·검증 명령 |
| `experimental-dependency.md` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 플래그 설명 및 변경 대응 계획 | | `quickstart.md` | 5분 퀵스타트 |
| `plugin-guide.md` | **하네스 플러그인 작성 가이드** — 플러그인 구조·`plugin.json`/`marketplace.json`·스킬/에이전트 레이아웃·로컬 테스트·버전 관리 (작성자용) | | `experimental-dependency.md` | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 플래그 설명 |
| `plugin-guide.md` | 하네스 플러그인 작성 가이드 (작성자용) |
--- | `gen_install_guide.py` | 사내전용 설치가이드 pptx 생성 스크립트 (진실원천) |
| `gen_intro_deck.py` | 소개 덱 생성 스크립트 |
## .github/ (GitHub 자동화) | `zioinfo_사내전용_설치가이드.pptx` | 산출물 |
| 경로 | 용도 |
|------|------|
| `ISSUE_TEMPLATE/bug_report.yml` | 버그 리포트 템플릿 |
| `ISSUE_TEMPLATE/feature_request.yml` | 기능 요청 템플릿 |
| `ISSUE_TEMPLATE/question.yml` | 질문 템플릿 |
| `ISSUE_TEMPLATE/config.yml` | 이슈 템플릿 설정 |
| `PULL_REQUEST_TEMPLATE.md` | PR 템플릿 |
---
## _workspace/ (에이전트 작업 공간)
에이전트가 실행 중 생성하는 중간 산출물. 세션 간 유지되므로 작업 이력 추적 가능.
| 파일/폴더 | 용도 |
|----------|------|
| `01_auditor_repo_audit.md` | 저장소 감사 산출물 (이전 실행) |
| `02_content_launch_contents.md` | 런치 콘텐츠 산출물 (이전 실행) |
| `03_scout_outreach_map.md` | 아웃리치 맵 산출물 (이전 실행) |
| `04_strategist_launch_plan.md` | 런치 전략 산출물 (이전 실행) |
| `release/audit-2026-04-18.md` | v1.2.0 릴리즈 감사 |
| `release/post-m0-audit-2026-04-18.md` | M0 릴리즈 후 감사 |
--- ---
@ -138,11 +118,12 @@ zio-harness 풀스택 개발 에이전트 팀. 4종 에이전트가 파이프라
| 항목 | 규칙 | | 항목 | 규칙 |
|------|------| |------|------|
| 스킬 위치 | `skills/{skill-name}/SKILL.md` | | 스킬 위치 | `plugins/zioinfo/skills/{skill-name}/SKILL.md` |
| 참조 파일 | `skills/{skill-name}/references/*.md` | | 참조 파일 | `plugins/zioinfo/skills/{skill-name}/references/*.md` |
| 에이전트 정의 | `.claude/agents/{name}.md` | | 에이전트(플러그인 번들) | `plugins/zioinfo/agents/{name}.md` (frontmatter name/description 필수) |
| 에이전트(프로젝트별) | 대상 프로젝트 `.claude/agents/{name}.md` — zio-harness references 템플릿으로 생성 |
| SKILL.md 크기 제한 | 500줄 이내 (초과 시 references/ 분리) | | SKILL.md 크기 제한 | 500줄 이내 (초과 시 references/ 분리) |
| 버전 관리 | Semantic Versioning, plugin.json 기준 | | 버전 관리 | Semantic Versioning, plugins/zioinfo/.claude-plugin/plugin.json 기준 |
| 다국어 문서 | README.md (EN) · README_KO.md · README_JA.md 동기화 필수 | | 다국어 문서 | README.md (EN) · README_KO.md · README_JA.md 동기화 필수 |
--- ---
@ -151,9 +132,9 @@ zio-harness 풀스택 개발 에이전트 팀. 4종 에이전트가 파이프라
| 항목 | 값 | | 항목 | 값 |
|------|-----| |------|-----|
| Claude Code 버전 | v2.x 이상 | | Claude Code 버전 | v2.x 이상 (테마는 experimental — 최신 버전 권장) |
| 필수 환경 변수 | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` | | 필수 환경 변수 | `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` (에이전트 팀 모드) |
| 설치 명령(이 저장소) | `claude plugin marketplace add https://git.zioinfo.co.kr/ythong/harness.git``claude plugin install harness@ythong` (⚠️ 비-GitHub git 저장소는 **`.git` 필수** — 없으면 `expected object, received string` 오류) | | 설치 명령(이 저장소) | `claude plugin marketplace add https://git.zioinfo.co.kr/ythong/harness.git``claude plugin install zioinfo@ythong` (⚠️ 비-GitHub git 저장소는 **`.git` 필수** — 없으면 `expected object, received string` 오류) |
--- ---
@ -161,7 +142,8 @@ zio-harness 풀스택 개발 에이전트 팀. 4종 에이전트가 파이프라
| 날짜 | 변경 내용 | 담당 | | 날짜 | 변경 내용 | 담당 |
|------|----------|------| |------|----------|------|
| 2026-06-23 | `docs/plugin-guide.md` 신설(하네스 플러그인 작성 가이드) + CONTRIBUTING 포인터 + PROJECT_MAP 현행화(버전 1.3.1·마켓플레이스명·설치명령) | - | | 2026-07-21 | **4개 플러그인 → zioinfo v2.0.0 단일 통합** (git mv 히스토리 보존) + LLM wiki 커맨드·ZIO WISE 테마·manifest 최신화($schema·displayName) | - |
| 2026-06-17 | PROJECT_MAP.md 초기 생성 | analyst | | 2026-07-21 | zio-harness v1.3.0 — hermes(전령) 에이전트 추가 (5→6인) + 팀 이미지 일치화 | - |
| 2026-06-23 | `docs/plugin-guide.md` 신설 + PROJECT_MAP 현행화 | - |
| 2026-06-17 | zio-harness 스킬 + 에이전트 4종 신규 생성 | orchestrator | | 2026-06-17 | zio-harness 스킬 + 에이전트 4종 신규 생성 | orchestrator |
| 2026-04-18 | v1.2.0/1.2.1 릴리즈: 버전 정합성·포지셔닝·CONTRIBUTING·docs/ 신설 | - | | 2026-04-18 | v1.2.0/1.2.1 릴리즈: 버전 정합성·포지셔닝·CONTRIBUTING·docs/ 신설 | - |

View File

@ -81,19 +81,21 @@ Phase 6: Validation & Testing
#### Add the marketplace #### Add the marketplace
```shell ```shell
/plugin marketplace add revfactory/harness /plugin marketplace add https://git.zioinfo.co.kr/ythong/harness.git
``` ```
#### Install the plugin #### Install the plugin
```shell ```shell
/plugin install harness@harness-marketplace /plugin install zioinfo@ythong
``` ```
> Since v2.0.0 the four former plugins (harness · zio-harness · proposal-builder · zioinfo) ship as the single `zioinfo` plugin (ZIO INFOTECH Suite).
### Direct Installation as Global Skill ### Direct Installation as Global Skill
```shell ```shell
# Copy the skills directory to ~/.claude/skills/harness/ # Copy the skills directory to ~/.claude/skills/harness/
cp -r skills/harness ~/.claude/skills/harness cp -r plugins/zioinfo/skills/harness ~/.claude/skills/harness
``` ```
## Plugin Structure ## Plugin Structure

View File

@ -84,19 +84,21 @@ Phase 6: 検証とテスト
#### マーケットプレイスの追加 #### マーケットプレイスの追加
```shell ```shell
/plugin marketplace add revfactory/harness /plugin marketplace add https://git.zioinfo.co.kr/ythong/harness.git
``` ```
#### プラグインのインストール #### プラグインのインストール
```shell ```shell
/plugin install harness-marketplace /plugin install zioinfo@ythong
``` ```
> v2.0.0 以降、旧4プラグイン(harness · zio-harness · proposal-builder · zioinfo)は単一の `zioinfo` プラグイン(ZIO INFOTECH Suite)として統合配布される。
### グローバルスキルとして直接インストール ### グローバルスキルとして直接インストール
```shell ```shell
# skillsディレクトリを ~/.claude/skills/harness/ にコピー # skillsディレクトリを ~/.claude/skills/harness/ にコピー
cp -r skills/harness ~/.claude/skills/harness cp -r plugins/zioinfo/skills/harness ~/.claude/skills/harness
``` ```
## プラグイン構成 ## プラグイン構成

View File

@ -84,19 +84,21 @@ Phase 6: 검증 및 테스트
#### 마켓플레이스 추가 #### 마켓플레이스 추가
```shell ```shell
/plugin marketplace add revfactory/harness /plugin marketplace add https://git.zioinfo.co.kr/ythong/harness.git
``` ```
#### 플러그인 설치 #### 플러그인 설치
```shell ```shell
/plugin install harness-marketplace /plugin install zioinfo@ythong
``` ```
> v2.0.0부터 구 4개 플러그인(harness · zio-harness · proposal-builder · zioinfo)은 단일 `zioinfo` 플러그인(ZIO INFOTECH Suite)으로 통합 배포된다.
### 글로벌 스킬로 직접 설치 ### 글로벌 스킬로 직접 설치
```shell ```shell
# skills 디렉토리를 ~/.claude/skills/harness/에 복사 # skills 디렉토리를 ~/.claude/skills/harness/에 복사
cp -r skills/harness ~/.claude/skills/harness cp -r plugins/zioinfo/skills/harness ~/.claude/skills/harness
``` ```
## 플러그인 구조 ## 플러그인 구조

View File

@ -115,21 +115,21 @@ if os.path.exists(BANNER):
except Exception: pass except Exception: pass
text(s, 0.9, 2.1, 10.5, 2.4, [ text(s, 0.9, 2.1, 10.5, 2.4, [
[("사내전용 설치가이드", 52, True, WHITE)], [("사내전용 설치가이드", 52, True, WHITE)],
[("ythong 마켓플레이스 · Claude Code 플러그인 4종", 21, True, SKY)], [("ythong 마켓플레이스 · zioinfo 통합 플러그인 v2.0.0", 21, True, SKY)],
], space=10) ], space=10)
text(s, 0.95, 4.6, 11.4, 1.6, [ text(s, 0.95, 4.6, 11.4, 1.6, [
[("harness · zio-harness · proposal-builder · zioinfo", 16, True, RGBColor(0xCF, 0xE4, 0xF5))], [("ZIO INFOTECH Suite — 풀스택 개발 · 하네스 팩토리 · 제안서 · PM·PMO 4개 트랙 통합", 16, True, RGBColor(0xCF, 0xE4, 0xF5))],
[("설치 2줄이면 끝 — /plugin install <플러그인>@ythong → /reload-plugins", 14, False, RGBColor(0xB9, 0xCD, 0xE6))], [("설치 2줄이면 끝 — /plugin install zioinfo@ythong → /reload-plugins", 14, False, RGBColor(0xB9, 0xCD, 0xE6))],
], space=8) ], space=8)
text(s, 0.95, 6.5, 11, 0.5, [[("ZIO INFOTECH · 사내 배포용 · 외부 공유 금지", 11, False, RGBColor(0x8A, 0x9F, 0xC0))]]) text(s, 0.95, 6.5, 11, 0.5, [[("ZIO INFOTECH · 사내 배포용 · 외부 공유 금지", 11, False, RGBColor(0x8A, 0x9F, 0xC0))]])
# ── 2. 개요: 무엇이 설치되나 ───────────────────────────────────────── # ── 2. 개요: 무엇이 설치되나 ─────────────────────────────────────────
s = prs.slides.add_slide(BLANK); header(s, "무엇이 설치되나 — 플러그인 4종", "OVERVIEW", 2) s = prs.slides.add_slide(BLANK); header(s, "무엇이 설치되나 — zioinfo 통합 플러그인 (4개 트랙)", "OVERVIEW", 2)
rows = [ rows = [
("harness", "v1.3.1", "메타 스킬 — 도메인 한 문장을 에이전트 팀 + 스킬로 자동 생성하는 팩토리"), ("풀스택 개발", "zio-harness 스킬", "React + Spring Boot + Mobile 6인 팀 — analyst·designer·agent·bot·hermes(전령: push·배포·알림)"),
("zio-harness", "v1.1.0", "React + Spring Boot + Mobile 풀스택 개발 하네스 (orchestrator·analyst·bot·agent)"), ("하네스 팩토리", "harness 스킬", "메타 스킬 — 도메인 한 문장을 에이전트 팀 + 스킬로 자동 생성"),
("proposal-builder", "v1.0.0", "RFP + PPT 템플릿 → 제안서 자동 완성 (전문가 7인 + 아키텍처 풀, /proposal)"), ("제안서", "/zioinfo:proposal", "RFP + PPT 템플릿 → 제안서 자동 완성 (전문가 7인 + 아키텍처 풀)"),
("zioinfo", "v1.1.0", "PM·PMO 하네스 — 계획/WBS·리스크·보고·감리·포트폴리오·AI 의뢰서 (8인, /pmo)"), ("PM·PMO", "/zioinfo:pmo", "계획/WBS·리스크·보고(EVM)·감리·포트폴리오·AI 의뢰서 (8인) + LLM wiki(/zioinfo:wiki)"),
] ]
y = 1.6 y = 1.6
for name, ver, desc in rows: for name, ver, desc in rows:
@ -150,8 +150,8 @@ card(s, 0.6, 1.6, 5.95, 2.3, "필수", [
], accent=NAVY, tsize=16) ], accent=NAVY, tsize=16)
card(s, 6.8, 1.6, 5.95, 2.3, "선택 (기능별)", [ card(s, 6.8, 1.6, 5.95, 2.3, "선택 (기능별)", [
"Agent Teams 팀 모드: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1", "Agent Teams 팀 모드: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1",
"proposal-builder PPTX 생성: pip install python-pptx", "제안서 트랙 PPTX 생성: pip install python-pptx",
"zioinfo 지식그래프: graphify 스킬 (있으면 활용)", "지식그래프·LLM wiki: graphify (훅이 자동 설치, 끄기 ZIO_HARNESS_NO_GRAPHIFY=1)",
], accent=BLUE, tsize=16) ], accent=BLUE, tsize=16)
card(s, 0.6, 4.15, 12.15, 2.1, "권한·보안 안내", [ card(s, 0.6, 4.15, 12.15, 2.1, "권한·보안 안내", [
"마켓플레이스는 사내 Gitea 저장소(ythong/harness) 기준 — 외부 공개 저장소 아님", "마켓플레이스는 사내 Gitea 저장소(ythong/harness) 기준 — 외부 공개 저장소 아님",
@ -177,13 +177,14 @@ footer(s)
# ── 5. STEP 2: 플러그인 설치 ───────────────────────────────────────── # ── 5. STEP 2: 플러그인 설치 ─────────────────────────────────────────
s = prs.slides.add_slide(BLANK); header(s, "STEP 2 — 플러그인 설치 + 리로드", "INSTALL", 5) s = prs.slides.add_slide(BLANK); header(s, "STEP 2 — 플러그인 설치 + 리로드", "INSTALL", 5)
codebox(s, 0.6, 1.6, 12.1, 2.9, "필요한 플러그인만 골라 설치 (세션 안 2줄)", [ codebox(s, 0.6, 1.6, 12.1, 2.0, "설치는 하나면 끝 (세션 안 2줄)", [
"/plugin install zioinfo@ythong", "/plugin install zioinfo@ythong",
"/plugin install proposal-builder@ythong",
"/plugin install zio-harness@ythong",
"/plugin install harness@ythong",
"/reload-plugins", "/reload-plugins",
]) ])
text(s, 0.6, 3.75, 12.1, 0.9, [
[("구버전 4개(harness·zio-harness·proposal-builder·구 zioinfo)를 쓰던 PC는 먼저 ", 12.5, False, GRAY),
("claude plugin uninstall <이름>@ythong", 12.5, True, NAVY), (" 으로 제거", 12.5, False, GRAY)],
], space=6)
text(s, 0.6, 4.8, 12.1, 1.6, [ text(s, 0.6, 4.8, 12.1, 1.6, [
[("설치 후 ", 13.5, False, GRAY), ("/reload-plugins", 13.5, True, NAVY), [("설치 후 ", 13.5, False, GRAY), ("/reload-plugins", 13.5, True, NAVY),
(" 한 번이면 현재 세션에 즉시 반영 (재시작 불필요)", 13.5, False, GRAY)], (" 한 번이면 현재 세션에 즉시 반영 (재시작 불필요)", 13.5, False, GRAY)],
@ -199,30 +200,30 @@ codebox(s, 0.6, 1.6, 5.95, 2.2, "설치 목록·상태", [
codebox(s, 6.8, 1.6, 5.95, 2.2, "컴포넌트 인벤토리", [ codebox(s, 6.8, 1.6, 5.95, 2.2, "컴포넌트 인벤토리", [
"claude plugin details zioinfo@ythong", "claude plugin details zioinfo@ythong",
]) ])
card(s, 0.6, 4.1, 12.15, 2.2, "정상 판정 기준 (zioinfo )", [ card(s, 0.6, 4.1, 12.15, 2.2, "정상 판정 기준 (zioinfo v2.0.0)", [
"Skills (2): pm-pmo-orchestrator, pmo / Agents (8): pm-planner ~ pm-qa", "Skills 4: zio-harness·harness·proposal-builder-orchestrator·pm-pmo-orchestrator / Commands 3: pmo·proposal·wiki",
"Hooks·MCP·LSP 오류 0", "Agents 15 · Hooks 1(SessionStart graphify) · Themes 1(ZIO WISE) · 오류 0",
"세션에서 /pmo 커맨드가 자동완성에 보이면 로드 완료", "세션에서 /zioinfo:pmo 커맨드가 자동완성에 보이면 로드 완료",
], accent=BLUE, tsize=16) ], accent=BLUE, tsize=16)
footer(s) footer(s)
# ── 7. 플러그인별 사용법 ───────────────────────────────────────────── # ── 7. 플러그인별 사용법 ─────────────────────────────────────────────
s = prs.slides.add_slide(BLANK); header(s, "설치 후 바로 쓰기 — 트리거 한 마디", "USAGE", 7) s = prs.slides.add_slide(BLANK); header(s, "설치 후 바로 쓰기 — 트리거 한 마디", "USAGE", 7)
card(s, 0.6, 1.55, 5.95, 2.45, "harness (메타)", [ card(s, 0.6, 1.55, 5.95, 2.45, "풀스택 개발 (zio-harness 트랙)", [
"\"기능 추가해줘\" · \"push하고 배포 확인해줘\"",
"→ 분석→디자인→구현→검증→전달(hermes) 6인 파이프라인",
], accent=BLUE, tsize=16)
card(s, 6.8, 1.55, 5.95, 2.45, "하네스 팩토리 (harness 트랙)", [
"\"이 프로젝트용 하네스 구성해줘\"", "\"이 프로젝트용 하네스 구성해줘\"",
"→ 에이전트 팀 + 스킬 + CLAUDE.md 자동 생성", "→ 에이전트 팀 + 스킬 + CLAUDE.md 자동 생성",
], accent=NAVY, tsize=16) ], accent=NAVY, tsize=16)
card(s, 6.8, 1.55, 5.95, 2.45, "zio-harness (풀스택)", [ card(s, 0.6, 4.25, 5.95, 2.45, "제안서 (/zioinfo:proposal)", [
"\"zio 실행\" · \"프로젝트 분석\"", "/zioinfo:proposal ○○사업 제안서 또는 \"제안서 작성해줘\"",
"→ React/Spring Boot/Mobile 개발 파이프라인",
], accent=BLUE, tsize=16)
card(s, 0.6, 4.25, 5.95, 2.45, "proposal-builder (제안서)", [
"/proposal ○○사업 제안서 또는 \"제안서 작성해줘\"",
"→ RFP 분석→전략→아키텍처→본문→PPTX→QA", "→ RFP 분석→전략→아키텍처→본문→PPTX→QA",
], accent=SKY, tsize=16) ], accent=SKY, tsize=16)
card(s, 6.8, 4.25, 5.95, 2.45, "zioinfo (PM·PMO)", [ card(s, 6.8, 4.25, 5.95, 2.45, "PM·PMO + LLM wiki", [
"/pmo 프로젝트 계획 · 주간보고 · 감리 준비", "/zioinfo:pmo 프로젝트 계획 · 주간보고 · 감리 준비",
"→ WBS·리스크·보고·감리·포트폴리오·AI 의뢰서", "/zioinfo:wiki → graphify-out/wiki/ 코드베이스 위키 생성",
], accent=STEEL, tsize=16) ], accent=STEEL, tsize=16)
footer(s) footer(s)

View File

@ -3,7 +3,7 @@
이 저장소(`ythong` 마켓플레이스)가 제공하는 Claude Code 플러그인 목록과 설치·검증 방법. 이 저장소(`ythong` 마켓플레이스)가 제공하는 Claude Code 플러그인 목록과 설치·검증 방법.
> 마켓플레이스 매니페스트: [`.claude-plugin/marketplace.json`](../.claude-plugin/marketplace.json) > 마켓플레이스 매니페스트: [`.claude-plugin/marketplace.json`](../.claude-plugin/marketplace.json)
> 최종 업데이트: 2026-07-17 (zioinfo 개명·v1.1.0) > 최종 업데이트: 2026-07-21 (4개 플러그인 → zioinfo v2.0.0 단일 통합)
--- ---
@ -11,10 +11,9 @@
| 플러그인 | 버전 | 설명 | | 플러그인 | 버전 | 설명 |
|----------|------|------| |----------|------|------|
| **harness** | 1.3.1 | 에이전트 팀 & 스킬 아키텍트. 도메인/프로젝트에 맞는 하네스를 구성하고 전문 에이전트·스킬을 생성하는 메타 스킬. | | **zioinfo** (ZIO INFOTECH Suite) | 2.0.0 | 구 4개 플러그인(harness·zio-harness·proposal-builder·zioinfo) 단일 통합판. ①풀스택 개발 6인 팀(orchestrator·analyst·designer·agent·bot·**hermes 전령**) ②하네스 팩토리 메타 스킬 ③제안서 자동완성 7인 팀(`/zioinfo:proposal`) ④PM·PMO 8인 팀(`/zioinfo:pmo`) + graphify 지식그래프 SessionStart 훅·**LLM wiki**(`/zioinfo:wiki`)·ZIO WISE 테마·KINTEX/GUARDiA 지식베이스. |
| **zio-harness** | 1.3.0 | React + Spring Boot + Mobile App 풀스택 개발 하네스. orchestrator·analyst·designer·agent·bot·hermes 6인 팀이 분석→디자인(선 SVG 아이콘·토큰·Stitch 의뢰 design.md)→개발→검증→전달(전령 hermes — Gitea push·배포 확인·산출물 중계·알림)을 파이프라인으로 처리. |
| **proposal-builder** | 1.0.0 | RFP 문서 + PowerPoint 디자인 템플릿 → 제안서 자동 완성. 전문가 7인 팀이 분석→전략→기술/아키텍처→본문→비주얼→PPTX→검증. SI 구축·SM 유지보수 제안 주력. | 구 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으로 통합되어 개별 배포가 종료됐다.
| **zioinfo** | 1.1.0 | PM·PMO 하네스. 전문가 8인 팀(planner·risk·reporter·auditor·governance·portfolio·ai-commissioner·qa)이 계획(WBS/M/M)→리스크/변경→진척보고(EVM)→감리 대응(모의감리·지적조치)→PMO 표준/게이트→포트폴리오→외부 AI 의뢰서(스티치 design.md·젠스파크·graphify 지식그래프)→정합성 검증. 수주 후 수행 단계 주력(제안은 proposal-builder). |
--- ---
@ -31,84 +30,76 @@ claude plugin marketplace add <git-url>
### 2. 플러그인 설치 ### 2. 플러그인 설치
```bash ```bash
claude plugin install proposal-builder@ythong
claude plugin install zioinfo@ythong claude plugin install zioinfo@ythong
claude plugin install zio-harness@ythong
claude plugin install harness@ythong
``` ```
`Successfully installed plugin: <name>@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. 설치·로드 검증 ### 3. 설치·로드 검증
```bash ```bash
claude plugin list # 설치 목록·enabled 상태 claude plugin list # 설치 목록·enabled 상태
claude plugin details proposal-builder@ythong # 컴포넌트 인벤토리·토큰 비용 claude plugin details zioinfo@ythong # 컴포넌트 인벤토리·토큰 비용
``` ```
`details` 출력 예 (proposal-builder, 오류 0 확인): 기대 인벤토리: Skills 4(zio-harness·harness·proposal-builder-orchestrator·pm-pmo-orchestrator) ·
``` Commands 3(pmo·proposal·wiki) · Agents 15 · Hooks 1(SessionStart graphify) · Themes 1(ZIO WISE)
Component inventory
Skills (2) proposal, proposal-builder-orchestrator
Agents (7) rfp-analyst, proposal-strategist, proposal-tech-advisor,
proposal-writer, proposal-visual-designer, deck-designer, proposal-qa
Hooks (0) MCP servers (0) LSP servers (0)
Projected token cost
Always-on: ~1,699 tok
```
> Agent Teams 기능을 쓰는 하네스는 `export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`이 필요하다. 상세: [`experimental-dependency.md`](./experimental-dependency.md). > Agent Teams 기능을 쓰는 하네스는 `export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`이 필요하다. 상세: [`experimental-dependency.md`](./experimental-dependency.md).
--- ---
## proposal-builder 사용 ## 트랙별 사용
설치 후 다음 한 마디로 오케스트레이터가 전문가 7인 + 아키텍처 전문가 풀을 총지휘한다: ### 풀스택 개발 (구 zio-harness)
``` ```
제안서를 작성해줘 사용자 로그인 기능 추가해줘 (React 화면 + API + 모바일) # 6인 파이프라인
``` 이번 변경 Gitea에 push하고 배포 확인해줘 # hermes(전령) Deploy 트랙
또는 슬래시 커맨드:
```
/proposal ○○시스템 구축 사업 제안서
``` ```
### 하네스 팩토리 (구 harness)
```
하네스 구성해줘: <도메인 문장>
```
### 제안서 자동완성 (구 proposal-builder)
```
/zioinfo:proposal ○○시스템 구축 사업 제안서
```
**입력**: ① RFP 문서(PDF·DOCX·나라장터 공고; HWP는 텍스트 변환) ② PPT 디자인 템플릿(.pptx) ③ 발주처·사업명 **입력**: ① RFP 문서(PDF·DOCX·나라장터 공고; HWP는 텍스트 변환) ② PPT 디자인 템플릿(.pptx) ③ 발주처·사업명
**사전 요구사항**: `pip install python-pptx` (PPTX 생성) **사전 요구사항**: `pip install python-pptx`
**상세 가이드**: [`plugins/proposal-builder/docs/INSTALL.md`](../plugins/proposal-builder/docs/INSTALL.md)
### 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 제작. 전 과정 온프레미스(외부 API·온라인 디자인 서비스 호출 없음). 선 아이콘은 외부 라이브러리 금지·직접 SVG 제작.
--- ---
## zioinfo 사용 (구 pm-pmo)
세션 내 간단 설치:
```
/plugin install zioinfo@ythong
/reload-plugins
```
설치 후 다음 한 마디로 오케스트레이터가 8인 팀을 지휘한다:
```
이 계약서로 프로젝트 계획 세워줘
```
또는 슬래시 커맨드:
```
/pmo 이번 주 주간보고 만들어줘
/pmo 종료 감리 준비 (모의감리 포함)
```
**입력**: ① 프로젝트 기초 정보(계약/RFP/과업 범위) ② 요청 유형(계획/보고/리스크/감리/PMO) ③ 실적 데이터(보고·포트폴리오 시)
**상세 가이드**: [`plugins/zioinfo/docs/INSTALL.md`](../plugins/zioinfo/docs/INSTALL.md)
---
## 제거 ## 제거
```bash ```bash
claude plugin uninstall proposal-builder@ythong claude plugin uninstall zioinfo@ythong
``` ```
## 설치 오류 대응 ## 설치 오류 대응
| 증상 | 해결 | | 증상 | 해결 |
|------|------| |------|------|
| `plugin not found` | 마켓플레이스를 먼저 `add` 했는지 확인. Git 설치 시 `plugins/<name>/`이 커밋됐는지 확인. | | `plugin not found` | 마켓플레이스를 먼저 `add` 했는지 확인. Git 설치 시 `plugins/zioinfo/`가 커밋됐는지 확인. |
| `invalid manifest` | `plugins/<name>/.claude-plugin/plugin.json` 존재·JSON 유효성, 루트 `marketplace.json``plugins[]` 등록 확인. BOM 없는 UTF-8인지 확인. | | `invalid manifest` | `plugins/zioinfo/.claude-plugin/plugin.json` 존재·JSON 유효성, 루트 `marketplace.json``plugins[]` 등록 확인. BOM 없는 UTF-8인지 확인. |
| 컴포넌트 로드 누락 | `claude plugin details <name>@ythong`로 인벤토리 점검(에이전트 frontmatter `name`/`description` 필수). | | 컴포넌트 로드 누락 | `claude plugin details zioinfo@ythong`로 인벤토리 점검(에이전트 frontmatter `name`/`description` 필수). |
| 구 플러그인과 충돌 | 구 4개 플러그인을 uninstall — 동일 스킬 중복 로드 시 트리거 불안정. |

View File

@ -1,26 +0,0 @@
{
"name": "proposal-builder",
"description": "RFP 문서와 PowerPoint 디자인 템플릿을 읽어 제안서를 자동 완성하는 하네스. rfp-analyst·strategist·tech-advisor(아키텍처 전문가 총동원)·writer·visual-designer(선 아이콘 직접 제작)·deck-designer·qa 7인 팀이 요구사항 분석→수주전략→기술/아키텍처 설계→본문→비주얼→템플릿 기반 PPTX→규격 검증을 파이프라인으로 처리. 시스템 구축(SI)·유지보수(SM) 제안 주력, 나라장터/공공·민간 RFP 대응.",
"version": "1.0.0",
"author": {
"name": "ythong",
"url": "https://git.zioinfo.co.kr/ythong"
},
"homepage": "https://git.zioinfo.co.kr/ythong/harness",
"repository": "https://git.zioinfo.co.kr/ythong/harness",
"license": "Apache-2.0",
"keywords": [
"harness",
"proposal",
"rfp",
"powerpoint",
"pptx",
"presentation",
"bid",
"narajangter",
"claude-code",
"claude-code-plugin",
"multi-agent",
"pipeline"
]
}

View File

@ -1,39 +0,0 @@
# proposal-builder — 제안서 자동완성 하네스
RFP 문서와 PowerPoint 디자인 템플릿을 읽어 **제안서를 자동 완성**하는 Claude Code 플러그인. 시스템 구축(SI)·유지보수(SM) 제안 주력.
## 무엇을 하나
플러그인을 설치하고 **"제안서를 작성해줘"** 라고 하면, 오케스트레이터가 **전 전문가를 총지휘**해 RFP 분석 → 수주전략 → 기술/아키텍처 설계 → 본문 작성 → 비주얼 디자인 → 템플릿 기반 PPTX 생성 → 규격 검증까지 한 번에 수행한다.
## 전문가 팀 (7인 + 아키텍처 풀)
| 에이전트 | 역할 |
|----------|------|
| `rfp-analyst` | RFP 해부 — 요구사항·평가배점·제출규격·RTM 추출 |
| `proposal-strategist` | 수주전략·win theme·배점가중 목차 |
| `proposal-tech-advisor` | **기술 자문 + 아키텍처 전문가 총동원 허브** (SI 아키텍처·SM 운영체계·SLA·공수산정) |
| `proposal-writer` | 섹션 본문 작성 (RTM 100% 반영) |
| `proposal-visual-designer` | 디자인 시스템 + **선(line) 아이콘 직접 제작** + 도식 컨셉 |
| `deck-designer` | 템플릿 PPTX 해부 + python-pptx 슬라이드 생성 |
| `proposal-qa` | RTM 충족·평가배점·제출규격·실격요건 검증 |
tech-advisor는 RFP 주제에 맞는 **아키텍처 전문가 풀**(architect·backend/frontend/db·pipeline·cloud·security·observability·legacy·capacity·ai/rag 등)을 병렬 소집해 단일 목표 아키텍처로 종합한다.
## 사용
```
1. 마켓플레이스에서 proposal-builder 설치
2. RFP 문서 + PPT 디자인 템플릿(PPTX) 준비
3. "이 RFP랑 템플릿으로 제안서 작성해줘"
→ 오케스트레이터가 Phase1~6 전 파이프라인 자동 지휘
```
## 의존성
- PPTX 생성: `pip install python-pptx`
- HWP RFP는 텍스트 변환 후 제공(외부 업로드 없음 — 온프레미스/로컬 처리)
## 원칙
- 선 아이콘은 외부 라이브러리 금지·직접 SVG 제작
- 과장·허위 금지 — 검증 가능한 역량·실적만
- 자격증명·민감정보 노출 금지

View File

@ -1,62 +0,0 @@
# proposal-builder 설치 & 사용 가이드
## 1. 설치
### 마켓플레이스로 설치 (권장)
```
/plugin marketplace add < 저장소 경로 또는 URL>
/plugin install proposal-builder@ythong
```
- 마켓플레이스 이름: `ythong` (저장소 `.claude-plugin/marketplace.json`)
- 플러그인 이름: `proposal-builder`
### 로컬 경로로 설치
저장소를 클론한 뒤:
```
/plugin marketplace add /경로/harness
/plugin install proposal-builder@ythong
```
설치 후 다음이 등록된다:
- 스킬: `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`)

View File

@ -1,25 +0,0 @@
{
"name": "zio-harness",
"description": "React + Spring Boot + Mobile App 풀스택 개발 하네스. orchestrator·analyst·designer·agent·bot·hermes 에이전트 팀이 기능 개발·디자인(선 SVG 아이콘·디자인 토큰·Stitch 의뢰 design.md)·테스트·전달(전령 hermes — Gitea push·배포 확인·산출물 중계·알림)을 파이프라인으로 처리. PROJECT_MAP.md로 폴더 구조를 세션 간 기억. 설치만으로 graphify 지식 그래프가 소스를 자동 분석(SessionStart 훅)하고, KINTEX 도메인 md 지식 베이스를 내장.",
"version": "1.3.0",
"author": {
"name": "ythong",
"url": "https://git.zioinfo.co.kr/ythong"
},
"homepage": "https://git.zioinfo.co.kr/ythong/harness",
"repository": "https://git.zioinfo.co.kr/ythong/harness",
"license": "Apache-2.0",
"keywords": [
"harness",
"zio-harness",
"fullstack",
"react",
"spring-boot",
"mobile",
"orchestration",
"claude-code",
"claude-code-plugin",
"multi-agent",
"pipeline"
]
}

View File

@ -1,7 +1,9 @@
{ {
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
"name": "zioinfo", "name": "zioinfo",
"description": "PM(프로젝트 관리)·PMO(프로젝트 관리 조직) 하네스. pm-planner·pm-risk-manager·pm-reporter·pm-auditor·pmo-governance·pmo-portfolio·pm-ai-commissioner·pm-qa 8인 팀이 착수/계획(사업수행계획서·WBS·일정·M/M)→리스크/이슈/변경→진척보고(주간/월간/EVM)→감리 대응(점검항목 매핑·모의감리·지적조치)→PMO 거버넌스(방법론·표준·품질게이트)→포트폴리오 총괄→외부 AI 의뢰서(스티치 design.md·젠스파크 조사 의뢰·graphify 지식그래프)→정합성 검증을 파이프라인으로 처리. SI 구축·SM 유지보수 프로젝트 수행 단계 주력.", "displayName": "ZIO INFOTECH Suite",
"version": "1.1.0", "description": "ZIO INFOTECH 통합 하네스 — 4개 플러그인(harness·zio-harness·proposal-builder·zioinfo) 단일 통합판. ①zio-harness: React+Spring Boot+Mobile 풀스택 개발 6인 팀(orchestrator·analyst·designer·agent·bot·hermes 전령 — Gitea push·배포 확인·산출물 중계·알림) + graphify 지식그래프 자동 분석(SessionStart 훅) + LLM wiki 생성(/zioinfo:wiki) + KINTEX·GUARDiA 지식베이스 내장. ②harness: 도메인 한 문장→에이전트 팀+스킬 자동 생성 메타 스킬(6개 팀 아키텍처 패턴). ③proposal-builder: RFP+PPT 템플릿→제안서 자동완성 7인 팀(/zioinfo:proposal). ④PM·PMO: 계획(WBS·M/M)→리스크→진척보고(EVM)→감리 대응→거버넌스→포트폴리오 8인 팀(/zioinfo:pmo). ZIO WISE 테마 동봉.",
"version": "2.0.0",
"author": { "author": {
"name": "ythong", "name": "ythong",
"url": "https://git.zioinfo.co.kr/ythong" "url": "https://git.zioinfo.co.kr/ythong"
@ -10,20 +12,30 @@
"repository": "https://git.zioinfo.co.kr/ythong/harness", "repository": "https://git.zioinfo.co.kr/ythong/harness",
"license": "Apache-2.0", "license": "Apache-2.0",
"keywords": [ "keywords": [
"zioinfo",
"harness", "harness",
"fullstack",
"react",
"spring-boot",
"mobile",
"hermes",
"proposal",
"rfp",
"pm", "pm",
"pmo", "pmo",
"project-management",
"wbs", "wbs",
"risk-management",
"status-report",
"evm", "evm",
"governance",
"portfolio",
"audit", "audit",
"graphify",
"knowledge-graph",
"llm-wiki",
"orchestration",
"claude-code", "claude-code",
"claude-code-plugin", "claude-code-plugin",
"multi-agent", "multi-agent",
"pipeline" "pipeline"
] ],
"experimental": {
"themes": "./themes/"
}
} }

View File

@ -1,7 +1,7 @@
# zioinfo — PM·PMO 하네스 # zioinfo — ZIO INFOTECH 통합 하네스 (v2.0.0)
PM(프로젝트 관리)·PMO(프로젝트 관리 조직) 업무를 8인 전문가 팀이 자동 수행하는 Claude Code 플러그인. 구 4개 플러그인(**harness · zio-harness · proposal-builder · zioinfo**)을 단일 플러그인으로 통합한
제안(수주 전)은 `proposal-builder`가, **수주 후 수행·총괄**은 이 플러그인이 담당한다. ZIO INFOTECH의 Claude Code 올인원 하네스.
## 설치 ## 설치
@ -11,45 +11,54 @@ PM(프로젝트 관리)·PMO(프로젝트 관리 조직) 업무를 8인 전문
``` ```
> 마켓플레이스 미등록 시 먼저: `/plugin marketplace add https://git.zioinfo.co.kr/ythong/harness.git` > 마켓플레이스 미등록 시 먼저: `/plugin marketplace add https://git.zioinfo.co.kr/ythong/harness.git`
> 구버전(harness·zio-harness·proposal-builder 개별 플러그인)을 쓰던 경우 `/plugin uninstall <이름>@ythong` 후 본 플러그인 하나만 설치.
## 전문가 팀 (8) ## 4개 트랙
| 에이전트 | 담당 | | 트랙 | 진입 | 팀 | 담당 |
|----------|------| |------|------|-----|------|
| `pm-planner` | 사업수행계획서·WBS·일정·자원(M/M)·예산 | | **풀스택 개발** (구 zio-harness) | `zio-harness` 스킬 (자연어: "기능 추가", "화면 개발" 등) | 6인: orchestrator·analyst·designer·agent·bot·**hermes(전령)** | React+Spring Boot+Mobile 분석→디자인→구현→검증→전달(Gitea push·배포 확인·산출물 중계·알림) |
| `pm-risk-manager` | 리스크 레지스터·이슈 로그·변경(CR) 영향분석 | | **하네스 팩토리** (구 harness) | `harness` 스킬 ("하네스 구성해줘") | 메타 스킬 | 도메인 한 문장→에이전트 팀+스킬 자동 생성 (6개 팀 아키텍처 패턴) |
| `pm-reporter` | 주간/월간/단계 보고·EVM(SPI/CPI)·경영진 요약 | | **제안서 자동완성** (구 proposal-builder) | `/zioinfo:proposal` | 7인: rfp-analyst·strategist·tech-advisor·writer·visual-designer·deck-designer·qa | RFP+PPT 템플릿→SI/SM 제안서 PPTX |
| `pm-auditor` | 정보시스템 감리 대응(점검항목 매핑·모의감리·지적조치)·검수 준비 | | **PM·PMO** | `/zioinfo:pmo` | 8인: pm-planner·risk-manager·reporter·auditor·pmo-governance·portfolio·ai-commissioner·qa | 계획(WBS·M/M)→리스크→보고(EVM)→감리→거버넌스→포트폴리오→외부 AI 의뢰 |
| `pmo-governance` | 방법론·표준 템플릿·품질게이트·성숙도 진단 |
| `pmo-portfolio` | 다중 프로젝트 대시보드·자원 충돌·우선순위·리스크 롤업 |
| `pm-ai-commissioner` | 외부 AI 의뢰서 — 스티치(Stitch) design.md(이미지 분석 기반)·젠스파크(Genspark) 조사/슬라이드 의뢰 md·graphify 지식그래프(graphify-out/) |
| `pm-qa` | 산출물 경계면 교차 검증 (WBS↔일정↔보고서↔레지스터↔감리매핑↔의뢰서) |
## 사용 ## 최신 플러그인 기능 (v2.0.0)
- **LLM wiki**`/zioinfo:wiki [경로]`: graphify 지식그래프에서 커뮤니티별 아티클(`graphify-out/wiki/`)을 생성/갱신
- **graphify SessionStart 훅** — 설치만으로 프로젝트 소스 자동 분석(`graphify-out/graph.json`), 코드 질문은 그래프 우선
- **ZIO WISE 테마**`/theme`에서 선택 가능 (시안 #11c3ff · 블루 #1f29fc 팔레트, experimental)
- **manifest 최신화**`$schema`(에디터 검증)·`displayName` 적용
- **지식베이스 내장**`knowledge/kintex/`(KINTEX 도메인)·`knowledge/guardia/`(GUARDiA 솔루션 카탈로그·표준 프레임워크·CI/CD·교훈)
## 사용 예
``` ```
/pmo 이 계약서로 프로젝트 계획 세워줘 사용자 로그인 기능 추가해줘 (React 화면 + API + 모바일) ← zio-harness 6인 파이프라인
/pmo 이번 주 주간보고 만들어줘 이번 변경 Gitea에 push하고 배포 확인해줘 ← hermes(전령) Deploy 트랙
/pmo 종료 감리 준비해줘 (모의감리 포함) 하네스 구성해줘: 데이터 마이그레이션 자동화 ← harness 메타 스킬
/pmo 전체 프로젝트 현황 정리해줘 /zioinfo:proposal RFP.pdf와 template.pptx로 제안서 작성
/pmo *.png 파일로 스티치에 의뢰할 design.md 만들어줘 /zioinfo:pmo 이번 주 주간보고 만들어줘
/pmo 젠스파크에 시장조사 의뢰서 작성해줘 /zioinfo:wiki ← 코드베이스 LLM wiki 생성
``` ```
또는 자연어로 — "WBS 작성", "리스크 레지스터 업데이트", "감리 지적사항 조치계획", "PMO 표준 수립", "자원 배분 검토", "디자인 의뢰서", "graphify-out 생성" 등의 요청이 `pm-pmo-orchestrator` 스킬을 트리거한다.
## 산출물
중간 산출물은 `_workspace/`에, 최종 문서는 사용자 지정 경로에 생성:
사업수행계획서 골격 · WBS · 일정 · 리스크/이슈/CR 레지스터 · 주간/월간/완료 보고서 · EVM 지표 · 감리 대응 매핑표 · 모의감리 결과 · 품질게이트 · 포트폴리오 대시보드 · design.md(스티치 의뢰서) · genspark_request.md(젠스파크 의뢰서) · graphify-out/(지식그래프) · QA 보고
## 구성 ## 구성
``` ```
plugins/zioinfo/ plugins/zioinfo/
├── .claude-plugin/plugin.json ├── .claude-plugin/plugin.json # v2.0.0 ($schema·displayName·experimental.themes)
├── agents/ # 8인 에이전트 정의 ├── agents/ # 15인 (proposal 7 + pm·pmo 8)
├── commands/pmo.md # /pmo 슬래시 커맨드 ├── commands/ # /zioinfo:pmo · /zioinfo:proposal · /zioinfo:wiki
├── skills/pm-pmo-orchestrator/SKILL.md ├── skills/
│ ├── zio-harness/ # 풀스택 개발 오케스트레이터 (+references 11종)
│ ├── harness/ # 하네스 팩토리 메타 스킬 (+references 6종)
│ ├── proposal-builder-orchestrator/ # 제안서 (+scripts 2종)
│ └── pm-pmo-orchestrator/ # PM·PMO
├── hooks/hooks.json # SessionStart → graphify 자동 분석
├── scripts/graphify_setup.py
├── themes/zioinfo.json # ZIO WISE 테마
├── knowledge/ # kintex/ + guardia/ 지식베이스
└── docs/INSTALL.md └── docs/INSTALL.md
``` ```
> zio-harness 트랙의 analyst·agent·bot·designer·hermes는 프로젝트별 `.claude/agents/`
> 정의 파일을 생성해 사용한다 (skills/zio-harness/references/*.md의 템플릿 참조).

View File

@ -0,0 +1,21 @@
---
description: 코드베이스 LLM wiki 생성/갱신. graphify 지식그래프에서 커뮤니티별 아티클(index.md + 아티클 md)을 graphify-out/wiki/에 산출한다. "LLM wiki 만들어줘", "위키 생성", "코드 위키", "wiki 갱신" 요청 시 사용.
---
graphify로 대상 코드베이스의 **LLM wiki**를 생성/갱신하라.
대상 경로(있으면): $ARGUMENTS — 없으면 현재 프로젝트 루트.
## 실행 지침
1. **graphify 스킬이 설치돼 있으면 우선 사용**: `/graphify <경로> --wiki` 절차를 따른다 (`~/.claude/skills/graphify/SKILL.md`).
2. 스킬이 없으면 CLI 폴백: `graphify` 실행 파일 확인(없으면 `pip install graphifyy[sql]`) 후,
- 그래프 미존재: `graphify extract <경로> --wiki`
- 그래프 존재(`graphify-out/graph.json`): `graphify update <경로>` 후 wiki 재생성(`--wiki`)
3. 산출 확인: `graphify-out/wiki/index.md` + 커뮤니티별 아티클 md. 산출물 요약(아티클 수·주요 커뮤니티)을 사용자에게 보고한다.
4. 이후 코드베이스 구조 질문은 파일 전수 검색 전에 `graphify query`/`explain`/`path`를 우선 사용한다.
## 원칙
- wiki는 **로컬 산출물**이다 — 외부 업로드·전송 금지, 자격증명·내부 IP가 소스에 있으면 아티클 인용에서 마스킹.
- 대규모 리포는 `--code-only`로 시작하고, wiki가 오래됐으면 재생성보다 `update` 증분을 우선한다.

View File

@ -1,4 +1,4 @@
# zioinfo 설치 & 사용 가이드 # zioinfo 설치 & 사용 가이드 (v2.0.0 통합판)
## 설치 (2단계) ## 설치 (2단계)
@ -8,10 +8,25 @@
``` ```
설치되는 것: 설치되는 것:
- 플러그인 이름: `zioinfo` - 플러그인: `zioinfo` (ZIO INFOTECH Suite) — 구 harness·zio-harness·proposal-builder·zioinfo 4개 통합
- 스킬: `pm-pmo-orchestrator` - 스킬 4종: `zio-harness`(풀스택 개발) · `harness`(하네스 팩토리) · `proposal-builder-orchestrator` · `pm-pmo-orchestrator`
- 커맨드: `/pmo` - 커맨드 3종: `/zioinfo:pmo` · `/zioinfo:proposal` · `/zioinfo:wiki`(LLM wiki)
- 에이전트 8종: pm-planner · pm-risk-manager · pm-reporter · pm-auditor · pmo-governance · pmo-portfolio · pm-ai-commissioner · pm-qa - 에이전트 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
```
## 마켓플레이스가 등록되지 않은 경우 ## 마켓플레이스가 등록되지 않은 경우
@ -30,19 +45,19 @@
## 확인 ## 확인
``` ```
claude plugin list # 설치 목록 claude plugin list # 설치 목록
claude plugin details zioinfo@ythong # 컴포넌트 인벤토리 claude plugin details zioinfo@ythong # 컴포넌트 인벤토리 (스킬 4·커맨드 3·에이전트 15·훅·테마)
``` ```
## 사용 ## 사용
``` ```
/pmo 이 계약서로 프로젝트 계획 세워줘 사용자 로그인 기능 추가해줘 # zio-harness 6인 파이프라인 (hermes 전령 포함)
/pmo 이번 주 주간보고 이번 변경 push하고 배포 확인해줘 # hermes Deploy 트랙
/pmo 종료 감리 준비 (모의감리 포함) 하네스 구성해줘: <도메인 설명> # harness 메타 스킬
/pmo 전체 프로젝트 현황 /zioinfo:proposal RFP와 템플릿으로 제안서 작성
/pmo *.png 파일로 스티치 의뢰 design.md 생성 /zioinfo:pmo 이번 주 주간보고
/pmo 젠스파크에 시장조사 의뢰서 /zioinfo:wiki # 코드베이스 LLM wiki 생성 (graphify-out/wiki/)
``` ```
## 트러블슈팅 ## 트러블슈팅
@ -50,6 +65,8 @@ claude plugin details zioinfo@ythong # 컴포넌트 인벤토리
| 증상 | 조치 | | 증상 | 조치 |
|------|------| |------|------|
| `plugin not found` | 마켓플레이스를 먼저 add 했는지 확인(`/plugin marketplace add ...`). 저장소에 `plugins/zioinfo/`가 커밋됐는지 확인(git 기반 설치 시). | | `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 등록 확인. | | `invalid manifest` | `plugins/zioinfo/.claude-plugin/plugin.json` JSON 유효성 확인. 루트 `.claude-plugin/marketplace.json``plugins[]`에 zioinfo만 등록돼 있는지 확인. |
| 설치 후 `/pmo` 안 보임 | `/reload-plugins` 실행 또는 세션 재시작. | | 설치 후 커맨드 안 보임 | `/reload-plugins` 실행 또는 세션 재시작. 커맨드는 `/zioinfo:pmo`처럼 네임스페이스가 붙는다. |
| 스킬이 트리거 안 됨 | "프로젝트 계획", "주간보고", "감리 대응" 등 명시적 표현 사용 또는 `/pmo` 커맨드 직접 호출. | | 구 플러그인과 스킬 중복 | 구 harness·zio-harness·proposal-builder를 uninstall — 동일 스킬이 두 곳에서 로드되면 트리거가 불안정해진다. |
| graphify 훅이 안 돎 | Python·pip 설치 확인. 끄려면 환경변수 `ZIO_HARNESS_NO_GRAPHIFY=1`. |
| 테마 안 보임 | 테마는 experimental 컴포넌트 — Claude Code 최신 버전 확인 후 `/theme`에서 "ZIO WISE" 선택. |

Some files were not shown because too many files have changed in this diff Show More