@su-record/vibe 0.4.4 → 0.4.6

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

@@ -1,121 +0,0 @@
-# ⚡ 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 정신

package/.agent/rules/languages/dart-flutter.md

@@ -1,509 +0,0 @@
-# 🎯 Dart + Flutter 품질 규칙
-
-## 핵심 원칙 (core에서 상속)
-
-```markdown
-✅ 단일 책임 (SRP)
-✅ 중복 제거 (DRY)
-✅ 재사용성
-✅ 낮은 복잡도
-✅ 함수 ≤ 30줄, build() ≤ 50줄
-✅ 중첩 ≤ 3단계
-✅ Cyclomatic complexity ≤ 10
-```
-
-## Dart/Flutter 특화 규칙
-
-### 1. Immutability 우선 (@immutable)
-
-```dart
-// ❌ Mutable 클래스
-class User {
-  String name;
-  int age;
-
-  User({required this.name, required this.age});
-}
-
-// ✅ Immutable 클래스 + copyWith
-@immutable
-class User {
-  const User({
-    required this.name,
-    required this.age,
-  });
-
-  final String name;
-  final int age;
-
-  User copyWith({
-    String? name,
-    int? age,
-  }) {
-    return User(
-      name: name ?? this.name,
-      age: age ?? this.age,
-    );
-  }
-
-  @override
-  bool operator ==(Object other) =>
-      identical(this, other) ||
-      other is User && name == other.name && age == other.age;
-
-  @override
-  int get hashCode => name.hashCode ^ age.hashCode;
-}
-```
-
-### 2. StatelessWidget 선호
-
-```dart
-// ✅ StatelessWidget (순수 위젯)
-class UserAvatar extends StatelessWidget {
-  const UserAvatar({
-    super.key,
-    required this.imageUrl,
-    this.size = 40.0,
-    this.onTap,
-  });
-
-  final String imageUrl;
-  final double size;
-  final VoidCallback? onTap;
-
-  @override
-  Widget build(BuildContext context) {
-    return GestureDetector(
-      onTap: onTap,
-      child: CircleAvatar(
-        radius: size / 2,
-        backgroundImage: NetworkImage(imageUrl),
-      ),
-    );
-  }
-}
-
-// ❌ StatefulWidget 남용 (상태가 없는데 사용)
-class UserAvatar extends StatefulWidget {
-  // 상태 관리 불필요
-}
-```
-
-### 3. Provider 패턴 (상태 관리)
-
-```dart
-// ✅ Immutable State + ChangeNotifier
-@immutable
-class FeedState {
-  const FeedState({
-    this.feeds = const [],
-    this.isLoading = false,
-    this.error,
-  });
-
-  final List<Feed> feeds;
-  final bool isLoading;
-  final String? error;
-
-  FeedState copyWith({
-    List<Feed>? feeds,
-    bool? isLoading,
-    String? error,
-  }) {
-    return FeedState(
-      feeds: feeds ?? this.feeds,
-      isLoading: isLoading ?? this.isLoading,
-      error: error ?? this.error,
-    );
-  }
-}
-
-class FeedProvider extends ChangeNotifier {
-  FeedState _state = const FeedState();
-  FeedState get state => _state;
-
-  final FeedService _feedService;
-
-  FeedProvider(this._feedService);
-
-  Future<void> loadFeeds() async {
-    _state = _state.copyWith(isLoading: true, error: null);
-    notifyListeners();
-
-    try {
-      final feeds = await _feedService.getFeeds();
-      _state = _state.copyWith(feeds: feeds, isLoading: false);
-    } catch (e) {
-      _state = _state.copyWith(error: e.toString(), isLoading: false);
-    }
-    notifyListeners();
-  }
-}
-
-// 사용
-class FeedScreen extends StatelessWidget {
-  @override
-  Widget build(BuildContext context) {
-    final feedState = context.watch<FeedProvider>().state;
-
-    if (feedState.isLoading) return const CircularProgressIndicator();
-    if (feedState.error != null) return ErrorWidget(feedState.error!);
-
-    return FeedList(feeds: feedState.feeds);
-  }
-}
-```
-
-### 4. Null Safety 명확히
-
-```dart
-// ✅ Null safety 활용
-class User {
-  User({
-    required this.id,        // Non-nullable (필수)
-    required this.name,
-    this.bio,                // Nullable (선택)
-  });
-
-  final String id;
-  final String name;
-  final String? bio;        // ? 명시
-
-  String getBioOrDefault() {
-    return bio ?? 'No bio';  // ?? 연산자
-  }
-
-  void printBio() {
-    bio?.length;             // ?. 안전 호출
-  }
-}
-
-// ✅ Late 변수 (초기화 지연)
-class MyWidget extends StatefulWidget {
-  @override
-  State<MyWidget> createState() => _MyWidgetState();
-}
-
-class _MyWidgetState extends State<MyWidget> {
-  late AnimationController _controller;  // initState에서 초기화
-
-  @override
-  void initState() {
-    super.initState();
-    _controller = AnimationController(vsync: this);
-  }
-
-  @override
-  void dispose() {
-    _controller.dispose();
-    super.dispose();
-  }
-}
-```
-
-### 5. 위젯 분리 (Extract Widget)
-
-```dart
-// ❌ 긴 build 메서드 (80줄)
-class UserProfile extends StatelessWidget {
-  @override
-  Widget build(BuildContext context) {
-    return Column(
-      children: [
-        // 30줄: 헤더
-        Container(...),
-        // 25줄: 통계
-        Row(...),
-        // 25줄: 피드 리스트
-        ListView(...),
-      ],
-    );
-  }
-}
-
-// ✅ 서브 위젯으로 분리
-class UserProfile extends StatelessWidget {
-  @override
-  Widget build(BuildContext context) {
-    return Column(
-      children: [
-        const ProfileHeader(),
-        const ProfileStats(),
-        const ProfileFeedList(),
-      ],
-    );
-  }
-}
-
-class ProfileHeader extends StatelessWidget {
-  const ProfileHeader({super.key});
-
-  @override
-  Widget build(BuildContext context) {
-    // 헤더만
-  }
-}
-
-class ProfileStats extends StatelessWidget {
-  const ProfileStats({super.key});
-
-  @override
-  Widget build(BuildContext context) {
-    // 통계만
-  }
-}
-```
-
-### 6. 순수 함수 (Static Methods)
-
-```dart
-// ✅ 순수 함수 (상태 없음)
-class DateUtils {
-  // Private constructor (인스턴스 생성 방지)
-  DateUtils._();
-
-  static String formatRelativeTime(DateTime dateTime) {
-    final now = DateTime.now();
-    final difference = now.difference(dateTime);
-
-    if (difference.inDays > 0) return '${difference.inDays}일 전';
-    if (difference.inHours > 0) return '${difference.inHours}시간 전';
-    return '${difference.inMinutes}분 전';
-  }
-
-  static bool isToday(DateTime dateTime) {
-    final now = DateTime.now();
-    return dateTime.year == now.year &&
-           dateTime.month == now.month &&
-           dateTime.day == now.day;
-  }
-}
-
-// 사용
-final formatted = DateUtils.formatRelativeTime(feed.createdAt);
-```
-
-### 7. 에러 처리 (Result/Either 패턴)
-
-```dart
-// ✅ Result 타입으로 에러 처리
-sealed class Result<T> {
-  const Result();
-}
-
-class Success<T> extends Result<T> {
-  const Success(this.value);
-  final T value;
-}
-
-class Failure<T> extends Result<T> {
-  const Failure(this.error);
-  final String error;
-}
-
-// 사용
-Future<Result<User>> login(String email, String password) async {
-  try {
-    final user = await _authService.login(email, password);
-    return Success(user);
-  } catch (e) {
-    return Failure(e.toString());
-  }
-}
-
-// 호출부 (Pattern matching)
-final result = await login(email, password);
-switch (result) {
-  case Success(:final value):
-    Navigator.pushReplacement(context, HomePage(user: value));
-  case Failure(:final error):
-    showErrorDialog(context, error);
-}
-```
-
-### 8. Extension Methods
-
-```dart
-// ✅ Extension으로 기능 확장
-extension StringExtension on String {
-  String capitalize() {
-    if (isEmpty) return this;
-    return '${this[0].toUpperCase()}${substring(1)}';
-  }
-
-  bool get isEmail {
-    final emailRegex = RegExp(r'^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$');
-    return emailRegex.hasMatch(this);
-  }
-}
-
-extension ListExtension<T> on List<T> {
-  List<T> distinctBy<K>(K Function(T) keySelector) {
-    final seen = <K>{};
-    return where((item) => seen.add(keySelector(item))).toList();
-  }
-}
-
-// 사용
-final name = 'john'.capitalize();  // 'John'
-final isValid = 'test@example.com'.isEmail;  // true
-```
-
-### 9. const Constructor 활용
-
-```dart
-// ✅ const constructor (컴파일 타임 상수)
-class AppColors {
-  const AppColors._();
-
-  static const primary = Color(0xFF6200EE);
-  static const secondary = Color(0xFF03DAC6);
-  static const error = Color(0xFFB00020);
-}
-
-class Spacing {
-  const Spacing._();
-
-  static const xs = 4.0;
-  static const sm = 8.0;
-  static const md = 16.0;
-  static const lg = 24.0;
-  static const xl = 32.0;
-}
-
-// ✅ const 위젯 (재사용 시 성능 향상)
-class LoadingIndicator extends StatelessWidget {
-  const LoadingIndicator({super.key});
-
-  @override
-  Widget build(BuildContext context) {
-    return const Center(
-      child: CircularProgressIndicator(),
-    );
-  }
-}
-
-// 사용
-const LoadingIndicator()  // const로 생성
-```
-
-### 10. 비동기 처리 (Future/Stream)
-
-```dart
-// ✅ Future (단일 비동기 작업)
-Future<List<Feed>> fetchFeeds() async {
-  final response = await dio.get('/api/feeds');
-  return (response.data as List)
-      .map((json) => Feed.fromJson(json))
-      .toList();
-}
-
-// ✅ Stream (연속 비동기 이벤트)
-Stream<List<Feed>> watchFeeds() {
-  return Stream.periodic(
-    const Duration(seconds: 30),
-    (_) => fetchFeeds(),
-  ).asyncMap((future) => future);
-}
-
-// ✅ StreamBuilder 사용
-class FeedStream extends StatelessWidget {
-  @override
-  Widget build(BuildContext context) {
-    return StreamBuilder<List<Feed>>(
-      stream: watchFeeds(),
-      builder: (context, snapshot) {
-        if (snapshot.connectionState == ConnectionState.waiting) {
-          return const LoadingIndicator();
-        }
-        if (snapshot.hasError) {
-          return ErrorWidget(snapshot.error.toString());
-        }
-        if (!snapshot.hasData) {
-          return const EmptyState();
-        }
-
-        return FeedList(feeds: snapshot.data!);
-      },
-    );
-  }
-}
-```
-
-## 안티패턴
-
-```dart
-// ❌ Mutable state
-class BadCounter extends StatefulWidget {
-  int count = 0;  // 위험! StatefulWidget은 재생성될 수 있음
-
-  @override
-  State<BadCounter> createState() => _BadCounterState();
-}
-
-// ❌ BuildContext를 async gap 너머에서 사용
-Future<void> badNavigate() async {
-  await Future.delayed(Duration(seconds: 1));
-  Navigator.push(context, ...);  // ❌ context가 무효화됐을 수 있음
-}
-
-// ✅ mounted 체크
-Future<void> goodNavigate() async {
-  await Future.delayed(Duration(seconds: 1));
-  if (!mounted) return;
-  Navigator.push(context, ...);
-}
-
-// ❌ setState에서 긴 작업
-setState(() {
-  // 10줄의 복잡한 계산  ❌
-});
-
-// ✅ 계산 후 setState
-final newValue = expensiveCalculation();
-setState(() {
-  _value = newValue;  // 간단한 할당만
-});
-
-// ❌ GlobalKey 남용
-final GlobalKey<FormState> _formKey = GlobalKey();
-
-// ✅ Controller 사용
-final TextEditingController _controller = TextEditingController();
-```
-
-## 코드 품질 도구
-
-```bash
-# 분석
-flutter analyze
-
-# 포맷팅
-dart format .
-
-# 테스트
-flutter test
-flutter test --coverage
-
-# 빌드
-flutter build apk --release
-flutter build ios --release
-flutter build web --release
-```
-
-## 체크리스트
-
-Dart/Flutter 코드 작성 시:
-
-- [ ] @immutable + copyWith 패턴
-- [ ] StatelessWidget 우선 사용
-- [ ] Provider로 상태 관리 분리
-- [ ] Null safety (?, ??, ?., !)
-- [ ] build() ≤ 50줄 (위젯 분리)
-- [ ] 순수 함수 (static methods)
-- [ ] Result 타입으로 에러 처리
-- [ ] Extension methods 활용
-- [ ] const constructor 사용
-- [ ] Future/Stream 적절히 선택
-- [ ] 복잡도 ≤ 10