monol-plugin-scout 2.0.0

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

@@ -0,0 +1,111 @@
+---
+description: 플러그인 포크 및 커스터마이징
+use_when:
+  - 사용자가 플러그인을 커스터마이징하고 싶을 때
+  - 기존 플러그인을 복사해서 수정하고 싶을 때
+---
+
+# /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/.claude/plugins/monol-plugin-scout/commands/scout.md

@@ -0,0 +1,209 @@
+---
+description: 플러그인 마켓플레이스 스캔 및 추천
+use_when:
+  - 사용자가 "플러그인", "추천", "마켓플레이스" 등을 언급할 때
+  - 프로젝트에 맞는 플러그인을 찾고 싶을 때
+  - 새 프로젝트를 시작할 때
+skills: plugin-evaluation
+---
+
+# /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/.claude/plugins/monol-plugin-scout/config.yaml

@@ -0,0 +1,76 @@
+# monol-plugin-scout 설정
+# Claude Code 플러그인 마켓플레이스 모니터링 및 추천 설정
+
+# 기본 설정
+general:
+  verbose: false
+  data_dir: "data/"
+
+# 마켓플레이스 스캔 소스
+sources:
+  github: true
+  npm: true
+  local: true
+  # 커스텀 레지스트리 URL (선택사항)
+  custom_registry: ""
+
+# 점수 가중치 (총합 100%)
+scoring:
+  project_match: 40    # 프로젝트 매칭 점수
+  popularity: 30       # 인기도 점수
+  security: 30         # 보안 점수
+
+# 프로젝트 매칭 세부 가중치
+project_match_weights:
+  language: 35         # 언어 매칭
+  framework: 30        # 프레임워크 호환성
+  category: 20         # 카테고리 관련성
+  dependencies: 15     # 의존성 매칭
+
+# 인기도 세부 가중치
+popularity_weights:
+  github_stars: 40     # GitHub 스타 수
+  recent_commits: 35   # 최근 커밋 활동
+  issue_health: 25     # 이슈 건강도
+
+# 보안 세부 가중치
+security_weights:
+  license: 40          # 라이선스 호환성
+  vulnerabilities: 35  # 알려진 취약점
+  author_trust: 25     # 저자 신뢰도
+
+# 자동 추천 설정
+auto_recommend:
+  enabled: true
+  # 작업 완료 후 추천 (Post-task)
+  post_task: true
+  # 최소 점수 (이 이상만 추천)
+  min_score: 60
+  # 최대 추천 수
+  max_suggestions: 3
+
+# 정리 설정 (cleanup)
+cleanup:
+  # 미사용 임계값 (일)
+  unused_days: 30
+  # 저사용 임계값 (회)
+  low_usage_count: 3
+  # 자동 정리 (false = 수동 확인)
+  auto_remove: false
+
+# 캐시 설정
+cache:
+  enabled: true
+  # 캐시 만료 (시간)
+  ttl_hours: 24
+  # 캐시 저장 위치
+  dir: ".cache/"
+
+# 알림 설정
+notifications:
+  # 새 플러그인 발견 시 알림
+  new_plugins: true
+  # 보안 업데이트 알림
+  security_updates: true
+  # 업데이트 가능 알림
+  available_updates: true

package/.claude/plugins/monol-plugin-scout/data/history.json

@@ -0,0 +1,36 @@
+{
+  "version": "1.0.0",
+  "lastUpdated": "2026-01-07T00:00:00.000Z",
+
+  "declined": {
+    "pyright-lsp": {
+      "count": 2,
+      "lastDeclined": "2026-01-06",
+      "reason": "Python 프로젝트 아님"
+    }
+  },
+
+  "installed": {
+    "typescript-lsp": {
+      "date": "2026-01-07",
+      "context": "typescript-project",
+      "source": "recommendation"
+    },
+    "code-review": {
+      "date": "2026-01-07",
+      "context": "productivity",
+      "source": "recommendation"
+    },
+    "sentry": {
+      "date": "2026-01-07",
+      "context": "existing-integration",
+      "source": "project-scan"
+    }
+  },
+
+  "preferences": {
+    "favoriteCategories": ["development", "productivity"],
+    "autoRecommend": true,
+    "quietMode": false
+  }
+}

package/.claude/plugins/monol-plugin-scout/data/usage.json

@@ -0,0 +1,49 @@
+{
+  "lastUpdated": "2026-01-07T00:00:00.000Z",
+  "config": {
+    "unusedThresholdDays": 30,
+    "lowUsageThreshold": 3
+  },
+  "plugins": {
+    "typescript-lsp": {
+      "installed": "2026-01-07",
+      "usageCount": 8,
+      "lastUsed": "2026-01-07"
+    },
+    "code-review": {
+      "installed": "2026-01-07",
+      "usageCount": 15,
+      "lastUsed": "2026-01-07"
+    },
+    "commit-commands": {
+      "installed": "2026-01-07",
+      "usageCount": 23,
+      "lastUsed": "2026-01-07"
+    },
+    "sentry": {
+      "installed": "2026-01-07",
+      "usageCount": 5,
+      "lastUsed": "2026-01-06"
+    },
+    "slack": {
+      "installed": "2026-01-07",
+      "usageCount": 3,
+      "lastUsed": "2026-01-05"
+    },
+    "plugin-dev": {
+      "installed": "2025-11-15",
+      "usageCount": 0,
+      "lastUsed": null
+    },
+    "hookify": {
+      "installed": "2026-01-07",
+      "usageCount": 1,
+      "lastUsed": "2026-01-07"
+    },
+    "old-unused-plugin": {
+      "installed": "2025-10-01",
+      "usageCount": 2,
+      "lastUsed": "2025-10-15"
+    }
+  }
+}

package/.claude/plugins/monol-plugin-scout/overrides/code-review/override.md

@@ -0,0 +1,21 @@
+---
+plugin: code-review
+version: ">=1.0.0"
+---
+
+# code-review 커스텀 규칙
+
+## 추가 체크 항목
+- 한국어 주석 권장
+- console.log 사용 금지 (production 코드)
+- any 타입 사용 시 경고
+- 함수 길이 50줄 초과 시 분리 제안
+
+## 무시 항목
+- 테스트 파일 (*.test.ts, *.spec.ts)
+- 설정 파일 (*.config.js)
+- 마이그레이션 파일
+
+## 추가 메시지
+- 리뷰 시작 시: "캠핏 코드 컨벤션에 따라 리뷰합니다."
+- 리뷰 완료 시: "리뷰 완료! 수고하셨습니다. 🎉"

package/.claude/plugins/monol-plugin-scout/plugin.json

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