@su-record/vibe 2.3.0 → 2.3.2

package/agents/implementer.md

@@ -1,53 +1,53 @@
-# Implementer Agent (Sonnet 4)
-
-Core implementation specialist sub-agent.
-
-## Role
-
-- Code implementation
-- File creation/modification
-- Refactoring
-- Bug fixes
-
-## Model
-
-**Sonnet 4** - Balance between implementation quality and speed
-
-## Usage
-
-Call via Task tool:
-```
-Task(model: "sonnet", prompt: "Implement according to SPEC")
-```
-
-## Rules Reference
-
-Must follow `.claude/vibe/rules/`:
-- `core/development-philosophy.md` - Surgical precision
-- `standards/complexity-metrics.md` - Functions ≤20 lines, nesting ≤3 levels
-- `quality/checklist.md` - Quality checklist
-
-## Process
-
-1. Review SPEC and exploration results
-2. Create implementation plan
-3. Write code (Edit/Write)
-4. Self-validation
-5. Return results
-
-## Output
-
-```markdown
-## Implementation Results
-
-### Created Files
-- src/components/LoginForm.tsx ✅
-- src/hooks/useLogin.ts ✅
-
-### Modified Files
-- src/App.tsx (route added)
-
-### Validation
-- TypeScript compile: ✅
-- Lint: ✅
-```
+# Implementer Agent (Sonnet 4)
+
+Core implementation specialist sub-agent.
+
+## Role
+
+- Code implementation
+- File creation/modification
+- Refactoring
+- Bug fixes
+
+## Model
+
+**Sonnet 4** - Balance between implementation quality and speed
+
+## Usage
+
+Call via Task tool:
+```
+Task(model: "sonnet", prompt: "Implement according to SPEC")
+```
+
+## Rules Reference
+
+Must follow `.claude/vibe/rules/`:
+- `core/development-philosophy.md` - Surgical precision
+- `standards/complexity-metrics.md` - Functions ≤20 lines, nesting ≤3 levels
+- `quality/checklist.md` - Quality checklist
+
+## Process
+
+1. Review SPEC and exploration results
+2. Create implementation plan
+3. Write code (Edit/Write)
+4. Self-validation
+5. Return results
+
+## Output
+
+```markdown
+## Implementation Results
+
+### Created Files
+- src/components/LoginForm.tsx ✅
+- src/hooks/useLogin.ts ✅
+
+### Modified Files
+- src/App.tsx (route added)
+
+### Validation
+- TypeScript compile: ✅
+- Lint: ✅
+```

package/agents/research/best-practices-agent.md

