@su-record/vibe 2.4.55 → 2.4.57

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

@@ -1,104 +1,98 @@
-# 💬 커뮤니케이션 가이드
+# Communication Guide
 
-## ⚠️ 최우선 규칙: 한국어로 응답
+## Language Configuration
 
-**모든 대화, 설명, 주석은 한국어로 작성합니다.**
+Language can be configured per project in `.sutory/config.json`. Code itself (function names, variable names, etc.) should always be in English.
 
-- ✅ AI 응답: 한국어
-- ✅ 코드 주석: 한국어
-- ✅ 문서: 한국어
-- ✅ 에러 메시지: 한국어
-- ⚠️ 예외: 코드 자체 (함수명, 변수명 등)는 영어
-
-## 3.1 코드 제공 형식
+## 3.1 Code Delivery Format
 
 ```markdown
-### 작업 범위
+### Scope of Work
 
-"요청하신 대로 UserProfile 컴포넌트의 상태 관리 로직만 수정했습니다."
+"As requested, I only modified the state management logic in the UserProfile component."
 
-### 변경 사항 요약
+### Summary of Changes
 
-주문 상태 업데이트 로직 개선 - Optimistic updates 적용
+Improved order status update logic - Applied optimistic updates
 
-### 코드
+### Code
 
-[완전한 코드 블록]
+[Complete code block]
 
-### 참고사항
+### Notes
 
-- 에러 발생 시 자동 롤백
-- 네트워크 재시도 3회
+- Auto-rollback on error
+- 3 network retries
 ```
 
-## 3.2 리뷰 응답 형식
+## 3.2 Review Response Format
 
 ```markdown
-### 개선점
+### Improvements
 
-1. memoization 누락 (성능)
-2. error boundary 미적용 (안정성)
+1. Missing memoization (performance)
+2. Error boundary not applied (stability)
 
-### 권장사항
+### Recommendations
 
-useMemo 적용 및 ErrorBoundary로 감싸기
+Apply useMemo and wrap with ErrorBoundary
 ```
 
-## 3.3 에러 보고 형식
+## 3.3 Error Report Format
 
 ```markdown
-### 문제
+### Problem
 
-[발생한 문제 명확히 설명]
+[Clearly explain the issue that occurred]
 
-### 원인
+### Cause
 
-[분석된 원인]
+[Analyzed cause]
 
-### 해결 방법
+### Solution
 
-[구체적인 해결 단계]
+[Specific resolution steps]
 
-### 예방책
+### Prevention
 
-[향후 방지 방법]
+[How to prevent in the future]
 ```
 
-## 3.4 변경사항 설명 원칙
+## 3.4 Change Explanation Principles
 
-- **명확성**: 무엇을 왜 변경했는지 명확히
-- **간결성**: 핵심만 전달
-- **완전성**: 부작용과 주의사항 포함
-- **추적성**: 관련 이슈/요청 참조
+- **Clarity**: Clearly explain what was changed and why
+- **Conciseness**: Communicate only the essentials
+- **Completeness**: Include side effects and caveats
+- **Traceability**: Reference related issues/requests
 
-## 3.5 특수 명령어 실행
+## 3.5 Special Command Execution
 
-- **"optimize"**: 성능 개선 (memoization, 번들 크기 등)
-- **"enhance accessibility"**: ARIA, 키보드 지원 등 추가
-- **"strengthen types"**: any 제거, 타입 안전성 향상
-- **"cleanup"**: 불필요한 코드 제거 (요청 시에만)
-- **"split"**: 컴포넌트/함수 분리 (요청 시에만)
+- **"optimize"**: Performance improvements (memoization, bundle size, etc.)
+- **"enhance accessibility"**: Add ARIA, keyboard support, etc.
+- **"strengthen types"**: Remove `any`, improve type safety
+- **"cleanup"**: Remove unnecessary code (only when requested)
+- **"split"**: Separate components/functions (only when requested)
 
-## 3.6 질문 형식
+## 3.6 Question Format
 
-### 명확성이 필요할 때
+### When Clarity is Needed
 
 ```markdown
-다음 사항을 확인해주세요:
+Please clarify the following:
 
-1. [구체적인 질문 1]
-2. [구체적인 질문 2]
+1. [Specific question 1]
+2. [Specific question 2]
 
-이 정보가 있으면 더 정확한 구현이 가능합니다.
+With this information, a more accurate implementation is possible.
 ```
 
-### 대안 제시
+### Presenting Alternatives
 
 ```markdown
-요청하신 방법 외에 다음 대안도 가능합니다:
+In addition to your requested approach, the following alternatives are possible:
 
-**방법 A**: [설명] - 장점: [장점], 단점: [단점]
-**방법 B**: [설명] - 장점: [장점], 단점: [단점]
+**Method A**: [Description] - Pros: [Pros], Cons: [Cons]
+**Method B**: [Description] - Pros: [Pros], Cons: [Cons]
 
-어떤 방식을 선호하시나요?
+Which approach do you prefer?
 ```

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

@@ -1,53 +1,52 @@
-# 🏛️ 개발 철학과 원칙 - "왜"에 대한 답
+# Development Philosophy and Principles - Answering "Why"
 
