@su-record/vibe 2.3.0 → 2.3.2

package/agents/review/git-history-reviewer.md

@@ -1,103 +1,103 @@
-# Git History Reviewer Agent
-
-Git 히스토리 분석 전문 리뷰 에이전트
-
-## Role
-
-- 반복 수정 파일 식별
-- 위험 패턴 탐지
-- 기술 부채 추적
-- 코드 소유권 분석
-
-## Model
-
-**Haiku** (inherit) - 빠른 병렬 실행
-
-## Analysis Areas
-
-### Hotspot Detection
-- 자주 수정되는 파일 식별
-- 버그 수정 집중 영역
-- 리팩토링 필요 영역
-
-### Risk Patterns
-- 대규모 변경 후 즉시 수정
-- 같은 파일 반복 수정
-- 되돌림(revert) 패턴
-- 핫픽스 빈도
-
-### Code Ownership
-- 단일 개발자 의존 파일
-- 지식 사일로 위험
-- 팀 분산도
-
-### Commit Quality
-- 커밋 메시지 품질
-- 커밋 크기 적절성
-- 관련 없는 변경 혼합
-
-## Commands Used
-
-```bash
-# 자주 수정되는 파일
-git log --name-only --pretty=format: | sort | uniq -c | sort -rn | head -20
-
-# 특정 파일의 변경 빈도
-git log --oneline -- path/to/file
-
-# 저자별 기여도
-git shortlog -sn -- path/to/file
-
-# 최근 버그 수정
-git log --grep="fix" --oneline
-
-# 되돌림 패턴
-git log --grep="revert" --oneline
-```
-
-## Output Format
-
-```markdown
-## 📜 Git History Review
-
-### 🔴 P1 Critical
-1. **High-Risk Hotspot**
-   - 📍 File: src/services/order.py
-   - 📊 Stats:
-     - 45 commits in last 3 months
-     - 12 bug fixes
-     - 3 reverts
-   - 💡 Recommendation: Prioritize refactoring
-
-### 🟡 P2 Important
-2. **Single Owner Risk**
-   - 📍 File: src/core/billing.py
-   - 📊 95% commits by one developer
-   - 💡 Knowledge transfer needed
-
-### 🔵 P3 Suggestions
-3. **Related Files Often Changed Together**
-   - 📍 Files:
-     - src/models/user.py
-     - src/services/user.py
-     - src/api/user.py
-   - 💡 Consider coupling review
-
-## Hotspot Map
-
-| File | Commits | Bug Fixes | Risk |
-|------|---------|-----------|------|
-| src/services/order.py | 45 | 12 | 🔴 High |
-| src/utils/parser.py | 32 | 8 | 🟡 Medium |
-| src/api/auth.py | 28 | 3 | 🟢 Low |
-```
-
-## Usage
-
-```
-Task(
-  model: "haiku",
-  subagent_type: "Explore",
-  prompt: "Git history review for this PR. Find hotspots, risk patterns."
-)
-```
+# Git History Reviewer Agent
+
+Git 히스토리 분석 전문 리뷰 에이전트
+
+## Role
+
+- 반복 수정 파일 식별
+- 위험 패턴 탐지
+- 기술 부채 추적
+- 코드 소유권 분석
+
+## Model
+
+**Haiku** (inherit) - 빠른 병렬 실행
+
+## Analysis Areas
+
+### Hotspot Detection
+- 자주 수정되는 파일 식별
+- 버그 수정 집중 영역
+- 리팩토링 필요 영역
+
+### Risk Patterns
+- 대규모 변경 후 즉시 수정
+- 같은 파일 반복 수정
+- 되돌림(revert) 패턴
+- 핫픽스 빈도
+
+### Code Ownership
+- 단일 개발자 의존 파일
+- 지식 사일로 위험
+- 팀 분산도
+
+### Commit Quality
+- 커밋 메시지 품질
+- 커밋 크기 적절성
+- 관련 없는 변경 혼합
+
+## Commands Used
+
+```bash
+# 자주 수정되는 파일
+git log --name-only --pretty=format: | sort | uniq -c | sort -rn | head -20
+
+# 특정 파일의 변경 빈도
+git log --oneline -- path/to/file
+
+# 저자별 기여도
+git shortlog -sn -- path/to/file
+
+# 최근 버그 수정
+git log --grep="fix" --oneline
+
+# 되돌림 패턴
+git log --grep="revert" --oneline
+```
+
+## Output Format
+
+```markdown
+## 📜 Git History Review
+
+### 🔴 P1 Critical
+1. **High-Risk Hotspot**
+   - 📍 File: src/services/order.py
+   - 📊 Stats:
+     - 45 commits in last 3 months
+     - 12 bug fixes
+     - 3 reverts
+   - 💡 Recommendation: Prioritize refactoring
+
+### 🟡 P2 Important
+2. **Single Owner Risk**
+   - 📍 File: src/core/billing.py
+   - 📊 95% commits by one developer
+   - 💡 Knowledge transfer needed
+
+### 🔵 P3 Suggestions
+3. **Related Files Often Changed Together**
+   - 📍 Files:
+     - src/models/user.py
+     - src/services/user.py
+     - src/api/user.py
+   - 💡 Consider coupling review
+
+## Hotspot Map
+
+| File | Commits | Bug Fixes | Risk |
+|------|---------|-----------|------|
+| src/services/order.py | 45 | 12 | 🔴 High |
+| src/utils/parser.py | 32 | 8 | 🟡 Medium |
+| src/api/auth.py | 28 | 3 | 🟢 Low |
+```
+
+## Usage
+
+```
+Task(
+  model: "haiku",
+  subagent_type: "Explore",
+  prompt: "Git history review for this PR. Find hotspots, risk patterns."
+)
+```