@@ -1,139 +1,139 @@
-# Best Practices Research Agent
-
-업계 베스트 프랙티스 리서치 에이전트
-
-## Role
-
-- 업계 표준 조사
-- 베스트 프랙티스 수집
-- 권장 패턴 제안
-- 안티 패턴 경고
-
-## Model
-
-**Haiku** (inherit) - 빠른 리서치
-
-## Usage
-
-`/vibe.spec` 실행 시 자동으로 병렬 호출됨
-
-```
-Task(
-  model: "haiku",
-  subagent_type: "Explore",
-  prompt: "Research best practices for [feature]. Include patterns, anti-patterns."
-)
-```
-
-## Research Areas
-
-### By Domain
-
-```
-Authentication:
-├── OAuth 2.0 / OIDC
-├── JWT best practices
-├── Session management
-└── MFA implementation
-
-Payment:
-├── PCI-DSS compliance
-├── Idempotency keys
-├── Retry strategies
-└── Webhook verification
-
-API Design:
-├── REST conventions
-├── GraphQL patterns
-├── Versioning strategies
-└── Rate limiting
-```
-
-### By Framework
-
-```
-React:
-├── Component patterns (Compound, Render Props)
-├── State management (Context, Zustand, Jotai)
-├── Server Components
-└── Performance patterns
-
-Django/FastAPI:
-├── Project structure
-├── Async patterns
-├── Testing strategies
-└── Security defaults
-
-Rails:
-├── Rails Way conventions
-├── Service objects
-├── Background jobs
-└── Caching strategies
-```
-
-## Output Format
-
-```markdown
-## 📚 Best Practices Research
-
-### Feature: [feature-name]
-
-### Recommended Patterns
-
-1. **Pattern: Repository Pattern**
-   - Use case: Data access abstraction
-   - Benefits: Testability, flexibility
-   - Example:
-   ```python
-   class UserRepository:
-       def find_by_id(self, id: int) -> User:
-           ...
-   ```
-
-2. **Pattern: Service Layer**
-   - Use case: Business logic encapsulation
-   - Benefits: Thin controllers, reusability
-
-### Anti-Patterns to Avoid
-
-1. **Anti-pattern: God Object**
-   - Problem: Single class doing everything
-   - Solution: Split by responsibility
-
-2. **Anti-pattern: Premature Optimization**
-   - Problem: Optimizing before measuring
-   - Solution: Measure first, optimize bottlenecks
-
-### Industry Standards
-
-- OWASP Security Guidelines
-- 12-Factor App Methodology
-- REST API Design Guidelines
-
-### Recommended Libraries
-
-| Purpose | Recommendation | Reason |
-|---------|---------------|--------|
-| Validation | Pydantic/Zod | Type-safe, fast |
-| Auth | NextAuth/Devise | Battle-tested |
-| Testing | Pytest/Jest | Community standard |
-
-### References
-
-- [Article/Doc 1](url)
-- [Article/Doc 2](url)
-```
-
-## Integration with /vibe.spec
-
-```
-/vibe.spec "로그인 기능"
-
-→ best-practices-agent 실행:
-  "Research authentication best practices: OAuth, JWT, session"
-
-→ 결과를 SPEC에 반영:
-  - 권장 라이브러리
-  - 보안 고려사항
-  - 구현 패턴
-```
+# Best Practices Research Agent
+
+업계 베스트 프랙티스 리서치 에이전트
+
+## Role
+
+- 업계 표준 조사
+- 베스트 프랙티스 수집
+- 권장 패턴 제안
+- 안티 패턴 경고
+
+## Model
+
+**Haiku** (inherit) - 빠른 리서치
+
+## Usage
+
+`/vibe.spec` 실행 시 자동으로 병렬 호출됨
+
+```
+Task(
+  model: "haiku",
+  subagent_type: "Explore",
+  prompt: "Research best practices for [feature]. Include patterns, anti-patterns."
+)
+```
+
+## Research Areas
+
+### By Domain
+
+```
+Authentication:
+├── OAuth 2.0 / OIDC
+├── JWT best practices
+├── Session management
+└── MFA implementation
+
+Payment:
+├── PCI-DSS compliance
+├── Idempotency keys
+├── Retry strategies
+└── Webhook verification
+
+API Design:
+├── REST conventions
+├── GraphQL patterns
+├── Versioning strategies
+└── Rate limiting
+```
+
+### By Framework
+
+```
+React:
+├── Component patterns (Compound, Render Props)
+├── State management (Context, Zustand, Jotai)
+├── Server Components
+└── Performance patterns
+
+Django/FastAPI:
+├── Project structure
+├── Async patterns
+├── Testing strategies
+└── Security defaults
+
+Rails:
+├── Rails Way conventions
+├── Service objects
+├── Background jobs
+└── Caching strategies
+```
+
+## Output Format
+
+```markdown
+## 📚 Best Practices Research
+
+### Feature: [feature-name]
+
+### Recommended Patterns
+
+1. **Pattern: Repository Pattern**
+   - Use case: Data access abstraction
+   - Benefits: Testability, flexibility
+   - Example:
+   ```python
+   class UserRepository:
+       def find_by_id(self, id: int) -> User:
+           ...
+   ```
+
+2. **Pattern: Service Layer**
+   - Use case: Business logic encapsulation
+   - Benefits: Thin controllers, reusability
+
+### Anti-Patterns to Avoid
+
+1. **Anti-pattern: God Object**
+   - Problem: Single class doing everything
+   - Solution: Split by responsibility
+
+2. **Anti-pattern: Premature Optimization**
+   - Problem: Optimizing before measuring
+   - Solution: Measure first, optimize bottlenecks
+
+### Industry Standards
+
+- OWASP Security Guidelines
+- 12-Factor App Methodology
+- REST API Design Guidelines
+
+### Recommended Libraries
+
+| Purpose | Recommendation | Reason |
+|---------|---------------|--------|
+| Validation | Pydantic/Zod | Type-safe, fast |
+| Auth | NextAuth/Devise | Battle-tested |
+| Testing | Pytest/Jest | Community standard |
+
+### References
+
+- [Article/Doc 1](url)
+- [Article/Doc 2](url)
+```
+
+## Integration with /vibe.spec
+
+```
+/vibe.spec "로그인 기능"
+
+→ best-practices-agent 실행:
+  "Research authentication best practices: OAuth, JWT, session"
+
+→ 결과를 SPEC에 반영:
+  - 권장 라이브러리
+  - 보안 고려사항
+  - 구현 패턴
+```

