@axboot-mcp/mcp-server 1.0.0

package/MCP_USAGE.md

@@ -0,0 +1,914 @@
+# MCP Axboot 사용 가이드
+
+MCP Axboot는 NH-FE-B 프레임워크 기반 프로젝트에서 Zustand Store와 React Hook을 자동 생성하는 MCP 서버입니다.
+
+## 설치 및 설정
+
+### 1. MCP 서버 등록 (Claude Desktop)
+
+Claude Desktop 설정 파일에 MCP 서버를 등록합니다.
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "mcp-axboot": {
+      "command": "node",
+      "args": ["/Users/kyle/work/mcp-axboot/dist/index.js"]
+    }
+  }
+}
+```
+
+### 2. 빌드
+
+```bash
+cd /Users/kyle/work/mcp-axboot
+npm run build
+```
+
+---
+
+## 사용 가능한 도구
+
+| 도구 | 설명 |
+|------|------|
+| `generate_store_and_hook_interactive` | ⭐ 대화형 생성 (파일명 검색, 경로 제안) |
+| `analyze_interface` | 인터페이스 Repository 파일 분석 |
+| `generate_store` | Zustand Store 파일 생성 (통합 템플릿 사용) |
+| `generate_hook` | React Hook 파일 생성 |
+| `generate_store_and_hook` | Store와 Hook 동시 생성 |
+| `analyze_requirements` | 자연어 요구사항 분석 |
+| `generate_store_from_requirements` | 요구사항 기반 Store 자동 생성 |
+| `generate_multi_stores` | 다중 리스트 통합 Store 생성 |
+| `detect_multi_list_pattern` | 다중 리스트 패턴 감지 |
+| `list_layouts` | NH 레이아웃 패턴 목록 조회 |
+| `suggest_layout` | 적합한 레이아웃 패턴 추천 |
+| `generate_requirements_from_layout` | 레이아웃 기반 요구사항 생성 |
+| `generate_search_params` | SearchParams JSX 코드 생성 |
+| `generate_listdatagrid` | ListDataGrid 컴포넌트 생성 |
+
+---
+
+## Store 타입
+
+| 타입 | 이름 | 설명 | 사용 사례 |
+|------|------|------|-----------|
+| 1 | 기본 리스트 + 상세 | 선택된 항목의 상세 정보 표시, 저장/수정 지원 | 회원 목록, 상품 목록 |
+| 2 | 마스터-디테일 + 모달 + 삭제 | 왼쪽 리스트, 오른쪽 상세, 모달, 삭제 기능 | B2B 상품, 견적 상담 |
+| 3 | 트리 기반 | 트리 구조 데이터, 펼치기/접기, 저장 지원 | 카테고리 관리, 메뉴 관리 |
+| 4 | 대시보드 | 여러 개의 리스트와 요약 정보, 탭 전환 | 회원 대시보드, 주문 대시보드 |
+| 5 | 단순 리스트 | 최소한의 기능만 있는 단순 리스트 | 참조 데이터 조회 |
+| 6 | 재정렬 가능 리스트 | 드래그 앤 드롭으로 순서 변경 가능 | 팝업 메뉴, 배너 순서 |
+| 7 | 마스터-디테일 + 모달 + 삭제 + 엑셀 | 왼쪽 리스트, 오른쪽 상세, 모달, 삭제, 엑셀 다운로드 | B2B 견적 상담, 주문 관리 |
+| 8 | 리스트 + 선택 + 엑셀 다운로드 | 선택 아이템, 체크박스, 엑셀 다운로드 (상세 없음) | 주문 전체 조회, 결제 조회 |
+| 9 | 마스터-디테일 + 모달 + 상세조회 API | 왼쪽 리스트, 오른쪽 상세, 모달, 상세 조회 API 호출 | 직배송 구독, 상담 내역 |
+| 10 | 마스터-디테일 + 엑셀 다운로드 | 선택된 행 표시, 엑셀 다운로드 (상세/모달 없음) | 상품 그룹 마스터, 분류 관리 |
+
+---
+
+## 사용 예시
+
+### ⭐ 대화형 생성 (추천) - 파일명만 입력
+
+파일명만 말하면 자동으로 검색하고 경로를 제안합니다.
+
+#### 예시 1: 한글 자연어 (회원리포)
+
+```
+👤 사용자: 회원리포로 Store랑 Hook 만들어줘.
+
+🤖 Claude: [자연어 분석 중...]
+
+🔍 자연어 분석:
+   "회원리포" → Member
+
+📁 발견된 Repository:
+   1. MemberRepository.ts (Member, 5개 API)
+
+📂 생성 경로 제안:
+   Store: src/stores/useMemberListStore.ts
+   Hook:  src/hooks/useMemberService.ts
+
+이 경로들로 생성할까요?
+
+👤 사용자: 응
+
+🤖 Claude: 네, 생성을 시작합니다.
+
+✅ Store 생성 완료: src/stores/useMemberListStore.ts
+✅ Hook 생성 완료: src/hooks/useMemberService.ts
+
+타입 체크 통과!
+```
+
+#### 예시 2: 한글 자연어 (배너리포)
+
+```
+👤 사용자: 배너리포 분석해서 Store랑 Hook 생성해줘.
+
+🤖 Claude: [자연어 분석 중...]
+
+🔍 자연어 분석:
+   "배너리포" → Banner
+
+📁 발견된 Repository:
+   1. BannerRepository.ts (Banner, 4개 API)
+
+📂 생성 경로 제안:
+   Store: src/stores/useBannerListStore.ts
+   Hook:  src/hooks/useBannerService.ts
+
+이 경로들로 생성할까요?
+
+👤 사용자: 확인
+
+🤖 Claude: 네, 생성을 시작합니다.
+
+✅ Store 생성 완료: src/stores/useBannerListStore.ts
+✅ Hook 생성 완료: src/hooks/useBannerService.ts
+```
+
+#### 예시 3: 한글 자연어 (거래처리포)
+
+```
+👤 사용자: 거래처리포로 Store랑 Hook 만들어줘.
+
+🤖 Claude: [자연어 분석 중...]
+
+🔍 자연어 분석:
+   "거래처리포" → Customer 또는 Partner 또는 Client 또는 Supplier
+
+📁 발견된 Repository:
+   1. CustomerRepository.ts (Customer, 6개 API)
+   2. PartnerRepository.ts (Partner, 3개 API)
+
+어느 파일을 사용할까요?
+
+👤 사용자: 1번
+
+🤖 Claude: 1번 CustomerRepository.ts를 선택합니다.
+
+📂 생성 경로 제안:
+   Store: src/stores/useCustomerListStore.ts
+   Hook:  src/hooks/useCustomerService.ts
+
+이 경로들로 생성할까요?
+
+👤 사용자: Store는 src/stores/customer/store.ts로 바꿔줘
+
+🤖 Claude: 네, 경로를 변경해서 생성합니다.
+
+✅ Store 생성 완료: src/stores/customer/store.ts
+✅ Hook 생성 완료: src/hooks/useCustomerService.ts
+```
+
+#### 예시 4: 한글 자연어 (제품리포)
+
+```
+👤 사용자: 제품리포 기반으로 Store랑 Hook 생성해줘.
+
+🤖 Claude: [자연어 분석 중...]
+
+🔍 자연어 분석:
+   "제품리포" → Product
+
+📁 발견된 Repository:
+   1. ProductRepository.ts (Product, 7개 API)
+
+📂 생성 경로 제안:
+   Store: src/stores/useProductListStore.ts
+   Hook:  src/hooks/useProductService.ts
+
+이 경로들로 생성할까요?
+
+👤 사용자: 확인
+
+🤖 Claude: 네, 생성을 시작합니다.
+
+✅ Store 생성 완료: src/stores/useProductListStore.ts
+✅ Hook 생성 완료: src/hooks/useProductService.ts
+```
+
+#### 예시 2: 다중 파일 선택
+
+```
+👤 사용자: Product Repository 분석해서 Store랑 Hook 만들어줘.
+
+🤖 Claude: [파일 검색 중...]
+
+📁 발견된 Repository:
+   1. ProductRepository.ts (src/services/repository/product/) - 6개 API
+   2. ProductRepositoryCustom.ts (src/services/repository/product/) - 9개 API
+
+어느 파일을 사용할까요?
+
+👤 사용자: 2번
+
+🤖 Claude: 2번 ProductRepositoryCustom.ts를 선택합니다.
+
+📂 생성 경로 제안:
+   Store: src/stores/useProductListStore.ts
+   Hook:  src/hooks/useProductService.ts
+
+이 경로들로 생성할까요?
+
+👤 사용자: Store는 src/stores/product/store.ts로 바꿔줘
+
+🤖 Claude: 네, 경로를 변경해서 생성합니다.
+
+✅ Store 생성 완료: src/stores/product/store.ts
+✅ Hook 생성 완료: src/hooks/useProductService.ts
+```
+
+#### 예시 3: 경로만 확인
+
+```
+👤 사용자: OrderRepository 기반으로 Store랑 Hook 생성해줘.
+
+🤖 Claude: [파일 검색 중...]
+
+📁 발견된 Repository:
+   1. OrderRepository.ts (src/services/repository/order/)
+
+📂 생성 경로 제안:
+   Store: src/stores/useOrderListStore.ts
+   Hook:  src/hooks/useOrderService.ts
+
+이 경로들로 생성할까요?
+
+👤 사용자: 확인
+
+🤖 Claude: 네, 생성을 시작합니다.
+
+✅ Store 생성 완료: src/stores/useOrderListStore.ts
+✅ Hook 생성 완료: src/hooks/useOrderService.ts
+```
+
+---
+
+### 자연어 기반 상세 예시
+
+간단한 자연어 요구사항만 입력하면 Store와 Hook을 자동 생성합니다.
+
+#### 예시 1: 단일 리스트 (기본)
+
+**입력:**
+```javascript
+{
+  "interfacePath": "/path/to/ProductRepository.ts",
+  "requirements": "목록, 검색, 저장, 삭제"
+}
+```
+
+**결과:**
+```
+✅ Store 생성 완료 (Type 2)
+
+자동 분석:
+- 목록(리스트), 검색, 저장, 삭제 감지
+- 모달/상세 패턴 적용
+
+생성된 파일:
+- src/stores/useProductListStore.ts
+  ✓ 목록 상태 (listData, listPage)
+  ✓ 검색 기능 (listRequestValue, callListApi)
+  ✓ 저장/삭제 (callSaveApi, callDeleteApi)
+  ✓ 모달 상태 (modalOpen)
+
+- src/hooks/useProductService.ts
+  ✓ getList (목록 조회)
+  ✓ getDetail (상세 조회)
+```
+
+#### 예시 2: 왼쪽 목록 + 오른쪽 상세
+
+**입력:**
+```javascript
+{
+  "interfacePath": "/path/to/OrderRepository.ts",
+  "requirements": "왼쪽 목록, 오른쪽 상세, 저장, 삭제"
+}
+```
+
+**결과:**
+```
+✅ 다중 리스트 Store 생성 완료
+
+자동 분석:
+- LEFT_DETAIL_LIST 패턴 감지
+- 왼쪽: 목록 + 검색
+- 오른쪽: 상세 + 저장 + 삭제
+
+생성된 파일:
+- src/stores/useOrderStore.ts
+  ✓ leftListData, leftListPage (왼쪽 목록)
+  ✓ detailData, detailSpinning (오른쪽 상세)
+  ✓ modalOpen, saveSpinning (저장 모달)
+
+- src/hooks/useOrderService.ts
+  ✓ getList (왼쪽 목록)
+  ✓ getDetail (오른쪽 상세)
+```
+
+#### 예시 3: 상단/하단 목록
+
+**입력:**
+```javascript
+{
+  "interfacePath": "/path/to/CustomerRepository.ts",
+  "requirements": "상단 고객 목록, 하단 주문 내역, 각각 검색"
+}
+```
+
+**결과:**
+```
+✅ 다중 리스트 Store 생성 완료
+
+자동 분석:
+- MULTI_PANEL 패턴 감지
+- 상단: 고객 목록 + 검색
+- 하단: 주문 내역 + 검색
+
+생성된 파일:
+- src/stores/useCustomerStore.ts
+  ✓ topListData, topListPage (상단)
+  ✓ bottomListData, bottomListPage (하단)
+  ✓ topListRequestValue, bottomListRequestValue
+
+- src/hooks/useCustomerService.ts
+  ✓ getTopList (고객 목록)
+  ✓ getBottomList (주문 내역)
+```
+
+#### 예시 4: 엑셀 다운로드 포함
+
+**입력:**
+```javascript
+{
+  "interfacePath": "/path/to/MemberRepository.ts",
+  "requirements": "목록, 검색, 엑셀 다운로드"
+}
+```
+
+**결과:**
+```
+✅ Store 생성 완료 (Type 8)
+
+자동 분석:
+- 목록, 검색, 엑셀 감지
+- 선택 + 엑셀 패턴 적용
+
+생성된 파일:
+- src/stores/useMemberListStore.ts
+  ✓ listData, listPage, checkedRowKeys
+  ✓ callExcelDownloadApi
+
+- src/hooks/useMemberService.ts
+  ✓ getList (목록 조회)
+```
+
+---
+
+### 개별 도구 사용법
+
+아래는 각 도구를 개별적으로 사용하는 방법입니다. (참고용)
+
+---
+
+### 1. 인터페이스 분석
+
+Repository 파일을 분석하여 Service 메서드와 타입 정보를 추출합니다.
+
+```javascript
+// Claude 대화에서 입력
+{
+  "interfacePath": "/Users/kyle/Desktop/nh-fe-bo/src/services/repository/member/MemberRepository.ts"
+}
+```
+
+**결과:**
+```json
+{
+  "success": true,
+  "className": "MemberRepository",
+  "serviceName": "MemberService",
+  "methods": [
+    {
+      "name": "postMemberListMember",
+      "requestType": "PostMemberListMemberRequest",
+      "responseType": "PostMemberListMemberResponse",
+      "isListMethod": true,
+      "hasPage": true,
+      "comment": "/* 회원 목록 */"
+    }
+  ]
+}
+```
+
+---
+
+### 2. Store 생성
+
+통합 템플릿을 사용하여 Store를 생성합니다.
+
+```javascript
+{
+  "interfacePath": "/Users/kyle/Desktop/nh-fe-bo/src/services/repository/member/MemberRepository.ts",
+  "outputPath": "/Users/kyle/Desktop/nh-fe-bo/src/stores/useMemberListStore.ts",
+  "storeName": "useMemberListStore"
+}
+```
+
+**생성되는 파일:** `src/stores/useMemberListStore.ts`
+
+---
+
+### 3. Hook 생성
+
+Repository 파일에서 "목록/조회" API만 추출하여 React Hook을 생성합니다.
+
+```javascript
+{
+  "interfacePath": "/Users/kyle/Desktop/nh-fe-bo/src/services/repository/member/MemberRepository.ts",
+  "outputPath": "/Users/kyle/Desktop/nh-fe-bo/src/hooks/useMemberService.ts"
+}
+```
+
+**특징:**
+- 제외 키워드: "저장", "삭제", "수정", "엑셀", "업로드", "다운로드"
+- 포함 키워드: "조회", "목록"
+- 목록 API (`ds: Type[]`) → `list` 상태
+- 단건 API (`rs: Type`) → `detail` 상태
+- `hasPage` 있으면 `page`, `setPage` 생성
+
+---
+
+### 4. Store와 Hook 동시 생성
+
+```javascript
+{
+  "interfacePath": "/Users/kyle/Desktop/nh-fe-bo/src/services/repository/member/MemberRepository.ts",
+  "storeOutputPath": "/Users/kyle/Desktop/nh-fe-bo/src/stores/useMemberListStore.ts",
+  "hookOutputPath": "/Users/kyle/Desktop/nh-fe-bo/src/hooks/useMemberService.ts",
+  "storeName": "useMemberListStore"
+}
+```
+
+**결과:**
+```
+✅ Store 및 Hook 생성 완료
+
+엔티티: Member
+
+생성된 파일:
+- /Users/kyle/Desktop/nh-fe-bo/src/stores/useMemberListStore.ts (Store)
+- /Users/kyle/Desktop/nh-fe-bo/src/hooks/useMemberService.ts (Hook)
+
+Store: 타입 체크 통과
+Hook: 타입 체크 통과
+```
+
+---
+
+### 5. 요구사항 분석 (자연어)
+
+자연어 요구사항을 분석하여 적합한 Store 타입과 피처를 추천합니다.
+
+```javascript
+{
+  "requirements": "왼쪽 목록, 오른쪽 상세, 모달로 저장, 삭제 가능, 엑셀 다운로드"
+}
+```
+
+**결과:**
+```json
+{
+  "success": true,
+  "recommendedType": 7,
+  "recommendedTypeName": "마스터-디테일 + 모달 + 삭제 + 엑셀",
+  "detectedFeatures": ["LIST", "DETAIL_PANEL", "MODAL", "DELETE", "EXCEL_DOWNLOAD"]
+}
+```
+
+---
+
+### 6. 요구사항 기반 Store 자동 생성
+
+```javascript
+{
+  "interfacePath": "/Users/kyle/Desktop/nh-fe-bo/src/services/repository/order/OrderRepository.ts",
+  "outputPath": "/Users/kyle/Desktop/nh-fe-bo/src/stores/useOrderStore.ts",
+  "requirements": "왼쪽 주문 목록, 상단 주문 상세 목록, 하단 주문 항목 목록, 각 목록은 검색과 엑셀 다운로드, 하단은 체크박스"
+}
+```
+
+---
+
+### 7. 다중 리스트 통합 Store 생성
+
+```javascript
+{
+  "interfacePath": "/Users/kyle/Desktop/nh-fe-bo/src/services/repository/order/OrderRepository.ts",
+  "outputPath": "/Users/kyle/Desktop/nh-fe-bo/src/stores/useOrderStore.ts",
+  "requirements": "왼쪽 목록, 상단 디테일 목록, 하단 디테일 목록, 각 목록은 검색과 엑셀 다운로드, 하단은 체크박스",
+  "baseStoreName": "useOrderStore"
+}
+```
+
+---
+
+### 8. 다중 리스트 패턴 감지
+
+```javascript
+{
+  "requirements": "왼쪽 목록, 상단 디테일 목록, 하단 디테일 목록, 각 목록은 검색과 엑셀 다운로드, 하단은 체크박스"
+}
+```
+
+**결과:**
+```json
+{
+  "success": true,
+  "isMultiList": true,
+  "pattern": {
+    "leftList": { "name": "목록", "features": ["LIST", "SEARCH", "EXCEL_DOWNLOAD"] },
+    "topDetail": { "name": "디테일 목록", "features": ["LIST", "SEARCH", "EXCEL_DOWNLOAD"] },
+    "bottomDetail": { "name": "디테일 목록", "features": ["LIST", "SEARCH", "CHECKBOX", "EXCEL_DOWNLOAD"] }
+  }
+}
+```
+
+---
+
+### 9. 레이아웃 패턴 기반 요구사항 생성
+
+```javascript
+{
+  "interfacePath": "/Users/kyle/Desktop/nh-fe-bo/src/services/repository/product/ProductRepository.ts",
+  "layoutType": "LEFT_DETAIL_LIST",
+  "additional": "상세는 체크박스 지원"
+}
+```
+
+---
+
+### 10. 레이아웃 패턴 목록 조회
+
+```javascript
+{}
+```
+
+**결과:**
+```json
+{
+  "success": true,
+  "layouts": [
+    { "type": "LEFT_DETAIL_FORM", "name": "왼쪽 목록 + 오른쪽 폼", "description": "..." },
+    { "type": "LEFT_DETAIL_LIST", "name": "왼쪽 목록 + 오른쪽 목록", "description": "..." },
+    { "type": "MULTI_PANEL", "name": "다중 패널", "description": "..." }
+  ]
+}
+```
+
+---
+
+### 11. 적합한 레이아웃 추천
+
+```javascript
+{
+  "interfacePath": "/Users/kyle/Desktop/nh-fe-bo/src/services/repository/product/ProductRepository.ts"
+}
+```
+
+---
+
+### 12. SearchParams 생성
+
+```javascript
+{
+  "appPath": "/Users/kyle/Desktop/nh-fe-bo/src/pages/product/App.tsx",
+  "searchParams": {
+    "dateRange": {
+      "withPeriodType": true,
+      "periodOptions": [
+        { "label": "전체", "value": "" },
+        { "label": "오늘", "value": "today" },
+        { "label": "일주일", "value": "week" },
+        { "label": "1개월", "value": "month" }
+      ],
+      "name": "dateRange",
+      "label": "등록일",
+      "presetType": "all"
+    },
+    "codes": [
+      { "name": "statusCd", "label": "상태", "codeVar": "STATUS_CODE", "width": 150 },
+      { "name": "useYn", "label": "사용여부", "codeVar": "USE_YN", "width": 120 }
+    ],
+    "search": {
+      "withSearchType": true,
+      "options": [
+        { "label": "상품명", "value": "name" },
+        { "label": "상품코드", "value": "code" }
+      ],
+      "textName": "searchText",
+      "typeName": "searchType"
+    },
+    "ynFields": [
+      { "name": "displayYn", "label": "전시여부" }
+    ],
+    "lineBreak": true
+  }
+}
+```
+
+---
+
+### 13. ListDataGrid 컴포넌트 생성
+
+```javascript
+{
+  "outputPath": "/Users/kyle/Desktop/nh-fe-bo/src/pages/product/ProductListDataGrid.tsx",
+  "config": {
+    "storeName": "useProductListStore",
+    "dtoType": "ProductRes",
+    "rowKey": "prdCd",
+    "selectionMode": "multi",
+    "withFormHeader": true,
+    "withExcel": true,
+    "columns": [
+      { "key": "rowNo", "label": "No.", "type": "rowNo", "align": "center", "width": 60 },
+      { "key": "prdCd", "label": "상품코드", "type": "title", "align": "left", "width": 150 },
+      { "key": "prdNm", "label": "상품명", "type": "title", "align": "left" },
+      { "key": "prdPrc", "label": "판매가", "type": "money", "align": "right", "width": 120 },
+      { "key": "regDt", "label": "등록일", "type": "dateTime", "align": "center", "width": 150 },
+      { "key": "regUser", "label": "등록자", "type": "user", "align": "center", "width": 120 }
+    ],
+    "onClickType": "modal"
+  }
+}
+```
+
+---
+
+## Hook 생성 상세
+
+### API 필터링 규칙
+
+| 구분 | 키워드 |
+|------|--------|
+| 포함 | "조회", "목록" |
+| 제외 | "저장", "삭제", "수정", "엑셀", "업로드", "다운로드" |
+
+### 네이밍 규칙
+
+**목록 API:**
+| 메서드명 | 변수명 | 함수명 |
+|----------|--------|--------|
+| `postMemberListMember` | `list` | `getList` |
+| `postMemberListAdmin` | `adminList` | `getAdminList` |
+| `postMemberListActive` | `activeList` | `getActiveList` |
+
+**단건 API:**
+| 메서드명 | 변수명 | 함수명 |
+|----------|--------|--------|
+| `postMemberDetail` | `detail` | `getDetail` |
+| `postMemberInfo` | `info` | `getInfo` |
+| `postMemberProfile` | `profile` | `getProfile` |
+| `getMember` | `member` | `getMember` |
+
+### 중복 처리
+
+중복이 발생하면 자동으로 접두사를 추가합니다.
+
+```typescript
+// 중복 전
+postMemberDetail → detail, getDetail
+getMemberDetail → detail, getDetail
+
+// 중복 후 (자동 처리)
+postMemberDetail → postDetail, getPostDetail
+getMemberDetail → detail, getDetail
+```
+
+### 가변 페이징 처리
+
+`hasPage` 여부에 따라 `page`, `setPage`를 가변적으로 생성합니다.
+
+```typescript
+// hasPage: true인 경우
+const [list, setList] = useState<MemberRes[]>([]);
+const [page, setPage] = useState<AXDGPage>({...}); // ✅ 생성됨
+
+// hasPage: false인 경우
+const [adminList, setAdminList] = useState<AdminRes[]>([]);
+// ❌ adminPage, setAdminPage 없음
+```
+
+---
+
+## 타입 체크
+
+생성된 파일은 자동으로 타입 체크를 수행합니다.
+
+1. **프로젝트 구조 자동 분석** (tsconfig.json, package.json)
+2. **적절한 명령으로 타입 체크** (npm run type-check 또는 npx tsc --noEmit)
+3. **AI 자동 수정 시도** (1차 시도)
+4. **결과 반환** (성공 또는 타입 오류)
+
+---
+
+## 대화형 도구 상세
+
+### `generate_store_and_hook_interactive`
+
+파일명 또는 한글 자연어로 입력하면 자동으로 Repository를 검색하고 생성 경로를 제안합니다.
+
+#### AI 기반 검색 방식
+
+하드코딩된 매핑 테이블을 사용하지 않고, AI가 입력값을 해석하여 유연한 검색 패턴을 생성합니다.
+
+**작동 방식:**
+1. 사용자가 "회원리포", "MemberRepository", "member" 등을 입력
+2. AI가 입력값을 분석하여 여러 검색 패턴 생성
+3. glob 패턴 매칭으로 프로젝트 전체에서 파일 검색
+4. 발견된 파일을 사용자에게 제시
+
+**검색 패턴 예시:**
+```
+입력: "회원리포"
+→ 검색 패턴: **/*회원*.ts, **/MemberRepository.ts, **/*Member*.ts
+
+입력: "MemberRepository"
+→ 검색 패턴: **/MemberRepository.ts, **/*MemberRepository.ts
+
+입력: "member"
+→ 검색 패턴: **/MemberRepository.ts, **/*member*.ts
+```
+
+#### 입력 예시
+
+```
+회원리포 → 회원 관련 Repository 파일 검색
+배너리포 → 배너 관련 Repository 파일 검색
+거래처리포 → 거래처 관련 Repository 파일 검색
+제품리포 → 제품 관련 Repository 파일 검색
+```
+
+#### 작동 단계
+
+#### 작동 단계
+
+**1단계: 파일 검색**
+```javascript
+{
+  "fileName": "MemberRepository"
+}
+```
+
+→ 프로젝트 전체에서 `MemberRepository.ts` 파일 검색
+
+**2단계: 파일 선택 (여러 파일 발견 시)**
+```javascript
+{
+  "fileName": "MemberRepository",
+  "userSelections": {
+    "fileIndex": 1
+  }
+}
+```
+
+→ 1번 파일 선택
+
+**3단계: 경로 확인**
+```javascript
+{
+  "fileName": "MemberRepository",
+  "userSelections": {
+    "fileIndex": 1,
+    "storePath": null,  // 제안 경로 사용
+    "hookPath": null
+  }
+}
+```
+
+→ 제안된 경로로 생성
+
+#### 경로 변경 예시
+
+```javascript
+{
+  "fileName": "MemberRepository",
+  "userSelections": {
+    "fileIndex": 1,
+    "storePath": "src/stores/member/store.ts",  // 직접 지정
+    "hookPath": null  // 제안 경로 사용
+  }
+}
+```
+
+#### 응답 상태
+
+| 상태 | 설명 |
+|------|------|
+| `need_file_selection` | 여러 파일 발견, 선택 필요 |
+| `need_path_confirmation` | 경로 제안 완료, 확인 필요 |
+| `complete` | 생성 완료 |
+| `error` | 오류 발생 |
+
+---
+
+---
+
+## Auto CRUD 예시
+
+전체 페이지 구조를 자동으로 생성하는 예시입니다.
+
+### 1. Store 생성
+
+```javascript
+{
+  "interfacePath": "/path/to/ProductRepository.ts",
+  "outputPath": "/path/to/src/stores/useProductListStore.ts",
+  "storeName": "useProductListStore"
+}
+```
+
+### 2. Hook 생성
+
+```javascript
+{
+  "interfacePath": "/path/to/ProductRepository.ts",
+  "outputPath": "/path/to/src/hooks/useProductService.ts"
+}
+```
+
+### 3. SearchParams 생성
+
+```javascript
+{
+  "appPath": "/path/to/src/pages/product/App.tsx",
+  "searchParams": {
+    "dateRange": { "withPeriodType": true, "label": "등록일" },
+    "codes": [{ "name": "statusCd", "label": "상태", "codeVar": "STATUS_CODE" }],
+    "search": { "withSearchType": true }
+  }
+}
+```
+
+### 4. ListDataGrid 생성
+
+```javascript
+{
+  "outputPath": "/path/to/src/pages/product/ProductListDataGrid.tsx",
+  "config": {
+    "storeName": "useProductListStore",
+    "dtoType": "ProductRes",
+    "rowKey": "prdCd",
+    "selectionMode": "multi",
+    "withFormHeader": true,
+    "withExcel": true,
+    "columns": [...]
+  }
+}
+```
+
+---
+
+## 파일 구조
+
+```
+src/
+├── stores/
+│   ├── useMemberListStore.ts      # Store (생성됨)
+│   └── index.ts                    # export 자동 추가
+├── hooks/
+│   ├── useMemberService.ts         # Hook (생성됨)
+│   └── index.ts                    # export 자동 추가
+└── pages/
+    └── product/
+        ├── App.tsx                 # SearchParams 추가됨
+        └── ProductListDataGrid.tsx # 컴포넌트 (생성됨)
+```
+
+---
+
+## 주요 기능
+
+- ✅ **자동 타입 체크**: 생성 후 자동으로 tsc 실행
+- ✅ **AI 자동 수정**: 1차 시도로 �입 오류 자동 수정
+- ✅ **Lint/Prettier**: 생성된 파일 자동 포맷팅
+- ✅ **index.ts 자동 생성**: export 자동 추가
+- ✅ **다중 리스트 지원**: 왼쪽/상단/하단 목록 통합
+- ✅ **가변 페이징 처리**: hasPage 여부에 따른 page 생성
+- ✅ **옵션 기능 주석 처리**: 자동 초기화, i18n 등
+
+---
+
+## 참고 자료
+
+- NH-FE-B Store 패턴 가이드: `src/docs/store-patterns-usage-guide.md`
+- Hook 생성 계획서: `src/docs/HOOK_GENERATION_PLAN.md`
+- Store 타입 정의: `src/features/store-features.ts`