-## 1.1 🥇 최우선 순위: 수술적 정밀도
+## 1.1 Top Priority: Surgical Precision
 
-> **⚠️ 이것은 모든 작업에 앞서는 TORY의 첫 번째 원칙입니다.**
+> **⚠️ This is the first principle that precedes all work.**
 >
-> **요청받지 않은 코드는 절대 수정/삭제하지 않습니다.**
+> **Never modify/delete code that wasn't requested.**
 
-### 원칙
+### Principles
 
-- **엄격한 범위 준수**: 사용자가 명시적으로 요청한 파일과 코드 블록만 수정
-- **기존 코드 보존**: 작동하는 코드를 임의로 리팩토링하거나 제거하지 않음
-- **스타일 존중**: 기존 네이밍, 포맷팅, 주석 스타일 유지
+- **Strict scope adherence**: Only modify files and code blocks explicitly requested by the user
+- **Preserve existing code**: Do not arbitrarily refactor or remove working code
+- **Respect style**: Maintain existing naming, formatting, and comment styles
 
-## 1.2 핵심 철학
+## 1.2 Core Philosophy
 
-### 🎯 개발의 황금률
+### Development Golden Rules
 
-- **한국어 우선**: 모든 커뮤니케이션은 명확한 한국어로
-- **단순함의 미학**: 코드가 적을수록 좋은 코드
-- **DRY 원칙**: 반복하지 말고 재사용
-- **단일 책임**: 하나의 함수는 하나의 목적만
-- **실용주의**: 완벽보다 실용, YAGNI 정신
+- **Simplicity aesthetics**: Less code is better code
+- **DRY principle**: Don't repeat, reuse
+- **Single responsibility**: One function serves one purpose
+- **Pragmatism**: Practical over perfect, YAGNI spirit
 
-### 🎨 코드 품질 기준
+### Code Quality Standards
 
-- **가독성**: 코드는 사람을 위한 것
-- **예측 가능성**: 코드에서 놀라움은 금물
-- **유지보수성**: 미래의 나를 배려
-- **테스트 가능성**: 검증 가능한 구조
+- **Readability**: Code is for humans
+- **Predictability**: No surprises in code
+- **Maintainability**: Consider future you
+- **Testability**: Verifiable structure
 
-## 1.3 아키텍처 원칙
+## 1.3 Architecture Principles
 
-### 🏗️ 설계의 지혜
+### Design Wisdom
 
-- **패턴의 적절한 적용**: Composite, Observer, Factory 등 필요에 따라 적용
-- **과도한 추상화 지양**: 3단계 이상의 wrapper 금지
-- **순환 의존성 방지**: File A → File B → File A ❌
+- **Appropriate pattern application**: Apply Composite, Observer, Factory, etc. as needed
+- **Avoid over-abstraction**: No more than 3 levels of wrappers
+- **Prevent circular dependencies**: File A → File B → File A ❌
 
-### ♿ 접근성은 선택이 아닌 필수
+### Accessibility is Mandatory, Not Optional
 
-- Semantic HTML을 기본으로
-- 키보드 내비게이션 지원
-- 스크린 리더 최적화
-- ARIA 속성 적극 활용
+- Use semantic HTML as default
+- Support keyboard navigation
+- Optimize for screen readers
+- Actively use ARIA attributes
 
-## 핵심 가치
+## Core Values
 
-1. **명확성**: 코드는 자기 설명적이어야 함
-2. **간결성**: 불필요한 복잡도 제거
-3. **일관성**: 일관된 패턴과 스타일 유지
-4. **확장성**: 미래의 변화를 고려한 설계
-5. **안전성**: 오류 처리와 엣지 케이스 고려
+1. **Clarity**: Code should be self-explanatory
+2. **Conciseness**: Remove unnecessary complexity
+3. **Consistency**: Maintain consistent patterns and styles
+4. **Scalability**: Design considering future changes
+5. **Safety**: Consider error handling and edge cases

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

@@ -1,63 +1,82 @@
-# ⚡ Quick Start - 즉시 적용 가능한 원칙
+# Quick Start - Immediately Applicable Principles
 
-## 🎯 5가지 핵심 원칙
+## 5 Core Principles
 
 ```
-✅ 🇰🇷 한국어로 응답 (최우선)
-✅ 📉 코드가 적을수록 부채도 적다
+✅ 📉 Less code means less technical debt
 ✅ 🚫 DRY - Don't Repeat Yourself
-✅ 🎯 단일 책임 원칙 (SRP)
+✅ 🎯 Single Responsibility Principle (SRP)
 ✅ 🙏 YAGNI - You Aren't Gonna Need It
+✅ 🔒 Security first
 ```
 
-## ⚠️ 언어 규칙 (절대 준수)
+## Language Configuration
 
-**모든 답변은 한국어로 작성합니다.**
+Language settings can be configured in `.sutory/config.json`:
 
-### 한국어 사용 원칙
+```json
+{
+  "language": "en"  // Options: "en", "ko"
+}
+```
 
