monol-plugin-scout 2.0.5 → 2.0.6

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "monol-plugin-scout",
-  "version": "2.0.5",
+  "version": "2.0.6",
   "description": "Claude Code 플러그인 마켓플레이스 모니터링 및 추천 에이전트",
   "author": "Kent",
   "commands": "monol-plugin-scout-pkg/commands/",

package/monol-plugin-scout-pkg/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "monol-plugin-scout",
-  "version": "2.0.5",
+  "version": "2.0.6",
   "description": "Claude Code 플러그인 마켓플레이스 모니터링 및 추천 에이전트",
   "author": "monol",
   "commands": "commands/",

package/monol-plugin-scout-pkg/skills/audit.md

@@ -0,0 +1,98 @@
+---
+description: 설치된 플러그인 보안 및 업데이트 점검
+argument-hint: "[--security | --updates]"
+allowed-tools: [Read, Glob, Bash, WebFetch]
+---
+
+# /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/monol-plugin-scout-pkg/skills/cleanup.md

@@ -0,0 +1,122 @@
+---
+description: 미사용 플러그인 정리 제안
+argument-hint: "[--dry-run | --force]"
+allowed-tools: [Read, Glob, Bash, AskUserQuestion]
+---
+
+# /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/monol-plugin-scout-pkg/skills/compare.md

@@ -0,0 +1,91 @@
+---
+description: 플러그인 비교표 생성
+argument-hint: "<plugin1> <plugin2> [plugin3]"
+allowed-tools: [Read, Glob, Grep, WebFetch]
+---
+
+# /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/monol-plugin-scout-pkg/skills/explore.md

@@ -0,0 +1,117 @@
+---
+description: 마켓플레이스 카테고리별 탐색
+argument-hint: "[category | --search <keyword>]"
+allowed-tools: [Read, Glob, WebFetch, AskUserQuestion]
+---
+
+# /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' 관련 플러그인 검색
+```

package/monol-plugin-scout-pkg/skills/fork.md

@@ -0,0 +1,110 @@
+---
+description: 플러그인 포크 및 커스터마이징
+argument-hint: "<source-plugin> <new-name> [--local]"
+allowed-tools: [Read, Write, Bash, Glob]
+---
+
+# /scout fork - 플러그인 포크
+
+플러그인을 복사하여 커스텀 버전을 만듭니다.
+
+## 사용법
+
+```
+/scout fork <source-plugin> <new-name>
+/scout fork <source-plugin> <new-name> --local
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+### 1. 소스 플러그인 확인
+
+- 설치된 플러그인인지 확인
+- 마켓플레이스에서 플러그인 위치 조회
+
+### 2. 포크 생성
+
+```bash
+# 로컬 플러그인 디렉토리에 복사
+.claude/plugins/<new-name>/
+├── plugin.json          # 이름 변경
+├── agents/              # 원본 복사
+├── commands/            # 원본 복사
+├── skills/              # 원본 복사
+└── FORKED_FROM.txt      # 원본 정보 기록
+```
+
+### 3. 메타데이터 업데이트
+
+`plugin.json` 수정:
+```json
+{
+  "name": "<new-name>",
+  "version": "1.0.0",
+  "forkedFrom": "<source-plugin>",
+  "description": "Forked from <source-plugin>",
+  "author": "<current-user>"
+}
+```
+
+### 4. 포크 완료 메시지
+
+```
+✅ 플러그인 포크 완료
+
+원본: code-review
+새 이름: my-code-review
+
+생성 위치:
+.claude/plugins/my-code-review/
+├── plugin.json
+├── commands/
+│   └── review.md
+└── FORKED_FROM.txt
+
+다음 단계:
+1. 플러그인 파일 수정
+2. /plugin reload로 적용
+3. /my-code-review로 사용
+
+Tip: overrides/를 사용해 원본을 유지하면서 규칙만 추가할 수도 있습니다.
+```
+
+## Override vs Fork
+
+| 방식 | 용도 | 장점 |
+|------|------|------|
+| Override | 규칙만 추가/수정 | 원본 업데이트 자동 반영 |
+| Fork | 전체 커스터마이징 | 완전한 제어 |
+
+Override 예시:
+```
+overrides/code-review/override.md
+→ code-review 플러그인에 추가 규칙 적용
+```
+
+## 에러 처리
+
+- **소스 플러그인 없음**:
+  ```
+  '{source}' 플러그인을 찾을 수 없습니다.
+  설치된 플러그인: /plugin list
+  ```
+
+- **이름 충돌**:
+  ```
+  '{new-name}' 플러그인이 이미 존재합니다.
+  다른 이름을 사용해주세요.
+  ```
+
+## 예시
+
+```
+/scout fork code-review my-code-review
+→ code-review를 my-code-review로 복사
+
+/scout fork typescript-lsp custom-lsp --local
+→ 로컬 전용으로 포크
+```

