monol-plugin-scout 2.0.0

package/.claude/plugins/monol-plugin-scout/skills/plugin-evaluation.md

@@ -0,0 +1,227 @@
+---
+name: plugin-evaluation
+description: |
+  플러그인 평가 방법론. 플러그인 점수 계산, 보안 검토, 호환성 분석 시 사용합니다.
+
+  Use when: "플러그인 평가", "플러그인 점수", "플러그인 보안 검토", "compare plugins",
+  "evaluate plugin", "check plugin safety", "plugin compatibility"
+---
+
+# 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` - 라이선스 호환성 매트릭스

package/CHANGELOG.md

@@ -0,0 +1,41 @@
+# Changelog
+
+## [2.0.0] - 2026-01-07
+
+### Added
+- `/scout compare` - 플러그인 비교 기능
+- `/scout cleanup` - 오래된 미사용 플러그인 정리
+- `/scout fork` - 플러그인 포크 기능
+- `/scout explore` - 마켓플레이스 탐색
+- `/scout audit` - 보안/업데이트 점검
+- Override 시스템 - 플러그인 커스터마이징
+- Combos 시스템 - 워크플로우 조합
+- 학습/히스토리 시스템 - 거절/선호도 학습
+- 사용량 추적 시스템
+
+### Changed
+- Post-task 추천을 인터뷰식으로 변경 (간략화)
+- cleanup 기준을 "오래된 미사용"으로 변경 (30일+)
+- 설치 질문에 multiSelect 적용
+
+### Documentation
+- FEATURE_SPEC.md - 기능 명세서 작성
+- TEST_RESULTS.md - 테스트 케이스 및 결과
+- USER_GUIDE.md - 사용자 가이드 및 활용 예시
+
+---
+
+## [1.0.0] - 2026-01-07
+
+### Added
+- 기본 프로젝트 스캔 및 추천
+- 종합 점수 계산 (프로젝트 매칭 40% + 인기도 30% + 보안 30%)
+- 인터뷰식 설치 플로우
+- Post-task 추천 (작업 완료 후)
+- 평가 스킬 (SKILL.md)
+- 참조 문서 (scoring-methodology, security-checklist, license-compatibility)
+
+### Technical
+- plugin-scout.md 에이전트 생성
+- plugin-evaluation 스킬 생성
+- AskUserQuestion 기반 인터뷰 플로우

package/README.md

@@ -0,0 +1,115 @@
+# monol-plugin-scout
+
+Claude Code 플러그인 마켓플레이스 모니터링 및 추천 에이전트
+
+## 기능
+
+- **프로젝트 분석**: package.json, pyproject.toml 등으로 언어/프레임워크 자동 감지
+- **마켓플레이스 스캔**: GitHub, NPM, 로컬 마켓플레이스 지원
+- **플러그인 평가**: 프로젝트 매칭(40%) + 인기도(30%) + 보안(30%) 점수
+- **인터뷰식 설치**: 대화형으로 복수 선택 가능한 설치
+- **정리 제안**: 미사용 플러그인 자동 감지 및 정리
+
+## 설치
+
+```bash
+# 1. 레포 클론
+git clone https://github.com/your/monol-plugin-scout.git ~/monol-plugin-scout
+
+# 2. Claude Code 설정에 마켓플레이스 등록
+```
+
+`~/.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 --quick            # 점수 80+ 만 빠르게
+```
+
+### 플러그인 비교
+```
+/scout compare typescript-lsp pyright-lsp
+```
+
+### 미사용 정리
+```
+/scout cleanup
+```
+
+### 마켓플레이스 탐색
+```
+/scout explore development
+```
+
+### 보안 점검
+```
+/scout audit
+```
+
+### 플러그인 포크
+```
+/scout fork code-review my-code-review
+```
+
+## 점수 시스템
+
+| 점수 | 등급 | 권장 |
+|------|------|------|
+| 90-100 | Excellent | 적극 추천 |
+| 75-89 | Good | 추천 |
+| 60-74 | Fair | 대안 검토 |
+| 40-59 | Poor | 주의 |
+| 0-39 | Not Recommended | 비추천 |
+
+## 디렉토리 구조
+
+```
+monol-plugin-scout/
+├── .claude/
+│   └── plugins/
+│       ├── marketplace.json
+│       └── monol-plugin-scout/
+│           ├── plugin.json
+│           ├── config.yaml
+│           ├── CLAUDE.md
+│           ├── commands/
+│           ├── skills/
+│           ├── combos/
+│           ├── overrides/
+│           └── data/
+├── docs/
+├── examples/
+├── tests/
+├── README.md
+├── CHANGELOG.md
+└── ROADMAP.md
+```
+
+## 문서
+
+- [사용자 가이드](docs/USER_GUIDE.md)
+- [기능 명세](docs/FEATURE_SPEC.md)
+- [테스트 결과](docs/TEST_RESULTS.md)
+- [개발 일지](docs/DEV_LOG.md)
+
+## 라이선스
+
+MIT

