@wooojin/forgen 0.1.0

package/skills/documentation/SKILL.md

@@ -0,0 +1,270 @@
+---
+name: documentation
+description: This skill should be used when the user asks to "documentation,문서화,docs,기술 문서,readme,API docs". Technical documentation writing with audience analysis and structured content
+---
+
+<!-- forgen-managed -->
+
+<Purpose>
+기술 문서를 체계적으로 작성합니다.
+대상 독자 분석, 정보 구조 설계, 초안 작성, 리뷰, 배포까지
+기술 문서의 전체 라이프사이클을 다룹니다.
+</Purpose>
+
+<Steps>
+1. **대상 독자 분석**: 문서를 읽을 사람을 파악합니다
+   - 독자의 기술 수준 (초급/중급/고급)
+   - 독자의 역할 (개발자, DevOps, PM, 최종 사용자)
+   - 독자가 달성하려는 목표 (설치, 통합, 트러블슈팅)
+   - 사전 지식 가정 (프로그래밍 언어, 프레임워크, 도메인)
+   - 문서 접근 맥락 (처음 사용 vs 참조 vs 문제 해결)
+
+2. **정보 구조 설계**: 문서의 뼈대를 구성합니다
+   - 문서 유형 결정:
+     * Tutorial (학습 지향) -- "이렇게 해보세요"
+     * How-to Guide (목표 지향) -- "이렇게 하면 됩니다"
+     * Reference (정보 지향) -- "이것은 이렇습니다"
+     * Explanation (이해 지향) -- "이것이 왜 이렇게 동작합니다"
+   - 목차(TOC) 초안 작성
+   - 섹션별 깊이와 범위 결정
+   - 네비게이션 구조 (선형 vs 비선형)
+   - 연관 문서 링크 맵
+
+3. **초안 작성**: 내용을 채워넣습니다
+   - 명확한 제목과 부제 (스캔 가능)
+   - 각 섹션 첫 문장에 핵심 내용 (역피라미드 구조)
+   - 코드 예시 (복사-붙여넣기 가능, 실행 가능)
+   - 단계별 절차 (번호 매기기, 검증 단계 포함)
+   - 시각적 보조 자료 (다이어그램, 스크린샷, 표)
+   - 주의 사항 표시 (Note, Warning, Caution, Tip)
+   - 용어 일관성 유지 (용어집 참조)
+   - 다국어 고려 (영어 + 한국어 병행 여부)
+
+4. **리뷰 및 검증**: 문서 품질을 확인합니다
+   - 기술적 정확성 -- 코드 예시 실행 확인
+   - 완전성 -- 누락된 단계나 정보 확인
+   - 명확성 -- 모호한 표현, 전문 용어 과다 사용 점검
+   - 일관성 -- 용어, 포맷, 스타일 통일
+   - 접근성 -- 스크린 리더 호환, 대체 텍스트
+   - 검색 가능성 -- 핵심 키워드가 적절히 포함
+
+5. **배포 및 유지보수**: 문서를 공개하고 관리합니다
+   - 배포 채널 결정 (GitHub Pages, Docusaurus, Notion)
+   - 버전 관리 (문서 버전 = 소프트웨어 버전)
+   - 피드백 수집 체계 (이슈, 코멘트, 분석)
+   - 정기 리뷰 일정 설정
+   - 폐기(deprecation) 절차
+</Steps>
+
+## 에이전트 위임
+
+`writer` 에이전트(Haiku 모델)에 위임하여 문서를 작성합니다:
+
+```
+Agent(
+  subagent_type="writer",
+  model="haiku",
+  prompt="DOCUMENTATION TASK
+
+기술 문서를 작성하세요.
+
+Subject: [문서화 대상]
+Audience: [대상 독자]
+Type: [Tutorial / How-to / Reference / Explanation]
+
+Writing Checklist:
+1. 대상 독자 수준에 맞는 어조 사용
+2. 실행 가능한 코드 예시 포함
+3. 단계별 절차에 검증 단계 포함
+4. 시각적 보조 자료 활용 (표, 다이어그램)
+5. 용어 일관성 유지
+
+Output: 완성된 기술 문서:
+- 목차
+- 섹션별 내용
+- 코드 예시
+- 주의 사항
+- 관련 문서 링크"
+)
+```
+
+## External Consultation (Optional)
+
+writer 에이전트는 교차 검증을 위해 Claude Task 에이전트에 자문할 수 있습니다.
+
+### Protocol
+1. **자체 문서 초안을 먼저 완료** -- 독립적으로 작성
+2. **검증을 위한 자문** -- Claude Task 에이전트를 통해 기술 정확성 교차 확인
+3. **비판적 평가** -- 외부 제안을 맹목적으로 수용하지 않음
+4. **우아한 폴백** -- 위임이 불가능할 경우 절대 차단하지 않음
+
+### 자문이 필요한 경우
+- 공개 API 문서 (외부 개발자 대상)
+- 아키텍처 설명 문서
+- 복잡한 통합 가이드
+- 다국어 문서
+
+### 자문을 생략하는 경우
+- 내부 README 업데이트
+- 간단한 설치 가이드
+- 인라인 코드 문서 (JSDoc, TSDoc)
+- 변경 이력 (CHANGELOG)
+
+## 문서 유형 가이드
+
+| 유형 | 목적 | 구조 | 예시 |
+|------|------|------|------|
+| **Tutorial** | 학습 | 단계별 진행 | "첫 번째 앱 만들기" |
+| **How-to** | 문제 해결 | 목표 → 단계 → 결과 | "인증 추가하기" |
+| **Reference** | 정보 조회 | 알파벳/카테고리 정렬 | "API 레퍼런스" |
+| **Explanation** | 이해 | 배경 → 원인 → 결과 | "인증 구조 이해하기" |
+
+## 문서 품질 체크리스트
+
+### 내용 (5개)
+- [ ] 기술적으로 정확함 (코드 예시 실행 확인)
+- [ ] 대상 독자 수준에 적합
+- [ ] 모든 필수 단계가 포함됨
+- [ ] 사전 조건(prerequisites)이 명시됨
+- [ ] 코드 예시가 복사-실행 가능
+
+### 구조 (4개)
+- [ ] 목차가 논리적으로 구성됨
+- [ ] 제목이 내용을 정확히 설명
+- [ ] 스캔이 가능한 형식 (짧은 단락, 목록, 표)
+- [ ] 관련 문서에 대한 링크 포함
+
+### 스타일 (4개)
+- [ ] 일관된 용어 사용
+- [ ] 능동태 사용 (수동태 최소화)
+- [ ] 불필요한 전문 용어 없음 (있으면 설명 포함)
+- [ ] Note/Warning/Tip이 적절히 사용됨
+
+### 접근성 (3개)
+- [ ] 이미지에 대체 텍스트 제공
+- [ ] 코드 블록에 언어 태그 명시
+- [ ] 색상으로만 정보를 전달하지 않음
+
+## 작성 원칙
+
+| 원칙 | 나쁜 예 | 좋은 예 |
+|------|---------|---------|
+| **구체적** | "설정을 변경합니다" | "`config.json`의 `port` 값을 `3000`으로 변경합니다" |
+| **능동태** | "파일이 생성됩니다" | "이 명령이 파일을 생성합니다" |
+| **검증 포함** | "실행합니다" | "실행합니다. `Started on port 3000` 메시지가 보이면 성공입니다" |
+| **이유 설명** | "캐시를 비웁니다" | "이전 빌드 아티팩트가 간섭할 수 있으므로 캐시를 비웁니다" |
+
+<Output>
+```
+DOCUMENTATION PLAN / 문서화 계획
+==================================
+
+Subject: [문서화 대상]
+Type: [Tutorial / How-to / Reference / Explanation]
+Audience: [대상 독자] ([기술 수준])
+
+TABLE OF CONTENTS / 목차
+--------------------------
+1. 개요
+   - 이 문서의 목적
+   - 사전 조건
+2. [핵심 섹션 1]
+   - [하위 항목]
+3. [핵심 섹션 2]
+4. 트러블슈팅
+5. 다음 단계
+6. 관련 문서
+
+CONTENT / 내용
+---------------
+## 1. 개요
+
+[간결한 설명 -- 이 문서를 읽으면 무엇을 할 수 있는지]
+
+### 사전 조건
+- [필요한 도구/지식 1]
+- [필요한 도구/지식 2]
+
+## 2. [핵심 섹션]
+
+### 단계 1: [동작]
+
+[왜 이 단계가 필요한지 한 줄 설명]
+
+```bash
+npm install @example/sdk
+```
+
+> **Tip:** [유용한 추가 정보]
+
+### 검증
+[성공 시 보이는 결과 설명]
+
+## 트러블슈팅
+
+| 문제 | 원인 | 해결 |
+|------|------|------|
+| [에러 메시지] | [원인] | [해결 방법] |
+
+REVIEW STATUS / 리뷰 상태
+----------------------------
+- [ ] 기술 정확성 검증
+- [ ] 코드 예시 실행 확인
+- [ ] 용어 일관성 확인
+- [ ] 접근성 검토
+```
+</Output>
+
+<Policy>
+- 코드 예시는 반드시 실행 가능해야 합니다 (복사-붙여넣기로 동작)
+- 모든 단계에 검증 방법을 포함합니다 ("이렇게 보이면 성공")
+- 독자를 가정하지 않습니다 -- 사전 조건을 명시합니다
+- 용어는 프로젝트 전체에서 일관되게 사용합니다
+- 문서는 소프트웨어와 함께 버전 관리합니다
+- 최소 1명의 기술 리뷰어를 거친 후 배포합니다
+</Policy>
+
+## 다른 스킬과의 연동
+
+**API 설계 연동:**
+```
+/forgen:api-design OpenAPI 스키마 기반 문서
+```
+API 설계 결과를 문서화
+
+**아키텍처 결정 연동:**
+```
+/forgen:architecture-decision ADR 문서화
+```
+아키텍처 결정 기록 문서화
+
+**코드 리뷰 연동:**
+```
+/forgen:code-review 문서 코드 예시
+```
+문서 내 코드 예시의 정확성 검증
+
+## Best Practices
+
+- **독자 중심** -- 자신이 아닌 독자의 관점에서 작성
+- **실행 가능** -- 모든 코드 예시는 실제로 동작해야 함
+- **스캔 가능** -- 긴 텍스트보다 목록, 표, 코드 블록 활용
+- **최신 유지** -- 코드 변경 시 문서도 함께 업데이트
+- **피드백 수용** -- 독자 피드백을 적극적으로 반영
+
+<Arguments>
+## 사용법
+`/forgen:documentation {문서화 대상}`
+
+### 예시
+- `/forgen:documentation 프로젝트 README 작성`
+- `/forgen:documentation API 레퍼런스 문서`
+- `/forgen:documentation 설치 가이드 (초보자용)`
+- `/forgen:documentation 아키텍처 설명 문서`
+
+### 인자
+- 문서화할 대상, 독자, 문서 유형 등을 설명
+- 인자 없으면 프로젝트를 분석하여 필요한 문서를 제안
+</Arguments>
+
+$ARGUMENTS

