Honeypot

Claude Code 플러그인 마켓플레이스 — ISD 연구계획서, 시각자료, 논문 스타일, 연금 포트폴리오 분석, 주식 상담, HWPX 문서 생성

Version: 3.5.0
Author: Baekdong Cha
License: MIT

주요 기능

플러그인	설명	유형
isd-generator	ISD 연구계획서 전체 생성 (5개 Chapter + 이미지)	Agent+Command+Skill
visual-generator	Kurzgesagt/Gov/Seminar/WhatIf/Pitch/Comparison 테마 시각자료 생성 + Gemini 렌더링	Agent+Command+Skill
paper-style-generator	PDF 논문 분석 → 논문 작성 스킬 세트 자동 생성 (메타-플러그인)	Agent+Command+Skill
report-generator	연구 노트 → 국가기관 제출용 연구 보고서 자동 생성	Agent+Command+Skill
investments-portfolio	DC 연금 포트폴리오 분석 멀티 에이전트 시스템	Agent+Command+Skill
stock-consultation	주식/ETF 투자 상담 Multi-Agent. Bogle/Vanguard 철학 기반.	Agent+Command+Skill
hwpx-generator	HWPX 문서 생성/편집/분석 통합 플러그인. XML-first 빌드 + ZIP 치환.	Agent+Command+Skill
macro-analysis	거시경제 분석 공용 에이전트 (지수/금리/섹터/리스크/리더십/종합/검증)	Agent
general-agents	범용 에이전트 (인터뷰 등)	Agent
equity-research	기관급 주식 분석 리포트 생성	Agent
worktree-workflow	Git worktree를 활용한 Claude Code 병렬 실행 워크플로우	Agent
plugin-dev	플러그인 개발 종합 툴킷 (Hook, MCP, 구조, 설정, 커맨드/에이전트/스킬 개발) ¹	Agent+Command+Skill
patent-trend-analyzer	KIPRIS API 기반 특허 동향 분석 (키워드 최적화, 검색, 다축 분류, 시각화)	Agent+Command+Skill

빠른 시작

1. 마켓플레이스 등록

# Claude Code에서 실행
/plugin marketplace add /path/to/honeypot

2. 플러그인 사용

# 예: ISD 연구계획서 생성
@isd-generator 오케스트레이터를 사용해서 연구계획서를 생성해줘

# 예: DC 연금 포트폴리오 분석
@investments-portfolio 포트폴리오 분석을 시작해줘

# 예: 시각자료 생성
@visual-generator 발표 자료를 만들어줘

프로젝트 구조

honeypot/
├── .claude-plugin/
│   └── marketplace.json              # 마켓플레이스 레지스트리 (13개 플러그인)
├── plugins/
│   ├── isd-generator/                # ISD 연구계획서 생성
│   │   ├── agents/                   # 6 agents (chapter1-5, figure)
│   │   ├── commands/                 # isd-generate (오케스트레이터)
│   │   └── skills/                   # 11 skills (chapter guides, core-resources 등)
│   ├── visual-generator/             # 시각자료 생성
│   │   ├── agents/                   # 5 agents (content-organizer, content-reviewer, prompt-designer, prompt-validator, renderer-agent)
│   │   ├── commands/                 # visual-generate (오케스트레이터)
│   │   └── skills/                   # 8 skills (layout-types, theme-*, slide-renderer)
│   ├── paper-style-generator/        # 논문 스타일 스킬 생성
│   │   ├── agents/                   # 3 agents (pdf-converter, style-analyzer, skill-generator)
│   │   ├── commands/                 # paper-style-generate (오케스트레이터)
│   │   └── skills/                   # 1 skill (paper-style-toolkit)
│   ├── report-generator/             # 연구 보고서 생성
│   │   ├── agents/                   # 4 agents (input-analyzer, content-mapper, chapter-writer, quality-checker)
│   │   ├── commands/                 # report-generate (오케스트레이터)
│   │   └── skills/                   # 3 skills (chapter-structure, field-keywords, four-step-pattern)
│   ├── investments-portfolio/        # DC 연금 포트폴리오
│   │   ├── agents/                   # 4 agents (fund-portfolio, compliance-checker, output-critic, material-organizer)
│   │   ├── commands/                 # portfolio-analyze (오케스트레이터)
│   │   └── skills/                   # 11 skills (bogle-principles, dc-pension-rules 등)
│   ├── stock-consultation/           # 주식/ETF 투자 상담
│   │   ├── agents/                   # 5 agents (materials-organizer, stock-screener, stock-valuation, bear-case-critic, stock-critic)
│   │   ├── commands/                 # stock-consult (오케스트레이터)
│   │   └── skills/                   # 3 skills (analyst-common-stock, file-save-protocol-stock, stock-data-verifier)
│   ├── hwpx-generator/               # HWPX 문서 생성/편집/분석
│   │   ├── agents/                   # 2 agents (hwpx-builder, hwpx-analyzer)
│   │   ├── commands/                 # hwpx-generate (오케스트레이터)
│   │   └── skills/                   # 2 skills (hwpx-core, hwpx-templates)
│   ├── macro-analysis/               # 거시경제 분석 공용 에이전트
│   │   └── agents/                   # 7 agents (index-fetcher, rate-analyst, sector-analyst, risk-analyst, leadership-analyst, macro-synthesizer, macro-critic)
│   ├── general-agents/               # 범용 에이전트
│   │   └── agents/                   # 1 agent (interview)
│   ├── equity-research/              # 기관급 주식 분석
│   │   └── agents/                   # 1 agent (equity-research-analyst)
│   ├── worktree-workflow/            # Git worktree 워크플로우
│   │   └── agents/                   # 1 agent (worktree)
│   └── plugin-dev/                   # 플러그인 개발 종합 툴킷 [^1]
│       ├── agents/                   # 3 agents (agent-creator, plugin-validator, skill-reviewer)
│       ├── commands/                 # create-plugin (워크플로우)
│       └── skills/                   # 7 skills (hook, mcp, structure, settings, command, agent, skill)
│   └── patent-trend-analyzer/        # 특허 동향 분석
│       ├── agents/                   # 3 agents (patent-planner, patent-searcher, patent-analyzer)
│       ├── commands/                 # analyze-patents (오케스트레이터)
│       └── skills/                   # 5 skills (mcp-setup, research-planning, search-collect, analysis-viz, ipc-classification-guide)
├── AGENTS.md                         # 프로젝트 상세 지식 베이스
└── README.md                         # 이 문서

