monol-plugin-scout 2.0.0

package/.claude/plugins/marketplace.json

@@ -0,0 +1,12 @@
+{
+  "name": "monol-plugin-scout",
+  "description": "Claude Code 플러그인 마켓플레이스 모니터링 및 추천",
+  "plugins": [
+    {
+      "name": "monol-plugin-scout",
+      "version": "2.0.0",
+      "description": "플러그인 마켓플레이스 스캔, 평가, 추천 에이전트",
+      "path": "monol-plugin-scout"
+    }
+  ]
+}

package/.claude/plugins/monol-plugin-scout/CLAUDE.md

@@ -0,0 +1,135 @@
+# Plugin Scout v2.0
+
+Claude Code 플러그인 마켓플레이스 모니터링 및 추천 에이전트
+
+## 설치 (Claude Code 플러그인)
+
+```bash
+# 1. 레포 클론
+git clone https://github.com/your/monol-plugin-scout.git ~/monol-plugin-scout
+
+# 2. ~/.claude/settings.json에 마켓플레이스 등록
+```
+
+`~/.claude/settings.json`:
+```json
+{
+  "extraKnownMarketplaces": {
+    "monol-plugin-scout": {
+      "source": {
+        "source": "directory",
+        "path": "~/monol-plugin-scout/.claude/plugins"
+      }
+    }
+  },
+  "enabledPlugins": {
+    "monol-plugin-scout@monol-plugin-scout": true
+  }
+}
+```
+
+플러그인 활성화 후:
+- `/scout`, `/scout compare`, `/scout cleanup` 등 스킬 사용 가능
+- 프로젝트 분석 후 맞춤 플러그인 추천
+
+## 스킬 (Commands)
+
+```
+/scout                    # 프로젝트 분석 후 플러그인 추천
+/scout --quick            # 빠른 스캔 (점수 80+ 만)
+/scout --category <cat>   # 특정 카테고리만 스캔
+
+/scout compare <a> <b>    # 플러그인 비교표 생성
+/scout cleanup            # 미사용 플러그인 정리 제안
+/scout explore [category] # 마켓플레이스 카테고리 탐색
+/scout audit              # 보안 및 업데이트 점검
+/scout fork <src> <name>  # 플러그인 포크
+```
+
+## 점수 계산
+
+**종합 점수 = (프로젝트 매칭 × 40%) + (인기도 × 30%) + (보안 × 30%)**
+
+| 점수 | 등급 | 권장 |
+|------|------|------|
+| 90-100 | Excellent | 적극 추천 |
+| 75-89 | Good | 추천 |
+| 60-74 | Fair | 대안 검토 |
+| 40-59 | Poor | 주의 |
+| 0-39 | Not Recommended | 비추천 |
+
+## 프로젝트 감지
+
+자동으로 감지하는 프로젝트 타입:
+- JavaScript/TypeScript (package.json, tsconfig.json)
+- Python (requirements.txt, pyproject.toml)
+- Rust (Cargo.toml)
+- Go (go.mod)
+- Java (pom.xml, build.gradle)
+- PHP (composer.json)
+- Ruby (Gemfile)
+
+## 설정 (config.yaml)
+
+```yaml
+# 점수 가중치
+scoring:
+  project_match: 40
+  popularity: 30
+  security: 30
+
+# 자동 추천
+auto_recommend:
+  enabled: true
+  min_score: 60
+  max_suggestions: 3
+
+# 정리 기준
+cleanup:
+  unused_days: 30
+  low_usage_count: 3
+```
+
+## 파일 구조
+
+```
+.claude/plugins/
+├── marketplace.json              # 마켓플레이스 정의
+└── monol-plugin-scout/
+    ├── plugin.json               # 플러그인 매니페스트
+    ├── config.yaml               # 설정
+    ├── CLAUDE.md                 # 이 파일
+    ├── commands/
+    │   ├── scout.md              # /scout 메인 커맨드
+    │   ├── compare.md            # /scout compare
+    │   ├── cleanup.md            # /scout cleanup
+    │   ├── explore.md            # /scout explore
+    │   ├── audit.md              # /scout audit
+    │   └── fork.md               # /scout fork
+    ├── skills/
+    │   └── plugin-evaluation.md  # 평가 방법론
+    ├── combos/                   # 워크플로우 조합
+    ├── overrides/                # 플러그인 오버라이드
+    └── data/
+        ├── history.json          # 거절/설치 이력
+        └── usage.json            # 사용량 추적
+```
+
+## 안전 규칙
+
+1. **자동 설치 금지** - 항상 사용자 동의 필요
+2. **보안 경고 표시** - 위험한 플러그인에 경고
+3. **설치 전 확인** - 명령어 확인 후 승인
+
+## Override vs Fork
+
+| 방식 | 용도 | 장점 |
+|------|------|------|
+| Override | 규칙만 추가/수정 | 원본 업데이트 자동 반영 |
+| Fork | 전체 커스터마이징 | 완전한 제어 |
+
+Override 예시:
+```
+overrides/code-review/override.md
+→ code-review 플러그인에 추가 규칙 적용
+```

