@wooojin/forgen 0.1.0

package/commands/migrate.md

@@ -0,0 +1,101 @@
+---
+name: migrate
+description: This skill should be used when the user asks to "migrate,마이그레이션,업그레이드,upgrade". Safe migration workflow for DB, API, and framework upgrades
+triggers:
+  - "migrate"
+  - "마이그레이션"
+  - "업그레이드"
+  - "upgrade"
+---
+
+<Purpose>
+데이터베이스 스키마 변경, API 버전 업그레이드, 프레임워크 마이그레이션을
+안전하게 수행하는 5단계 워크플로우를 제공합니다.
+각 단계에서 롤백 지점을 확보하여 위험을 최소화합니다.
+</Purpose>
+
+<Steps>
+1. **분석 (Analyze)**
+   - 현재 상태 스냅샷: 의존성 트리, 스키마 버전, API 계약 문서화
+   - 변경 영향 범위 파악: `grep -r "import.*{패키지}" --include="*.ts"`
+   - Breaking Change 목록 작성 (CHANGELOG, 공식 마이그레이션 가이드 확인)
+   - 영향받는 파일/컴포넌트/테이블 전수 조사
+
+2. **계획 (Plan)**
+   - 마이그레이션 단계를 원자적 작업으로 분해
+   - 각 단계별 성공 기준(Done Criteria) 정의
+   - 롤백 트리거 조건 명시 (에러율 > N%, 레이턴시 > Nms)
+   - 다운타임 허용 여부 결정 → Zero-downtime 전략 수립
+
+3. **백업 (Backup)**
+   ```bash
+   # DB 백업
+   pg_dump -h localhost -U user dbname > backup_$(date +%Y%m%d_%H%M%S).sql
+   mysqldump -u user -p dbname > backup_$(date +%Y%m%d_%H%M%S).sql
+
+   # 코드 상태 태깅
+   git tag pre-migration-$(date +%Y%m%d) -m "Migration 전 백업 포인트"
+   git push origin --tags
+   ```
+
+4. **실행 (Execute)**
+   - **DB 마이그레이션**: 스키마 변경 → 데이터 변환 → 인덱스 재구성
+     ```sql
+     -- Expand-Contract 패턴 (Zero-downtime)
+     -- Phase 1: 새 컬럼 추가 (nullable)
+     ALTER TABLE users ADD COLUMN new_field VARCHAR(255);
+     -- Phase 2: 데이터 채우기 (백그라운드)
+     UPDATE users SET new_field = legacy_field WHERE new_field IS NULL;
+     -- Phase 3: 애플리케이션 배포 후 기존 컬럼 제거
+     ALTER TABLE users DROP COLUMN legacy_field;
+     ```
+   - **API 업그레이드**: 하위호환성 레이어 → 새 버전 배포 → 구버전 deprecation
+   - **프레임워크 업그레이드**:
+     ```bash
+     npx npm-check-updates -u     # 의존성 일괄 업데이트 확인
+     npx <framework> codemods     # 공식 코드모드 실행
+     ```
+
+5. **검증 (Verify)**
+   - 마이그레이션 전후 데이터 무결성 검증
+   - E2E 테스트 전체 실행
+   - 성능 회귀 벤치마크 (p95 레이턴시 비교)
+   - 롤백 절차 실제 테스트 (스테이징 환경)
+
+### 롤백 전략
+```bash
+# DB 롤백
+psql -h localhost -U user dbname < backup_20240101_120000.sql
+
+# 코드 롤백
+git checkout pre-migration-20240101
+git push --force-with-lease origin main  # 팀 동의 후만
+
+# 컨테이너/배포 롤백
+kubectl rollout undo deployment/app-name
+```
+</Steps>
+
+<Policy>
+- 프로덕션 마이그레이션 전 스테이징에서 반드시 전체 절차 검증
+- 대용량 테이블 마이그레이션은 배치 처리로 분할 (한 번에 MAX 10,000행)
+- Breaking Change는 최소 한 버전 deprecation 기간 제공
+- 마이그레이션 스크립트는 멱등성(idempotent) 보장
+</Policy>
+
+<Arguments>
+## 사용법
+`/forgen:migrate {마이그레이션 대상}`
+
+### 예시
+- `/forgen:migrate PostgreSQL users 테이블 스키마 변경 (email 컬럼 unique 추가)`
+- `/forgen:migrate React 17 → 19 업그레이드`
+- `/forgen:migrate REST API v1 → v2 마이그레이션 계획`
+
+### 인자
+- 마이그레이션 대상 (DB/API/프레임워크)
+- 현재 버전과 목표 버전
+- 다운타임 허용 여부 등 제약 조건
+</Arguments>
+
+$ARGUMENTS