플러그인 상세

isd-generator

ISD (기업부설연구소) 연구계획서 자동 생성

워크플로우: Chapter 3 → 1 → 2 → 4 → 5 순서로 생성
오케스트레이터: commands/isd-generate.md
출력: output/[프로젝트명]/chapter_{1-5}/
이미지 생성: Gemini API로 캡션 기반 이미지 자동 생성

구성	항목
Agents (6)	chapter1, chapter2, chapter3, chapter4, chapter5, figure
Command (1)	isd-generate (오케스트레이터)
Skills (11)	chapter1~5-guide, core-resources, data-collection-guide, figure-guide, image-reference-guide, input-template, verification-rules

visual-generator

시각자료 프롬프트 생성 및 렌더링 (6개 테마 + 레이아웃)

동일한 주제(스마트 팩토리)를 6개 테마로 시각화한 예시:

theme-concept — Kurzgesagt 풍 시각 스토리텔링

텍스트 없이 장면과 시각적 메타포만으로 개념을 전달하는 교육용 일러스트레이션

theme-gov — 정부/공공기관 PPT

굵은 테두리 박스에 번호가 매겨진 체계적 격자. 공식 문서 톤.

theme-seminar — 세미나/학술 발표

에디토리얼 매거진 × 아이소메트릭 3D. 포토리얼리스틱 3D 아이콘과 다이나믹 타이포그래피.

theme-whatif — 미래 비전 스냅샷

공상과학 영화 UI처럼 빛나는 HUD. 이미 성공한 미래 안에 서 있는 느낌.

theme-pitch — 피치덱

Apple 키노트처럼 어두운 그래디언트 위의 거대한 숫자와 프로스티드 글래스 카드.

theme-comparison — Before/After 비교

IMAX 분할 화면처럼 좌우 풀블리드 이미지 위에 핵심 수치가 떠 있다.

구성	항목
Agents (5)	content-organizer, content-reviewer, prompt-designer, prompt-validator, renderer-agent
Command (1)	visual-generate (오케스트레이터)
Skills (8)	layout-types, theme-concept, theme-gov, theme-seminar, theme-whatif, theme-pitch, theme-comparison, slide-renderer

paper-style-generator

PDF 논문 → 논문 작성 스킬 세트 생성 (메타-플러그인)

MinerU로 PDF → Markdown 변환
스타일 패턴 추출 (Voice, Tense, 전환어 등)
하이브리드 플러그인 생성 (9 agents + 1 skill):
- Agents: {name}-paper-orchestrator, {name}-title-writer, {name}-abstract-writer, {name}-introduction-writer, {name}-methodology-writer, {name}-results-writer, {name}-discussion-writer, {name}-caption-writer, {name}-verify
- Skill: {name}-style-guide (스타일 가이드 + 11개 참조 문서)