package/monol-plugin-scout-pkg/skills/scout.md

@@ -0,0 +1,206 @@
+---
+description: 플러그인 마켓플레이스 스캔 및 추천
+argument-hint: "[--quick | --category <cat> | compare | cleanup | explore | audit | fork]"
+allowed-tools: [Read, Glob, Grep, Bash, WebFetch, AskUserQuestion]
+---
+
+# /scout - 플러그인 마켓플레이스 스캔 및 추천
+
+프로젝트 컨텍스트를 분석하고 호환되는 플러그인을 발견합니다.
+
+## 사용법
+
+```
+/scout                    # 프로젝트 분석 후 추천
+/scout --quick            # 빠른 스캔 (점수 80+ 만 표시)
+/scout --category <cat>   # 특정 카테고리만 스캔
+```
+
+## 서브커맨드
+
+```
+/scout compare <a> <b>    # 플러그인 비교 → compare.md 참조
+/scout cleanup            # 미사용 플러그인 정리 → cleanup.md 참조
+/scout explore [category] # 마켓플레이스 탐색 → explore.md 참조
+/scout audit              # 보안/업데이트 점검 → audit.md 참조
+/scout fork <src> <name>  # 플러그인 포크 → fork.md 참조
+```
+
+## 인자: $ARGUMENTS
+
+## 동작
+
+### Phase 1: 프로젝트 컨텍스트 분석
+
+1. **프로젝트 타입 감지**:
+   ```
+   package.json          → Node.js/JavaScript/TypeScript
+   requirements.txt      → Python
+   pyproject.toml        → Python (modern)
+   Cargo.toml            → Rust
+   go.mod                → Go
+   pom.xml / build.gradle → Java
+   composer.json         → PHP
+   Gemfile               → Ruby
+   ```
+
+2. **프레임워크 식별** (의존성에서 추출):
+   - React, Vue, Angular, Svelte (frontend)
+   - Express, Fastify, NestJS (Node backend)
+   - FastAPI, Django, Flask (Python)
+   - Spring, Quarkus (Java)
+
+3. **설치된 플러그인 확인**:
+   - `~/.claude/settings.json`의 `enabledPlugins`
+   - `.claude/settings.json`의 프로젝트 플러그인
+   - 이미 설치된 플러그인은 추천에서 제외
+
+### Phase 2: 마켓플레이스 스캔
+
+1. **설정된 마켓플레이스 조회**:
+   ```bash
+   cat ~/.claude/settings.json | grep -A 20 "extraKnownMarketplaces"
+   ```
+
+2. **마켓플레이스 메타데이터 로드**:
+   - GitHub: `.claude-plugin/marketplace.json` 가져오기
+   - 로컬: 디렉토리 구조 읽기
+   - 플러그인 정보 파싱 (이름, 설명, 카테고리, 저자)
+
+3. **플러그인 인벤토리 구축**:
+   - 플러그인 이름과 버전
+   - 카테고리 (development, productivity, security, testing)
+   - 저자/조직
+   - 소스 타입 (github, git, npm, local)
+
+### Phase 3: 평가 및 점수 계산
+
+`plugin-evaluation` 스킬을 적용하여 종합 점수 계산:
+
+**종합 점수 = (프로젝트 매칭 × 0.4) + (인기도 × 0.3) + (보안 × 0.3)**
+
+#### 프로젝트 매칭 (40%)
+| 기준 | 점수 |
+|------|------|
+| 언어 정확 매칭 | 30 |
+| 프레임워크 호환성 | 25 |
+| 카테고리 관련성 | 20 |
+| 의존성 호환성 | 15 |
+| 아키텍처 적합성 | 10 |
+
+#### 인기도 (30%)
+| 기준 | 점수 |
+|------|------|
+| GitHub 스타 (10k+: 30, 1k+: 25, 100+: 15) | 0-30 |
+| 최근 커밋 (90일) | 0-20 |
+| 업데이트 최신성 | 0-20 |
+| 이슈 응답 건강도 | 0-15 |
+| 포크 활동 | 0-15 |
+
+#### 보안 (30%)
+| 기준 | 점수 |
+|------|------|
+| 라이선스 (MIT/Apache: 30, GPL: 20, Unknown: 0) | 0-30 |
+| 알려진 취약점 | 0-40 |
+| 저자 평판 (Official: 30, Verified: 20) | 0-30 |
+
+### Phase 4: 추천 제시
+
+추천 결과를 다음 형식으로 출력:
+
+```markdown
+## Plugin Scout Report
+
+**프로젝트**: [감지된 언어] + [프레임워크]
+**설치된 플러그인**: [개수] ([목록])
+
+### 추천 플러그인
+
+#### 1. [plugin-name] (점수: XX/100)
+**추천 이유**: [프로젝트 컨텍스트 기반 설명]
+
+| 지표 | 점수 | 상세 |
+|------|------|------|
+| 프로젝트 매칭 | XX | [이유] |
+| 인기도 | XX | [스타, 활동] |
+| 보안 | XX | [라이선스, 저자] |
+
+**설치**: `/plugin install [name]@[marketplace]`
+
+---
+
+[상위 3-5개 플러그인 반복]
+```
+
+### 인터뷰식 설치
+
+AskUserQuestion 도구를 사용해 대화형으로 설치:
+
+```yaml
+questions:
+  - question: "어떤 종류의 플러그인을 찾으시나요?"
+    header: "카테고리"
+    options:
+      - label: "개발 도구"
+        description: "LSP, 코드 분석, 기능 개발"
+      - label: "생산성"
+        description: "커밋, PR, 이슈 관리"
+      - label: "외부 서비스"
+        description: "Slack, GitHub, Notion 연동"
+      - label: "전체 스캔"
+        description: "프로젝트 분석 후 맞춤 추천"
+    multiSelect: false
+```
+
+설치 선택 시 `multiSelect: true`로 복수 선택 가능하게.
+
+## 안전 규칙
+
+1. **자동 설치 금지** - 항상 사용자 동의 필요
+2. **보안 경고 표시**:
+   - 알 수 없거나 제한적인 라이선스
+   - 1년 이상 업데이트 없음
+   - 검증되지 않은 저자
+   - 알려진 취약점
+3. **설치 전 확인** - 설치 명령 반복 후 승인 대기
+
+## 보안 경고 형식
+
+```markdown
+**보안 경고**: [plugin-name]
+- 라이선스: [type] - [영향]
+- 마지막 업데이트: [date] - [우려 사항]
+- 저자: [name] - [검증 상태]
+- 취약점: [status]
+
+주의해서 진행하세요. 신뢰하는 소스만 설치하세요.
+```
+
+## 에러 처리
+
+- **마켓플레이스 없음**:
+  ```
+  설정된 마켓플레이스가 없습니다. 추가하세요:
+  /plugin marketplace add anthropics/claude-code-plugins
+  ```
+
+- **네트워크 에러**: 캐시된 데이터 사용, 문제 보고
+
+- **프로젝트 감지 실패**:
+  ```
+  프로젝트 타입을 감지할 수 없습니다.
+  어떤 언어/프레임워크를 사용하시나요?
+  ```
+
+## 예시
+
+```
+/scout
+→ 프로젝트 분석 후 맞춤 플러그인 추천
+
+/scout --quick
+→ 점수 80점 이상 플러그인만 빠르게 표시
+
+/scout --category development
+→ 개발 도구 카테고리만 스캔
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "monol-plugin-scout",
-  "version": "2.0.5",
+  "version": "2.0.6",
   "description": "Claude Code 플러그인 마켓플레이스 모니터링 및 추천 에이전트",
   "author": "Kent",
   "license": "MIT",

package/monol-plugin-scout-pkg/skills/plugin-evaluation/SKILL.md

@@ -1,227 +0,0 @@
----
-skill: plugin-evaluation
-description: 플러그인 평가 방법론. 플러그인 점수 계산, 보안 검토, 호환성 분석 시 사용합니다.
-proactive: false
-triggers:
-  - plugin_install
-  - plugin_compare
----
-
-# Plugin Evaluation Skill
-
-플러그인을 체계적으로 평가하기 위한 방법론입니다.
-
-## Composite Score Formula
-
-```
-Composite = (Project Match × 0.40) + (Popularity × 0.30) + (Security × 0.30)
-```
-
-**Rating Scale**:
-| Score | Rating | Recommendation |
-|-------|--------|----------------|
-| 90-100 | Excellent | 적극 추천 |
-| 75-89 | Good | 추천 |
-| 60-74 | Fair | 대안 검토 필요 |
-| 40-59 | Poor | 주의 필요 |
-| 0-39 | Not Recommended | 비추천 |
-
----
-
-## 1. Project Match Scoring (40%)
-
-### Language Detection
-
-| Config File | Language | Confidence |
-|-------------|----------|------------|
-| package.json | JavaScript/TypeScript | High |
-| tsconfig.json | TypeScript | High |
-| requirements.txt | Python | High |
-| pyproject.toml | Python | High |
-| Cargo.toml | Rust | High |
-| go.mod | Go | High |
-| pom.xml | Java | High |
-| build.gradle | Java/Kotlin | High |
-| composer.json | PHP | High |
-| Gemfile | Ruby | High |
-
-### Scoring Criteria
-
-```yaml
-language_match:
-  exact: 30      # TypeScript plugin for TypeScript project
-  related: 15    # TypeScript plugin for JavaScript project
-  none: 0
-
-framework_match:
-  exact: 25      # React plugin for React project
-  compatible: 15 # Frontend plugin for React project
-  none: 0
-
-category_relevance:
-  high: 20       # Testing plugin for test-heavy project
-  medium: 10
-  low: 5
-
-dependency_compatibility:
-  no_conflicts: 15
-  minor_conflicts: 5
-  major_conflicts: 0
-
-architecture_fit:
-  excellent: 10
-  good: 5
-  poor: 0
-```
-
----
-
-## 2. Popularity Scoring (30%)
-
-### GitHub Metrics
-
-```yaml
-stars:
-  10000+: 30
-  1000-9999: 25
-  100-999: 15
-  10-99: 10
-  0-9: 5
-
-recent_commits_90d:
-  20+: 20
-  5-19: 15
-  1-4: 10
-  0: 5
-
-last_update:
-  <30_days: 20
-  30-90_days: 15
-  90-180_days: 10
-  180-365_days: 5
-  >365_days: 0
-
-issue_health:
-  excellent: 15  # >80% closed, fast response
-  good: 10
-  moderate: 5
-  poor: 0
-
-fork_activity:
-  active: 15
-  moderate: 10
-  low: 5
-```
-
-### Normalization Formula
-
-For highly variable metrics:
-```
-normalized_stars = min(log10(stars + 1) / log10(100000) × 100, 100)
-```
-
----
-
-## 3. Security Scoring (30%)
-
-### License Analysis
-
-```yaml
-permissive:  # 30 points
-  - MIT
-  - Apache-2.0
-  - BSD-2-Clause
-  - BSD-3-Clause
-  - ISC
-
-copyleft:    # 20 points
-  - GPL-3.0
-  - GPL-2.0
-  - LGPL-3.0
-  - MPL-2.0
-
-restrictive: # 0-10 points
-  - proprietary: 10
-  - unknown: 0
-  - custom: 5
-```
-
-### Vulnerability Assessment
-
-```yaml
-vulnerability_scoring:
-  none_known: 40
-  minor_fixed: 35     # had issues, all patched
-  minor_open: 20      # low-severity unpatched
-  moderate_open: 10
-  critical_open: 0
-  no_data: 20         # cannot assess
-```
-
-### Author Reputation
-
-```yaml
-author_scoring:
-  official_anthropic: 30
-  verified_org:
-    major_company: 25   # Microsoft, Google, etc.
-    known_org: 20
-  individual:
-    established: 15     # many popular repos
-    known: 10
-    new: 5
-  unknown: 0
-```
-
----
-
-## Evaluation Output Template
-
-```yaml
-plugin_evaluation:
-  name: [plugin-name]
-  marketplace: [marketplace-id]
-  version: [version]
-
-  scores:
-    project_match: [0-100]
-    popularity: [0-100]
-    security: [0-100]
-    composite: [0-100]
-    rating: [Excellent/Good/Fair/Poor/Not Recommended]
-
-  project_analysis:
-    language_match: [language] ([status])
-    framework_match: [framework] ([status])
-    category_relevance: [high/medium/low]
-
-  activity_analysis:
-    github_stars: [count]
-    recent_commits: [count]
-    last_update: [date]
-
-  security_analysis:
-    license: [type]
-    license_compatible: [true/false]
-    known_vulnerabilities: [none/minor/critical]
-    author: [name] ([type])
-
-  warnings:
-    - level: [critical/moderate/informational]
-      message: [warning text]
-
-  recommendation:
-    install: [true/false]
-    confidence: [high/medium/low]
-    command: "/plugin install [name]@[marketplace]"
-```
-
----
-
-## Reference Files
-
-For detailed information, see:
-
-- `docs/references/scoring-methodology.md` - 상세 점수 계산 공식
-- `docs/references/security-checklist.md` - 설치 전 보안 체크리스트
-- `docs/references/license-compatibility.md` - 라이선스 호환성 매트릭스