harness/docs/plugins.md
DESKTOP-TKLFCPR\ython d87d90069a docs: ythong-harness 플러그인 카탈로그 추가 (plugins.md)
- harness·zio-harness·proposal-builder 목록·버전·설명
- 검증된 설치 명령(marketplace add / install / details)
- proposal-builder 사용법·설치 오류 대응

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-20 23:37:22 +09:00

3.7 KiB

ythong-harness 마켓플레이스 — 플러그인 카탈로그

이 저장소(ythong-harness 마켓플레이스)가 제공하는 Claude Code 플러그인 목록과 설치·검증 방법.

마켓플레이스 매니페스트: .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. 마켓플레이스 등록

# 로컬 디렉토리에서
claude plugin marketplace add /경로/harness
# 또는 Git 원격에서
claude plugin marketplace add <git-url>

Successfully added marketplace: ythong-harness

2. 플러그인 설치

claude plugin install proposal-builder@ythong-harness
claude plugin install zio-harness@ythong-harness
claude plugin install harness@ythong-harness

Successfully installed plugin: <name>@ythong-harness

3. 설치·로드 검증

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.


proposal-builder 사용

설치 후 다음 한 마디로 오케스트레이터가 전문가 7인 + 아키텍처 전문가 풀을 총지휘한다:

제안서를 작성해줘

또는 슬래시 커맨드:

/proposal ○○시스템 구축 사업 제안서

입력: ① RFP 문서(PDF·DOCX·나라장터 공고; HWP는 텍스트 변환) ② PPT 디자인 템플릿(.pptx) ③ 발주처·사업명 사전 요구사항: pip install python-pptx (PPTX 생성) 상세 가이드: plugins/proposal-builder/docs/INSTALL.md

전 과정 온프레미스(외부 API·온라인 디자인 서비스 호출 없음). 선 아이콘은 외부 라이브러리 금지·직접 SVG 제작.


제거

claude plugin uninstall proposal-builder@ythong-harness

설치 오류 대응

증상 해결
plugin not found 마켓플레이스를 먼저 add 했는지 확인. Git 설치 시 plugins/<name>/이 커밋됐는지 확인.
invalid manifest plugins/<name>/.claude-plugin/plugin.json 존재·JSON 유효성, 루트 marketplace.jsonplugins[] 등록 확인. BOM 없는 UTF-8인지 확인.
컴포넌트 로드 누락 claude plugin details <name>@ythong-harness로 인벤토리 점검(에이전트 frontmatter name/description 필수).