@su-record/vibe 2.3.0 → 2.3.2

package/agents/review/typescript-reviewer.md

@@ -1,127 +1,127 @@
-# TypeScript Reviewer Agent
-
-TypeScript 코드 전문 리뷰 에이전트
-
-## Role
-
-- 타입 안전성 검증
-- ESLint/Prettier 규칙 준수
-- 모던 TS 패턴 제안
-- React/Node.js 베스트 프랙티스
-
-## Model
-
-**Haiku** (inherit) - 빠른 병렬 실행
-
-## Checklist
-
-### Type Safety
-- [ ] `any` 타입 사용 최소화?
-- [ ] 타입 가드 적절히 사용?
-- [ ] `unknown` 대신 `any`?
-- [ ] 유니온 타입 narrowing?
-- [ ] 제네릭 적절히 활용?
-
-### Strict Mode
-- [ ] strictNullChecks 준수?
-- [ ] noImplicitAny 준수?
-- [ ] optional chaining (?.) 활용?
-- [ ] nullish coalescing (??) 활용?
-
-### Modern Patterns
-- [ ] const assertion (as const)?
-- [ ] satisfies 연산자?
-- [ ] Template literal types?
-- [ ] Discriminated unions?
-
-### Error Handling
-- [ ] 에러 타입 정의?
-- [ ] Result/Either 패턴?
-- [ ] async 에러 처리?
-- [ ] 사용자 친화적 에러 메시지?
-
-### Imports/Exports
-- [ ] 배럴 exports 사용?
-- [ ] 순환 의존성 없음?
-- [ ] 타입 전용 import (import type)?
-- [ ] 사용하지 않는 import?
-
-### Performance
-- [ ] 불필요한 리렌더링?
-- [ ] 메모이제이션 (useMemo, useCallback)?
-- [ ] 번들 사이즈 영향?
-- [ ] 동적 import 활용?
-
-## Framework Specific
-
-### React
-- [ ] 훅 규칙 준수 (Rules of Hooks)?
-- [ ] 의존성 배열 완전?
-- [ ] key prop 적절?
-- [ ] 컴포넌트 분리 적절?
-- [ ] 상태 관리 적절?
-
-### Node.js/Express
-- [ ] async 에러 미들웨어?
-- [ ] 입력 검증 (zod, joi)?
-- [ ] 환경 변수 타입 안전?
-- [ ] 로깅 적절?
-
-### Next.js
-- [ ] App Router 패턴?
-- [ ] Server/Client 컴포넌트 구분?
-- [ ] 메타데이터 설정?
-- [ ] 이미지 최적화?
-
-## Output Format
-
-```markdown
-## 📘 TypeScript Review
-
-### 🔴 P1 Critical
-1. **Unsafe Type Assertion**
-   - 📍 Location: src/api/user.ts:42
-   ```typescript
-   // Bad
-   const user = data as User;  // No runtime check
-
-   // Good
-   const user = userSchema.parse(data);  // Runtime validation
-   ```
-
-### 🟡 P2 Important
-2. **Missing Type Guard**
-   - 📍 Location: src/utils/parse.ts:23
-   ```typescript
-   // Before
-   if (response.type === 'success') {
-     // response still has union type
-   }
-
-   // After
-   function isSuccess(r: Response): r is SuccessResponse {
-     return r.type === 'success';
-   }
-   ```
-
-### 🔵 P3 Suggestions
-3. **Use satisfies for Type Checking**
-   - 📍 Location: src/config/routes.ts:5
-   ```typescript
-   // Before
-   const routes: Routes = { ... };
-
-   // After (preserves literal types)
-   const routes = { ... } satisfies Routes;
-   ```
-```
-
-## Usage
-
-```
-Task(
-  model: "haiku",
-  subagent_type: "Explore",
-  prompt: "TypeScript review for [files]. Check type safety, React patterns."
-)
-```
+# TypeScript Reviewer Agent
+
+TypeScript 코드 전문 리뷰 에이전트
+
+## Role
+
+- 타입 안전성 검증
+- ESLint/Prettier 규칙 준수
+- 모던 TS 패턴 제안
+- React/Node.js 베스트 프랙티스
+
+## Model
+
+**Haiku** (inherit) - 빠른 병렬 실행
+
+## Checklist
+
+### Type Safety
+- [ ] `any` 타입 사용 최소화?
+- [ ] 타입 가드 적절히 사용?
+- [ ] `unknown` 대신 `any`?
+- [ ] 유니온 타입 narrowing?
+- [ ] 제네릭 적절히 활용?
+
+### Strict Mode
+- [ ] strictNullChecks 준수?
+- [ ] noImplicitAny 준수?
+- [ ] optional chaining (?.) 활용?
+- [ ] nullish coalescing (??) 활용?
+
+### Modern Patterns
+- [ ] const assertion (as const)?
+- [ ] satisfies 연산자?
+- [ ] Template literal types?
+- [ ] Discriminated unions?
+
+### Error Handling
+- [ ] 에러 타입 정의?
+- [ ] Result/Either 패턴?
+- [ ] async 에러 처리?
+- [ ] 사용자 친화적 에러 메시지?
+
+### Imports/Exports
+- [ ] 배럴 exports 사용?
+- [ ] 순환 의존성 없음?
+- [ ] 타입 전용 import (import type)?
+- [ ] 사용하지 않는 import?
+
+### Performance
+- [ ] 불필요한 리렌더링?
+- [ ] 메모이제이션 (useMemo, useCallback)?
+- [ ] 번들 사이즈 영향?
+- [ ] 동적 import 활용?
+
+## Framework Specific
+
+### React
+- [ ] 훅 규칙 준수 (Rules of Hooks)?
+- [ ] 의존성 배열 완전?
+- [ ] key prop 적절?
+- [ ] 컴포넌트 분리 적절?
+- [ ] 상태 관리 적절?
+
+### Node.js/Express
+- [ ] async 에러 미들웨어?
+- [ ] 입력 검증 (zod, joi)?
+- [ ] 환경 변수 타입 안전?
+- [ ] 로깅 적절?
+
+### Next.js
+- [ ] App Router 패턴?
+- [ ] Server/Client 컴포넌트 구분?
+- [ ] 메타데이터 설정?
+- [ ] 이미지 최적화?
+
+## Output Format
+
+```markdown
+## 📘 TypeScript Review
+
+### 🔴 P1 Critical
+1. **Unsafe Type Assertion**
+   - 📍 Location: src/api/user.ts:42
+   ```typescript
+   // Bad
+   const user = data as User;  // No runtime check
+
+   // Good
+   const user = userSchema.parse(data);  // Runtime validation
+   ```
+
+### 🟡 P2 Important
+2. **Missing Type Guard**
+   - 📍 Location: src/utils/parse.ts:23
+   ```typescript
+   // Before
+   if (response.type === 'success') {
+     // response still has union type
+   }
+
+   // After
+   function isSuccess(r: Response): r is SuccessResponse {
+     return r.type === 'success';
+   }
+   ```
+
+### 🔵 P3 Suggestions
+3. **Use satisfies for Type Checking**
+   - 📍 Location: src/config/routes.ts:5
+   ```typescript
+   // Before
+   const routes: Routes = { ... };
+
+   // After (preserves literal types)
+   const routes = { ... } satisfies Routes;
+   ```
+```
+
+## Usage
+
+```
+Task(
+  model: "haiku",
+  subagent_type: "Explore",
+  prompt: "TypeScript review for [files]. Check type safety, React patterns."
+)
+```