package/skills/ecomode/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: ecomode
+description: This skill should be used when the user asks to "eco,ecomode,절약,비용절약". Token-saving eco mode with Haiku priority and minimal responses
+---
+
+<Purpose>
+Compound Harness Ecomode — 토큰 절약 모드.
+비용을 최소화하면서 작업을 수행합니다. Haiku 모델을 우선 사용하고, 간결한 응답을 지향합니다.
+</Purpose>
+
+<Execution_Policy>
+1. 모든 탐색은 최소한으로 (Glob/Grep 우선, Agent 최소화)
+2. 응답은 간결하게 (불필요한 설명 생략)
+3. 코드 블록 위주로 답변, 부연 설명 최소화
+4. 한 번에 정확히 수정 (반복 수정 회피)
+5. 에이전트 스폰 시 전부 Haiku 모델 사용
+</Execution_Policy>
+
+<Model_Routing>
+- 모든 작업: Haiku (강제)
+- 에이전트 스폰: Haiku (강제)
+- 복잡한 아키텍처 판단이 필요한 경우에만 Sonnet 허용
+</Model_Routing>
+
+<Constraints>
+- Agent 도구 사용 최소화 (직접 Glob/Grep/Read로 해결)
+- 불필요한 파일 탐색 금지 (목적이 명확한 탐색만)
+- 코드 설명은 요청 시에만 제공
+- 반복 수정 시 즉시 중단하고 전체 구조 파악 후 단일 수정
+- 에이전트 스폰 시 model: "haiku" 파라미터 필수
+</Constraints>
+
+<Arguments>
+## 사용법
+`/forgen:ecomode {작업 내용}`
+
+### 예시
+- `/forgen:ecomode 버그 수정: login API 500 에러`
+- `/forgen:ecomode 타입 정의 추가: UserProfile 인터페이스`
+- `eco 이 함수 리팩토링해줘`
+
+### 인자
+- 간단한 작업 설명을 전달하면 최소 비용으로 처리
+</Arguments>
+
+$ARGUMENTS

