@su-record/vibe 0.4.6 → 0.4.7

package/.vibe/rules/core/communication-guide.md

@@ -0,0 +1,104 @@
+# 💬 커뮤니케이션 가이드
+
+## ⚠️ 최우선 규칙: 한국어로 응답
+
+**모든 대화, 설명, 주석은 한국어로 작성합니다.**
+
+- ✅ AI 응답: 한국어
+- ✅ 코드 주석: 한국어
+- ✅ 문서: 한국어
+- ✅ 에러 메시지: 한국어
+- ⚠️ 예외: 코드 자체 (함수명, 변수명 등)는 영어
+
+## 3.1 코드 제공 형식
+
+```markdown
+### 작업 범위
+
+"요청하신 대로 UserProfile 컴포넌트의 상태 관리 로직만 수정했습니다."
+
+### 변경 사항 요약
+
+주문 상태 업데이트 로직 개선 - Optimistic updates 적용
+
+### 코드
+
+[완전한 코드 블록]
+
+### 참고사항
+
+- 에러 발생 시 자동 롤백
+- 네트워크 재시도 3회
+```
+
+## 3.2 리뷰 응답 형식
+
+```markdown
+### 개선점
+
+1. memoization 누락 (성능)
+2. error boundary 미적용 (안정성)
+
+### 권장사항
+
+useMemo 적용 및 ErrorBoundary로 감싸기
+```
+
+## 3.3 에러 보고 형식
+
+```markdown
+### 문제
+
+[발생한 문제 명확히 설명]
+
+### 원인
+
+[분석된 원인]
+
+### 해결 방법
+
+[구체적인 해결 단계]
+
+### 예방책
+
+[향후 방지 방법]
+```
+
+## 3.4 변경사항 설명 원칙
+
+- **명확성**: 무엇을 왜 변경했는지 명확히
+- **간결성**: 핵심만 전달
+- **완전성**: 부작용과 주의사항 포함
+- **추적성**: 관련 이슈/요청 참조
+
+## 3.5 특수 명령어 실행
+
+- **"optimize"**: 성능 개선 (memoization, 번들 크기 등)
+- **"enhance accessibility"**: ARIA, 키보드 지원 등 추가
+- **"strengthen types"**: any 제거, 타입 안전성 향상
+- **"cleanup"**: 불필요한 코드 제거 (요청 시에만)
+- **"split"**: 컴포넌트/함수 분리 (요청 시에만)
+
+## 3.6 질문 형식
+
+### 명확성이 필요할 때
+
+```markdown
+다음 사항을 확인해주세요:
+
+1. [구체적인 질문 1]
+2. [구체적인 질문 2]
+
+이 정보가 있으면 더 정확한 구현이 가능합니다.
+```
+
+### 대안 제시
+
+```markdown
+요청하신 방법 외에 다음 대안도 가능합니다:
+
+**방법 A**: [설명] - 장점: [장점], 단점: [단점]
+**방법 B**: [설명] - 장점: [장점], 단점: [단점]
+
+어떤 방식을 선호하시나요?
+```

package/.vibe/rules/core/development-philosophy.md

@@ -0,0 +1,53 @@
+# 🏛️ 개발 철학과 원칙 - "왜"에 대한 답
+
+## 1.1 🥇 최우선 순위: 수술적 정밀도
+
+> **⚠️ 이것은 모든 작업에 앞서는 TORY의 첫 번째 원칙입니다.**
+>
+> **요청받지 않은 코드는 절대 수정/삭제하지 않습니다.**
+
+### 원칙
+
+- **엄격한 범위 준수**: 사용자가 명시적으로 요청한 파일과 코드 블록만 수정
+- **기존 코드 보존**: 작동하는 코드를 임의로 리팩토링하거나 제거하지 않음
+- **스타일 존중**: 기존 네이밍, 포맷팅, 주석 스타일 유지
+
+## 1.2 핵심 철학
+
+### 🎯 개발의 황금률
+
+- **한국어 우선**: 모든 커뮤니케이션은 명확한 한국어로
+- **단순함의 미학**: 코드가 적을수록 좋은 코드
+- **DRY 원칙**: 반복하지 말고 재사용
+- **단일 책임**: 하나의 함수는 하나의 목적만
+- **실용주의**: 완벽보다 실용, YAGNI 정신
+
+### 🎨 코드 품질 기준
+
+- **가독성**: 코드는 사람을 위한 것
+- **예측 가능성**: 코드에서 놀라움은 금물
+- **유지보수성**: 미래의 나를 배려
+- **테스트 가능성**: 검증 가능한 구조
+
+## 1.3 아키텍처 원칙
+
+### 🏗️ 설계의 지혜
+
+- **패턴의 적절한 적용**: Composite, Observer, Factory 등 필요에 따라 적용
+- **과도한 추상화 지양**: 3단계 이상의 wrapper 금지
+- **순환 의존성 방지**: File A → File B → File A ❌
+
+### ♿ 접근성은 선택이 아닌 필수
+
+- Semantic HTML을 기본으로
+- 키보드 내비게이션 지원
+- 스크린 리더 최적화
+- ARIA 속성 적극 활용
+
+## 핵심 가치
+
+1. **명확성**: 코드는 자기 설명적이어야 함
+2. **간결성**: 불필요한 복잡도 제거
+3. **일관성**: 일관된 패턴과 스타일 유지
+4. **확장성**: 미래의 변화를 고려한 설계
+5. **안전성**: 오류 처리와 엣지 케이스 고려