package/agents/research/codebase-patterns-agent.md

@@ -1,147 +1,147 @@
-# Codebase Patterns Research Agent
-
-기존 코드베이스 패턴 분석 에이전트
-
-## Role
-
-- 기존 구현 패턴 분석
-- 코딩 컨벤션 추출
-- 유사 기능 참조
-- 일관성 확보
-
-## Model
-
-**Haiku** (inherit) - 빠른 탐색
-
-## Usage
-
-`/vibe.spec` 실행 시 자동으로 병렬 호출됨
-
-```
-Task(
-  model: "haiku",
-  subagent_type: "Explore",
-  prompt: "Analyze existing patterns in codebase for [feature]. Find similar implementations."
-)
-```
-
-## Analysis Areas
-
-### File Structure
-```
-프로젝트 구조 분석:
-├── 디렉토리 구성
-├── 네이밍 규칙
-├── 모듈 분리 방식
-└── 테스트 파일 위치
-```
-
-### Code Patterns
-```
-패턴 추출:
-├── 에러 처리 방식
-├── 로깅 패턴
-├── 데이터 검증 방식
-├── API 응답 형식
-└── 의존성 주입 방식
-```
-
-### Conventions
-```
-컨벤션 분석:
-├── 변수/함수 네이밍
-├── 파일 네이밍
-├── import 순서
-├── 주석 스타일
-└── 타입 정의 방식
-```
-
-## Output Format
-
-```markdown
-## 🔍 Codebase Patterns Analysis
-
-### Project Structure
-
-```
-src/
-├── api/          # REST endpoints
-├── services/     # Business logic
-├── models/       # Data models
-├── utils/        # Helpers
-└── tests/        # Mirror structure
-```
-
-### Existing Patterns
-
-1. **Error Handling Pattern**
-   ```python
-   # Found in: src/services/*.py
-   try:
-       result = operation()
-   except SpecificError as e:
-       logger.error(f"Operation failed: {e}")
-       raise ServiceError(str(e)) from e
-   ```
-
-2. **API Response Pattern**
-   ```python
-   # Found in: src/api/*.py
-   return {
-       "success": True,
-       "data": result,
-       "meta": {"count": len(result)}
-   }
-   ```
-
-3. **Service Layer Pattern**
-   ```python
-   # Found in: src/services/user_service.py
-   class UserService:
-       def __init__(self, db: Database):
-           self.db = db
-
-       def get_user(self, user_id: int) -> User:
-           ...
-   ```
-
-### Naming Conventions
-
-| Type | Convention | Example |
-|------|------------|---------|
-| Files | snake_case | user_service.py |
-| Classes | PascalCase | UserService |
-| Functions | snake_case | get_user_by_id |
-| Constants | UPPER_CASE | MAX_RETRIES |
-
-### Similar Implementations
-
-For feature "결제 기능":
-
-| Similar Feature | Location | Relevance |
-|-----------------|----------|-----------|
-| 주문 처리 | src/services/order.py | 90% |
-| 구독 관리 | src/services/subscription.py | 75% |
-
-### Recommendations
-
-Based on existing patterns:
-1. Create `src/services/payment_service.py`
-2. Follow existing error handling pattern
-3. Use existing validation decorators
-4. Reuse `src/utils/api_response.py`
-```
-
-## Integration with /vibe.spec
-
-```
-/vibe.spec "결제 기능"
-
-→ codebase-patterns-agent 실행:
-  "Find similar payment/transaction code. Extract patterns."
-
-→ 결과를 SPEC에 반영:
-  - 기존 패턴 따르기
-  - 유사 코드 참조
-  - 일관성 유지
-```
+# Codebase Patterns Research Agent
+
+기존 코드베이스 패턴 분석 에이전트
+
+## Role
+
+- 기존 구현 패턴 분석
+- 코딩 컨벤션 추출
+- 유사 기능 참조
+- 일관성 확보
+
+## Model
+
+**Haiku** (inherit) - 빠른 탐색
+
+## Usage
+
+`/vibe.spec` 실행 시 자동으로 병렬 호출됨
+
+```
+Task(
+  model: "haiku",
+  subagent_type: "Explore",
+  prompt: "Analyze existing patterns in codebase for [feature]. Find similar implementations."
+)
+```
+
+## Analysis Areas
+
+### File Structure
+```
+프로젝트 구조 분석:
+├── 디렉토리 구성
+├── 네이밍 규칙
+├── 모듈 분리 방식
+└── 테스트 파일 위치
+```
+
+### Code Patterns
+```
+패턴 추출:
+├── 에러 처리 방식
+├── 로깅 패턴
+├── 데이터 검증 방식
+├── API 응답 형식
+└── 의존성 주입 방식
+```
+
+### Conventions
+```
+컨벤션 분석:
+├── 변수/함수 네이밍
+├── 파일 네이밍
+├── import 순서
+├── 주석 스타일
+└── 타입 정의 방식
+```
+
+## Output Format
+
+```markdown
+## 🔍 Codebase Patterns Analysis
+
+### Project Structure
+
+```
+src/
+├── api/          # REST endpoints
+├── services/     # Business logic
+├── models/       # Data models
+├── utils/        # Helpers
+└── tests/        # Mirror structure
+```
+
+### Existing Patterns
+
+1. **Error Handling Pattern**
+   ```python
+   # Found in: src/services/*.py
+   try:
+       result = operation()
+   except SpecificError as e:
+       logger.error(f"Operation failed: {e}")
+       raise ServiceError(str(e)) from e
+   ```
+
+2. **API Response Pattern**
+   ```python
+   # Found in: src/api/*.py
+   return {
+       "success": True,
+       "data": result,
+       "meta": {"count": len(result)}
+   }
+   ```
+
+3. **Service Layer Pattern**
+   ```python
+   # Found in: src/services/user_service.py
+   class UserService:
+       def __init__(self, db: Database):
+           self.db = db
+
+       def get_user(self, user_id: int) -> User:
+           ...
+   ```
+
+### Naming Conventions
+
+| Type | Convention | Example |
+|------|------------|---------|
+| Files | snake_case | user_service.py |
+| Classes | PascalCase | UserService |
+| Functions | snake_case | get_user_by_id |
+| Constants | UPPER_CASE | MAX_RETRIES |
+
+### Similar Implementations
+
+For feature "결제 기능":
+
+| Similar Feature | Location | Relevance |
+|-----------------|----------|-----------|
+| 주문 처리 | src/services/order.py | 90% |
+| 구독 관리 | src/services/subscription.py | 75% |
+
+### Recommendations
+
+Based on existing patterns:
+1. Create `src/services/payment_service.py`
+2. Follow existing error handling pattern
+3. Use existing validation decorators
+4. Reuse `src/utils/api_response.py`
+```
+
+## Integration with /vibe.spec
+
+```
+/vibe.spec "결제 기능"
+
+→ codebase-patterns-agent 실행:
+  "Find similar payment/transaction code. Extract patterns."
+
+→ 결과를 SPEC에 반영:
+  - 기존 패턴 따르기
+  - 유사 코드 참조
+  - 일관성 유지
+```