package/.claude/plugins/monol-plugin-scout/combos/full-review.yaml

@@ -0,0 +1,33 @@
+# Full Review Combo
+# PR 생성부터 리뷰까지 원스톱 워크플로우
+
+name: full-review
+description: "변경사항 커밋 → 코드 리뷰 → 보안 검사 → PR 생성"
+trigger: "/full-review"
+
+steps:
+  - name: "변경사항 커밋"
+    plugin: commit-commands
+    action: commit
+    options:
+      includeUntracked: true
+
+  - name: "코드 리뷰"
+    plugin: code-review
+    action: review
+    options:
+      scope: "staged"
+
+  - name: "보안 검사"
+    plugin: security-guidance
+    action: scan
+    optional: true  # 설치 안 되어 있으면 스킵
+
+  - name: "PR 생성"
+    plugin: commit-commands
+    action: pr
+    options:
+      draft: false
+
+# 에러 처리
+on_error: "ask"  # ask | skip | abort

package/.claude/plugins/monol-plugin-scout/combos/quick-commit.yaml

@@ -0,0 +1,15 @@
+# Quick Commit Combo
+# 빠른 커밋 워크플로우
+
+name: quick-commit
+description: "변경사항 빠르게 커밋하고 푸시"
+trigger: "/qc"
+
+steps:
+  - name: "변경사항 커밋"
+    plugin: commit-commands
+    action: commit
+
+  - name: "푸시"
+    plugin: commit-commands
+    action: push

package/.claude/plugins/monol-plugin-scout/commands/audit.md

