개요

본 문서는 Claude Code 플러그인 마켓플레이스의 등록, 설치 및 사용 방법을 기술합니다.

seungah-claude-plugins 마켓플레이스를 통해 플러그인을 공유하고 있습니다. 현재 다음 4개의 팀별 플러그인으로 구성되어 있습니다.

마켓플레이스 버전: 1.4.0 · 저장소: https://github.com/seungahhong/seungah-claude-plugins

설치 방법

설치는 3가지 방법을 지원합니다. 팀 내 공유 시에는 방법 A(마켓플레이스 등록 후 설치)를 권장합니다.

방법 A - 마켓플레이스 등록 후 설치 (권장)

2단계로 진행됩니다.

Step 1. 마켓플레이스 추가

마켓플레이스 레지스트리를 로컬 환경에 등록합니다. 이 단계에서는 사용 가능한 플러그인 목록만 등록되며, 스킬이 활성화되지는 않습니다.

# seugnah-claude-plugins
/plugin marketplace add https://github.com/seungahhong/seungah-claude-plugins

(참고) github clone이 안되어 마켓플레이스 추가가 안된다면

gh auth login

Step 2. 플러그인 설치

등록된 마켓플레이스에서 원하는 플러그인을 선택하여 설치합니다.

# seugnah-claude-plugins 내 플러그인
/plugin install frontend-harness@seungah-claude-plugins

/plugin install frontend-harness

설치 범위는 다음 3가지 중 선택할 수 있습니다.

방법 B - GitHub에서 직접 설치

GitHub 저장소에서 CLI로 마켓플레이스를 직접 추가하는 방법입니다.

claude plugin add seungahhong/seungah-claude-plugins

방법 C - 로컬 경로로 설치

로컬에 클론된 저장소 경로를 지정하여 설치하는 방법입니다. 개발 및 디버깅 시 유용합니다.

claude --plugin-dir /path/to/frontend-harness

마켓플레이스 등록 화면

아래는 seungah-claude-plugins 마켓플레이스 등록 및 플러그인 설치 과정입니다.

1단계. /plugin 명령어 입력

Claude Code 실행 후 /plugin 명령어를 입력합니다.

/plugin 명령어 자동완성 화면

2단계. Add Marketplace - 마켓플레이스 URL 입력

Add Marketplace를 선택하고, 마켓플레이스 저장소 URL을 입력합니다.

seungah-claude-plugins URL 입력 화면

3단계. Discover - 설치 가능한 플러그인 목록 확인

Discover 탭에서 설치 가능한 플러그인 목록을 확인합니다.

• Discover 탭 플러그인 목록
• space 클릭 해서 선택 → enter 설치 진행

4단계. Plugin Details - 플러그인 상세 및 설치 범위 선택

설치할 플러그인을 선택하면 상세 정보가 표시됩니다. 설치 범위(user/project/local scope)를 선택합니다.

frontend-harness Plugin Details 화면

5단계. 설치 확인 - settings.local.json

설치가 완료되면 .claude/settings.local.json에 enabledPlugins 설정이 추가됩니다.

settings.local.json 확인 화면

6단계. 스킬 실행

설치된 플러그인의 스킬을 /스킬명 형식으로 실행합니다.

• /a11y 스킬 실행 화면
• 나오지 않을 경우 /reload-plugins 실행 후 /(슬러시) 명령어 재시도

플러그인 구성 요소

각 팀 플러그인은 아래 구성 요소를 조합하여 사용합니다.

구성 요소 추가 시 marketplace.json 수정은 불필요합니다. plugin.json에 경로가 선언되어 있으므로, 해당 디렉토리에 파일만 추가하면 됩니다.

스킬 구성

frontend-harness 플러그인 (12개 스킬)

커맨드 (7개)

훅 (1개)

harness-generator 플러그인 (1개 스킬)

git-harness 플러그인 (2개 스킬)

meta-harness 플러그인 (4개 스킬 + 4개 에이전트)

에이전트 4종(모두 model: opus): trace-capturer(원형 trace 정규화) · failure-diagnostician(결함별 root cause 병렬 진단) · pareto-refiner(패치 생성) · experience-historian(experience-store 큐레이션).

GitHub 저장소 활용

저장소: https://github.com/seungahhong/seungah-claude-plugins

사용자가 사용하는 방법

1. 마켓플레이스 등록 — Claude Code에서 /plugin marketplace add https://github.com/seungahhong/seungah-claude-plugins (또는 CLI claude plugin add seungahhong/seungah-claude-plugins)
2. 플러그인 설치 — /plugin install frontend-harness@seungah-claude-plugins 처럼 원하는 플러그인만 골라 설치 (user / project / local scope 선택)
3. 스킬 실행 — 설치 후 /planner, /review, /commit 등 슬래시 커맨드로 호출하거나 자연어로 트리거. 목록이 안 보이면 /reload-plugins 후 재시도
4. 업데이트 — 저장소에 변경이 반영되면 /plugin marketplace update seungah-claude-plugins 로 최신화

기여·로컬 개발

git clone https://github.com/seungahhong/seungah-claude-plugins.git
cd seungah-claude-plugins
# 로컬 경로로 바로 로드하여 디버깅
claude --plugin-dir ./plugins/frontend-harness

구성 요소(skills / commands / agents / hooks)는 각 플러그인 디렉토리에 파일만 추가하면 되고, marketplace.json 수정은 불필요합니다(plugin.json에 경로가 선언되어 있음).

사용 예시

설치 완료 후, Claude Code 대화창에서 자연어 또는 슬래시 커맨드로 스킬을 트리거할 수 있습니다.

스킬 단위 실행 흐름

/grill-me            // 1. 요구사항 명확화
/planner             // 2. 구현 계획(PRD)
/architecture        // 3. 기술 아키텍처 설계
/critic              // 4. 설계 검증·리스크 분석
/tdd                 // 5. 테스트 주도 구현
/a11y /semantic-html /seo-geo-optimizer   // 6. 품질·접근성·SEO 점검
/review              // 7. 통합 리뷰(5개 관점 중 선택 병렬 + 재리뷰 루프)
/verify              // 8. 동작·빌드 검증(E2E + tsc + build)
/commit              // 9. 커밋 메시지 작성(git-harness)

오케스트레이터로 전체 자동화

/orchestrator        // research → prd → develop → review → verify 전체 파이프라인 자동 실행

메타 워크플로우 — 하네스 자체 다루기

/harness-generator   // 신규 도메인용 하네스(에이전트+스킬+오케스트레이터) 한 묶음 생성
/meta-harness        // 사용 중인 하네스를 full-trace로 캡처·진단·개선(사용자 승인 게이트)

자연어 트리거 예시

• “이 컴포넌트 웹접근성 점검해줘” → /a11y
• “배포 전 보안 감사랑 성능 검사 해줘” → /review(security-audit + lighthouse 선택)
• “이 변경사항 한국어로 커밋해줘” → /commit
• “결제 기능 처음부터 끝까지 개발해줘” → /orchestrator