package/commands/performance.md

@@ -0,0 +1,288 @@
+---
+name: performance
+description: This skill should be used when the user asks to "performance,성능,profiling,최적화,프로파일링,bottleneck". Performance profiling, bottleneck identification, and optimization
+triggers:
+  - "performance"
+  - "성능"
+  - "profiling"
+  - "최적화"
+  - "프로파일링"
+  - "bottleneck"
+---
+<!-- forgen-managed -->
+
+<Purpose>
+애플리케이션의 성능을 체계적으로 프로파일링하고 최적화합니다.
+측정 기반 접근법으로 병목 지점을 식별하고, 최적화를 적용한 후
+개선 효과를 정량적으로 검증합니다.
+</Purpose>
+
+<Steps>
+1. **베이스라인 측정**: 현재 성능 지표를 수집합니다
+   - 응답 시간 측정 (P50, P95, P99)
+   - 처리량(throughput) 측정 (RPS, TPS)
+   - 메모리 사용량 프로파일링 (힙 크기, GC 빈도)
+   - CPU 사용률 측정 (사용자/시스템 시간)
+   - I/O 대기 시간 (디스크, 네트워크)
+   - 번들 크기 측정 (프론트엔드)
+   - Core Web Vitals 수집 (LCP, FID, CLS)
+   - 측정 환경 기록 (하드웨어, OS, 런타임 버전)
+
+2. **병목 지점 식별**: 성능 저하의 근본 원인을 찾습니다
+   - CPU 프로파일링 (핫 함수 식별)
+   - 메모리 프로파일링 (힙 스냅샷, 리크 탐지)
+   - 네트워크 분석 (요청 waterfall, 느린 API 호출)
+   - 데이터베이스 쿼리 분석 (EXPLAIN, 슬로우 쿼리 로그)
+   - N+1 쿼리 패턴 탐지
+   - 불필요한 리렌더링 탐지 (React Profiler)
+   - 이벤트 루프 블로킹 탐지 (Node.js)
+   - 동기/비동기 혼용 문제 확인
+
+3. **최적화 적용**: 식별된 병목을 해결합니다
+   - 알고리즘 최적화 (시간/공간 복잡도 개선)
+   - 캐싱 전략 적용 (인메모리, Redis, CDN)
+   - 쿼리 최적화 (인덱스 추가, 쿼리 리팩토링)
+   - 지연 로딩(lazy loading) 적용
+   - 코드 스플리팅 (동적 import)
+   - 이미지/에셋 최적화 (압축, WebP, CDN)
+   - 커넥션 풀링 최적화
+   - 비동기/병렬 처리 도입
+   - 메모이제이션 적용 (useMemo, React.memo)
+   - 불필요한 직렬화/역직렬화 제거
+
+4. **검증**: 최적화 효과를 정량적으로 측정합니다
+   - 동일 조건에서 베이스라인 대비 비교
+   - 개선율 계산 (% 단위)
+   - 회귀 테스트 -- 기능 동작이 변경되지 않았는지 확인
+   - 부하 테스트 (k6, Artillery, autocannon)
+   - 메모리 리크 없음 확인 (장시간 실행)
+   - 엣지 케이스 성능 확인 (빈 데이터, 대용량 데이터)
+
+5. **문서화**: 최적화 결과와 가이드를 기록합니다
+   - 이전/이후 성능 비교표
+   - 적용한 최적화 기법과 근거
+   - 향후 성능 모니터링 포인트
+   - 성능 예산(performance budget) 설정
+   - 회귀 방지를 위한 성능 테스트 추가
+</Steps>
+
+## 에이전트 위임
+
+`performance-reviewer` 에이전트(Opus 모델)에 위임하여 성능 분석을 수행합니다:
+
+```
+Agent(
+  subagent_type="performance-reviewer",
+  model="opus",
+  prompt="PERFORMANCE ANALYSIS TASK
+
+성능 프로파일링 및 최적화를 수행하세요.
+
+Target: [분석 대상 코드/서비스]
+Concern: [구체적인 성능 문제 또는 전반적 분석]
+
+Analysis Checklist:
+1. 베이스라인 측정 (응답 시간, 메모리, CPU)
+2. 병목 지점 식별 (프로파일링)
+3. 최적화 방안 제시 (우선순위별)
+4. 최적화 적용 및 효과 검증
+5. 성능 예산 및 모니터링 계획
+
+Output: 성능 분석 리포트:
+- 베이스라인 지표
+- 병목 지점 목록 (영향도 순)
+- 최적화 방안 및 예상 개선율
+- 적용 결과 (이전/이후 비교)
+- 권장 성능 예산"
+)
+```
+
+## External Consultation (Optional)
+
+performance-reviewer 에이전트는 교차 검증을 위해 Claude Task 에이전트에 자문할 수 있습니다.
+
+### Protocol
+1. **자체 성능 분석을 먼저 완료** -- 독립적으로 프로파일링 수행
+2. **검증을 위한 자문** -- Claude Task 에이전트를 통해 최적화 전략 교차 확인
+3. **비판적 평가** -- 외부 제안을 맹목적으로 수용하지 않음
+4. **우아한 폴백** -- 위임이 불가능할 경우 절대 차단하지 않음
+
+### 자문이 필요한 경우
+- 복잡한 알고리즘 최적화 (시간/공간 트레이드오프)
+- 데이터베이스 쿼리 튜닝 (복잡한 JOIN, 서브쿼리)
+- 분산 시스템의 성능 문제
+- 메모리 리크 진단
+
+### 자문을 생략하는 경우
+- 단순 캐싱 적용
+- 명확한 N+1 쿼리 해결
+- 번들 크기 최적화
+- 이미지/에셋 최적화
+
+## 성능 분석 체크리스트
+
+### 서버 사이드 (5개)
+- [ ] 슬로우 쿼리가 식별되고 최적화됨
+- [ ] N+1 쿼리 패턴이 제거됨
+- [ ] 적절한 캐싱이 적용됨
+- [ ] 커넥션 풀 크기가 적절히 설정됨
+- [ ] 비동기 처리가 활용됨 (I/O 바운드 작업)
+
+### 클라이언트 사이드 (5개)
+- [ ] Core Web Vitals가 "Good" 등급
+- [ ] 번들 크기가 예산 이내
+- [ ] 코드 스플리팅이 적용됨
+- [ ] 불필요한 리렌더링이 제거됨
+- [ ] 이미지가 최적화됨 (WebP, lazy load)
+
+### 인프라 (4개)
+- [ ] CDN이 적절히 활용됨
+- [ ] 캐시 히트율이 측정됨
+- [ ] 오토스케일링 임계값이 설정됨
+- [ ] 리소스 사용량이 모니터링됨
+
+### 검증 (4개)
+- [ ] 베이스라인 대비 개선율이 측정됨
+- [ ] 부하 테스트로 한계 확인됨
+- [ ] 메모리 리크가 없음이 확인됨
+- [ ] 기능 회귀가 없음이 확인됨
+
+## 성능 등급 기준
+
+| 등급 | 응답 시간 (P95) | 메모리 | 번들 크기 |
+|------|-----------------|--------|-----------|
+| **EXCELLENT** | < 100ms | 안정적, 리크 없음 | < 200KB (gzip) |
+| **GOOD** | < 300ms | 안정적 | < 500KB (gzip) |
+| **FAIR** | < 1000ms | 점진적 증가 | < 1MB (gzip) |
+| **POOR** | > 1000ms | 리크 의심 | > 1MB (gzip) |
+
+## 최적화 우선순위 가이드
+
+| 우선순위 | 대상 | 예상 효과 |
+|----------|------|-----------|
+| 1 | 슬로우 쿼리/N+1 제거 | 10x~100x |
+| 2 | 캐싱 도입 | 5x~50x |
+| 3 | 알고리즘 최적화 | 2x~10x |
+| 4 | 번들/에셋 최적화 | 20~50% 감소 |
+| 5 | 불필요한 리렌더링 제거 | 체감 개선 |
+
+<Output>
+```
+PERFORMANCE REPORT / 성능 분석 리포트
+======================================
+
+Target: [분석 대상]
+Environment: [Node.js 20 / Chrome 120 / etc.]
+Date: YYYY-MM-DDTHH:MM:SSZ
+
+BASELINE / 베이스라인
+----------------------
+| Metric           | Value    | Grade     |
+|------------------|----------|-----------|
+| Response (P50)   | 120ms    | GOOD      |
+| Response (P95)   | 850ms    | FAIR      |
+| Response (P99)   | 2100ms   | POOR      |
+| Memory (avg)     | 256MB    | GOOD      |
+| CPU (avg)        | 45%      | GOOD      |
+| Bundle (gzip)    | 380KB    | GOOD      |
+
+BOTTLENECKS / 병목 지점
+-------------------------
+1. [CRITICAL] src/api/orders.ts:45 - N+1 쿼리
+   Impact: P95 응답 시간의 60%를 차지
+   Evidence: 주문 1건당 상품 쿼리 N회 발생
+   Fix: JOIN 또는 DataLoader 패턴 적용
+
+2. [HIGH] src/utils/transform.ts:120 - O(n^2) 알고리즘
+   Impact: 데이터 1000건 이상에서 급격한 성능 저하
+   Evidence: CPU 프로파일링에서 핫스팟
+   Fix: Map 기반 O(n) 알고리즘으로 변경
+
+3. [MEDIUM] src/components/List.tsx - 불필요한 리렌더링
+   Impact: 스크롤 시 프레임 드롭
+   Evidence: React Profiler에서 불필요한 렌더 감지
+   Fix: React.memo + useMemo 적용
+
+OPTIMIZATIONS APPLIED / 적용된 최적화
+---------------------------------------
+1. N+1 쿼리 제거: JOIN 적용
+   Before: 850ms (P95)  →  After: 120ms (P95)
+   Improvement: 86% 감소
+
+2. 알고리즘 최적화: O(n^2) → O(n)
+   Before: 450ms (1000건)  →  After: 12ms (1000건)
+   Improvement: 97% 감소
+
+AFTER / 최적화 후
+-------------------
+| Metric           | Before   | After    | Change   |
+|------------------|----------|----------|----------|
+| Response (P95)   | 850ms    | 150ms    | -82%     |
+| Memory (avg)     | 256MB    | 230MB    | -10%     |
+| Bundle (gzip)    | 380KB    | 310KB    | -18%     |
+
+PERFORMANCE BUDGET / 성능 예산
+-------------------------------
+- API Response (P95): < 200ms
+- Bundle Size (gzip): < 400KB
+- LCP: < 2.5s
+- FID: < 100ms
+- CLS: < 0.1
+
+GRADE: [EXCELLENT / GOOD / FAIR / POOR]
+```
+</Output>
+
+<Policy>
+- 추측 기반 최적화 금지 -- 반드시 측정 결과에 근거
+- 최적화 전후 비교를 정량적으로 제시합니다
+- 가독성/유지보수성을 해치는 미시 최적화는 지양합니다
+- 성능 예산을 설정하여 회귀를 방지합니다
+- 프로덕션 환경과 유사한 조건에서 측정합니다
+- 최적화의 부작용(메모리 증가, 복잡도 증가)을 명시합니다
+</Policy>
+
+## 다른 스킬과의 연동
+
+**데이터베이스 연동:**
+```
+/forgen:database 슬로우 쿼리 인덱싱
+```
+쿼리 성능 문제를 인덱스로 해결
+
+**코드 리뷰 연동:**
+```
+/forgen:code-review 성능 최적화 코드
+```
+최적화 코드의 정확성 검증
+
+**TDD 연동:**
+```
+/forgen:tdd 성능 회귀 테스트
+```
+성능 기준을 테스트로 보장
+
+## Best Practices
+
+- **측정 우선** -- "느린 것 같다"는 최적화 근거가 아님
+- **큰 것부터** -- 10% 개선보다 10x 개선을 먼저 찾기
+- **회귀 방지** -- 성능 테스트를 CI에 포함
+- **예산 설정** -- 성능 예산을 팀과 합의
+- **지속 모니터링** -- 프로덕션 성능을 실시간 추적
+
+<Arguments>
+## 사용법
+`/forgen:performance {분석 대상}`
+
+### 예시
+- `/forgen:performance API 응답 시간 최적화`
+- `/forgen:performance 프론트엔드 번들 크기 분석`
+- `/forgen:performance src/services/order.ts 쿼리 성능`
+- `/forgen:performance 메모리 리크 진단`
+
+### 인자
+- 분석할 대상, 성능 문제, 최적화 목표를 설명
+- 인자 없으면 프로젝트 전반의 성능을 프로파일링
+</Arguments>
+
+$ARGUMENTS