package/skills/frontend/SKILL.md

@@ -0,0 +1,265 @@
+---
+name: frontend
+description: This skill should be used when the user asks to "frontend,프론트엔드,component,접근성,accessibility,컴포넌트 설계". Frontend component design, accessibility audit, and responsive implementation
+---
+
+<!-- forgen-managed -->
+
+<Purpose>
+프론트엔드 컴포넌트를 체계적으로 설계하고 구현합니다.
+컴포넌트 계층 구조 설계, Props 인터페이스 정의, 접근성 감사,
+반응형 레이아웃, 성능 최적화를 포함한 프론트엔드 개발 전체를 다룹니다.
+</Purpose>
+
+<Steps>
+1. **컴포넌트 계층 구조 설계**: 컴포넌트 트리를 설계합니다
+   - 페이지/기능 요구사항 분석
+   - Atomic Design 원칙 적용 (Atoms → Molecules → Organisms → Templates → Pages)
+   - 컴포넌트 책임 분리 (UI vs 로직)
+   - 공유 컴포넌트 vs 도메인 컴포넌트 구분
+   - 컴포넌트 트리 다이어그램 작성
+   - 상태 관리 위치 결정 (로컬 vs 전역 vs 서버)
+   - 데이터 흐름 방향 정의 (단방향 데이터 흐름)
+
+2. **Props 인터페이스 설계**: 컴포넌트 API를 정의합니다
+   - TypeScript 인터페이스 정의
+   - 필수/선택 Props 구분
+   - 기본값 설정 (defaultProps 또는 default parameter)
+   - 콜백 Props 네이밍 컨벤션 (onXxx, handleXxx)
+   - children 패턴 활용 (합성 패턴)
+   - Render Props 또는 Compound Component 패턴 고려
+   - Props 과도 확산(prop drilling) 방지 전략
+   - Discriminated Union 타입으로 변형(variant) 관리
+
+3. **접근성 감사**: WCAG 2.1 AA 기준으로 접근성을 검증합니다
+   - 시맨틱 HTML 사용 (button, nav, main, section, article)
+   - ARIA 속성 적절 사용 (aria-label, aria-describedby, role)
+   - 키보드 내비게이션 (Tab, Enter, Escape, Arrow keys)
+   - 포커스 관리 (포커스 트랩, 포커스 복원)
+   - 색상 대비 (최소 4.5:1 for text, 3:1 for large text)
+   - 스크린 리더 호환성 (라이브 리전, 상태 알림)
+   - 모션 감소 대응 (prefers-reduced-motion)
+   - 터치 타겟 크기 (최소 44x44px)
+   - 대체 텍스트 (이미지 alt, 아이콘 aria-label)
+   - 폼 접근성 (label 연결, 에러 메시지 연결)
+
+4. **반응형 구현**: 다양한 화면 크기를 지원합니다
+   - 브레이크포인트 정의 (mobile: 320px, tablet: 768px, desktop: 1024px+)
+   - Mobile-first 접근법 적용
+   - 유동적 레이아웃 (Flexbox, Grid)
+   - 반응형 타이포그래피 (clamp, fluid type)
+   - 이미지 반응형 처리 (srcset, picture, next/image)
+   - 터치/마우스 인터랙션 차이 대응
+   - 가로/세로 모드 대응
+
+5. **성능 최적화**: 렌더링 성능을 최적화합니다
+   - React.memo로 불필요한 리렌더링 방지
+   - useMemo/useCallback 적절 사용 (남용 방지)
+   - 코드 스플리팅 (React.lazy + Suspense)
+   - 가상 스크롤 (대량 리스트, react-window)
+   - 이미지 지연 로딩 (loading="lazy", Intersection Observer)
+   - Web Vitals 모니터링 (LCP, FID, CLS)
+   - 번들 분석 (webpack-bundle-analyzer)
+</Steps>
+
+## 에이전트 위임
+
+`designer` 에이전트(Sonnet 모델)에 위임하여 컴포넌트를 설계합니다:
+
+```
+Agent(
+  subagent_type="designer",
+  model="sonnet",
+  prompt="FRONTEND COMPONENT TASK
+
+프론트엔드 컴포넌트를 설계하고 구현하세요.
+
+Feature: [기능/페이지 설명]
+Framework: [React / Vue / Svelte / etc.]
+Styling: [Tailwind / CSS Modules / styled-components]
+
+Design Checklist:
+1. 컴포넌트 계층 구조 설계
+2. Props 인터페이스 (TypeScript)
+3. 접근성 감사 (WCAG 2.1 AA)
+4. 반응형 레이아웃 (Mobile-first)
+5. 성능 최적화 (리렌더링, 코드 스플리팅)
+
+Output: 컴포넌트 설계 문서:
+- 컴포넌트 트리
+- Props 인터페이스
+- 접근성 체크리스트 결과
+- 반응형 브레이크포인트
+- 성능 최적화 포인트"
+)
+```
+
+## External Consultation (Optional)
+
+designer 에이전트는 교차 검증을 위해 Claude Task 에이전트에 자문할 수 있습니다.
+
+### Protocol
+1. **자체 설계를 먼저 완료** -- 독립적으로 컴포넌트 설계
+2. **검증을 위한 자문** -- Claude Task 에이전트를 통해 접근성/UX 교차 확인
+3. **비판적 평가** -- 외부 제안을 맹목적으로 수용하지 않음
+4. **우아한 폴백** -- 위임이 불가능할 경우 절대 차단하지 않음
+
+### 자문이 필요한 경우
+- 복잡한 인터랙션 패턴 (드래그앤드롭, 가상 스크롤)
+- 접근성이 중요한 공개 웹사이트
+- 대규모 상태 관리 아키텍처
+- 디자인 시스템 구축
+
+### 자문을 생략하는 경우
+- 단순 폼 컴포넌트
+- 잘 알려진 UI 패턴
+- 내부 어드민 도구
+- 프로토타입 수준의 UI
+
+## 접근성 체크리스트 (WCAG 2.1 AA)
+
+### 인지 가능 (Perceivable) (5개)
+- [ ] 모든 이미지에 대체 텍스트 (alt) 제공
+- [ ] 색상 대비 4.5:1 이상 (텍스트), 3:1 이상 (대형 텍스트)
+- [ ] 색상만으로 정보를 전달하지 않음 (아이콘/텍스트 병행)
+- [ ] 텍스트 크기 200%까지 확대 가능 (레이아웃 깨짐 없이)
+- [ ] 자동 재생 미디어에 정지 버튼 제공
+
+### 조작 가능 (Operable) (5개)
+- [ ] 모든 기능이 키보드로 접근 가능
+- [ ] 포커스 순서가 논리적
+- [ ] 포커스 표시가 명확 (outline 제거 금지)
+- [ ] 터치 타겟 최소 44x44px
+- [ ] 시간 제한이 있는 기능에 연장 옵션 제공
+
+### 이해 가능 (Understandable) (4개)
+- [ ] 폼 필드에 label이 연결됨
+- [ ] 에러 메시지가 해당 필드 근처에 표시됨
+- [ ] 링크 텍스트가 목적지를 설명 ("여기를 클릭" 금지)
+- [ ] 언어 속성 (lang)이 설정됨
+
+### 견고함 (Robust) (4개)
+- [ ] 시맨틱 HTML 요소 사용 (div 남용 금지)
+- [ ] ARIA 속성이 올바르게 사용됨
+- [ ] 동적 콘텐츠에 aria-live 적용
+- [ ] 커스텀 위젯에 적절한 role 설정
+
+## 컴포넌트 복잡도 가이드
+
+| 복잡도 | Props 수 | 상태 | 패턴 |
+|--------|---------|------|------|
+| **단순** | 0~3 | Stateless | 함수 컴포넌트 |
+| **보통** | 4~8 | 로컬 상태 | useState/useReducer |
+| **복잡** | 9+ | 전역 + 로컬 | Compound Component, Context |
+
+<Output>
+```
+FRONTEND COMPONENT DESIGN / 프론트엔드 컴포넌트 설계
+=====================================================
+
+Feature: [기능명]
+Framework: [React 18 + TypeScript]
+Styling: [Tailwind CSS]
+
+COMPONENT TREE / 컴포넌트 트리
+---------------------------------
+<ProductPage>
+  ├── <ProductHeader>
+  │   ├── <Breadcrumb />
+  │   └── <ProductTitle />
+  ├── <ProductGallery>
+  │   ├── <ImageCarousel />
+  │   └── <ThumbnailStrip />
+  ├── <ProductInfo>
+  │   ├── <PriceDisplay />
+  │   ├── <VariantSelector />
+  │   └── <AddToCartButton />
+  └── <ProductReviews>
+      ├── <ReviewSummary />
+      └── <ReviewList />
+
+PROPS INTERFACES / Props 인터페이스
+--------------------------------------
+interface ProductInfoProps {
+  product: Product;
+  selectedVariant: Variant | null;
+  onVariantSelect: (variant: Variant) => void;
+  onAddToCart: (quantity: number) => void;
+  isLoading?: boolean;
+}
+
+ACCESSIBILITY AUDIT / 접근성 감사
+-----------------------------------
+Perceivable:  [5/5 PASS]
+Operable:     [4/5 - 터치 타겟 크기 수정 필요]
+Understandable: [4/4 PASS]
+Robust:       [4/4 PASS]
+
+RESPONSIVE BREAKPOINTS / 반응형 브레이크포인트
+-------------------------------------------------
+Mobile (< 768px):  단일 컬럼, 갤러리 스와이프
+Tablet (768~1024px): 2컬럼 (갤러리 + 정보)
+Desktop (> 1024px): 3컬럼 (갤러리 + 정보 + 리뷰)
+
+PERFORMANCE / 성능
+-------------------
+- ImageCarousel: React.lazy로 지연 로딩
+- ReviewList: 가상 스크롤 (react-window)
+- 이미지: next/image with srcset
+- 번들 기여: ~25KB (gzip)
+```
+</Output>
+
+<Policy>
+- 접근성은 선택이 아닌 기본입니다 -- WCAG 2.1 AA를 항상 충족
+- 컴포넌트는 단일 책임 원칙을 따릅니다
+- Props 인터페이스는 TypeScript로 명시합니다
+- Mobile-first로 설계하고 데스크톱으로 확장합니다
+- 성능 최적화는 측정 후 필요한 곳에만 적용합니다 (사전 최적화 금지)
+- 디자인 시스템/토큰이 있으면 반드시 활용합니다
+</Policy>
+
+## 다른 스킬과의 연동
+
+**성능 연동:**
+```
+/forgen:performance 프론트엔드 번들 분석
+```
+번들 크기와 렌더링 성능 최적화
+
+**TDD 연동:**
+```
+/forgen:tdd 컴포넌트 유닛 테스트
+```
+컴포넌트별 테스트 작성
+
+**코드 리뷰 연동:**
+```
+/forgen:code-review src/components/
+```
+컴포넌트 코드 품질 검증
+
+## Best Practices
+
+- **합성 우선** -- 상속보다 합성(composition) 패턴 사용
+- **접근성 내장** -- 나중에 추가하지 않고 처음부터 포함
+- **타입 안전** -- Props에 TypeScript 타입을 명시
+- **측정 후 최적화** -- React Profiler로 확인 후 최적화
+- **일관된 패턴** -- 프로젝트 전체에서 동일한 패턴 유지
+
+<Arguments>
+## 사용법
+`/forgen:frontend {설계 대상}`
+
+### 예시
+- `/forgen:frontend 상품 상세 페이지 컴포넌트 설계`
+- `/forgen:frontend 기존 폼 컴포넌트 접근성 개선`
+- `/forgen:frontend 대시보드 레이아웃 반응형 구현`
+- `/forgen:frontend 디자인 시스템 기본 컴포넌트 설계`
+
+### 인자
+- 설계할 페이지/기능, 프레임워크, 접근성 요구사항 등을 설명
+- 인자 없으면 프로젝트의 프론트엔드 구조를 분석하여 개선점 제시
+</Arguments>
+
+$ARGUMENTS