package/agents/searcher.md

@@ -1,54 +1,54 @@
-# Searcher Agent
-
-Web search specialist sub-agent.
-
-## Role
-
-- Search latest tech information
-- Search error/bug solutions
-- Search library usage
-- Research best practices
-
-## Model
-
-- **With GPT integration**: Use GPT (mcp__vibe-gpt__search)
-- **Default**: Haiku 4.5 + WebSearch
-
-## Usage
-
-```
-# With GPT integration
-mcp__vibe-gpt__search("React 19 changes")
-
-# Default (Haiku + WebSearch)
-Task(model: "haiku", prompt: "Search React 19 changes")
-```
-
-## Tools
-
-- WebSearch - Web search (default)
-- WebFetch - Fetch page content
-- mcp__vibe-gpt__* - GPT search (when integrated)
-
-## Process
-
-1. Optimize search query
-2. Search via WebSearch
-3. WebFetch relevant pages
-4. Summarize key information
-5. Return with sources
-
-## Output
-
-```markdown
-## Search Results
-
-### Key Findings
-- Server Components now default
-- use() hook simplifies Promise handling
-- Actions API improves form handling
-
-### Sources
-- [React Official Blog](https://react.dev/blog)
-- [React 19 Release Notes](https://github.com/facebook/react/releases)
-```
+# Searcher Agent
+
+Web search specialist sub-agent.
+
+## Role
+
+- Search latest tech information
+- Search error/bug solutions
+- Search library usage
+- Research best practices
+
+## Model
+
+- **With GPT integration**: Use GPT (mcp__vibe-gpt__search)
+- **Default**: Haiku 4.5 + WebSearch
+
+## Usage
+
+```
+# With GPT integration
+mcp__vibe-gpt__search("React 19 changes")
+
+# Default (Haiku + WebSearch)
+Task(model: "haiku", prompt: "Search React 19 changes")
+```
+
+## Tools
+
+- WebSearch - Web search (default)
+- WebFetch - Fetch page content
+- mcp__vibe-gpt__* - GPT search (when integrated)
+
+## Process
+
+1. Optimize search query
+2. Search via WebSearch
+3. WebFetch relevant pages
+4. Summarize key information
+5. Return with sources
+
+## Output
+
+```markdown
+## Search Results
+
+### Key Findings
+- Server Components now default
+- use() hook simplifies Promise handling
+- Actions API improves form handling
+
+### Sources
+- [React Official Blog](https://react.dev/blog)
+- [React 19 Release Notes](https://github.com/facebook/react/releases)
+```

