261117_01_ENH: 생성 의존성 실제 버전으로 기록, cn을 @kri/common과 동기화하고 clsx·tailwind-merge 제거

This commit is contained in:
2026-11-17 09:19:15 +09:00
parent 263a32b99f
commit a90f9c8cd9
3 changed files with 132 additions and 34 deletions

View File

@@ -50,12 +50,13 @@ Agent Harness 관련 기본값과 옵션:
## 생성 과정
1. 표준 템플릿 복사
2. Next.js 및 shadcn 호환 npm 의존성 설치
2. Next.js 및 shadcn 호환 npm 의존성 설치(설치 시점의 실제 버전 범위로 기록)
3. `@kri/common@latest` 설치 후 exact 버전 기록
4. KRI UI Registry 9개 항목 설치
5. TypeScript 검사
6. Next.js production build
7. Agent Harness 공유 등록, `AGENTS.md`/`CLAUDE.md` 합성 및 검증
5. `cn` 버전을 설치된 `@kri/common`의 `cn` 의존성과 같은 exact 버전으로 동기화
6. TypeScript 검사
7. Next.js production build
8. Agent Harness 공유 등록, `AGENTS.md`/`CLAUDE.md` 합성 및 검증
UI Registry: `https://ui-registry.kric.com/r`
@@ -78,6 +79,9 @@ UI Registry: `https://ui-registry.kric.com/r`
## 호환성 정책
- 생성 프로젝트는 Node.js 22 이상이 필요합니다(`@kri/common`의 `cn` 의존성 요구 사항).
- 의존성은 `latest`를 그대로 기록하지 않고, 설치 시점에 해석된 실제 버전 범위(예: `^19.2.1`)로 기록합니다. `--skip-install`로 생성하면 설치 전이므로 spec(`latest` 등)이 그대로 남습니다.
- `@kri/common`은 프로젝트 생성 시점의 최신 버전을 설치하고 exact 버전으로 기록합니다.
- `cn`은 `@kri/common`이 의존하는 버전을 읽어 같은 exact 버전으로 설치합니다. shadcn 기본 컴포넌트와 `@kri/common/ui`가 같은 `cn`을 사용해 중복 설치되지 않습니다.
- Next.js 생태계 호환성을 위해 생성 프로젝트의 TypeScript는 최신 5.x, ESLint는 최신 9.x를 사용합니다.
- shadcn 기본 컴포넌트가 사용하는 `class-variance-authority`, `clsx`, `tailwind-merge`, `lucide-react`를 기본 의존성에 포함합니다.
- shadcn 기본 컴포넌트가 사용하는 `class-variance-authority`, `lucide-react`를 기본 의존성에 포함합니다. 클래스 병합은 `clsx`·`tailwind-merge` 대신 `cn`을 사용합니다.