package/.vibe/rules/core/quick-start.md

@@ -0,0 +1,121 @@
+# ⚡ Quick Start - 즉시 적용 가능한 원칙
+
+## 🎯 5가지 핵심 원칙
+
+```
+✅ 🇰🇷 한국어로 응답 (최우선)
+✅ 📉 코드가 적을수록 부채도 적다
+✅ 🚫 DRY - Don't Repeat Yourself
+✅ 🎯 단일 책임 원칙 (SRP)
+✅ 🙏 YAGNI - You Aren't Gonna Need It
+```
+
+## ⚠️ 언어 규칙 (절대 준수)
+
+**모든 답변은 한국어로 작성합니다.**
+
+### 한국어 사용 원칙
+
+1. **설명, 주석, 대화**: 100% 한국어
+2. **코드**: 영어 (프로그래밍 언어 표준)
+3. **기술 용어**: 한국어 우선, 필요시 영어 병기
+   - ✅ "의존성 주입 (Dependency Injection)"
+   - ✅ "상태 관리 (State Management)"
+   - ❌ "Dependency Injection"
+4. **에러 메시지**: 한국어로 설명
+5. **문서 제목/헤더**: 한국어
+
+### 예시
+
+```python
+# ✅ 좋은 예
+# 사용자 인증 미들웨어
+async def authenticate_user(token: str) -> User:
+    """
+    JWT 토큰을 검증하고 사용자를 반환합니다.
+
+    Args:
+        token: JWT 인증 토큰
+
+    Returns:
+        인증된 사용자 객체
+
+    Raises:
+        HTTPException: 토큰이 유효하지 않은 경우
+    """
+    # 토큰 검증
+    payload = decode_jwt(token)
+
+    # 사용자 조회
+    user = await get_user(payload["sub"])
+    if not user:
+        raise HTTPException(401, detail="인증 실패")
+
+    return user
+
+# ❌ 나쁜 예
+# User authentication middleware
+async def authenticate_user(token: str) -> User:
+    """
+    Verify JWT token and return user.
+    """
+    # Verify token
+    payload = decode_jwt(token)
+
+    # Get user
+    user = await get_user(payload["sub"])
+    if not user:
+        raise HTTPException(401, detail="Authentication failed")
+
+    return user
+```
+
+### AI 응답 예시
+
+```markdown
+# ❌ 영어 응답
+I'll help you create a new API endpoint. First, let's define the schema...
+
+# ✅ 한국어 응답
+새로운 API 엔드포인트를 만들어드리겠습니다. 먼저 스키마를 정의하겠습니다...
+```
+
+## 📦 체크포인트
+
+### 새 패키지 추가 전
+
+- [ ] 기존 패키지로 해결 가능한가?
+- [ ] 정말 필요한가?
+- [ ] 번들 크기 영향은?
+
+### 파일 생성 시
+
+- [ ] 사용 위치 확인
+- [ ] import 즉시 추가
+- [ ] 순환 의존성 체크
+
+## 🥇 최우선 원칙: 수술적 정밀도
+
+> **⚠️ 이것은 모든 작업에 앞서는 TORY의 첫 번째 원칙입니다.**
+>
+> **요청받지 않은 코드는 절대 수정/삭제하지 않습니다.**
+
+- **엄격한 범위 준수**: 사용자가 명시적으로 요청한 파일과 코드 블록만 수정
+- **기존 코드 보존**: 작동하는 코드를 임의로 리팩토링하거나 제거하지 않음
+- **스타일 존중**: 기존 네이밍, 포맷팅, 주석 스타일 유지
+
+## 🚀 작업 전 필수 체크리스트
+
+```
+[x] 최우선 원칙 준수: 요청 범위 외 절대 수정 금지
+[ ] 기존 코드 존중: 기존 스타일과 구조 유지
+[ ] 문서 규칙 준수: 네이밍, 구조 등 모든 가이드라인 준수
+```
+
+## 🎯 황금률
+
+- **한국어 우선**: 모든 커뮤니케이션은 명확한 한국어로
+- **단순함의 미학**: 코드가 적을수록 좋은 코드
+- **DRY 원칙**: 반복하지 말고 재사용
+- **단일 책임**: 하나의 함수는 하나의 목적만
+- **실용주의**: 완벽보다 실용, YAGNI 정신