package/skills/git-master/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: git-master
+description: This skill should be used when the user asks to "git-master,깃마스터,atomic commit". Atomic commits, smart rebasing, and history management
+---
+
+<Purpose>
+원자적 커밋 전략과 체계적인 Git 히스토리 관리를 실행합니다.
+Conventional Commits 컨벤션, 인터랙티브 리베이스, 브랜치 전략을 통해
+읽기 쉽고 유지보수 가능한 커밋 히스토리를 구축합니다.
+</Purpose>
+
+<Steps>
+1. **원자적 커밋 전략**
+   - 하나의 커밋 = 하나의 논리적 변경 단위
+   - 빌드 가능하고 테스트 통과 상태로 유지
+   - `git add <specific-files>`로 변경사항을 파일 단위로 선택적 스테이징
+   > **Note:** `git add -p`(인터랙티브 패치 모드)와 `git add -i`는 Claude Code에서 지원되지 않습니다. `git add <specific-files>`를 사용하세요.
+
+2. **Conventional Commits 메시지 컨벤션**
+   ```
+   <type>(<scope>): <subject>
+
+   <body>
+
+   <footer>
+   ```
+   - **type**: feat, fix, docs, style, refactor, test, chore, perf
+   - **scope**: 변경된 모듈/컴포넌트 (선택)
+   - **subject**: 현재형 동사로 시작, 50자 이내
+   - **Breaking Change**: footer에 `BREAKING CHANGE:` 명시
+
+3. **인터랙티브 리베이스**
+   > **Note:** `git rebase -i`는 Claude Code에서 지원되지 않습니다 (인터랙티브 입력 불가). 대신 `git rebase` with explicit commit range 또는 `git commit --fixup` + `git rebase --autosquash`를 사용하세요.
+   ```bash
+   git rebase -i HEAD~N  # N개 커밋 재정리 (Claude Code 외부에서 실행)
+   ```
+   - `pick`: 그대로 유지
+   - `squash`/`fixup`: 이전 커밋과 합치기
+   - `reword`: 메시지만 수정
+   - `edit`: 커밋 내용 수정
+   - `drop`: 커밋 삭제
+   - ⚠ 공유 브랜치에서 리베이스 금지
+
+4. **브랜치 전략**
+   - `main/master`: 항상 배포 가능 상태
+   - `develop`: 통합 브랜치 (Git Flow)
+   - `feature/<ticket>-<short-desc>`: 기능 개발
+   - `fix/<ticket>-<short-desc>`: 버그 수정
+   - `hotfix/<ticket>`: 긴급 수정
+   - 브랜치명에 티켓 번호 포함 권장
+
+5. **Squash & Fixup 워크플로우**
+   ```bash
+   git commit --fixup <sha>        # 특정 커밋에 fixup 생성
+   git rebase -i --autosquash main # fixup 자동 정렬
+   ```
+
+6. **Conflict 해결 전략**
+   - `git mergetool` 또는 IDE 통합 도구 사용
+   - 복잡한 충돌: `git checkout --ours/--theirs <file>` 선택
+   - 충돌 해결 후 반드시 테스트 실행
+   - `git log --merge`: 충돌에 기여한 커밋 확인
+</Steps>
+
+<Policy>
+- 공유 브랜치(main, develop)에서 force push 금지
+- 커밋 전 `git diff --staged`로 변경사항 최종 확인
+- WIP 커밋은 push 전 squash 처리
+- 커밋 메시지에 '수정', 'fix', 'update'만 쓰지 않고 구체적 맥락 포함
+</Policy>
+
+<Arguments>
+## 사용법
+`/forgen:git-master {작업 내용}`
+
+### 예시
+- `/forgen:git-master 3개의 WIP 커밋을 원자적 커밋으로 재정리`
+- `/forgen:git-master feature 브랜치를 main에 리베이스하며 충돌 해결`
+- `/forgen:git-master 커밋 히스토리 클린업 후 PR 준비`
+
+### 인자
+- 현재 Git 상태 또는 수행할 작업을 설명
+- 브랜치명, 커밋 범위, 목표 브랜치 등 구체적 정보 포함 권장
+</Arguments>
+
+$ARGUMENTS