package/docs/DEV_LOG.md

@@ -0,0 +1,115 @@
+# Plugin Scout 개발 로그
+
+## 2026-01-07 - 초기 개발 세션
+
+### 배경
+
+사용자가 Claude Code 플러그인 마켓플레이스를 모니터링하고 유용한 플러그인을 추천해주는 에이전트를 만들고 싶다고 요청.
+
+### 논의 내용
+
+1. **기본 구조 논의**
+   - 에이전트 vs 스킬 선택 → 에이전트로 결정 (능동적 작업 필요)
+   - 마켓플레이스 접근 방법 연구
+   - 점수 계산 방법론 설계
+
+2. **요구사항 확정**
+   - 모니터링 방식: 수동 호출 + 자동 추천
+   - 마켓플레이스: 모든 소스 지원 (GitHub, Git, NPM, 로컬)
+   - 추천 기준: 종합 점수 (프로젝트 40% + 인기도 30% + 보안 30%)
+
+3. **v1.0 구현**
+   - plugin-scout.md 에이전트 생성
+   - plugin-evaluation 스킬 생성
+   - 인터뷰식 설치 플로우
+
+4. **테스트 및 피드백**
+   - 현재 프로젝트(Nextedition) 대상 테스트
+   - sentry, firebase, slack 등 기존 통합 감지 확인
+   - 플러그인 5개 설치 테스트 완료
+
+5. **v2.0 확장 논의**
+   - Post-task 추천 기능 추가
+   - 인터뷰식 형태로 간략화 요청
+   - 설치된 플러그인 활용 팁 추가
+
+6. **확장 기능 논의**
+   - 업데이트 알림
+   - 사용량 추적 / 정리
+   - 플러그인 비교
+   - 플러그인 익스텐션 (커스터마이징, 조합, 포크)
+   - 학습 기능
+   - 팀 협업
+
+7. **v2.0 구현**
+   - `/scout compare` 구현
+   - `/scout cleanup` 구현 (오래된 미사용만)
+   - Override 시스템 구현
+   - Combos 시스템 구현
+   - 학습/히스토리 시스템 구현
+
+8. **문서화**
+   - FEATURE_SPEC.md 작성
+   - TEST_RESULTS.md 작성
+   - USER_GUIDE.md 작성
+
+9. **프로젝트 구조화**
+   - plugin-scout/ 프로젝트 폴더 생성
+   - README, CHANGELOG, ROADMAP 작성
+
+### 주요 결정사항
+
+| 결정 | 이유 |
+|-----|------|
+| 에이전트로 구현 | 능동적 추천 필요 |
+| 종합 점수 40/30/30 | 프로젝트 적합성 가장 중요 |
+| 인터뷰식 UI | 작업 중 방해 최소화 |
+| 30일+ 미사용만 정리 | 최근 설치는 아직 활용 가능성 |
+| multiSelect 적용 | 복수 플러그인 한번에 선택 |
+
+### 생성된 파일
+
+```
+.claude/
+├── agents/plugin-scout.md
+├── skills/plugin-evaluation/SKILL.md
+└── plugin-scout/
+    ├── combos/
+    ├── plugin-overrides/
+    ├── scout-history.json
+    └── scout-usage.json
+
+plugin-scout/
+├── README.md
+├── CHANGELOG.md
+├── ROADMAP.md
+├── src/
+├── docs/
+├── tests/
+└── examples/
+```
+
+### 설치된 플러그인 (테스트)
+
+1. sentry
+2. slack
+3. typescript-lsp
+4. code-review
+5. commit-commands
+6. plugin-dev
+7. hookify
+
+### 다음 단계
+
+1. UX 개선 (무음 모드, 빈도 조절)
+2. 학습 기능 강화
+3. 팀 협업 기능
+4. 실제 사용 피드백 수집
+
+---
+
+## 개발 환경
+
+- Claude Code (Opus 4.5)
+- 작업 디렉토리: /Users/Kent/Work/Nextedition
+- 테스트 프로젝트: camfit_backend (Strapi + MongoDB + Firebase + Sentry)