@@ -0,0 +1,99 @@
+---
+description: 설치된 플러그인 보안 및 업데이트 점검
+use_when:
+  - 사용자가 플러그인 보안을 점검하고 싶을 때
+  - 업데이트 가능한 플러그인을 확인하고 싶을 때
+---
+
+# /scout audit - 보안 및 업데이트 점검
+
+설치된 플러그인의 보안 및 업데이트 상태를 점검합니다.
+
+## 사용법
+
+```
+/scout audit              # 전체 점검
+/scout audit --security   # 보안만 점검
+/scout audit --updates    # 업데이트만 점검
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+### 1. 설치된 플러그인 조회
+
+`~/.claude/settings.json`과 `.claude/settings.json`에서 `enabledPlugins` 확인.
+
+### 2. 보안 점검 항목
+
+| 항목 | 상태 | 설명 |
+|------|------|------|
+| 라이선스 | ✓ / ⚠ / ✗ | MIT/Apache (✓), GPL (⚠), Unknown (✗) |
+| 취약점 | ✓ / ✗ | npm audit, GitHub Security Advisories |
+| 저자 검증 | ✓ / ⚠ | Official (✓), Verified (⚠), Unverified (✗) |
+| 업데이트 | ✓ / ⚠ | <1년 (✓), 1년+ (⚠) |
+
+### 3. 점검 결과 출력
+
+```
+🔒 플러그인 보안 점검
+
+설치된 플러그인: 7개
+
+## 보안 상태
+
+| 플러그인 | 라이선스 | 취약점 | 저자 | 업데이트 |
+|----------|----------|--------|------|----------|
+| typescript-lsp | ✓ MIT | ✓ | ✓ Official | ✓ 2일 전 |
+| code-review | ✓ Apache | ✓ | ✓ Official | ✓ 7일 전 |
+| old-plugin | ⚠ GPL | ✓ | ⚠ Unverified | ✗ 14개월 전 |
+
+## 경고 (1개)
+
+⚠ old-plugin
+  - 14개월간 업데이트 없음
+  - 검증되지 않은 저자
+  - GPL 라이선스 (제한적 호환성)
+
+권장: /plugin uninstall old-plugin
+
+## 업데이트 가능 (2개)
+
+| 플러그인 | 현재 | 최신 |
+|----------|------|------|
+| typescript-lsp | 1.2.0 | 1.3.0 |
+| code-review | 2.0.0 | 2.1.0 |
+
+업데이트: /plugin update <name>
+```
+
+### 4. 심각한 경고
+
+보안 문제가 심각한 경우:
+
+```
+🚨 보안 경고
+
+다음 플러그인에 알려진 취약점이 있습니다:
+
+• vulnerable-plugin (CVE-2025-1234)
+  심각도: High
+  영향: 원격 코드 실행 가능
+
+즉시 제거를 권장합니다:
+/plugin uninstall vulnerable-plugin
+```
+
+## 예시
+
+```
+/scout audit
+→ 전체 보안 및 업데이트 점검
+
+/scout audit --security
+→ 보안만 점검
+
+/scout audit --updates
+→ 업데이트 가능 여부만 확인
+```

package/.claude/plugins/monol-plugin-scout/commands/cleanup.md

@@ -0,0 +1,123 @@
+---
+description: 미사용 플러그인 정리 제안
+use_when:
+  - 사용자가 플러그인 정리를 원할 때
+  - 오래된 미사용 플러그인을 찾고 싶을 때
+---
+
+# /scout cleanup - 미사용 플러그인 정리
+
+오래된 미사용 플러그인만 정리 제안합니다.
+
+## 사용법
+
+```
+/scout cleanup              # 미사용 플러그인 분석 및 정리 제안
+/scout cleanup --dry-run    # 정리 대상만 표시 (삭제 안 함)
+/scout cleanup --force      # 확인 없이 정리
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+### 1. 사용 기록 로드
+
+`.claude/plugins/monol-plugin-scout/data/usage.json`에서 사용 기록 로드:
+
+```json
+{
+  "plugins": {
+    "typescript-lsp": {
+      "installed": "2025-12-01",
+      "usageCount": 42,
+      "lastUsed": "2026-01-18"
+    },
+    "old-plugin": {
+      "installed": "2025-10-01",
+      "usageCount": 3,
+      "lastUsed": "2025-10-15"
+    }
+  }
+}
+```
+
+### 2. 정리 기준 적용
+
+`config.yaml`의 설정 기준:
+- `cleanup.unused_days`: 미사용 임계값 (기본 30일)
+- `cleanup.low_usage_count`: 저사용 임계값 (기본 3회)
+
+정리 대상:
+- 30일 이상 미사용 (lastUsed가 30일 이전)
+- 설치 후 한 번도 사용 안 함 (lastUsed가 null이고 설치 후 7일 경과)
+
+### 3. 정리 대상 표시
+
+```
+📊 플러그인 정리 제안
+
+오래된 미사용 플러그인이 2개 있습니다:
+
+• plugin-dev
+  설치: 2025-11-15 (53일 전)
+  마지막 사용: 없음
+
+• old-unused-plugin
+  설치: 2025-10-01 (98일 전)
+  마지막 사용: 2025-10-15 (84일 전)
+
+나머지 5개 플러그인은 최근 활발히 사용 중입니다. ✓
+```
+
+### 4. 인터뷰식 정리
+
+AskUserQuestion으로 정리할 플러그인 선택:
+
+```yaml
+questions:
+  - question: "정리할 플러그인을 선택하세요"
+    header: "정리"
+    options:
+      - label: "plugin-dev"
+        description: "53일간 미사용"
+      - label: "old-unused-plugin"
+        description: "84일간 미사용"
+      - label: "전체 삭제"
+        description: "위 플러그인 모두 삭제"
+      - label: "취소"
+        description: "정리하지 않음"
+    multiSelect: true
+```
+
+### 5. 정리 실행
+
+선택한 플러그인 제거:
+```bash
+/plugin uninstall <plugin-name>
+```
+
+사용 기록에서도 제거.
+
+## 에러 처리
+
+- **사용 기록 없음**:
+  ```
+  사용 기록이 없습니다. 플러그인 사용 후 다시 시도해주세요.
+  ```
+
+- **정리 대상 없음**:
+  ```
+  정리할 미사용 플러그인이 없습니다.
+  모든 플러그인이 활발히 사용 중입니다. ✓
+  ```
+
+## 예시
+
+```
+/scout cleanup
+→ 미사용 플러그인 분석 및 정리 제안
+
+/scout cleanup --dry-run
+→ 정리 대상만 표시 (삭제 안 함)
+```

