From d87d90069a40e5635d5008709d6f07aab82f2ca1 Mon Sep 17 00:00:00 2001 From: "DESKTOP-TKLFCPR\\ython" Date: Sat, 20 Jun 2026 23:37:22 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20ythong-harness=20=ED=94=8C=EB=9F=AC?= =?UTF-8?q?=EA=B7=B8=EC=9D=B8=20=EC=B9=B4=ED=83=88=EB=A1=9C=EA=B7=B8=20?= =?UTF-8?q?=EC=B6=94=EA=B0=80=20(plugins.md)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - harness·zio-harness·proposal-builder 목록·버전·설명 - 검증된 설치 명령(marketplace add / install / details) - proposal-builder 사용법·설치 오류 대응 Co-Authored-By: Claude Opus 4.8 --- docs/plugins.md | 89 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 89 insertions(+) create mode 100644 docs/plugins.md diff --git a/docs/plugins.md b/docs/plugins.md new file mode 100644 index 0000000..8774afa --- /dev/null +++ b/docs/plugins.md @@ -0,0 +1,89 @@ +# ythong-harness 마켓플레이스 — 플러그인 카탈로그 + +이 저장소(`ythong-harness` 마켓플레이스)가 제공하는 Claude Code 플러그인 목록과 설치·검증 방법. + +> 마켓플레이스 매니페스트: [`.claude-plugin/marketplace.json`](../.claude-plugin/marketplace.json) +> 최종 업데이트: 2026-06-20 (proposal-builder 추가·설치 검증 완료) + +--- + +## 플러그인 목록 + +| 플러그인 | 버전 | 설명 | +|----------|------|------| +| **harness** | 1.3.1 | 에이전트 팀 & 스킬 아키텍트. 도메인/프로젝트에 맞는 하네스를 구성하고 전문 에이전트·스킬을 생성하는 메타 스킬. | +| **zio-harness** | 1.0.1 | React + Spring Boot + Mobile App 풀스택 개발 하네스. orchestrator·analyst·bot·agent 팀이 개발·테스트·배포를 파이프라인으로 처리. | +| **proposal-builder** | 1.0.0 | RFP 문서 + PowerPoint 디자인 템플릿 → 제안서 자동 완성. 전문가 7인 팀이 분석→전략→기술/아키텍처→본문→비주얼→PPTX→검증. SI 구축·SM 유지보수 제안 주력. | + +--- + +## 설치 (검증된 명령) + +### 1. 마켓플레이스 등록 +```bash +# 로컬 디렉토리에서 +claude plugin marketplace add /경로/harness +# 또는 Git 원격에서 +claude plugin marketplace add +``` +→ `Successfully added marketplace: ythong-harness` + +### 2. 플러그인 설치 +```bash +claude plugin install proposal-builder@ythong-harness +claude plugin install zio-harness@ythong-harness +claude plugin install harness@ythong-harness +``` +→ `Successfully installed plugin: @ythong-harness` + +### 3. 설치·로드 검증 +```bash +claude plugin list # 설치 목록·enabled 상태 +claude plugin details proposal-builder@ythong-harness # 컴포넌트 인벤토리·토큰 비용 +``` + +`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 제작. + +--- + +## 제거 +```bash +claude plugin uninstall proposal-builder@ythong-harness +``` + +## 설치 오류 대응 +| 증상 | 해결 | +|------|------| +| `plugin not found` | 마켓플레이스를 먼저 `add` 했는지 확인. Git 설치 시 `plugins//`이 커밋됐는지 확인. | +| `invalid manifest` | `plugins//.claude-plugin/plugin.json` 존재·JSON 유효성, 루트 `marketplace.json`의 `plugins[]` 등록 확인. BOM 없는 UTF-8인지 확인. | +| 컴포넌트 로드 누락 | `claude plugin details @ythong-harness`로 인벤토리 점검(에이전트 frontmatter `name`/`description` 필수). |