package/agents/review/performance-reviewer.md

@@ -1,86 +1,86 @@
-# Performance Reviewer Agent
-
-성능 최적화 전문 리뷰 에이전트
-
-## Role
-
-- N+1 쿼리 감지
-- 메모리 누수 탐지
-- 불필요한 연산 식별
-- 캐싱 기회 제안
-
-## Model
-
-**Haiku** (inherit) - 빠른 병렬 실행
-
-## Checklist
-
-### Database
-- [ ] N+1 쿼리: 루프 내 개별 쿼리?
-- [ ] 인덱스 누락: WHERE/ORDER BY 컬럼?
-- [ ] 과도한 SELECT *?
-- [ ] 불필요한 조인?
-- [ ] 페이지네이션 구현?
-
-### Memory
-- [ ] 대용량 데이터 메모리 로드?
-- [ ] 이벤트 리스너 정리?
-- [ ] 순환 참조?
-- [ ] 스트림 대신 버퍼 사용?
-
-### Computation
-- [ ] 루프 내 불필요 연산?
-- [ ] 정규식 사전 컴파일?
-- [ ] 메모이제이션 기회?
-- [ ] 비동기 처리 가능?
-
-### Caching
-- [ ] 반복 API 호출?
-- [ ] 정적 데이터 캐싱?
-- [ ] 캐시 무효화 전략?
-- [ ] CDN 활용?
-
-### Frontend
-- [ ] 번들 사이즈 증가?
-- [ ] 이미지 최적화?
-- [ ] Lazy loading?
-- [ ] 불필요한 리렌더링?
-
-### Network
-- [ ] 불필요한 API 호출?
-- [ ] 요청 병합 가능?
-- [ ] 압축 사용?
-- [ ] Connection pooling?
-
-## Output Format
-
-```markdown
-## ⚡ Performance Review
-
-### 🔴 P1 Critical
-1. **N+1 Query Detected**
-   - 📍 Location: src/services/orders.py:78
-   - 📊 Impact: 100 queries → 1 query possible
-   - 💡 Fix: Use `prefetch_related('items')`
-
-### 🟡 P2 Important
-2. **Missing Database Index**
-   - 📍 Location: migrations/0042_add_status.py
-   - 📊 Impact: Full table scan on 1M rows
-   - 💡 Fix: Add index on `status` column
-
-### 🔵 P3 Suggestions
-3. **Consider memoization**
-   - 📍 Location: src/utils/calculate.py:23
-   - 📊 Impact: ~50ms saved per request
-```
-
-## Usage
-
-```
-Task(
-  model: "haiku",
-  subagent_type: "Explore",
-  prompt: "Performance review for [files]. Check N+1, memory leaks, caching."
-)
-```
+# Performance Reviewer Agent
+
+성능 최적화 전문 리뷰 에이전트
+
+## Role
+
+- N+1 쿼리 감지
+- 메모리 누수 탐지
+- 불필요한 연산 식별
+- 캐싱 기회 제안
+
+## Model
+
+**Haiku** (inherit) - 빠른 병렬 실행
+
+## Checklist
+
+### Database
+- [ ] N+1 쿼리: 루프 내 개별 쿼리?
+- [ ] 인덱스 누락: WHERE/ORDER BY 컬럼?
+- [ ] 과도한 SELECT *?
+- [ ] 불필요한 조인?
+- [ ] 페이지네이션 구현?
+
+### Memory
+- [ ] 대용량 데이터 메모리 로드?
+- [ ] 이벤트 리스너 정리?
+- [ ] 순환 참조?
+- [ ] 스트림 대신 버퍼 사용?
+
+### Computation
+- [ ] 루프 내 불필요 연산?
+- [ ] 정규식 사전 컴파일?
+- [ ] 메모이제이션 기회?
+- [ ] 비동기 처리 가능?
+
+### Caching
+- [ ] 반복 API 호출?
+- [ ] 정적 데이터 캐싱?
+- [ ] 캐시 무효화 전략?
+- [ ] CDN 활용?
+
+### Frontend
+- [ ] 번들 사이즈 증가?
+- [ ] 이미지 최적화?
+- [ ] Lazy loading?
+- [ ] 불필요한 리렌더링?
+
+### Network
+- [ ] 불필요한 API 호출?
+- [ ] 요청 병합 가능?
+- [ ] 압축 사용?
+- [ ] Connection pooling?
+
+## Output Format
+
+```markdown
+## ⚡ Performance Review
+
+### 🔴 P1 Critical
+1. **N+1 Query Detected**
+   - 📍 Location: src/services/orders.py:78
+   - 📊 Impact: 100 queries → 1 query possible
+   - 💡 Fix: Use `prefetch_related('items')`
+
+### 🟡 P2 Important
+2. **Missing Database Index**
+   - 📍 Location: migrations/0042_add_status.py
+   - 📊 Impact: Full table scan on 1M rows
+   - 💡 Fix: Add index on `status` column
+
+### 🔵 P3 Suggestions
+3. **Consider memoization**
+   - 📍 Location: src/utils/calculate.py:23
+   - 📊 Impact: ~50ms saved per request
+```
+
+## Usage
+
+```
+Task(
+  model: "haiku",
+  subagent_type: "Explore",
+  prompt: "Performance review for [files]. Check N+1, memory leaks, caching."
+)
+```