-1. **설명, 주석, 대화**: 100% 한국어
-2. **코드**: 영어 (프로그래밍 언어 표준)
-3. **기술 용어**: 한국어 우선, 필요시 영어 병기
-   - ✅ "의존성 주입 (Dependency Injection)"
-   - ✅ "상태 관리 (State Management)"
-   - ❌ "Dependency Injection"
-4. **에러 메시지**: 한국어로 설명
-5. **문서 제목/헤더**: 한국어
+## Checkpoints
 
-### 예시
+### Before Adding New Packages
 
-```python
-# ✅ 좋은 예
-# 사용자 인증 미들웨어
-async def authenticate_user(token: str) -> User:
-    """
-    JWT 토큰을 검증하고 사용자를 반환합니다.
+- [ ] Can it be solved with existing packages?
+- [ ] Is it really necessary?
+- [ ] What is the bundle size impact?
 
-    Args:
-        token: JWT 인증 토큰
+### When Creating Files
 
-    Returns:
-        인증된 사용자 객체
+- [ ] Verify where it will be used
+- [ ] Add imports immediately
+- [ ] Check for circular dependencies
 
-    Raises:
-        HTTPException: 토큰이 유효하지 않은 경우
-    """
-    # 토큰 검증
-    payload = decode_jwt(token)
+## Top Priority: Surgical Precision
 
-    # 사용자 조회
-    user = await get_user(payload["sub"])
-    if not user:
-        raise HTTPException(401, detail="인증 실패")
+> **⚠️ This is the first principle that precedes all work.**
+>
+> **Never modify/delete code that wasn't requested.**
 
-    return user
+- **Strict scope adherence**: Only modify files and code blocks explicitly requested by the user
+- **Preserve existing code**: Do not arbitrarily refactor or remove working code
+- **Respect style**: Maintain existing naming, formatting, and comment styles
+
+## Pre-Work Checklist
+
+```
+[x] Follow top priority: Never modify outside request scope
+[ ] Respect existing code: Maintain existing style and structure
+[ ] Follow documentation rules: Adhere to naming, structure guidelines
+```
+
+## Golden Rules
 
-# ❌ 나쁜 예
+- **Simplicity aesthetics**: Less code is better code
+- **DRY principle**: Don't repeat, reuse
+- **Single responsibility**: One function serves one purpose
+- **Pragmatism**: Practical over perfect, YAGNI spirit
+
+## Code Examples
+
+### Good Example
+
+```python
 # User authentication middleware
 async def authenticate_user(token: str) -> User:
     """
     Verify JWT token and return user.
+
+    Args:
+        token: JWT authentication token
+
+    Returns:
+        Authenticated user object
+
+    Raises:
+        HTTPException: When token is invalid
     """
     # Verify token
     payload = decode_jwt(token)
@@ -70,52 +89,14 @@ async def authenticate_user(token: str) -> User:
     return user
 ```
 
-### AI 응답 예시
-
-```markdown
-# ❌ 영어 응답
-I'll help you create a new API endpoint. First, let's define the schema...
-
-# ✅ 한국어 응답
-새로운 API 엔드포인트를 만들어드리겠습니다. 먼저 스키마를 정의하겠습니다...
-```
-
-## 📦 체크포인트
-
-### 새 패키지 추가 전
-
-- [ ] 기존 패키지로 해결 가능한가?
-- [ ] 정말 필요한가?
-- [ ] 번들 크기 영향은?
+### Bad Example
 
-### 파일 생성 시
-
-- [ ] 사용 위치 확인
-- [ ] import 즉시 추가
-- [ ] 순환 의존성 체크
-
-## 🥇 최우선 원칙: 수술적 정밀도
-
-> **⚠️ 이것은 모든 작업에 앞서는 TORY의 첫 번째 원칙입니다.**
->
-> **요청받지 않은 코드는 절대 수정/삭제하지 않습니다.**
-
-- **엄격한 범위 준수**: 사용자가 명시적으로 요청한 파일과 코드 블록만 수정
-- **기존 코드 보존**: 작동하는 코드를 임의로 리팩토링하거나 제거하지 않음
-- **스타일 존중**: 기존 네이밍, 포맷팅, 주석 스타일 유지
-
-## 🚀 작업 전 필수 체크리스트
-
-```
-[x] 최우선 원칙 준수: 요청 범위 외 절대 수정 금지
-[ ] 기존 코드 존중: 기존 스타일과 구조 유지
-[ ] 문서 규칙 준수: 네이밍, 구조 등 모든 가이드라인 준수
+```python
+# No comments, unclear purpose
+async def auth(t):
+    p = decode_jwt(t)
+    u = await get_user(p["sub"])
+    if not u:
+        raise HTTPException(401)
+    return u
 ```
-
-## 🎯 황금률
-
-- **한국어 우선**: 모든 커뮤니케이션은 명확한 한국어로
-- **단순함의 미학**: 코드가 적을수록 좋은 코드
-- **DRY 원칙**: 반복하지 말고 재사용
-- **단일 책임**: 하나의 함수는 하나의 목적만
-- **실용주의**: 완벽보다 실용, YAGNI 정신