sonamu 0.7.53 → 0.8.0

package/src/skills/sonamu/frontend.md

@@ -477,6 +477,154 @@ function UserListPage() {
 - `selectedKeys`: 현재 선택된 키 배열
 - `isAllSelected`: 전체 선택 여부
 
+## IdAsyncSelect
+
+Entity의 레코드를 비동기로 검색하여 선택하는 컴포넌트입니다. Entity의 Primary Key 타입에 따라 제네릭 타입을 명시해야 합니다.
+
+### 기본 사용법
+
+IdAsyncSelect는 일반적으로 Entity별 래퍼 컴포넌트로 사용합니다:
+
+```typescript
+import { IdAsyncSelect } from "@sonamu-kit/react-components/components";
+import { UserAsyncIdConfig } from "@/services/services.generated";
+import type { UserSubsetKey, UserSubsetMapping } from "@/services/sonamu.generated";
+import type { UserListParams } from "@/services/user/user.types";
+
+export type UserIdAsyncSelectProps<T extends UserSubsetKey> = {
+  subset: T;
+  baseListParams?: UserListParams;
+  displayField?: keyof UserSubsetMapping[T] & string;
+  valueField?: keyof UserSubsetMapping[T] & string;
+  placeholder?: string;
+  clearable?: boolean;
+  disabled?: boolean;
+  className?: string;
+  multiple?: boolean;
+  value?: number | number[] | null;  // Number PK
+  onValueChange?: (value: number | number[] | undefined) => void;
+};
+
+export function UserIdAsyncSelect<T extends UserSubsetKey>({
+  subset,
+  value,
+  onValueChange,
+  baseListParams,
+  displayField = "name",
+  valueField = "id",
+  placeholder = "사용자",
+  clearable,
+  disabled,
+  className,
+  multiple = false,
+}: UserIdAsyncSelectProps<T>) {
+  return (
+    <IdAsyncSelect<number>  // Number PK
+      config={UserAsyncIdConfig}
+      subset={subset}
+      baseListParams={baseListParams}
+      displayField={displayField}
+      valueField={valueField}
+      placeholder={placeholder}
+      clearable={clearable}
+      disabled={disabled}
+      className={className}
+      multiple={multiple}
+      value={value}
+      onValueChange={onValueChange}
+    />
+  );
+}
+```
+
+**주요 Props:**
+- `config`: 자동 생성된 AsyncIdConfig (EntityAsyncIdConfig 형태)
+- `subset`: 조회할 Subset 키
+- `baseListParams`: 목록 조회 필터 파라미터
+- `displayField`: 화면에 표시할 필드명 (기본값: Entity에 따라 다름)
+- `valueField`: value로 사용할 필드명 (기본값: "id")
+- `multiple`: 다중 선택 여부
+- `value`: 현재 선택된 값 (PK 타입에 따라 number 또는 string)
+- `onValueChange`: 값 변경 핸들러
+
+### IMPORTANT: String Primary Key Support
+
+**Number PK Entity (대부분의 Entity):**
+```typescript
+export type PostIdAsyncSelectProps<T extends PostSubsetKey> = {
+  // ...
+  value?: number | number[] | null;
+  onValueChange?: (value: number | number[] | undefined) => void;
+};
+
+export function PostIdAsyncSelect<T extends PostSubsetKey>({...}: PostIdAsyncSelectProps<T>) {
+  return (
+    <IdAsyncSelect<number>  // ← Number PK
+      config={PostAsyncIdConfig}
+      // ...
+    />
+  );
+}
+```
+
+**String PK Entity (User, Account, Session, Verification 등):**
+```typescript
+export type AccountIdAsyncSelectProps<T extends AccountSubsetKey> = {
+  // ...
+  value?: string | string[] | null;  // ← String으로 변경
+  onValueChange?: (value: string | string[] | undefined) => void;
+};
+
+export function AccountIdAsyncSelect<T extends AccountSubsetKey>({...}: AccountIdAsyncSelectProps<T>) {
+  return (
+    <IdAsyncSelect<string>  // ← String PK
+      config={AccountAsyncIdConfig}
+      // ...
+    />
+  );
+}
+```
+
+**String PK를 사용하는 주요 Entity:**
+- `User`: 사용자 계정 (일반적으로 UUID 또는 영문자 ID)
+- `Account`: 인증 계정 정보
+- `Session`: 세션 관리
+- `Verification`: 인증 토큰
+
+**scaffolding 후 수정 필요:**
+- Sonamu scaffolding은 기본적으로 Number PK를 가정하고 코드를 생성합니다
+- String PK Entity의 경우 생성된 IdAsyncSelect 래퍼 컴포넌트를 수동으로 수정해야 합니다
+- 제네릭 타입, value 타입, onValueChange 타입을 모두 `string`으로 변경해야 합니다
+
+### 폼에서 사용
+
+```tsx
+function PostForm() {
+  const { form, setForm, register } = useTypeForm(PostSaveParams, {
+    title: "",
+    author_id: 0,  // or "" for string PK
+  });
+
+  return (
+    <form>
+      <Input {...register("title")} />
+
+      {/* Number PK */}
+      <UserIdAsyncSelect
+        subset="A"
+        {...register("author_id")}
+      />
+
+      {/* String PK */}
+      <AccountIdAsyncSelect
+        subset="A"
+        {...register("account_id")}
+      />
+    </form>
+  );
+}
+```
+
 ## FileInput
 
 파일 업로드 컴포넌트 (이미지/일반 파일, eager/lazy 모드)
@@ -721,6 +869,72 @@ registerSSR({
 });
 ```
 
+## 프로젝트 초기 설정
+
+### 프로젝트명 변경 (신규 프로젝트 생성 시)
+
+사용자가 프로젝트 생성을 요청했을 때, 프론트엔드의 "Sonamu" 텍스트를 프로젝트명으로 변경해야 합니다.
+
+**변경해야 할 파일 4개:**
+
+1. **`packages/web/index.html`** - 브라우저 탭 제목
+```html
+<!-- 변경 전 -->
+<title>Sonamu Project</title>
+
+<!-- 변경 후 -->
+<title>{프로젝트명}</title>
+```
+
+2. **`packages/web/src/routes/__root.tsx`** - TanStack Router head 설정 (가장 중요!)
+```typescript
+// 변경 전
+head: () => ({
+  meta: [
+    { title: "Sonamu Project" },
+  ],
+}),
+
+// 변경 후
+head: () => ({
+  meta: [
+    { title: "{프로젝트명}" },
+  ],
+}),
+```
+
+**중요:** `__root.tsx`를 변경하지 않으면 HMR 시 title이 "Sonamu"로 되돌아갑니다!
+
+3. **`packages/web/src/routes/index.tsx`** - 메인 페이지 제목
+```tsx
+// 변경 전
+<h1 className="text-2xl font-bold mb-4">Welcome to Sonamu</h1>
+
+// 변경 후
+<h1 className="text-2xl font-bold mb-4">Welcome to {프로젝트명}</h1>
+```
+
+4. **`packages/web/src/components/Sidebar.tsx`** - 사이드바 앱 이름
+```typescript
+// 변경 전
+const title = isAdmin ? "Admin" : "Sonamu App";
+
+// 변경 후
+const title = isAdmin ? "Admin" : "{프로젝트명}";
+```
+
+**작업 순서:**
+1. 사용자가 "KOPRI 프로젝트 생성해줘" 요청
+2. API 프로젝트 생성 (`pnpm create sonamu kopri`)
+3. **프론트엔드 4개 파일에서 "Sonamu" → "KOPRI" 변경**
+4. 개발 서버 실행 후 브라우저에서 확인
+
+**확인 방법:**
+- 브라우저 탭에 프로젝트명이 표시되는지 확인
+- 파일 저장 시 HMR로 탭 제목이 변경되지 않는지 확인 (변경되면 `__root.tsx` 누락)
+
+---
+
 ## Rules
 
 - NEVER manually modify `services.generated.ts`

package/src/skills/sonamu/i18n.md

@@ -174,3 +174,98 @@ localizedColumn(tag, "name");  // → "태그" (ko) / "Tag" (en)
 | `enum.*` | Enum 라벨 | `enum.UserRole.admin` |
 | `menu.*` | 메뉴/네비게이션 | `menu.home`, `menu.settings` |
 | `rc.*` | react-components 내장 | `rc.pagination.next` |
+
+## 트러블슈팅
+
+### LocalizedString 타입 오류
+
+`Type 'string' is not assignable to type '{ __brand: "LocalizedString"; }'` 오류가 발생하는 경우:
+
+**원인 1: ko.ts에 i18n 키 누락**
+```typescript
+// 잘못된 예: ko.ts에 키가 없으면 타입 오류
+SD("validation.password");  // 키가 ko.ts에 없음
+```
+
+해결: ko.ts에 키 추가 후 `pnpm sync`
+
+**원인 2: 모델에서 SD() 미사용**
+```typescript
+// 잘못된 예: 문자열 직접 사용
+throw new BadRequestException("이메일이 잘못되었습니다");
+
+// 올바른 예: SD() 함수 사용
+throw new BadRequestException(SD("error.invalidEmail"));
+```
+
+모든 사용자 노출 문자열은 반드시 SD() 함수로 감싸야 합니다.
+
+---
+
+## 타입 안정성
+
+### String PK 지원
+
+Entity가 String PK를 사용하는 경우 i18n 함수 타입도 이를 반영해야 합니다.
+
+**BAD: Number만 지원**
+```typescript
+// ko.ts
+notFound: (name: string, id: number) => `존재하지 않는 ${name} ID ${id}`,
+
+// String PK 엔티티에서 타입 오류 발생
+// Account, Session, User, Verification 등
+throw new NotFoundException(SD("notFound")(this.modelName, id));
+// Error: Argument of type 'string' is not assignable to parameter of type 'number'
+```
+
+**GOOD: Union 타입으로 둘 다 지원**
+```typescript
+// ko.ts
+notFound: (name: string, id: number | string) => `존재하지 않는 ${name} ID ${id}`,
+
+// Number PK, String PK 모두 사용 가능
+throw new NotFoundException(SD("notFound")(this.modelName, id));
+```
+
+**적용 대상 i18n 키:**
+- `notFound`: Entity 조회 실패
+- `error.entityNotFound`: 구체적인 엔티티 조회 실패 (deprecated, notFound 사용 권장)
+
+### 네임스페이스별 타입 패턴
+
+| i18n 키 | 파라미터 타입 | 용도 |
+|---------|--------------|------|
+| `notFound` | `(name: string, id: number \| string)` | Entity 조회 실패 |
+| `search.invalidField` | `(field: string)` | 잘못된 검색 필드 |
+| `validation.required` | `(field: string)` | 필수 필드 검증 |
+| `validation.maxLength` | `(field: string, max: number)` | 최대 길이 검증 |
+| `validation.minLength` | `(field: string, min: number)` | 최소 길이 검증 |
+| `entity.create` | `(name: string)` | Entity 생성 화면 |
+| `entity.edit` | `(name: string, id: number \| string)` | Entity 수정 화면 |
+
+### PK 타입 확인 방법
+
+Entity 파일에서 id 필드 타입을 확인:
+
+```json
+// String PK
+{
+  "props": {
+    "id": { "type": "varchar(255)", "autoIncrement": false }
+  }
+}
+
+// Number PK (기본값)
+{
+  "props": {
+    "id": { "type": "int", "autoIncrement": true }
+  }
+}
+```
+
+**KOPRI 프로젝트의 String PK 엔티티:**
+- Account
+- Session
+- User
+- Verification

package/src/skills/sonamu/model.md

@@ -456,3 +456,156 @@ if (params.orderBy) {
 - 스캐폴딩 후 model의 orderBy 케이스 확인
 - entity.json의 orderBy enum과 일치하는지 확인
 - search 케이스, enhancers 등 다른 커스텀 로직도 확인
+
+---
+
+## 코드 품질과 일관성
+
+### DRY 원칙: this.modelName 사용
+
+에러 메시지에서 모델명을 하드코딩하지 않고 `this.modelName`을 사용합니다.
+
+**BAD: 모델명 하드코딩**
+```typescript
+// department.model.ts
+if (!rows[0]) {
+  throw new NotFoundException(SD("notFound")("Department", id));
+}
+
+// user.model.ts
+if (!rows[0]) {
+  throw new NotFoundException(SD("notFound")("User", id));
+}
+```
+
+**GOOD: this.modelName 활용**
+```typescript
+// 모든 Model 공통
+if (!rows[0]) {
+  throw new NotFoundException(SD("notFound")(this.modelName, id));
+}
+```
+
+**장점:**
+- 복붙 실수 방지: 다른 모델 코드 복사 시 모델명 수정 불필요
+- 일관성: 모든 모델이 동일한 패턴 사용
+- 유지보수: constructor의 modelName만 변경하면 모든 에러 메시지 자동 반영
+
+### 일관된 i18n 키 사용
+
+프로젝트 전체에서 동일한 목적의 i18n 키를 일관되게 사용합니다.
+
+**BAD: 중복된 i18n 키**
+```typescript
+// 여러 모델에서 서로 다른 키 사용
+throw new NotFoundException(SD("error.entityNotFound")(this.modelName, id));
+throw new NotFoundException(SD("error.notFound")(this.modelName, id));
+throw new NotFoundException(SD("notFound")(this.modelName, id));
+
+// 검색 필드 오류
+throw new BadRequestException(SD("error.unknownSearchField")(params.search));
+throw new BadRequestException(SD("error.invalidSearchField")(params.search));
+```
+
+**GOOD: 표준 i18n 키 사용**
+```typescript
+// Entity 조회 실패 - 짧고 명확
+throw new NotFoundException(SD("notFound")(this.modelName, id));
+
+// 검색 필드 오류 - search 네임스페이스
+throw new BadRequestException(SD("search.invalidField")(params.search));
+```
+
+**권장 i18n 키 패턴:**
+| 상황 | i18n 키 | 사용처 |
+|------|---------|--------|
+| Entity 조회 실패 | `notFound` | findById |
+| 잘못된 검색 필드 | `search.invalidField` | findMany search |
+| 필수 필드 누락 | `validation.required` | save 검증 |
+| 권한 없음 | `error.forbidden` | guards 실패 |
+| 로그인 필요 | `error.loginRequired` | Context.user null |
+
+### 벌크 리팩토링 전략
+
+여러 모델 파일을 일관되게 수정할 때 sed를 활용한 자동화:
+
+**1단계: 패턴 확인**
+```bash
+# 수정 대상 파일 찾기
+grep -r 'SD("error.entityNotFound")' packages/api/src/application/*/
+```
+
+**2단계: 변경 검증 (dry-run)**
+```bash
+# 변경될 내용 미리 확인
+sed -n 's/SD("error.entityNotFound")(\(.*\), id)/SD("notFound")(this.modelName, id)/p' file.ts
+```
+
+**3단계: 일괄 적용**
+```bash
+# 모든 model 파일 수정
+find packages/api/src/application -name "*.model.ts" -exec sed -i '' \
+  's/SD("error.entityNotFound")(\(.*\), id)/SD("notFound")(this.modelName, id)/g' {} \;
+```
+
+**4단계: 빌드로 검증**
+```bash
+# TypeScript 타입 체크
+pnpm typecheck
+
+# 전체 빌드
+pnpm build
+```
+
+**주의사항:**
+- 반드시 git commit 후 실행 (롤백 가능하도록)
+- dry-run으로 변경 내용 먼저 확인
+- 빌드로 타입 오류 체크
+- 테스트 실행으로 동작 검증
+
+### 타입 체크 패턴
+
+**satisfies vs as const:**
+
+```typescript
+// BAD: 타입 단언으로 타입 체크 우회
+const params = {
+  num: 24,
+  page: 1,
+  search: "id" as const,
+  orderBy: "wrong-value" as const,  // 오류 감지 안 됨
+  ...rawParams,
+} as RoleListParams;
+
+// GOOD: satisfies로 컴파일 타임 검증
+const params = {
+  num: 24,
+  page: 1,
+  search: "id" as const,
+  orderBy: "wrong-value" as const,  // 컴파일 오류 발생!
+  ...rawParams,
+} satisfies RoleListParams;
+```
+
+**적용 권장 위치:**
+- findMany의 params 기본값
+- 복잡한 객체 리터럴 (타입 체크가 중요한 경우)
+
+### 코드 리뷰 체크리스트
+
+새로운 Model 작성 시:
+- [ ] `this.modelName` 사용 (하드코딩 금지)
+- [ ] 표준 i18n 키 사용 (`notFound`, `search.invalidField`)
+- [ ] satisfies 키워드 활용 (타입 안전성)
+- [ ] debug 옵션 불필요하게 명시하지 않음
+- [ ] orderBy 모든 케이스 exhaustive 처리
+- [ ] ManyToMany relation이 있으면 _ids 배열 SaveParams에 추가
+
+20개 Model 일괄 수정 시:
+- [ ] miomock 같은 레퍼런스 코드와 패턴 비교
+- [ ] 불일치하는 패턴 우선순위 정리
+- [ ] sed 등으로 자동화 스크립트 작성
+- [ ] 변경 전 git commit
+- [ ] dry-run으로 변경 내용 검증
+- [ ] pnpm typecheck로 타입 오류 확인
+- [ ] pnpm test로 동작 검증

package/src/skills/sonamu/project-init.md

@@ -10,17 +10,176 @@ description: Sonamu 프로젝트 생성 및 초기화. Entity 설계 요청 시
 **한 번에 하나씩, 순서대로 진행:**
 
 ```
-1. 프로젝트 생성 확인 ← 첫 번째
+0. 작업 경로 확인 ← 최우선
+1. 프로젝트 생성 확인
 2. (프로젝트 없으면) 생성 여부 확인
 3. (생성 원하면) 프로젝트명 확인
 4. (생성 원하면) 기본값 사용 vs 옵션 설정
 5. 프로젝트 생성 실행
-6. 설정 확인/커스터마이징 (config.md 참조)
-7. → entity-basic.md로 이동
+6. (요구사항 제공 시) 요구사항 문서화 ← 중요!
+7. 설정 확인/커스터마이징 (config.md 참조)
+8. → entity-basic.md로 이동
 ```
 
 ---
 
+## 요구사항 문서화
+
+**사용자가 프로젝트 생성과 함께 요구사항을 제공한 경우, 반드시 문서화합니다.**
+
+### 프로세스
+
+1. **프로젝트 생성 완료 확인**
+   - `pnpm create sonamu` 완료
+   - `pnpm install` 완료
+   - `.claude/skills/project/` 디렉토리 자동 생성 확인
+
+2. **요구사항 작성**
+   ```bash
+   # .claude/skills/project/requirements.md 파일에 작성
+   ```
+
+3. **작성 내용**
+   - 프로젝트 개요
+   - 핵심 기능 목록
+   - 사용자 역할 정의
+   - 주요 엔티티 목록
+   - 비즈니스 규칙
+   - 기술 스택
+   - 추가 요구사항
+
+4. **지속적 참조**
+   - 이후 모든 개발 과정에서 이 문서를 참조
+   - Entity 설계, API 개발, 비즈니스 로직 구현 시 일관성 유지
+
+### 예시 시나리오
+
+```
+사용자: "연구과제 관리 시스템을 만들려고 해.
+        공고, 과제, 평가 관리가 필요하고,
+        관리자/평가위원/신청자 역할이 있어."
+
+Claude:
+1. 프로젝트 경로 확인
+2. "pnpm create sonamu research_system --yes" 실행
+3. 프로젝트 생성 완료
+4. .claude/skills/project/requirements.md에 다음 내용 작성:
+
+---
+# 연구과제 관리 시스템
+
+## 프로젝트 개요
+연구과제 공모, 지원, 평가를 관리하는 시스템
+
+## 핵심 기능
+- 공고 관리 (생성, 수정, 발행, 마감)
+- 과제 지원 및 관리
+- 평가 프로세스 (평가위원 배정, 평가표 작성, 점수 산정)
+- 사용자 권한 관리
+
+## 사용자 역할
+- 관리자: 전체 시스템 관리, 공고 생성, 평가위원 배정
+- 평가위원: 평가표 작성, 점수 부여
+- 신청자: 과제 지원, 진행 상황 확인
+
+## 주요 엔티티
+- Announcement (공고)
+- Project (과제)
+- Evaluation (평가)
+- User (사용자)
+- ...
+---
+
+5. 이후 Entity 설계 시 이 문서 참조하여 일관되게 진행
+```
+
+### 중요 사항
+
+**반드시 문서화해야 하는 경우:**
+- 사용자가 프로젝트 생성과 함께 요구사항/기능 명세를 제공한 경우
+- 비즈니스 규칙이나 특별한 제약사항이 있는 경우
+
+**문서화 시점:**
+- 프로젝트 생성 직후
+- Entity 설계 시작 전
+
+**문서 활용:**
+- Entity 설계 시 참조
+- API 비즈니스 로직 구현 시 참조
+- 테스트 케이스 작성 시 참조
+- 프론트엔드 UI 설계 시 참조
+
+---
+
+## 0. 작업 경로 확인
+
+**프로젝트 생성 전 반드시 확인:**
+
+개발자들은 종종 프로젝트 유형에 따라 작업 디렉토리를 분리합니다:
+- 회사/프레임워크 프로젝트: `~/Development/`
+- 개인 프로젝트: `~/dev/programming/`
+- 클라이언트 작업: `~/Projects/clients/`
+
+### 확인 프로세스
+
+1. **현재 작업 디렉토리 파악**
+   ```bash
+   pwd  # 현재 디렉토리 확인
+   ```
+
+2. **사용자에게 확인 질문**
+   ```
+   "현재 {현재_디렉토리}에서 요청하셨는데, 여기에 프로젝트를 생성할까요?
+   다른 경로에서 작업하신다면 프로젝트를 생성할 디렉토리를 말씀해 주세요.
+
+   1. 현재 디렉토리에 생성
+   2. 다른 디렉토리 지정"
+   ```
+
+3. **선택에 따른 처리**
+
+   **1번 선택 시:**
+   - 현재 디렉토리에서 바로 진행
+   - 다음 단계(프로젝트 생성 확인)로 이동
+
+   **2번 선택 시:**
+   - "프로젝트를 생성할 디렉토리 경로를 알려주세요."
+   - 경로 받은 후: `cd {지정_경로}`
+   - 디렉토리 존재 여부 확인
+   - 디렉토리 없으면: `mkdir -p {지정_경로} && cd {지정_경로}`
+   - 다음 단계로 이동
+
+### 예시 대화
+
+```
+사용자: "설문조사 시스템을 만들려고 해. Entity 설계해줘."
+
+Claude: "현재 /Users/noa/Documents에서 요청하셨는데, 여기에 프로젝트를 생성할까요?
+다른 경로에서 작업하신다면 프로젝트를 생성할 디렉토리를 말씀해 주세요.
+
+1. 현재 디렉토리에 생성
+2. 다른 디렉토리 지정"
+
+사용자: "2"
+
+Claude: "프로젝트를 생성할 디렉토리 경로를 알려주세요."
+
+사용자: "/Users/noa/Development"
+
+Claude: "/Users/noa/Development로 이동합니다.
+
+Sonamu 프로젝트가 이미 생성되어 있나요?"
+```
+
+### 주의사항
+
+- **상대 경로도 허용**: `~/Development`, `../projects` 등
+- **틸드(~) 확장**: 홈 디렉토리 자동 확장
+- **경로 검증**: 존재하지 않는 경로는 생성 여부 확인
+- **Working directory 변경**: 경로 이동 후 모든 명령어는 새 경로 기준
+
+---
+
 ## 전체 프로세스 상세
 
 ### A. Sonamu 개발자용 (로컬 링크)
@@ -144,6 +303,14 @@ pnpm -r build
 ```
 사용자: "설문조사 시스템을 만들려고 해. Entity 설계해줘."
 
+Claude: "현재 /Users/noa/Documents에서 요청하셨는데, 여기에 프로젝트를 생성할까요?
+다른 경로에서 작업하신다면 프로젝트를 생성할 디렉토리를 말씀해 주세요.
+
+1. 현재 디렉토리에 생성
+2. 다른 디렉토리 지정"
+
+사용자: "1"
+
 Claude: "Sonamu 프로젝트가 이미 생성되어 있나요?"
 
 사용자: "아니"
@@ -175,13 +342,16 @@ pnpm create sonamu survey_system --yes
 
 Claude: "설문조사 시스템 Entity를 설계하기 전에 확인할게요.
 
-1. Sonamu 프로젝트가 이미 생성되어 있나요?
-   - 생성되어 있다면 프로젝트 경로를 알려주세요.
-   - 아직 없다면 pnpm create sonamu로 먼저 생성할까요?
-2. 프로젝트명은 무엇으로 할까요?
-3. 어느 경로에 생성할까요?"
+1. 어느 경로에 프로젝트를 생성할까요?
+2. Sonamu 프로젝트가 이미 생성되어 있나요?
+3. 프로젝트명은 무엇으로 할까요?
+4. 기본값으로 생성할까요, 옵션을 직접 설정할까요?"
 ```
 
+**잘못된 이유:**
+- 여러 질문을 한 번에 던짐 (한 번에 하나씩 질문해야 함)
+- 질문 순서가 명확하지 않음
+
 ---
 
 ## 프로젝트 생성 후 설정