package/.claude/plugins/monol-plugin-scout/commands/compare.md

@@ -0,0 +1,92 @@
+---
+description: 플러그인 비교표 생성
+use_when:
+  - 사용자가 플러그인을 비교하고 싶을 때
+  - 어떤 플러그인을 선택할지 고민할 때
+---
+
+# /scout compare - 플러그인 비교
+
+두 개 이상의 플러그인을 비교표로 보여줍니다.
+
+## 사용법
+
+```
+/scout compare <plugin1> <plugin2>
+/scout compare <plugin1> <plugin2> <plugin3>
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+### 1. 인자 파싱
+
+최소 2개, 최대 4개의 플러그인 이름을 받습니다.
+
+### 2. 플러그인 메타데이터 로드
+
+각 플러그인에 대해:
+- 마켓플레이스에서 메타데이터 조회
+- 설치 여부 확인 (`enabledPlugins`)
+- `plugin-evaluation` 스킬로 점수 계산
+
+### 3. 비교표 생성
+
+```
+┌─────────────┬─────────────────┬─────────────────┐
+│             │ typescript-lsp  │ pyright-lsp     │
+├─────────────┼─────────────────┼─────────────────┤
+│ 카테고리    │ development     │ development     │
+│ 점수        │ 84              │ 82              │
+│ 언어        │ TypeScript/JS   │ Python          │
+│ 저자        │ Anthropic       │ Anthropic       │
+│ 설치        │ ✓               │ -               │
+│ 프로젝트    │ 적합            │ 부적합          │
+└─────────────┴─────────────────┴─────────────────┘
+
+추천: 현재 프로젝트(TypeScript)에는 typescript-lsp가 더 적합합니다.
+```
+
+### 4. 비교 항목
+
+| 항목 | 설명 |
+|------|------|
+| 카테고리 | development, productivity, security, testing |
+| 종합 점수 | 0-100 |
+| 주요 기능 | 플러그인 설명에서 추출 |
+| 저자/출처 | 저자 이름 및 소스 타입 |
+| 설치 여부 | ✓ / - |
+| 프로젝트 적합성 | 현재 프로젝트 컨텍스트 기반 |
+
+### 5. 추천 제시
+
+현재 프로젝트 컨텍스트를 기반으로 어떤 플러그인이 더 적합한지 한 줄 추천.
+
+## 에러 처리
+
+- **플러그인 없음**:
+  ```
+  '{name}' 플러그인을 찾을 수 없습니다.
+  ```
+
+- **동일 플러그인**:
+  ```
+  같은 플러그인입니다. 다른 플러그인을 선택해주세요.
+  ```
+
+- **인자 부족**:
+  ```
+  비교할 플러그인을 2개 이상 지정해주세요.
+  사용법: /scout compare <plugin1> <plugin2>
+  ```
+
+## 예시
+
+```
+/scout compare typescript-lsp pyright-lsp
+→ 두 LSP 플러그인 비교
+
+/scout compare sentry firebase slack
+→ 세 외부 서비스 플러그인 비교
+```

package/.claude/plugins/monol-plugin-scout/commands/explore.md

@@ -0,0 +1,118 @@
+---
+description: 마켓플레이스 카테고리별 탐색
+use_when:
+  - 사용자가 마켓플레이스를 둘러보고 싶을 때
+  - 특정 카테고리 플러그인을 찾고 싶을 때
+---
+
+# /scout explore - 마켓플레이스 탐색
+
+마켓플레이스를 카테고리별로 탐색합니다.
+
+## 사용법
+
+```
+/scout explore                    # 전체 카테고리 보기
+/scout explore <category>         # 특정 카테고리 탐색
+/scout explore --search <keyword> # 키워드 검색
+```
+
+## 인자: $ARGUMENTS
+
+## 카테고리
+
+| 카테고리 | 설명 | 예시 플러그인 |
+|----------|------|---------------|
+| development | 개발 도구 | typescript-lsp, pyright-lsp, feature-dev |
+| productivity | 생산성 | commit-commands, code-review |
+| security | 보안 | security-guidance |
+| testing | 테스트 | playwright |
+| external | 외부 서비스 | slack, github, notion, sentry |
+| database | 데이터베이스 | firebase, supabase |
+
+## 동작
+
+### 1. 인자 없는 경우 (전체 카테고리)
+
+카테고리 목록과 각 카테고리의 플러그인 수 표시:
+
+```
+📦 마켓플레이스 탐색
+
+카테고리를 선택하세요:
+
+• development (12개)
+  LSP, 코드 분석, 기능 개발
+
+• productivity (8개)
+  커밋, PR, 이슈 관리
+
+• security (3개)
+  보안 검사, 경고
+
+• testing (4개)
+  E2E, 브라우저 자동화
+
+• external (15개)
+  Slack, GitHub, Notion 연동
+
+• database (5개)
+  Firebase, Supabase
+```
+
+AskUserQuestion으로 카테고리 선택:
+
+```yaml
+questions:
+  - question: "어떤 카테고리를 탐색할까요?"
+    header: "카테고리"
+    options:
+      - label: "개발 도구"
+        description: "12개 플러그인"
+      - label: "생산성"
+        description: "8개 플러그인"
+      - label: "외부 서비스"
+        description: "15개 플러그인"
+      - label: "전체 보기"
+        description: "모든 플러그인"
+    multiSelect: false
+```
+
+### 2. 카테고리 지정 시
+
+해당 카테고리의 플러그인 목록 표시:
+
+```
+📦 development 카테고리 (12개)
+
+| 플러그인 | 점수 | 설명 | 설치 |
+|----------|------|------|------|
+| typescript-lsp | 84 | TypeScript/JS 코드 인텔리전스 | ✓ |
+| feature-dev | 82 | 기능 개발 워크플로우 | - |
+| greptile | 78 | AI 기반 코드베이스 검색 | - |
+...
+
+설치하려면: /plugin install <name>@<marketplace>
+```
+
+### 3. 키워드 검색
+
+`--search` 옵션으로 플러그인 이름/설명 검색:
+
+```
+/scout explore --search typescript
+→ 'typescript' 포함 플러그인 검색
+```
+
+## 예시
+
+```
+/scout explore
+→ 카테고리 목록 표시
+
+/scout explore development
+→ 개발 도구 카테고리 탐색
+
+/scout explore --search slack
+→ 'slack' 관련 플러그인 검색
+```