구성	항목
Agents (3)	pdf-converter, style-analyzer, skill-generator
Command (1)	paper-style-generate (오케스트레이터)
Skills (1)	paper-style-toolkit (스크립트, 템플릿, 참조자료)

report-generator

연구 노트 → 국가기관 제출용 연구 보고서 생성

입력: 폴더, 파일, 코드베이스
출력: 최대 9개 챕터 전문 보고서
문장 패턴: 4단계 패턴 적용 (What → Why → How → Impact)

구성	항목
Agents (4)	input-analyzer, content-mapper, chapter-writer, quality-checker
Command (1)	report-generate (오케스트레이터)
Skills (3)	chapter-structure, field-keywords, four-step-pattern

investments-portfolio

DC형 퇴직연금 포트폴리오 분석 멀티 에이전트 시스템

Agent Group	Agents	역할
Macro Analysis (macro-analysis)	index-fetcher, rate-analyst, sector-analyst, risk-analyst, leadership-analyst	거시경제 분석
Synthesizers (macro-analysis)	macro-synthesizer, macro-critic	분석 종합 및 검증
Portfolio (investments-portfolio)	fund-portfolio, compliance-checker	펀드 추천 및 규제 검증
Verification	output-critic, material-organizer	출력 검증 및 자료 정리

구성	항목
Agents (4)	fund-portfolio, compliance-checker, output-critic, material-organizer
Command (1)	portfolio-analyze (오케스트레이터)
Skills (11)	analyst-common, bogle-principles, data-updater, dc-pension-rules, devil-advocate, file-save-protocol, fund-output-template, fund-selection-criteria, macro-output-template, perspective-balance, web-search-verifier

stock-consultation

주식/ETF 투자 상담 Multi-Agent 시스템 (Bogle/Vanguard 철학 기반)

워크플로우: 거시경제 분석 → 종목 스크리닝 → 밸류에이션 → 반대 논거 → 최종 검증

구성	항목
Agents (5)	materials-organizer, stock-screener, stock-valuation, bear-case-critic, stock-critic
Command (1)	stock-consult (오케스트레이터)
Skills (3)	analyst-common-stock, file-save-protocol-stock, stock-data-verifier

hwpx-generator

HWPX 문서 생성/편집/분석 통합 플러그인

방식: XML-first 빌드 + ZIP 치환
build_hwpx.py 기반 생성, fix_namespaces.py 필수
v2.4.0: ZIP-level surgery 도구 추가 (zip_surgery.py), validate.py --strict 모드, cell_writer 금지 규칙 적용
v2.3.0: <hp:linesegarray> 자동 생성 — 한컴오피스 외 뷰어에서도 정확한 텍스트 레이아웃 보장 (cell_writer.py, 3개 빌드 경로 통합)

구성	항목
Agents (2)	hwpx-builder, hwpx-analyzer
Command (1)	hwpx-generate (오케스트레이터)
Skills (2)	hwpx-core, hwpx-templates

macro-analysis

거시경제 분석 공용 에이전트 모음

investments-portfolio, stock-consultation 등에서 공유하는 거시경제 분석 에이전트 7종.

Agent	역할
index-fetcher	주요 지수 데이터 수집
rate-analyst	금리 분석
sector-analyst	섹터 분석
risk-analyst	리스크 분석
leadership-analyst	리더십/정책 분석
macro-synthesizer	분석 종합
macro-critic	분석 검증

equity-research

기관급 주식 분석 리포트 생성

티커와 함께 호출하면 기관급(institutional-grade) 주식 분석 리포트를 생성합니다.

general-agents

범용 에이전트 모음

interview: 심층 인터뷰 + 실행 에이전트

worktree-workflow

Git worktree 기반 병렬 실행 워크플로우

Git worktree를 활용하여 Claude Code 인스턴스를 병렬로 실행하는 워크플로우.

plugin-dev

플러그인 개발 종합 툴킷 ¹

Claude Code 플러그인(에이전트/커맨드/스킬) 개발을 위한 가이드와 검증 도구.

에이전트 생성: 프론트매터/본문/워크플로 템플릿 기반 자동 생성
플러그인 검증: marketplace.json, plugin.json, 구조 규칙 준수 검사
스킬 리뷰: SKILL.md 스펙 준수, 프로그레시브 로딩, 리소스 구조 검토

구성	항목
Agents (3)	agent-creator, plugin-validator, skill-reviewer
Command (1)	create-plugin (플러그인 생성 워크플로)
Skills (7)	hook-development, mcp-integration, plugin-structure, plugin-settings, command-development, agent-development, skill-development

