Claude Code 플러그인 마켓플레이스
TUI 없이 /plugin install 한 번으로 preset 전체를 설치하는 두 번째 채널.

플러그인 마켓플레이스란

Claude Code에는 플러그인 시스템이 있습니다. agent-harness-store는 각 preset을 Claude Code 플러그인 형태로 빌드해서 마켓플레이스에 등록합니다. 사용자는 /plugin 명령으로 한 번에 설치합니다.

현재 등록된 플러그인 (4개)

fe-agent-harness
Next.js/TypeScript 프로젝트를 위한 완전한 FE 하네스. 24개 rules + 26개 skills.
be-agent-harness
Flask/Python 프로젝트를 위한 완전한 BE 하네스. 21개 rules + 19개 skills.
nx-best-practices
Nx 모노레포 독립 preset. FE 하네스에 포함된 것과 동일하지만 단독으로도 설치 가능.
example-baseline
기여 시 참조용 최소 예시 preset.

마켓플레이스 사용 방법

# 1. 마켓플레이스 추가 (최초 1회)
/plugin marketplace add <마켓플레이스 URL 또는 로컬 경로>

# 2. 설치 가능한 플러그인 목록 확인
/plugin list

# 3. 플러그인 설치
/plugin install fe-agent-harness
/plugin install be-agent-harness

# 4. 설치 확인
/plugin list --installed
ℹ️ 마켓플레이스 URL은 팀 내 Bitbucket 또는 공유 서버에서 제공합니다. 설치 후에는 TUI 설치와 동일하게 .agents/ 폴더와 CLAUDE.md managed block이 생성됩니다.

build-marketplace 빌드 프로세스

store 관리자가 콘텐츠를 업데이트하면 agent-harness-build-marketplace로 마켓플레이스를 재빌드합니다. 빌드 프로세스가 rules와 skills를 처리하는 방식이 다릅니다.

agent-harness-build-marketplace ├── presets/fe-agent-harness.yaml를 읽음 │ ├── rules 처리 │ │ ├── rules/workflow/plan-first.md → 변환 │ │ │ └── disable-model-invocation: true 추가 │ │ │ └── plugins/fe-agent-harness/skills/workflow-plan-first/SKILL.md │ │ └── (24개 rules 모두 같은 방식으로 변환) │ │ │ └── skills 처리 │ ├── skills/monorepo/nx-best-practices/ → 복사 │ │ └── name: "monorepo-nx-best-practices" (네임스페이싱) │ │ └── plugins/fe-agent-harness/skills/monorepo-nx-best-practices/SKILL.md │ └── (26개 skills 모두 같은 방식으로 복사) │ └── .claude-plugin/marketplace.json 업데이트

Rule → Skill 변환

Marketplace에서는 rule도 Claude Code가 인식하는 skill 형태로 변환됩니다. 하지만 rule은 절차가 아닌 제약이므로 disable-model-invocation: true를 추가해 Claude가 참조만 하고 절차로 실행하지 않게 합니다.

Rule (원본)
--- name: Plan before code description: Write and self-review... tags: [workflow] --- # Plan before code Before writing code, write a short implementation plan...
Skill (변환 후 — marketplace)
--- name: workflow-plan-first description: Write and self-review... disable-model-invocation: true --- # Plan before code Before writing code, write a short implementation plan...

Skill 네임스페이싱

마켓플레이스에서는 skill id가 <category>-<id> 형식으로 네임스페이싱됩니다. 여러 preset에서 같은 skill을 포함해도 충돌하지 않도록 하기 위함입니다.

원본 경로마켓플레이스 skill 이름
skills/monorepo/nx-best-practices/monorepo-nx-best-practices
skills/auth/azure-ad-sso-flask/auth-azure-ad-sso-flask
skills/code-review/are-we-done/code-review-are-we-done
rules/workflow/plan-first (변환)workflow-plan-first

marketplace.json 구조

// .claude-plugin/marketplace.json
{
  "version": "1.0",
  "plugins": [
    {
      "id": "fe-agent-harness",
      "name": "FE Agent Harness",
      "description": "Complete rule and skill set for GS Retail frontend projects.",
      "version": "1.0.0",
      "path": "plugins/fe-agent-harness",
      "skills": [
        "workflow-plan-first",
        "workflow-fe-tdd",
        "monorepo-nx-best-practices",
        "auth-azure-ad-sso-nextjs",
        "code-review-are-we-done",
        // ...
      ]
    },
    // be-agent-harness, nx-best-practices, example-baseline
  ]
}

마켓플레이스 vs TUI — 선택 기준

상황선택이유
새 프로젝트 부트스트랩 (팀 전체)마켓플레이스/plugin install 한 줄, CI/CD에 넣기 쉬움
특정 rule/skill만 추가TUI개별 항목 선택 가능
오프라인 환경TUI마켓플레이스는 서버 접근 필요
새 콘텐츠 테스트TUI마켓플레이스 빌드 없이 바로 설치 가능
onboarding 자동화마켓플레이스스크립트로 설치 가능, Python 불필요
권장: 팀 onboarding 스크립트에 마켓플레이스 설치를 포함하세요. 새 개발자가 프로젝트를 클론하면 /plugin install fe-agent-harness 한 번으로 전체 AI 환경이 구성됩니다.