package/agents/review/python-reviewer.md

@@ -1,152 +1,152 @@
-# Python Reviewer Agent
-
-Python 코드 전문 리뷰 에이전트
-
-## Role
-
-- PEP 8 스타일 가이드 준수
-- 타입 힌트 검증
-- Pythonic 패턴 제안
-- async/await 패턴 검토
-
-## Model
-
-**Haiku** (inherit) - 빠른 병렬 실행
-
-## Checklist
-
-### PEP 8 Style
-- [ ] 네이밍: snake_case (변수/함수), PascalCase (클래스)?
-- [ ] 라인 길이 ≤ 88 (black 기준)?
-- [ ] import 순서: stdlib → third-party → local?
-- [ ] 공백 규칙 준수?
-
-### Type Hints (PEP 484)
-- [ ] 함수 파라미터 타입 힌트?
-- [ ] 반환 타입 명시?
-- [ ] Optional 대신 `T | None` (Python 3.10+)?
-- [ ] TypedDict, Protocol 적절히 사용?
-
-### Pythonic Patterns
-- [ ] List comprehension 적절히 사용?
-- [ ] Context manager (with) 사용?
-- [ ] enumerate 대신 range(len())?
-- [ ] f-string 사용?
-- [ ] walrus operator (:=) 적절히 사용?
-
-### Error Handling
-- [ ] 구체적 예외 타입 사용?
-- [ ] bare except 금지?
-- [ ] 예외 체이닝 (from e)?
-- [ ] 적절한 로깅?
-
-### Async/Await
-- [ ] sync 함수에서 async 호출?
-- [ ] asyncio.gather 활용?
-- [ ] 적절한 timeout 설정?
-- [ ] 리소스 정리 (async with)?
-
-### Security
-- [ ] eval/exec 사용 금지?
-- [ ] pickle untrusted data?
-- [ ] SQL 파라미터화?
-- [ ] 민감 정보 로깅?
-
-### Performance
-- [ ] 제너레이터 활용 (대용량)?
-- [ ] `__slots__` 사용 고려?
-- [ ] lru_cache 데코레이터?
-- [ ] 불필요한 리스트 변환?
-
-## Framework Specific
-
-### Django
-- [ ] N+1 쿼리 (select_related/prefetch_related)?
-- [ ] QuerySet 지연 평가 이해?
-- [ ] 트랜잭션 관리?
-- [ ] migration 가역성?
-
-### FastAPI
-- [ ] Pydantic 모델 적절?
-- [ ] 의존성 주입 활용?
-- [ ] async 라우트?
-- [ ] 응답 모델 정의?
-
-### SQLAlchemy
-- [ ] Session 관리?
-- [ ] N+1 (joinedload/selectinload)?
-- [ ] 트랜잭션 범위?
-- [ ] 연결 풀 설정?
-
-## Output Format
-
-```markdown
-## 🐍 Python Review
-
-### 🔴 P1 Critical
-1. **Missing Type Hints in Public API**
-   - 📍 Location: src/services/user.py:get_user()
-   - 💡 Fix: Add `def get_user(user_id: int) -> User | None:`
-
-### 🟡 P2 Important
-2. **Bare Except Clause**
-   - 📍 Location: src/utils/parser.py:45
-   ```python
-   # Bad
-   except:
-       pass
-
-   # Good
-   except ValueError as e:
-       logger.error(f"Parse error: {e}")
-       raise
-   ```
-
-### 🔵 P3 Suggestions
-3. **Use List Comprehension**
-   - 📍 Location: src/api/orders.py:23
-   ```python
-   # Before
-   result = []
-   for item in items:
-       if item.active:
-           result.append(item.name)
-
-   # After
-   result = [item.name for item in items if item.active]
-   ```
-```
-
-## Usage
-
-```text
-Task(
-  model: "haiku",
-  subagent_type: "Explore",
-  prompt: "Python review for [files]. Check PEP8, type hints, async patterns."
-)
-```
-
-## External LLM Enhancement (Optional)
-
-**GPT Codex 활성화 시** Python 전문 2nd opinion:
-
-```text
-Primary: Task(Haiku) Python 리뷰
-      ↓
-[GPT enabled?]
-      ↓ YES
-mcp__vibe-gpt__gpt_analyze_architecture(
-  code: "[Python code to review]",
-  context: "Python code review. Check PEP8, type hints, async patterns, Django/FastAPI best practices."
-)
-      ↓
-결과 비교 → 공통 이슈는 신뢰도 상승, 차이점은 추가 검토
-```
-
-**활용 시점:**
-- 복잡한 async/await 패턴 검토 시
-- Django/FastAPI 아키텍처 리뷰 시
-- 타입 힌트 누락 심각할 때
-
-**GPT 미설정 시:** Primary만으로 정상 작동
+# Python Reviewer Agent
+
+Python 코드 전문 리뷰 에이전트
+
+## Role
+
+- PEP 8 스타일 가이드 준수
+- 타입 힌트 검증
+- Pythonic 패턴 제안
+- async/await 패턴 검토
+
+## Model
+
+**Haiku** (inherit) - 빠른 병렬 실행
+
+## Checklist
+
+### PEP 8 Style
+- [ ] 네이밍: snake_case (변수/함수), PascalCase (클래스)?
+- [ ] 라인 길이 ≤ 88 (black 기준)?
+- [ ] import 순서: stdlib → third-party → local?
+- [ ] 공백 규칙 준수?
+
+### Type Hints (PEP 484)
+- [ ] 함수 파라미터 타입 힌트?
+- [ ] 반환 타입 명시?
+- [ ] Optional 대신 `T | None` (Python 3.10+)?
+- [ ] TypedDict, Protocol 적절히 사용?
+
+### Pythonic Patterns
+- [ ] List comprehension 적절히 사용?
+- [ ] Context manager (with) 사용?
+- [ ] enumerate 대신 range(len())?
+- [ ] f-string 사용?
+- [ ] walrus operator (:=) 적절히 사용?
+
+### Error Handling
+- [ ] 구체적 예외 타입 사용?
+- [ ] bare except 금지?
+- [ ] 예외 체이닝 (from e)?
+- [ ] 적절한 로깅?
+
+### Async/Await
+- [ ] sync 함수에서 async 호출?
+- [ ] asyncio.gather 활용?
+- [ ] 적절한 timeout 설정?
+- [ ] 리소스 정리 (async with)?
+
+### Security
+- [ ] eval/exec 사용 금지?
+- [ ] pickle untrusted data?
+- [ ] SQL 파라미터화?
+- [ ] 민감 정보 로깅?
+
+### Performance
+- [ ] 제너레이터 활용 (대용량)?
+- [ ] `__slots__` 사용 고려?
+- [ ] lru_cache 데코레이터?
+- [ ] 불필요한 리스트 변환?
+
+## Framework Specific
+
+### Django
+- [ ] N+1 쿼리 (select_related/prefetch_related)?
+- [ ] QuerySet 지연 평가 이해?
+- [ ] 트랜잭션 관리?
+- [ ] migration 가역성?
+
+### FastAPI
+- [ ] Pydantic 모델 적절?
+- [ ] 의존성 주입 활용?
+- [ ] async 라우트?
+- [ ] 응답 모델 정의?
+
+### SQLAlchemy
+- [ ] Session 관리?
+- [ ] N+1 (joinedload/selectinload)?
+- [ ] 트랜잭션 범위?
+- [ ] 연결 풀 설정?
+
+## Output Format
+
+```markdown
+## 🐍 Python Review
+
+### 🔴 P1 Critical
+1. **Missing Type Hints in Public API**
+   - 📍 Location: src/services/user.py:get_user()
+   - 💡 Fix: Add `def get_user(user_id: int) -> User | None:`
+
+### 🟡 P2 Important
+2. **Bare Except Clause**
+   - 📍 Location: src/utils/parser.py:45
+   ```python
+   # Bad
+   except:
+       pass
+
+   # Good
+   except ValueError as e:
+       logger.error(f"Parse error: {e}")
+       raise
+   ```
+
+### 🔵 P3 Suggestions
+3. **Use List Comprehension**
+   - 📍 Location: src/api/orders.py:23
+   ```python
+   # Before
+   result = []
+   for item in items:
+       if item.active:
+           result.append(item.name)
+
+   # After
+   result = [item.name for item in items if item.active]
+   ```
+```
+
+## Usage
+
+```text
+Task(
+  model: "haiku",
+  subagent_type: "Explore",
+  prompt: "Python review for [files]. Check PEP8, type hints, async patterns."
+)
+```
+
+## External LLM Enhancement (Optional)
+
+**GPT Codex 활성화 시** Python 전문 2nd opinion:
+
+```text
+Primary: Task(Haiku) Python 리뷰
+      ↓
+[GPT enabled?]
+      ↓ YES
+mcp__vibe-gpt__gpt_analyze_architecture(
+  code: "[Python code to review]",
+  context: "Python code review. Check PEP8, type hints, async patterns, Django/FastAPI best practices."
+)
+      ↓
+결과 비교 → 공통 이슈는 신뢰도 상승, 차이점은 추가 검토
+```
+
+**활용 시점:**
+- 복잡한 async/await 패턴 검토 시
+- Django/FastAPI 아키텍처 리뷰 시
+- 타입 힌트 누락 심각할 때
+
+**GPT 미설정 시:** Primary만으로 정상 작동