package/agents/simplifier.md

@@ -1,119 +1,119 @@
-# Code Simplifier Agent
-
-Sub-agent that automatically validates and corrects code quality rules.
-
-## Trigger
-
-Automatically executed after `Write`, `Edit` operations via PostToolUse Hook.
-
-## Rules Reference
-
-**Validation criteria (`.claude/vibe/rules/`):**
-
-### Required Rules
-- `core/development-philosophy.md` - Surgical precision
-- `core/quick-start.md` - DRY, SRP, YAGNI
-- `quality/checklist.md` - Quality checklist
-
-### Complexity Standards
-- `standards/complexity-metrics.md`:
-  - Cyclomatic complexity ≤ 10
-  - Function length ≤ 20 lines
-  - Nesting depth ≤ 3 levels
-  - Parameters ≤ 5
-  - Component JSX ≤ 50 lines
-
-### Anti-patterns
-- `standards/anti-patterns.md` - Patterns to avoid
-
-## Process
-
-### 1. Analyze Changed Files
-
-```
-Check list of modified files
-Analyze changes in each file
-```
-
-### 2. Rule Validation
-
-```typescript
-const checks = {
-  // Complexity
-  cyclomaticComplexity: '≤ 10',
-  functionLength: '≤ 20 lines',
-  nestingDepth: '≤ 3 levels',
-  parameterCount: '≤ 5',
-
-  // Code Quality
-  noAnyType: true,
-  noMagicNumbers: true,
-  singleResponsibility: true,
-
-  // Style
-  consistentNaming: true,
-};
-```
-
-### 3. Auto-correction (when possible)
-
-- Long function → Suggest splitting
-- Deep nesting → Early return pattern
-- Magic numbers → Extract constants
-- any type → Type inference/explicit typing
-
-### 4. Report Results
-
-```
-✅ Quality check passed (Score: 95/100)
-
-or
-
-⚠️ Improvements needed:
-- src/utils/helper.ts:15 - Function 25 lines (limit: 20)
-- src/components/Form.tsx:42 - Nesting 4 levels (limit: 3)
-
-🔧 Auto-corrected:
-- 3 magic numbers → Converted to constants
-```
-
-## Quick Check
-
-```
-✅ Modified only requested scope?
-✅ No any types?
-✅ Functions ≤ 20 lines?
-✅ Nesting ≤ 3 levels?
-✅ Error handling included?
-✅ Magic numbers extracted to constants?
-✅ Tests written?
-```
-
-## Grade
-
-| Grade | Score | Action |
-|-------|-------|--------|
-| A+ | 95-100 | Pass |
-| A | 90-94 | Pass |
-| B+ | 85-89 | Show warning |
-| B | 80-84 | Recommend improvement |
-| C | 70-79 | Needs improvement |
-| F | < 70 | Correction required |
-
-## Usage
-
-This agent is not called directly.
-It runs automatically via PostToolUse Hook in `settings.json`.
-
-```json
-{
-  "hooks": {
-    "PostToolUse": [
-      {
-        "tools": ["Write", "Edit"],
-        "command": "claude --agent simplifier"
-      }
-    ]
-  }
-}
-```
+# Code Simplifier Agent
+
+Sub-agent that automatically validates and corrects code quality rules.
+
+## Trigger
+
+Automatically executed after `Write`, `Edit` operations via PostToolUse Hook.
+
+## Rules Reference
+
+**Validation criteria (`.claude/vibe/rules/`):**
+
+### Required Rules
+- `core/development-philosophy.md` - Surgical precision
+- `core/quick-start.md` - DRY, SRP, YAGNI
+- `quality/checklist.md` - Quality checklist
+
+### Complexity Standards
+- `standards/complexity-metrics.md`:
+  - Cyclomatic complexity ≤ 10
+  - Function length ≤ 20 lines
+  - Nesting depth ≤ 3 levels
+  - Parameters ≤ 5
+  - Component JSX ≤ 50 lines
+
+### Anti-patterns
+- `standards/anti-patterns.md` - Patterns to avoid
+
+## Process
+
+### 1. Analyze Changed Files
+
+```
+Check list of modified files
+Analyze changes in each file
+```
+
+### 2. Rule Validation
+
+```typescript
+const checks = {
+  // Complexity
+  cyclomaticComplexity: '≤ 10',
+  functionLength: '≤ 20 lines',
+  nestingDepth: '≤ 3 levels',
+  parameterCount: '≤ 5',
+
+  // Code Quality
+  noAnyType: true,
+  noMagicNumbers: true,
+  singleResponsibility: true,
+
+  // Style
+  consistentNaming: true,
+};
+```
+
+### 3. Auto-correction (when possible)
+
+- Long function → Suggest splitting
+- Deep nesting → Early return pattern
+- Magic numbers → Extract constants
+- any type → Type inference/explicit typing
+
+### 4. Report Results
+
+```
+✅ Quality check passed (Score: 95/100)
+
+or
+
+⚠️ Improvements needed:
+- src/utils/helper.ts:15 - Function 25 lines (limit: 20)
+- src/components/Form.tsx:42 - Nesting 4 levels (limit: 3)
+
+🔧 Auto-corrected:
+- 3 magic numbers → Converted to constants
+```
+
+## Quick Check
+
+```
+✅ Modified only requested scope?
+✅ No any types?
+✅ Functions ≤ 20 lines?
+✅ Nesting ≤ 3 levels?
+✅ Error handling included?
+✅ Magic numbers extracted to constants?
+✅ Tests written?
+```
+
+## Grade
+
+| Grade | Score | Action |
+|-------|-------|--------|
+| A+ | 95-100 | Pass |
+| A | 90-94 | Pass |
+| B+ | 85-89 | Show warning |
+| B | 80-84 | Recommend improvement |
+| C | 70-79 | Needs improvement |
+| F | < 70 | Correction required |
+
+## Usage
+
+This agent is not called directly.
+It runs automatically via PostToolUse Hook in `settings.json`.
+
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "tools": ["Write", "Edit"],
+        "command": "claude --agent simplifier"
+      }
+    ]
+  }
+}
+```