/Part 6: 생태계/플러그인 시스템
🌐
Part 6고급⏱ 약 50분 · 2개 섹션

플러그인 시스템

마켓플레이스 기반 확장

플러그인 시스템 대표 이미지
이 챕터에서 배울 것
  • 플러그인은 커맨드, 에이전트, 훅, 스타일 제공 가능
  • 마켓플레이스(GCS) 기반 배포와 검색
  • 보안 검증, 블랙리스트, MDM 정책 지원
전체 아키텍처에서 현재 위치
⚙️코어 엔진
🔧도구 시스템
🛡️보안
🧠컨텍스트
🤝멀티 에이전트
🌐생태계
인프라
1

플러그인 아키텍처

로더, 매니페스트, 설치, 검증

매니페스트설치검증스코프|utils/plugins/pluginLoader.tsutils/plugins/validatePlugin.ts

플러그인 시스템은 46개 모듈로 구성되며, 마켓플레이스 기반 배포, 매니페스트 검증, 보안 블랙리스트를 포함합니다.

src/utils/plugins/pluginLoader.ts
1// src/utils/plugins/pluginLoader.ts — 플러그인 디스커버리
2
3// 플러그인 디렉토리 구조:
4// my-plugin/
5// ├── plugin.json # 매니페스트 (메타데이터)
6// ├── commands/ # 슬래시 커맨드
7// │ ├── build.md
8// │ └── deploy.md
9// ├── agents/ # AI 에이전트
10// │ └── test-runner.md
11// └── hooks/ # 훅 설정
12// └── hooks.json
13
14// 플러그인 로더가 처리하는 것:
15// - 매니페스트 검증 (validatePlugin.ts, 28KB)
16// - 훅 설정 로드 + 변수 해석
17// - 중복 이름 감지
18// - 활성/비활성 상태 관리
19// - 에러 수집 및 리포트
20
21// 플러그인 컴포넌트 4가지:
22type PluginComponent =💡
23 | { type: 'command', command: Command } // 슬래시 커맨드
24 | { type: 'agent', agent: AgentDefinition } // AI 에이전트
25 | { type: 'hook', hook: HookConfig } // 이벤트 훅
26 | { type: 'outputStyle', style: OutputStyle } // 출력 스타일
2

마켓플레이스와 보안

플러그인 검색, 배포, 블랙리스트

마켓플레이스블랙리스트화이트리스트정책|utils/plugins/marketplaceManager.tsutils/plugins/pluginBlocklist.ts

마켓플레이스 매니저(93KB)는 GCS 기반 공식 마켓플레이스와 커스텀 마켓플레이스를 지원합니다.

플러그인 설치 및 보안
1// 설치 관리 (installed_plugins.json V2 형식)
2{
3 "version": 2,
4 "plugins": {
5 "my-plugin": {
6 "source": "marketplace",
7 "version": "1.0.0",
8 "scope": "global", // global | session
9 "installedAt": "2026-01-01T00:00:00Z",
10 "enabled": true
11 }
12 }
13}
14
15// 보안: 블랙리스트 + MDM 정책
16// pluginBlocklist.ts → 악성 플러그인 차단
17// pluginOnlyPolicy → MDM으로 비플러그인 도구 제한 가능