patent-trend-analyzer

⚠️ 해외 특허 서비스 신규 구독 후 1~2일간 서버 전파 지연이 발생할 수 있습니다 (간헐적 AccessKey Not Registered 에러). 한국 특허는 즉시 사용 가능.

KIPRIS API 기반 특허 동향 분석 및 시각화

연구 주제를 입력하면 3단계 파이프라인(계획 → 검색 → 분석)을 거쳐 분류, 트렌드 분석, 시각화 대시보드까지 자동 생성합니다. 특정 기술 도메인에 종속되지 않으며 모든 연구 분야에 적용 가능합니다.

L1 Planning ──→ L2 Search ──→ L3 Analysis

@patent-trend-analyzer "자율주행 라이다 센서" 주제로 특허 동향 분석을 해줘.
대상 국가는 한국, 미국이고 분석 기간은 2020-2025년이야.

사전 준비: KIPRIS Open API 키 발급

KIPRIS Plus 포털에서 회원 가입 → 서비스 조회 → 구매 신청 → 수수료 결제 → APIKEY 관리에서 인증키 확인 (5단계). 승인까지 1~2 영업일 소요.

MCP 서버 자동 설정

/patent-trend-analyzer:patent-mcp-setup {발급받은_API_키} 설정해줘

API 키가 없으면 발급 절차를 안내합니다. venv 생성 + 패키지 설치 + 클라이언트 설정 파일(Claude Code / OpenCode) 등록까지 자동 수행됩니다.

구성	항목
Agents (3)	patent-planner, patent-searcher, patent-analyzer
Command (1)	analyze-patents (오케스트레이터)
Skills (5)	patent-mcp-setup, patent-research-planning, patent-search-collect, patent-analysis-viz, ipc-classification-guide

파이프라인 상세, 출력 구조, IPC 코드 가이드, 수동 설정 등은 patent-trend-analyzer README 참조

Submodule 사용법

이 저장소를 다른 프로젝트의 하위 디렉토리로 추가하여 사용할 수 있습니다.

Submodule 추가

cd your-project
git submodule add https://github.com/orientpine/honeypot.git honeypot
git commit -m "Add honeypot as submodule"

Submodule 클론

# 방법 A: 처음부터 submodule과 함께
git clone --recurse-submodules https://github.com/username/your-project.git

# 방법 B: 이미 클론 후 초기화
git submodule update --init --recursive

Submodule 업데이트

# 최신 버전으로 업데이트
git submodule update --remote --merge

# 메인 프로젝트에 반영 (필수!)
git add honeypot
git commit -m "Update honeypot submodule"
git push

자주 사용하는 명령어

명령어	설명
`git submodule status`	상태 확인
`git submodule update --init --recursive`	초기화
`git submodule update --remote --merge`	최신화
`git diff --submodule`	변경사항 확인

전역 설정 (권장)

# 앞으로 git 작업 시 submodule 자동 업데이트
git config --global submodule.recurse true

개발 가이드

플러그인 표준 구조

plugins/{plugin-name}/
├── .claude-plugin/
│   └── plugin.json          # 플러그인 메타데이터
├── agents/                  # 에이전트 .md 파일
├── commands/                # 커맨드(워크플로우) .md 파일
└── skills/                  # 스킬 폴더 (각 스킬은 하위 디렉토리)
    └── {skill-name}/
        ├── SKILL.md         # 스킬 정의 (필수)
        ├── references/      # 참조 문서
        ├── assets/          # 템플릿, 리소스
        └── scripts/         # 실행 스크립트

scripts/, references/, assets/는 반드시 스킬 폴더 내부에 위치해야 합니다 (플러그인 루트 금지).

새 플러그인 추가 시

plugins/{plugin-name}/ 디렉토리 생성
.claude-plugin/plugin.json 생성
agents/, commands/, skills/ 하위에 .md 파일 작성
.claude-plugin/marketplace.json에 플러그인 등록
캐시 클리어 후 재등록

주의사항

marketplace.json은 루트에 하나만 유지
모든 .md 파일은 LF 줄바꿈 사용
description에 특수문자 포함 시 큰따옴표로 감싸기
Agent/Skill 파일 추가/삭제 시 marketplace.json 동기화 필수
플러그인 수정 시 plugin.json + marketplace.json 버전 동시 업데이트

상세 개발 가이드는 AGENTS.md 참조

참고 링크

변경 이력