package/commands/refactor.md

@@ -0,0 +1,105 @@
+---
+name: refactor
+description: This skill should be used when the user asks to "refactor,리팩토링,리팩터,코드정리". Safe refactoring with test-first approach and SOLID principles
+triggers:
+  - "refactor"
+  - "리팩토링"
+  - "리팩터"
+  - "코드정리"
+---
+
+<Purpose>
+테스트 확보→변경→검증의 3단계를 통해 기능을 유지하면서 코드 구조를 개선합니다.
+코드 스멜 식별, SOLID 원칙 적용, 리팩토링 카탈로그를 활용해 체계적으로 진행합니다.
+</Purpose>
+
+<Steps>
+1. **테스트 확보 (Test First)**
+   - 리팩토링 전 기존 동작을 테스트로 고정
+   - 테스트 없는 코드: 특성화 테스트(Characterization Test) 먼저 작성
+     ```typescript
+     // 현재 동작을 그대로 문서화하는 테스트
+     it('현재 동작 특성화', () => {
+       expect(legacyFunction(input)).toMatchSnapshot();
+     });
+     ```
+   - 커버리지 확인: 변경할 코드 경로가 모두 테스트에 포함됐는지 검증
+
+2. **코드 스멜 식별**
+   - **긴 함수**: 50줄 초과 → 추출(Extract) 대상
+   - **중복 코드**: DRY 원칙 위반 → 공통 추출
+   - **복잡한 조건**: 중첩 if/else 3단계 초과 → Early Return 또는 전략 패턴
+   - **긴 매개변수 목록**: 4개 초과 → 객체로 묶기
+   - **거대한 클래스**: 단일 책임 원칙 위반 → 분리
+   - **주석으로 설명이 필요한 코드**: 코드 자체를 명확하게 개선
+
+3. **SOLID 원칙 적용**
+   - **S** (단일 책임): 클래스/함수는 하나의 이유로만 변경
+   - **O** (개방-폐쇄): 확장에 열려 있고 수정에 닫혀 있도록 설계
+   - **L** (리스코프 치환): 하위 타입은 상위 타입을 완전히 대체 가능
+   - **I** (인터페이스 분리): 사용하지 않는 메서드를 강요하지 않음
+   - **D** (의존성 역전): 구체 클래스가 아닌 추상화에 의존
+
+4. **리팩토링 카탈로그 (Fowler)**
+   - **Extract Method**: 코드 블록을 독립적인 함수로 추출
+     ```typescript
+     // Before
+     function processOrder(order) {
+       // 가격 계산 (20줄)
+       let total = 0;
+       for (const item of order.items) { total += item.price * item.qty; }
+       // ...
+     }
+     // After
+     function processOrder(order) {
+       const total = calculateTotal(order.items);
+       // ...
+     }
+     function calculateTotal(items) { /* ... */ }
+     ```
+   - **Move Method**: 다른 클래스에서 더 많이 사용하는 메서드 이동
+   - **Replace Conditional with Polymorphism**: switch/if-else 체인 → 다형성
+     ```typescript
+     // Before: if (type === 'A') ... else if (type === 'B') ...
+     // After: strategy[type].execute()
+     ```
+   - **Introduce Parameter Object**: 매개변수 그룹 → 객체
+   - **Replace Magic Number with Constant**: 리터럴 → 명명된 상수
+   - **Inline Variable**: 불필요한 중간 변수 제거
+
+5. **변경 (Refactor)**
+   - 한 번에 하나의 리팩토링만 적용
+   - 각 단계 후 테스트 실행 (`npm test` / `vitest run`)
+   - 작은 커밋으로 이력 추적: `refactor: Extract calculateTotal from processOrder`
+   - 동작 변경과 구조 변경을 같은 커밋에 섞지 않음
+
+6. **검증 (Verify)**
+   - 전체 테스트 스위트 통과 확인
+   - 타입 검사: `tsc --noEmit`
+   - 린트: `eslint src/`
+   - 성능 회귀 없음 확인 (주요 경로 벤치마크)
+</Steps>
+
+<Policy>
+- 리팩토링과 기능 추가를 동시에 하지 않는다
+- 테스트 없이 리팩토링 시작 금지
+- 각 단계 후 테스트 통과 확인 필수
+- 한 세션에서 수정하는 파일은 최대 5개로 제한
+</Policy>
+
+<Arguments>
+## 사용법
+`/forgen:refactor {리팩토링 대상}`
+
+### 예시
+- `/forgen:refactor src/services/PaymentService.ts — 200줄 함수 분리`
+- `/forgen:refactor 주문 처리 로직의 중복 코드 제거`
+- `/forgen:refactor UserController를 SOLID 원칙에 맞게 재설계`
+
+### 인자
+- 리팩토링할 파일/함수/모듈 명시
+- 목표 (성능, 가독성, 유지보수성, 특정 패턴 적용)
+- 제약 조건 (하위 호환성 유지, 특정 인터페이스 유지 등)
+</Arguments>
+
+$ARGUMENTS