harness/docs/plugins.md
DESKTOP-TKLFCPR\ython 1876e3a18a feat(zio-harness): v1.2.0 — designer 에이전트 추가 (4→5인 파이프라인) + 팀 이미지 일치화
- 파이프라인: analyst → designer(UI 작업 시) → agent → bot
- references/designer.md 신설: UI/UX 스펙(01_design_spec.md)·디자인 토큰·
  선(line) SVG 아이콘 직접 제작 + 스티치(Stitch) 의뢰 design.md 생성
  (Stitch MCP 연결 시 직접 요청·검수, 미연결 시 의뢰서 산출)
- SKILL.md 배선: 팀 구성·spawn·태스크 의존성(t1~t4)·통신 프로토콜
  (bot→designer 시각 QA 반려)·작업 유형 Design 추가·UI 없는 작업 3인 규칙
- zioinfo_team.png: Designer(디자인) 노드 추가 — 지휘→분석→디자인→개발→검증
  5인 순환 다이어그램 (실제 플러그인 동작과 일치)
- plugin.json·marketplace.json v1.2.0, 카탈로그/PROJECT_MAP/CLAUDE.md 동기화
- 검증: claude plugin details zio-harness@ythong → v1.2.0 오류 0

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-17 10:00:29 +09:00

115 lines
4.8 KiB
Markdown

# ythong 마켓플레이스 — 플러그인 카탈로그
이 저장소(`ythong` 마켓플레이스)가 제공하는 Claude Code 플러그인 목록과 설치·검증 방법.
> 마켓플레이스 매니페스트: [`.claude-plugin/marketplace.json`](../.claude-plugin/marketplace.json)
> 최종 업데이트: 2026-07-17 (zioinfo 개명·v1.1.0)
---
## 플러그인 목록
| 플러그인 | 버전 | 설명 |
|----------|------|------|
| **harness** | 1.3.1 | 에이전트 팀 & 스킬 아키텍트. 도메인/프로젝트에 맞는 하네스를 구성하고 전문 에이전트·스킬을 생성하는 메타 스킬. |
| **zio-harness** | 1.2.0 | React + Spring Boot + Mobile App 풀스택 개발 하네스. orchestrator·analyst·designer·agent·bot 5인 팀이 분석→디자인(선 SVG 아이콘·토큰·Stitch 의뢰 design.md)→개발→검증을 파이프라인으로 처리. |
| **proposal-builder** | 1.0.0 | RFP 문서 + PowerPoint 디자인 템플릿 → 제안서 자동 완성. 전문가 7인 팀이 분석→전략→기술/아키텍처→본문→비주얼→PPTX→검증. SI 구축·SM 유지보수 제안 주력. |
| **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). |
---
## 설치 (검증된 명령)
### 1. 마켓플레이스 등록
```bash
# 로컬 디렉토리에서
claude plugin marketplace add /경로/harness
# 또는 Git 원격에서
claude plugin marketplace add <git-url>
```
`Successfully added marketplace: ythong`
### 2. 플러그인 설치
```bash
claude plugin install proposal-builder@ythong
claude plugin install zioinfo@ythong
claude plugin install zio-harness@ythong
claude plugin install harness@ythong
```
`Successfully installed plugin: <name>@ythong`
### 3. 설치·로드 검증
```bash
claude plugin list # 설치 목록·enabled 상태
claude plugin details proposal-builder@ythong # 컴포넌트 인벤토리·토큰 비용
```
`details` 출력 예 (proposal-builder, 오류 0 확인):
```
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).
---
## proposal-builder 사용
설치 후 다음 한 마디로 오케스트레이터가 전문가 7인 + 아키텍처 전문가 풀을 총지휘한다:
```
제안서를 작성해줘
```
또는 슬래시 커맨드:
```
/proposal ○○시스템 구축 사업 제안서
```
**입력**: ① RFP 문서(PDF·DOCX·나라장터 공고; HWP는 텍스트 변환) ② PPT 디자인 템플릿(.pptx) ③ 발주처·사업명
**사전 요구사항**: `pip install python-pptx` (PPTX 생성)
**상세 가이드**: [`plugins/proposal-builder/docs/INSTALL.md`](../plugins/proposal-builder/docs/INSTALL.md)
전 과정 온프레미스(외부 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
claude plugin uninstall proposal-builder@ythong
```
## 설치 오류 대응
| 증상 | 해결 |
|------|------|
| `plugin not found` | 마켓플레이스를 먼저 `add` 했는지 확인. Git 설치 시 `plugins/<name>/`이 커밋됐는지 확인. |
| `invalid manifest` | `plugins/<name>/.claude-plugin/plugin.json` 존재·JSON 유효성, 루트 `marketplace.json``plugins[]` 등록 확인. BOM 없는 UTF-8인지 확인. |
| 컴포넌트 로드 누락 | `claude plugin details <name>@ythong`로 인벤토리 점검(에이전트 frontmatter `name`/`description` 필수). |