버전	날짜	변경 내용
3.5.0	2026-03-17	visual-generator v3.2.0: Must-Render Registry 추가 (4개 테마 필수 렌더링 요소 명시화), marketplace metadata 버전 동기화 (2.4.0→3.5.0)
3.4.0	2026-03-16	patent-trend-analyzer v1.2.0: MCP 설정 스킬 개선 — API 키 발급 안내, venv 기반 설치, Claude Code/OpenCode 이중 설정(형식 차이 대응), 트러블슈팅 보강
3.3.0	2026-03-16	patent-trend-analyzer 플러그인 추가 (KIPRIS API 기반 특허 동향 분석, IPC 분류 가이드, 3 agents + 1 command + 5 skills)
3.2.0	2026-03-13	hwpx-generator v2.4.0: ZIP-level surgery 도구 추가 (zip_surgery.py, HwpxSurgeon), validate.py --strict 모드, cell_writer 금지 규칙, 표 행 높이 자동 조절, 단계적 디버깅 전략
3.1.0	2026-03-10	6개 테마 예시 프롬프트를 v3.0.0 Golden Reference로 업데이트 + Gemini API로 전체 이미지 재생성. 임시/계획 파일 정리.
3.0.0	2026-03-09	visual-generator v3.0.0: 4-block 마크다운 프롬프트 형식 복원 (INSTRUCTION/CONFIGURATION/CONTENT/FORBIDDEN) + v2.x 품질 보호 통합 (Style Sheet, Golden Reference, prompt-validator 7차원, 팔레트 세션 고정)
2.5.0	2026-03-09	visual-generator v2.2.0: 폰트명 유출 차단, 최소 텍스트 밀도(body≥8) 강제, Style Sheet 기반 슬라이드 일관성, prompt-validator 강화(밀도/폰트/팔레트 검증 추가)
2.4.1	2026-03-08	visual-generator v2.1.1: Golden Reference `<text_to_render>` key:value 형식 통일(4개 테마), 파이프라인 다이어그램 prompt-validator 반영, layout-types Progressive Disclosure 분리(938→82줄 + references/layout-catalog.md), scene-richness-spec 테마명 교정, README agent 수 5개 반영
2.4.0	2026-03-07	visual-generator v2.0.0: XML-tag 프롬프트 시스템 전면 개편 — 4-block 마크다운(INSTRUCTION/CONFIGURATION/CONTENT/FORBIDDEN) → 5-tag XML(`<scene>`, `<text_to_render>`, `<typography>`, `<canvas>`, `<layout>`) 전환. render_text/scene_context 분류 체계, 한국어 타이포그래피 가이드 추가
2.3.5	2026-03-06	visual-generator v1.11.0: Data Elements 메타라벨 방지 원칙, Content Placement 조사 문장 형식 강제, 세미나 테마 원 번호 마커 금지, renderer 검증 #12·#13 추가
2.3.4	2026-03-06	visual-generator v1.10.1: renderer-agent에 번호 참조 체계·고아 항목·세미나 라벨 탈맥락화 검증 3종 추가
2.3.3	2026-03-06	visual-generator v1.10.0: CONTENT↔Content Placement 전수 대응 원칙 추가 (고아 항목·Data 중복·개념 키워드 혼입 방지)
2.3.2	2026-03-06	visual-generator v1.9.0: 이중 렌더링 방지(번호 참조 체계), 세미나 테마 장면화 방지(테마 라벨 탈맥락화), 축 기반 레이아웃 공간-의미 역검증 추가
2.3.1	2026-03-05	hwpx-generator v2.3.0: linesegarray 자동 생성으로 전환 (cell_writer.py 신규, build_hwpx/pack 통합, 뷰어 호환성 보장)
2.3.0	2026-03-04	plugin-dev 플러그인 추가 (Anthropic claude-code 공식 저장소에서 포팅)
2.2.0	2026-02-27	visual-generator 6개 테마 예시 이미지 추가 (Gemini API 생성), README 시각적 개선
2.1.0	2026-02-27	README 전면 최신화: 표준 구조 반영, 11개 플러그인 문서화, visual-generator 6테마 체계 반영
2.0.0	2026-01-11	README 완전 재작성, 6개 플러그인 문서화
1.0.0	2026-01-08	최초 작성

anthropics/claude-code plugins/plugin-dev의 내용을 참조하여 포팅하였습니다. 원본 저자: Daisy Hollman (daisy@anthropic.com), 라이선스: MIT. ↩ ↩²

Name		Name	Last commit message	Last commit date
Latest commit History 294 Commits
.claude-plugin		.claude-plugin
.sisyphus		.sisyphus
assets/theme-examples		assets/theme-examples
plugins		plugins
resource		resource
scripts		scripts
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation