create-web-0to1 0.1.0

package/scripts/create-app.mjs

@@ -0,0 +1,1612 @@
+#!/usr/bin/env node
+
+import { spawnSync } from 'node:child_process';
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import { fileURLToPath } from 'node:url';
+
+import {
+  buildProjectGenerationPlan,
+  executeProjectGenerationPlan,
+} from '../internal/engine/generator-engine.ts';
+import { getStandaloneDependencyManifest } from '../internal/meta/standalone-dependency-manifest.ts';
+
+const PRESET_CHOICES = [
+  {
+    label: 'React standalone',
+    value: 'react',
+    description: 'create-vite 기반 app starter에 runtime/template를 적용합니다.',
+  },
+  {
+    label: 'Next standalone',
+    value: 'next',
+    description: 'create-next-app 기반 app starter에 runtime/template를 적용합니다.',
+  },
+  {
+    label: 'Monorepo workspace',
+    value: 'monorepo',
+    description: 'workspace scaffold를 직접 생성합니다.',
+  },
+];
+
+const EXECUTION_CHOICES = {
+  react: [
+    {
+      label: '자동 scaffold 후 생성',
+      value: 'auto-scaffold',
+      description: 'create-vite를 먼저 실행한 뒤 runtime/template를 자동 적용합니다.',
+    },
+    {
+      label: 'scaffolded dir에 적용',
+      value: 'scaffolded-apply',
+      description: '이미 create-vite로 만들어진 디렉터리에 runtime/template를 덮어씁니다.',
+    },
+  ],
+  next: [
+    {
+      label: '자동 scaffold 후 생성',
+      value: 'auto-scaffold',
+      description: 'create-next-app을 먼저 실행한 뒤 runtime/template를 자동 적용합니다.',
+    },
+    {
+      label: 'scaffolded dir에 적용',
+      value: 'scaffolded-apply',
+      description: '이미 create-next-app으로 만들어진 디렉터리에 runtime/template를 덮어씁니다.',
+    },
+  ],
+  monorepo: [
+    {
+      label: '바로 생성',
+      value: 'apply',
+      description: '비어 있는 디렉터리에 monorepo 결과물을 바로 생성합니다.',
+    },
+  ],
+};
+
+const ansi = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m',
+};
+
+function supportsAnsi() {
+  if (process.env.NO_COLOR === '1' || process.env.NO_COLOR === 'true') {
+    return false;
+  }
+
+  return Boolean(output.isTTY);
+}
+
+function paint(text, ...codes) {
+  if (!supportsAnsi()) {
+    return text;
+  }
+
+  return `${codes.join('')}${text}${ansi.reset}`;
+}
+
+function title(text) {
+  return paint(text, ansi.bold, ansi.cyan);
+}
+
+function success(text) {
+  return paint(text, ansi.bold, ansi.green);
+}
+
+function warning(text) {
+  return paint(text, ansi.bold, ansi.yellow);
+}
+
+function danger(text) {
+  return paint(text, ansi.bold, ansi.red);
+}
+
+function subtle(text) {
+  return paint(text, ansi.dim, ansi.gray);
+}
+
+function accent(text) {
+  return paint(text, ansi.bold, ansi.magenta);
+}
+
+function info(text) {
+  return paint(text, ansi.bold, ansi.blue);
+}
+
+function createStepTitleBuilder() {
+  let step = 1;
+
+  return (text) => `${step++}. ${text}`;
+}
+
+function formatPresetLabel(preset) {
+  if (preset === 'react') {
+    return 'React standalone';
+  }
+
+  if (preset === 'next') {
+    return 'Next standalone';
+  }
+
+  return 'Monorepo workspace';
+}
+
+function printHeader() {
+  console.log('');
+  console.log(title('0to1 Generator Wizard ✨'));
+  console.log(subtle('preset 선택부터 생성 확인까지 전부 인터랙션으로 진행합니다.'));
+  console.log('');
+}
+
+function formatSummary({
+  plan,
+  result,
+  dryRun,
+  fromScaffoldedDir,
+  autoScaffold,
+  includeDocs,
+  useStyles,
+  withCommitlint,
+}) {
+  return {
+    preset: plan.preset,
+    targetDir: plan.targetDir,
+    templateDir: plan.templateDir,
+    dryRun,
+    fromScaffoldedDir,
+    autoScaffold,
+    includeDocs,
+    useStyles,
+    withCommitlint,
+    removePaths: plan.removePaths,
+    templateFileCount: plan.templateFiles.length,
+    runtimeFileCount: plan.runtimeFiles.length,
+    copiedTemplateFileCount: result.copiedTemplateFiles.length,
+    copiedRuntimeFileCount: result.copiedRuntimeFiles.length,
+  };
+}
+
+async function ensureTargetDir(targetDir) {
+  await fs.mkdir(targetDir, {
+    recursive: true,
+  });
+}
+
+async function ensureParentDir(filePath) {
+  await fs.mkdir(path.dirname(filePath), {
+    recursive: true,
+  });
+}
+
+async function ensureTargetDirIsEmpty(targetDir) {
+  const entries = await fs.readdir(targetDir);
+
+  return entries.length === 0;
+}
+
+function getCommandName(command) {
+  if (process.platform === 'win32') {
+    return `${command}.cmd`;
+  }
+
+  return command;
+}
+
+function run(command, args, { cwd = process.cwd() } = {}) {
+  const result = spawnSync(getCommandName(command), args, {
+    cwd,
+    stdio: 'inherit',
+  });
+
+  if (result.status !== 0) {
+    throw new Error(`${command} ${args.join(' ')} 실행에 실패했습니다.`);
+  }
+}
+
+function getCreateViteTarget(targetDir) {
+  return path.relative(process.cwd(), targetDir) || path.basename(targetDir);
+}
+
+function hasDependency(packageJson, packageName) {
+  return Boolean(
+    packageJson?.dependencies?.[packageName] ??
+      packageJson?.devDependencies?.[packageName],
+  );
+}
+
+async function validateReactScaffold(targetDir) {
+  const packageJson = await readPackageJson(targetDir);
+  const isReactProject =
+    hasDependency(packageJson, 'react') && hasDependency(packageJson, '@vitejs/plugin-react');
+  const isTypeScriptProject = hasDependency(packageJson, 'typescript');
+
+  if (isReactProject && isTypeScriptProject) {
+    return;
+  }
+
+  throw new Error(
+    '이 generator는 현재 create-vite에서 React + TypeScript 계열만 지원합니다. create-vite 질문에서 React 프레임워크와 TypeScript variant를 선택해 주세요.',
+  );
+}
+
+async function validateNextScaffold(targetDir, { useStyles = true } = {}) {
+  const packageJson = await readPackageJson(targetDir);
+  const srcAppDirExists = await fileExists(path.join(targetDir, 'src/app'));
+  const tsconfigPath = path.join(targetDir, 'tsconfig.json');
+  const tsconfigText = (await fileExists(tsconfigPath))
+    ? await fs.readFile(tsconfigPath, 'utf8')
+    : '';
+  const hasRequiredDependencies =
+    hasDependency(packageJson, 'next') &&
+    hasDependency(packageJson, 'react') &&
+    hasDependency(packageJson, 'react-dom') &&
+    hasDependency(packageJson, 'typescript') &&
+    hasDependency(packageJson, 'eslint') &&
+    hasDependency(packageJson, 'eslint-config-next') &&
+    (!useStyles ||
+      (hasDependency(packageJson, 'tailwindcss') &&
+        hasDependency(packageJson, '@tailwindcss/postcss')));
+  const hasSupportedAlias =
+    tsconfigText.includes('"@/*"') &&
+    (tsconfigText.includes('"./src/*"') || tsconfigText.includes('["./src/*"]'));
+
+  if (hasRequiredDependencies && srcAppDirExists && hasSupportedAlias) {
+    return;
+  }
+
+  throw new Error(
+    useStyles
+      ? '이 generator는 현재 create-next-app에서 TypeScript + App Router + src dir + Tailwind + ESLint + @/* alias 조합만 지원합니다. create-next-app 질문에서 해당 조합으로 선택해 주세요.'
+      : '이 generator는 현재 create-next-app에서 TypeScript + App Router + src dir + ESLint + @/* alias 조합을 요구합니다. no-style을 선택해도 create-next-app 기본 질문에서는 해당 조건을 맞춰 주세요.',
+  );
+}
+
+async function fileExists(filePath) {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function readPackageJson(targetDir) {
+  const packageJsonPath = path.join(targetDir, 'package.json');
+
+  if (!(await fileExists(packageJsonPath))) {
+    return null;
+  }
+
+  const text = await fs.readFile(packageJsonPath, 'utf8');
+
+  return JSON.parse(text);
+}
+
+function getPackageManagerFromField(packageJson) {
+  const packageManagerField = packageJson?.packageManager;
+
+  if (typeof packageManagerField !== 'string') {
+    return null;
+  }
+
+  const packageManagerName = packageManagerField.split('@')[0];
+
+  if (['npm', 'pnpm', 'yarn', 'bun'].includes(packageManagerName)) {
+    return packageManagerName;
+  }
+
+  return null;
+}
+
+async function detectPackageManager(targetDir) {
+  const packageJson = await readPackageJson(targetDir);
+  const packageManagerFromField = getPackageManagerFromField(packageJson);
+
+  if (packageManagerFromField) {
+    return packageManagerFromField;
+  }
+
+  const lockfileChecks = [
+    ['pnpm-lock.yaml', 'pnpm'],
+    ['yarn.lock', 'yarn'],
+    ['bun.lock', 'bun'],
+    ['bun.lockb', 'bun'],
+    ['package-lock.json', 'npm'],
+    ['npm-shrinkwrap.json', 'npm'],
+  ];
+
+  for (const [lockfileName, packageManager] of lockfileChecks) {
+    if (await fileExists(path.join(targetDir, lockfileName))) {
+      return packageManager;
+    }
+  }
+
+  return 'npm';
+}
+
+function buildAddDependencyArgs(packageManager, packages, { dev = false } = {}) {
+  if (packages.length === 0) {
+    return null;
+  }
+
+  if (packageManager === 'npm') {
+    return ['install', ...(dev ? ['-D'] : []), ...packages];
+  }
+
+  if (packageManager === 'pnpm') {
+    return ['add', ...(dev ? ['-D'] : []), ...packages];
+  }
+
+  if (packageManager === 'yarn') {
+    return ['add', ...(dev ? ['-D'] : []), ...packages];
+  }
+
+  if (packageManager === 'bun') {
+    return ['add', ...(dev ? ['-d'] : []), ...packages];
+  }
+
+  throw new Error(`지원하지 않는 package manager입니다: ${packageManager}`);
+}
+
+function buildRemoveDependencyArgs(packageManager, packages) {
+  if (packages.length === 0) {
+    return null;
+  }
+
+  if (packageManager === 'npm') {
+    return ['uninstall', ...packages];
+  }
+
+  if (packageManager === 'pnpm') {
+    return ['remove', ...packages];
+  }
+
+  if (packageManager === 'yarn') {
+    return ['remove', ...packages];
+  }
+
+  if (packageManager === 'bun') {
+    return ['remove', ...packages];
+  }
+
+  throw new Error(`지원하지 않는 package manager입니다: ${packageManager}`);
+}
+
+async function readJsonFile(filePath) {
+  if (!(await fileExists(filePath))) {
+    return null;
+  }
+
+  const text = await fs.readFile(filePath, 'utf8');
+
+  return JSON.parse(text);
+}
+
+async function writeTextFile(filePath, value, { mode } = {}) {
+  await ensureParentDir(filePath);
+  await fs.writeFile(filePath, value, 'utf8');
+
+  if (typeof mode === 'number') {
+    await fs.chmod(filePath, mode);
+  }
+}
+
+async function writeJsonFile(filePath, value) {
+  await writeTextFile(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+
+async function updateJsonFile(filePath, updater) {
+  const currentValue = (await readJsonFile(filePath)) ?? {};
+  const nextValue = updater(currentValue);
+
+  await writeJsonFile(filePath, nextValue);
+}
+
+function appendScript(existingScript, appendedScript) {
+  if (typeof existingScript !== 'string' || existingScript.trim().length === 0) {
+    return appendedScript;
+  }
+
+  if (existingScript.includes(appendedScript)) {
+    return existingScript;
+  }
+
+  return `${existingScript} && ${appendedScript}`;
+}
+
+function getHuskyScriptName(packageManager) {
+  return packageManager === 'yarn' ? 'postinstall' : 'prepare';
+}
+
+function getPreCommitCommand(packageManager) {
+  if (packageManager === 'pnpm') return 'pnpm lint';
+  if (packageManager === 'yarn') return 'yarn lint';
+  if (packageManager === 'bun') return 'bun run lint';
+  return 'npm run lint';
+}
+
+function getCommitMsgCommand(packageManager) {
+  if (packageManager === 'pnpm') return 'pnpm exec commitlint --edit "$1"';
+  if (packageManager === 'yarn') return 'yarn exec commitlint --edit "$1"';
+  if (packageManager === 'bun') return 'bunx commitlint --edit "$1"';
+  return 'npx --no -- commitlint --edit "$1"';
+}
+
+function getStyleDependencyNames(preset) {
+  if (preset === 'react') {
+    return ['@tailwindcss/vite', 'tailwindcss'];
+  }
+
+  if (preset === 'next') {
+    return ['@tailwindcss/postcss', 'tailwindcss'];
+  }
+
+  return [];
+}
+
+function getReactNoStyleViteConfig() {
+  return `import path from 'node:path';
+
+import react from '@vitejs/plugin-react';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src'),
+    },
+  },
+});
+`;
+}
+
+function getReactNoStyleMainEntry() {
+  return `import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+
+import App from '@/app/app';
+
+createRoot(document.getElementById('root')!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);
+`;
+}
+
+function getNoStyleButton() {
+  return `import type { ButtonHTMLAttributes, ReactNode } from 'react';
+
+export type ButtonProps = {
+  children: ReactNode;
+  isLoading?: boolean;
+} & ButtonHTMLAttributes<HTMLButtonElement>;
+
+export function Button({
+  children,
+  disabled,
+  isLoading = false,
+  className,
+  ...props
+}: ButtonProps) {
+  return (
+    <button disabled={disabled || isLoading} className={className} {...props}>
+      {isLoading ? '저장 중...' : children}
+    </button>
+  );
+}
+`;
+}
+
+function getNoStyleTextInputField() {
+  return `import type { InputHTMLAttributes } from 'react';
+
+export type TextInputFieldProps = {
+  label: string;
+  required?: boolean;
+  error?: string;
+  helperText?: string;
+} & InputHTMLAttributes<HTMLInputElement>;
+
+export function TextInputField({
+  label,
+  required,
+  error,
+  helperText,
+  id,
+  className,
+  ...props
+}: TextInputFieldProps) {
+  const inputId = id ?? props.name;
+
+  return (
+    <div>
+      <label htmlFor={inputId}>
+        {label}
+        {required ? ' *' : null}
+      </label>
+      <input id={inputId} className={className} aria-invalid={error ? true : undefined} {...props} />
+      {error ? <p role="alert">{error}</p> : null}
+      {!error && helperText ? <p>{helperText}</p> : null}
+    </div>
+  );
+}
+`;
+}
+
+function getReactNoStyleGlobalModal() {
+  return `import { useModalStore } from '@/shared/ui/modal-store';
+
+export function GlobalModal() {
+  const { isOpen, title, description, closeModal } = useModalStore();
+
+  if (!isOpen) return null;
+
+  return (
+    <div role="dialog" aria-modal="true" aria-labelledby="global-modal-title">
+      <div>
+        <h2 id="global-modal-title">{title}</h2>
+        {description ? <p>{description}</p> : null}
+        <div>
+          <button type="button" onClick={closeModal}>
+            닫기
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}
+`;
+}
+
+function getNextNoStyleGlobalModal() {
+  return `'use client';
+
+import { useModalStore } from '@/shared/ui/modal-store';
+
+export function GlobalModal() {
+  const { isOpen, title, description, closeModal } = useModalStore();
+
+  if (!isOpen) return null;
+
+  return (
+    <div role="dialog" aria-modal="true" aria-labelledby="global-modal-title">
+      <div>
+        <h2 id="global-modal-title">{title}</h2>
+        {description ? <p>{description}</p> : null}
+        <div>
+          <button type="button" onClick={closeModal}>
+            닫기
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}
+`;
+}
+
+function getReactNoStyleHomePage() {
+  return `/**
+ * 템플릿 첫 화면 예시입니다.
+ * 프로젝트 소개나 대시보드 시작 화면으로 교체해서 사용하세요.
+ */
+export default function HomePage() {
+  return (
+    <main>
+      <section>
+        <p>템플릿</p>
+        <h1>필요한 기본값과 필수 전역 처리를 갖춘 Vite React 프론트엔드 스타터</h1>
+        <p>
+          이 템플릿은 feature-first 구조, React Router, TanStack Query, request helper, shared
+          utilities처럼 초기에 바로 필요한 것만 포함합니다.
+        </p>
+      </section>
+
+      <section>
+        <h2>기본 라우팅 흐름까지 바로 시작</h2>
+        <ul>
+          <li>
+            <code>src/pages/**/page.tsx</code> 파일은 자동으로 React Router 경로가 됩니다.
+          </li>
+          <li>
+            <code>react-router-dom</code>, Query, request helper를 기본으로 포함했습니다.
+          </li>
+          <li>
+            폼/목록 예제가 필요하면 <code>npm run create:feature -- products</code>로 생성할 수
+            있습니다.
+          </li>
+        </ul>
+      </section>
+    </main>
+  );
+}
+`;
+}
+
+function getReactNoStyleLoginPage() {
+  return `/**
+ * 인증 흐름 예시를 위한 로그인 플레이스홀더 화면입니다.
+ * 프로젝트의 실제 로그인 페이지로 교체해서 사용하세요.
+ */
+export default function LoginPage() {
+  return (
+    <main>
+      <section>
+        <p>로그인</p>
+        <h1>로그인이 필요합니다</h1>
+        <p>
+          기본 템플릿은 인증 오류가 발생하면 이 경로로 이동할 수 있습니다. 프로젝트 로그인 화면으로
+          교체하세요.
+        </p>
+      </section>
+    </main>
+  );
+}
+`;
+}
+
+function getReactNoStyleFrame() {
+  return `import { Outlet, useNavigation } from 'react-router-dom';
+
+/**
+ * 앱 공통 레이아웃 예시입니다.
+ * 공통 헤더, 인증 리스너, 전역 모달 연결이 필요하면 여기서 추가해서 사용하세요.
+ */
+export function AppFrame() {
+  const navigation = useNavigation();
+  const isRoutePending = navigation.state !== 'idle';
+
+  return (
+    <div>
+      {isRoutePending ? (
+        <div role="status" aria-live="polite">
+          페이지를 불러오는 중입니다.
+        </div>
+      ) : null}
+      <Outlet />
+    </div>
+  );
+}
+`;
+}
+
+function getReactNoStyleErrorBoundary() {
+  return `import { Component, type ErrorInfo, type ReactNode } from 'react';
+
+type AppErrorBoundaryProps = {
+  children: ReactNode;
+};
+
+type AppErrorBoundaryState = {
+  error: Error | null;
+  retryKey: number;
+};
+
+export class AppErrorBoundary extends Component<AppErrorBoundaryProps, AppErrorBoundaryState> {
+  state: AppErrorBoundaryState = {
+    error: null,
+    retryKey: 0,
+  };
+
+  static getDerivedStateFromError(error: Error): Partial<AppErrorBoundaryState> {
+    return {
+      error,
+    };
+  }
+
+  componentDidCatch(error: Error, errorInfo: ErrorInfo) {
+    console.error(error, errorInfo);
+  }
+
+  handleRetry = () => {
+    this.setState((prevState) => ({
+      error: null,
+      retryKey: prevState.retryKey + 1,
+    }));
+  };
+
+  render() {
+    if (this.state.error) {
+      return (
+        <main>
+          <section>
+            <p>오류</p>
+            <h1>문제가 발생했습니다.</h1>
+            <p>요청을 처리하는 중 오류가 발생했습니다. 잠시 후 다시 시도해주세요.</p>
+            <button type="button" onClick={this.handleRetry}>
+              다시 시도
+            </button>
+          </section>
+        </main>
+      );
+    }
+
+    return <div key={this.state.retryKey}>{this.props.children}</div>;
+  }
+}
+`;
+}
+
+function getReactNoStyleNotFoundPage() {
+  return `import { Link } from 'react-router-dom';
+
+import { routePaths } from '@/shared/routes/route-paths';
+
+export function NotFoundPage() {
+  return (
+    <main>
+      <section>
+        <p>404</p>
+        <h1>페이지를 찾을 수 없습니다</h1>
+        <p>주소가 잘못되었거나, 페이지가 이동되었을 수 있습니다.</p>
+        <Link to={routePaths.home}>홈으로 이동</Link>
+      </section>
+    </main>
+  );
+}
+`;
+}
+
+function getNextNoStyleLayout() {
+  return `import type { Metadata } from 'next';
+
+import { AppProviders } from '@/app/providers';
+
+export const metadata: Metadata = {
+  title: 'Next 프론트엔드 템플릿',
+  description: '가벼운 기본값과 필수 전역 에러 처리를 갖춘 Next.js 시작 템플릿',
+};
+
+/**
+ * 앱 공통 레이아웃 예시입니다.
+ * 메타데이터와 전역 provider 구성을 프로젝트에 맞게 바꿔서 사용하세요.
+ */
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="ko">
+      <body>
+        <AppProviders>{children}</AppProviders>
+      </body>
+    </html>
+  );
+}
+`;
+}
+
+function getNextNoStyleHomePage() {
+  return `/**
+ * 템플릿 첫 화면 예시입니다.
+ * 프로젝트 소개나 대시보드 시작 화면으로 교체해서 사용하세요.
+ */
+export default function Home() {
+  return (
+    <main>
+      <section>
+        <p>템플릿</p>
+        <h1>필요한 기본값과 필수 전역 처리를 갖춘 Next.js 프론트엔드 스타터</h1>
+        <p>
+          이 템플릿은 feature-first 구조, TanStack Query, request helper, shared utilities와
+          공통 인증/에러 반응처럼 초기에 바로 필요한 것만 포함합니다.
+        </p>
+      </section>
+
+      <section>
+        <h2>최소 기능도 끊기지 않게</h2>
+        <ul>
+          <li>기본 provider는 Query와 공통 에러 반응만 연결해 두어 시작 비용을 낮췄습니다.</li>
+          <li>인증 만료 redirect와 네트워크/권한 오류 모달은 기본 동작으로 포함합니다.</li>
+          <li>
+            폼/목록 예제가 필요하면 <code>npm run create:feature -- products</code>로 생성할 수
+            있습니다.
+          </li>
+        </ul>
+      </section>
+    </main>
+  );
+}
+`;
+}
+
+function getNextNoStyleLoginPage() {
+  return `/**
+ * 인증 흐름 예시를 위한 로그인 플레이스홀더 화면입니다.
+ * 프로젝트의 실제 로그인 페이지로 교체해서 사용하세요.
+ */
+export default function LoginPage() {
+  return (
+    <main>
+      <section>
+        <p>로그인</p>
+        <h1>로그인이 필요합니다</h1>
+        <p>
+          기본 템플릿은 인증 오류가 발생하면 이 경로로 이동합니다. 프로젝트 로그인 화면으로
+          교체하세요.
+        </p>
+      </section>
+    </main>
+  );
+}
+`;
+}
+
+function getNextNoStyleErrorPage() {
+  return `'use client';
+
+import { useEffect } from 'react';
+
+type AppErrorPageProps = {
+  error: Error & { digest?: string };
+  unstable_retry: () => void;
+};
+
+export default function AppErrorPage({ error, unstable_retry }: AppErrorPageProps) {
+  useEffect(() => {
+    console.error(error);
+  }, [error]);
+
+  return (
+    <main>
+      <section>
+        <p>오류</p>
+        <h1>문제가 발생했습니다.</h1>
+        <p>요청을 처리하는 중 오류가 발생했습니다. 잠시 후 다시 시도해주세요.</p>
+        <button type="button" onClick={() => unstable_retry()}>
+          다시 시도
+        </button>
+      </section>
+    </main>
+  );
+}
+`;
+}
+
+async function removeTargetPath(filePath) {
+  await fs.rm(filePath, {
+    force: true,
+    recursive: true,
+  });
+}
+
+async function applyReactNoStyleFiles(targetDir) {
+  await writeTextFile(path.join(targetDir, 'vite.config.ts'), getReactNoStyleViteConfig());
+  await writeTextFile(path.join(targetDir, 'src', 'main.tsx'), getReactNoStyleMainEntry());
+  await writeTextFile(path.join(targetDir, 'src', 'app', 'frame.tsx'), getReactNoStyleFrame());
+  await writeTextFile(
+    path.join(targetDir, 'src', 'app', 'error-boundary.tsx'),
+    getReactNoStyleErrorBoundary(),
+  );
+  await writeTextFile(
+    path.join(targetDir, 'src', 'app', 'not-found-page.tsx'),
+    getReactNoStyleNotFoundPage(),
+  );
+  await writeTextFile(
+    path.join(targetDir, 'src', 'pages', 'index', 'page.tsx'),
+    getReactNoStyleHomePage(),
+  );
+  await writeTextFile(
+    path.join(targetDir, 'src', 'pages', 'login', 'page.tsx'),
+    getReactNoStyleLoginPage(),
+  );
+  await writeTextFile(path.join(targetDir, 'src', 'shared', 'ui', 'button.tsx'), getNoStyleButton());
+  await writeTextFile(
+    path.join(targetDir, 'src', 'shared', 'ui', 'text-input-field.tsx'),
+    getNoStyleTextInputField(),
+  );
+  await writeTextFile(
+    path.join(targetDir, 'src', 'shared', 'ui', 'global-modal.tsx'),
+    getReactNoStyleGlobalModal(),
+  );
+  await removeTargetPath(path.join(targetDir, 'src', 'app', 'globals.css'));
+}
+
+async function applyNextNoStyleFiles(targetDir) {
+  await writeTextFile(path.join(targetDir, 'src', 'app', 'layout.tsx'), getNextNoStyleLayout());
+  await writeTextFile(path.join(targetDir, 'src', 'app', 'page.tsx'), getNextNoStyleHomePage());
+  await writeTextFile(
+    path.join(targetDir, 'src', 'app', 'login', 'page.tsx'),
+    getNextNoStyleLoginPage(),
+  );
+  await writeTextFile(path.join(targetDir, 'src', 'app', 'error.tsx'), getNextNoStyleErrorPage());
+  await writeTextFile(path.join(targetDir, 'src', 'shared', 'ui', 'button.tsx'), getNoStyleButton());
+  await writeTextFile(
+    path.join(targetDir, 'src', 'shared', 'ui', 'text-input-field.tsx'),
+    getNoStyleTextInputField(),
+  );
+  await writeTextFile(
+    path.join(targetDir, 'src', 'shared', 'ui', 'global-modal.tsx'),
+    getNextNoStyleGlobalModal(),
+  );
+  await removeTargetPath(path.join(targetDir, 'src', 'app', 'globals.css'));
+  await removeTargetPath(path.join(targetDir, 'postcss.config.mjs'));
+}
+
+async function applyStandaloneStyleMode(preset, targetDir, { useStyles = true } = {}) {
+  if (preset !== 'react' && preset !== 'next') {
+    return;
+  }
+
+  if (useStyles) {
+    return;
+  }
+
+  if (preset === 'react') {
+    await applyReactNoStyleFiles(targetDir);
+    return;
+  }
+
+  await applyNextNoStyleFiles(targetDir);
+}
+
+async function copyDevelopmentPrinciplesDocs(workspaceRoot, targetDir) {
+  const sourceDir = path.join(
+    workspaceRoot,
+    'templates',
+    'shared',
+    'docs',
+    '개발원칙',
+  );
+  const targetDocsDir = path.join(targetDir, 'docs', '개발원칙');
+
+  if (!(await fileExists(sourceDir))) {
+    throw new Error(`개발 원칙 문서를 찾지 못했습니다: ${sourceDir}`);
+  }
+
+  await fs.mkdir(path.dirname(targetDocsDir), {
+    recursive: true,
+  });
+  await fs.cp(sourceDir, targetDocsDir, {
+    recursive: true,
+  });
+}
+
+function runPackageScript(packageManager, scriptName, cwd) {
+  if (packageManager === 'yarn') {
+    run('yarn', ['run', scriptName], { cwd });
+    return;
+  }
+
+  run(packageManager, ['run', scriptName], { cwd });
+}
+
+async function enableCommitlint(targetDir, packageManager) {
+  const packageJsonPath = path.join(targetDir, 'package.json');
+  const huskyScriptName = getHuskyScriptName(packageManager);
+  const huskyInstallScript = 'node .husky/install.mjs';
+
+  await updateJsonFile(packageJsonPath, (packageJson) => ({
+    ...packageJson,
+    scripts: {
+      ...(packageJson.scripts ?? {}),
+      [huskyScriptName]: appendScript(packageJson.scripts?.[huskyScriptName], huskyInstallScript),
+    },
+  }));
+
+  await writeTextFile(
+    path.join(targetDir, '.husky', 'install.mjs'),
+    `import fs from 'node:fs';
+import path from 'node:path';
+
+const rootDir = process.cwd();
+const gitPath = path.join(rootDir, '.git');
+
+if (
+  process.env.NODE_ENV === 'production' ||
+  process.env.CI === 'true' ||
+  process.env.HUSKY === '0'
+) {
+  process.exit(0);
+}
+
+if (!fs.existsSync(gitPath)) {
+  process.exit(0);
+}
+
+try {
+  const husky = (await import('husky')).default;
+  husky();
+} catch {
+  process.exit(0);
+}
+`,
+  );
+  await writeTextFile(
+    path.join(targetDir, '.husky', 'pre-commit'),
+    `${getPreCommitCommand(packageManager)}\n`,
+    { mode: 0o755 },
+  );
+  await writeTextFile(
+    path.join(targetDir, '.husky', 'commit-msg'),
+    `${getCommitMsgCommand(packageManager)}\n`,
+    { mode: 0o755 },
+  );
+  await writeTextFile(
+    path.join(targetDir, 'commitlint.config.mjs'),
+    `const commitlintConfig = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [2, 'always', ['feat', 'fix', 'docs', 'style', 'refactor', 'test', 'chore']],
+  },
+};
+
+export default commitlintConfig;
+`,
+  );
+
+  runPackageScript(packageManager, huskyScriptName, targetDir);
+}
+
+async function syncStandaloneDependencies(
+  preset,
+  targetDir,
+  { useStyles = true, withCommitlint = false } = {},
+) {
+  if (preset !== 'react' && preset !== 'next') {
+    return {
+      packageManager: null,
+      dependencyCount: 0,
+      devDependencyCount: 0,
+    };
+  }
+
+  const dependencyManifest = getStandaloneDependencyManifest(preset);
+  const packageManager = await detectPackageManager(targetDir);
+  const styleDependencyNames = getStyleDependencyNames(preset);
+  const packageJsonBeforeSync = await readPackageJson(targetDir);
+  const removableStyleDependencies = !useStyles
+    ? styleDependencyNames.filter((packageName) =>
+        hasDependency(packageJsonBeforeSync, packageName),
+      )
+    : [];
+  const filteredDevDependencies = dependencyManifest.devDependencies.filter(
+    (packageName) => useStyles || !styleDependencyNames.includes(packageName),
+  );
+  const optionalDevDependencies = withCommitlint
+    ? [
+        ...(filteredDevDependencies.includes('husky') ? [] : ['husky']),
+        '@commitlint/cli',
+        '@commitlint/config-conventional',
+      ]
+    : [];
+  const removeDependencyArgs = buildRemoveDependencyArgs(
+    packageManager,
+    removableStyleDependencies,
+  );
+  const dependencyArgs = buildAddDependencyArgs(
+    packageManager,
+    dependencyManifest.dependencies,
+  );
+  const devDependencyArgs = buildAddDependencyArgs(
+    packageManager,
+    filteredDevDependencies,
+    { dev: true },
+  );
+  const optionalDevDependencyArgs = buildAddDependencyArgs(
+    packageManager,
+    optionalDevDependencies,
+    { dev: true },
+  );
+
+  console.log('');
+  console.log(
+    info(
+      `${packageManager} 기준으로 ${preset} 추가 의존성을 최신 버전으로 동기화합니다.`,
+    ),
+  );
+  console.log(
+    subtle(
+      `deps ${dependencyManifest.dependencies.length}개, devDeps ${filteredDevDependencies.length + optionalDevDependencies.length}개를 package manager 기본 정책으로 반영합니다.`,
+    ),
+  );
+  console.log('');
+
+  if (removeDependencyArgs) {
+    run(packageManager, removeDependencyArgs, { cwd: targetDir });
+  }
+
+  // 버전 문자열을 템플릿에 고정하지 않고 생성 시점의 package manager가
+  // 현재 레지스트리 기준 범위를 package.json에 기록하도록 맡깁니다.
+  if (dependencyArgs) {
+    run(packageManager, dependencyArgs, { cwd: targetDir });
+  }
+
+  if (devDependencyArgs) {
+    run(packageManager, devDependencyArgs, { cwd: targetDir });
+  }
+
+  if (optionalDevDependencyArgs) {
+    run(packageManager, optionalDevDependencyArgs, { cwd: targetDir });
+  }
+
+  return {
+    packageManager,
+    dependencyCount: dependencyManifest.dependencies.length,
+    devDependencyCount: filteredDevDependencies.length + optionalDevDependencies.length,
+  };
+}
+
+function scaffoldReactProject(targetDir) {
+  console.log('');
+  console.log(info('create-vite 기본 인터랙션으로 React scaffold를 준비합니다.'));
+  console.log('');
+
+  run('npx', [
+    'create-vite@latest',
+    getCreateViteTarget(targetDir),
+    '--no-immediate',
+  ]);
+}
+
+function scaffoldNextProject(targetDir) {
+  console.log('');
+  console.log(info('create-next-app 기본 인터랙션으로 Next scaffold를 준비합니다.'));
+  console.log('');
+
+  // create-next-app은 옵션이 하나라도 들어가면 내부적으로 defaults mode로
+  // 넘어가서 기본 질문을 건너뛸 수 있습니다. Next native 질문을 살리려면
+  // project path 외에는 넘기지 않는 편이 가장 안전합니다.
+  run('npx', [
+    'create-next-app@latest',
+    targetDir,
+  ]);
+}
+
+async function askQuestion(rl, promptText, { defaultValue = '' } = {}) {
+  const suffix = defaultValue ? ` ${subtle(`(${defaultValue})`)}` : '';
+  const answer = await rl.question(`${paint('›', ansi.bold, ansi.blue)} ${promptText}${suffix}: `);
+  const trimmed = answer.trim();
+
+  if (!trimmed && defaultValue) {
+    return defaultValue;
+  }
+
+  return trimmed;
+}
+
+async function askChoice(rl, heading, choices) {
+  console.log(title(heading));
+
+  choices.forEach((choice, index) => {
+    console.log(`  ${accent(String(index + 1))}. ${choice.label}`);
+    console.log(`     ${subtle(choice.description)}`);
+  });
+
+  console.log('');
+
+  while (true) {
+    const answer = await askQuestion(rl, '번호를 입력해 주세요');
+    const selectedIndex = Number.parseInt(answer, 10) - 1;
+
+    if (Number.isInteger(selectedIndex) && choices[selectedIndex]) {
+      console.log('');
+      return choices[selectedIndex];
+    }
+
+    console.log(danger('올바른 번호를 입력해 주세요.'));
+    console.log('');
+  }
+}
+
+async function askStyleMode(rl, heading) {
+  const styleChoice = await askChoice(rl, heading, [
+    {
+      label: 'Tailwind 포함',
+      value: 'tailwind',
+      description: '기본 스타일과 Tailwind 구성을 함께 생성합니다.',
+    },
+    {
+      label: 'No Style',
+      value: 'no-style',
+      description: '스타일 파일과 Tailwind 의존성 없이 구조와 로직 위주로 생성합니다.',
+    },
+  ]);
+
+  return styleChoice.value === 'tailwind';
+}
+
+async function askCommitlintInclusion(rl, heading) {
+  const commitlintChoice = await askChoice(rl, heading, [
+    {
+      label: '포함 안 함',
+      value: 'exclude',
+      description: 'husky와 commitlint 설정을 추가하지 않습니다.',
+    },
+    {
+      label: '같이 포함',
+      value: 'include',
+      description: 'commitlint 설정과 husky hook을 함께 구성합니다.',
+    },
+  ]);
+
+  return commitlintChoice.value === 'include';
+}
+
+async function askDocsInclusion(rl, heading) {
+  const docsChoice = await askChoice(rl, heading, [
+    {
+      label: '포함 안 함',
+      value: 'exclude',
+      description: '문서는 generator 안에서만 중앙 관리하고 생성물에는 넣지 않습니다.',
+    },
+    {
+      label: '같이 포함',
+      value: 'include',
+      description: '생성물 루트에 docs/개발원칙을 같이 복사합니다.',
+    },
+  ]);
+
+  return docsChoice.value === 'include';
+}
+
+async function askFinalConfirmation(rl, heading) {
+  const confirmationChoice = await askChoice(rl, heading, [
+    {
+      label: '바로 진행',
+      value: 'confirm',
+      description: '지금 고른 설정으로 scaffold와 generator 적용을 진행합니다.',
+    },
+    {
+      label: '취소',
+      value: 'cancel',
+      description: '아무 작업도 하지 않고 wizard를 종료합니다.',
+    },
+  ]);
+
+  return confirmationChoice.value === 'confirm';
+}
+
+function printExecutionNotes(preset, executionChoice) {
+  if (preset === 'react' || preset === 'next') {
+    if (executionChoice.value === 'scaffolded-apply') {
+      console.log(
+        warning(
+          `${preset}는 기존 scaffolded dir에도 적용할 수 있습니다. 현재 디렉터리 상태를 확인하고 진행해 주세요.`,
+        ),
+      );
+      console.log('');
+    }
+
+    if (executionChoice.value === 'auto-scaffold') {
+      if (preset === 'react') {
+        console.log(
+          subtle(
+            'React auto scaffold는 create-vite 기본 인터랙션을 그대로 넘깁니다.',
+          ),
+        );
+        console.log(
+          subtle(
+            '현재 generator 계약상 create-vite 안에서는 React 프레임워크와 TypeScript 계열 variant를 골라야 합니다.',
+          ),
+        );
+      }
+
+      if (preset === 'next') {
+        console.log(
+          subtle(
+            'Next auto scaffold는 create-next-app 기본 인터랙션을 그대로 넘깁니다.',
+          ),
+        );
+        console.log(
+          subtle(
+            '옵션을 미리 넘기면 defaults mode로 넘어갈 수 있어서, generator도 path 외에는 create-next-app 옵션을 강제로 넣지 않습니다.',
+          ),
+        );
+        console.log(
+          subtle(
+            '현재 generator 계약상 TypeScript + App Router + src dir + Tailwind + ESLint + @/* alias 조합으로 선택해 주셔야 합니다.',
+          ),
+        );
+        console.log(
+          subtle(
+            '참고로 create-next-app의 recommended defaults에는 현재 No src/ directory가 포함되어 있어서, customize settings로 들어가시는 편이 안전합니다.',
+          ),
+        );
+      }
+
+      console.log('');
+    }
+  }
+}
+
+function printPlannedSelections({
+  preset,
+  executionChoice,
+  targetArg,
+  useStyles,
+  withCommitlint,
+  includeDocs,
+}) {
+  console.log(title('선택한 설정'));
+  console.log(`  ${title('preset')} ${formatPresetLabel(preset)}`);
+  console.log(`  ${title('실행 방식')} ${executionChoice.label}`);
+  console.log(`  ${title('target')} ${targetArg}`);
+
+  if (preset === 'react' || preset === 'next') {
+    console.log(`  ${title('스타일')} ${useStyles ? 'Tailwind 포함' : 'No Style'}`);
+    console.log(`  ${title('commitlint')} ${withCommitlint ? '같이 포함' : '포함 안 함'}`);
+  }
+
+  console.log(`  ${title('docs/개발원칙')} ${includeDocs ? '같이 포함' : '포함 안 함'}`);
+  console.log('');
+}
+
+async function collectInteractiveOptions() {
+  const rl = readline.createInterface({
+    input,
+    output,
+  });
+
+  try {
+    printHeader();
+    const nextStepTitle = createStepTitleBuilder();
+
+    const presetChoice = await askChoice(
+      rl,
+      nextStepTitle('생성할 preset을 선택해 주세요'),
+      PRESET_CHOICES,
+    );
+    const executionChoice = await askChoice(
+      rl,
+      nextStepTitle('실행 방식을 선택해 주세요'),
+      EXECUTION_CHOICES[presetChoice.value],
+    );
+
+    printExecutionNotes(presetChoice.value, executionChoice);
+
+    const targetArg = await askQuestion(
+      rl,
+      nextStepTitle('target 디렉터리 경로를 입력해 주세요'),
+      {
+        defaultValue: `./playground/${presetChoice.value}-app`,
+      },
+    );
+    const useStyles =
+      presetChoice.value === 'react' || presetChoice.value === 'next'
+        ? await askStyleMode(rl, nextStepTitle('스타일 모드를 선택해 주세요'))
+        : true;
+    const withCommitlint =
+      presetChoice.value === 'react' || presetChoice.value === 'next'
+        ? await askCommitlintInclusion(
+            rl,
+            nextStepTitle('commitlint와 husky 포함 여부를 선택해 주세요'),
+          )
+        : false;
+    const includeDocs = await askDocsInclusion(
+      rl,
+      nextStepTitle('docs/개발원칙 포함 여부를 선택해 주세요'),
+    );
+
+    if (
+      presetChoice.value === 'next' &&
+      executionChoice.value === 'auto-scaffold' &&
+      !useStyles
+    ) {
+      console.log(
+        subtle(
+          'Next no-style을 선택해도 create-next-app 질문에서는 TypeScript + App Router + src dir + ESLint + @/* alias는 꼭 맞춰 주세요.',
+        ),
+      );
+      console.log('');
+    }
+
+    printPlannedSelections({
+      preset: presetChoice.value,
+      executionChoice,
+      targetArg,
+      useStyles,
+      withCommitlint,
+      includeDocs,
+    });
+
+    const confirmed = await askFinalConfirmation(
+      rl,
+      nextStepTitle('이 설정으로 진행할까요?'),
+    );
+
+    if (!confirmed) {
+      throw new Error('사용자 취소로 종료했습니다.');
+    }
+
+    return {
+      preset: presetChoice.value,
+      targetArg,
+      dryRun: false,
+      fromScaffoldedDir: executionChoice.value === 'scaffolded-apply',
+      autoScaffold: executionChoice.value === 'auto-scaffold',
+      useStyles,
+      withCommitlint,
+      includeDocs,
+    };
+  } finally {
+    rl.close();
+  }
+}
+
+function printSummary(summary) {
+  const modeLabel = summary.dryRun
+    ? '계획만 확인'
+    : summary.autoScaffold
+      ? '자동 scaffold 후 생성'
+      : summary.fromScaffoldedDir
+        ? 'scaffolded dir에 적용'
+        : '바로 생성';
+
+  console.log('');
+  console.log(success(summary.dryRun ? '계획 확인이 완료되었습니다.' : '파일 생성이 완료되었습니다.'));
+  console.log('');
+  console.log(`${title('preset')} ${formatPresetLabel(summary.preset)}`);
+  console.log(`${title('target')} ${summary.targetDir}`);
+  console.log(`${title('실행 방식')} ${modeLabel}`);
+  if (summary.preset === 'react' || summary.preset === 'next') {
+    console.log(`${title('스타일')} ${summary.useStyles ? 'Tailwind 포함' : 'No Style'}`);
+    console.log(`${title('commitlint')} ${summary.withCommitlint ? '같이 포함' : '포함 안 함'}`);
+  }
+  console.log(`${title('docs/개발원칙')} ${summary.includeDocs ? '같이 포함' : '포함 안 함'}`);
+  console.log(`${title('정리 대상 경로')} ${summary.removePaths.length}`);
+  console.log(`${title('template 파일')} ${summary.templateFileCount}`);
+  console.log(`${title('runtime 파일')} ${summary.runtimeFileCount}`);
+  console.log('');
+}
+
+async function main() {
+  if (process.argv.length > 2) {
+    throw new Error('이 create 명령은 이제 인자 대신 인터랙션으로만 동작합니다. 그냥 실행해 주세요.');
+  }
+
+  const options = await collectInteractiveOptions();
+  const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+  const workspaceRoot = path.resolve(scriptDir, '..');
+  const targetDir = path.resolve(process.cwd(), options.targetArg);
+
+  await ensureTargetDir(targetDir);
+  const targetDirIsEmpty = await ensureTargetDirIsEmpty(targetDir);
+
+  if (
+    !options.dryRun &&
+    (options.preset === 'react' || options.preset === 'next') &&
+    !options.fromScaffoldedDir &&
+    !options.autoScaffold
+  ) {
+    throw new Error(
+      `${options.preset} preset은 auto scaffold 또는 scaffolded dir apply 모드에서만 실행할 수 있습니다.`,
+    );
+  }
+
+  if (
+    !options.dryRun &&
+    (options.preset === 'react' || options.preset === 'next') &&
+    options.fromScaffoldedDir &&
+    targetDirIsEmpty
+  ) {
+    throw new Error(
+      'scaffolded dir apply는 이미 create-vite 또는 create-next-app 결과가 들어 있는 디렉터리에서만 실행할 수 있습니다. 현재 target dir이 비어 있습니다.',
+    );
+  }
+
+  if (
+    !options.dryRun &&
+    (options.preset === 'react' || options.preset === 'next') &&
+    options.autoScaffold &&
+    !targetDirIsEmpty
+  ) {
+    throw new Error(
+      'auto scaffold 모드는 비어 있는 target dir에서만 실행할 수 있습니다.',
+    );
+  }
+
+  if (!options.dryRun && options.preset === 'monorepo' && !targetDirIsEmpty) {
+    throw new Error(
+      'monorepo preset은 비어 있는 target dir에서만 바로 생성할 수 있습니다.',
+    );
+  }
+
+  if (!options.dryRun && options.autoScaffold) {
+    if (options.preset === 'react') {
+      scaffoldReactProject(targetDir);
+      await validateReactScaffold(targetDir);
+    }
+
+    if (options.preset === 'next') {
+      scaffoldNextProject(targetDir);
+      await validateNextScaffold(targetDir, {
+        useStyles: options.useStyles,
+      });
+    }
+  }
+
+  const plan = await buildProjectGenerationPlan({
+    workspaceRoot,
+    targetDir,
+    preset: options.preset,
+  });
+
+  const result = await executeProjectGenerationPlan({
+    plan,
+    dryRun: options.dryRun,
+  });
+
+  let dependencySyncResult = {
+    packageManager: null,
+    dependencyCount: 0,
+    devDependencyCount: 0,
+  };
+
+  if (!options.dryRun && options.includeDocs) {
+    await copyDevelopmentPrinciplesDocs(workspaceRoot, targetDir);
+  }
+
+  if (!options.dryRun && (options.preset === 'react' || options.preset === 'next')) {
+    await applyStandaloneStyleMode(options.preset, targetDir, {
+      useStyles: options.useStyles,
+    });
+  }
+
+  if (!options.dryRun && (options.preset === 'react' || options.preset === 'next')) {
+    dependencySyncResult = await syncStandaloneDependencies(options.preset, targetDir, {
+      useStyles: options.useStyles,
+      withCommitlint: options.withCommitlint,
+    });
+  }
+
+  if (
+    !options.dryRun &&
+    (options.preset === 'react' || options.preset === 'next') &&
+    options.withCommitlint &&
+    dependencySyncResult.packageManager
+  ) {
+    await enableCommitlint(targetDir, dependencySyncResult.packageManager);
+  }
+
+  const summary = formatSummary({
+    plan,
+    result,
+    dryRun: options.dryRun,
+    fromScaffoldedDir: options.fromScaffoldedDir,
+    autoScaffold: options.autoScaffold,
+    includeDocs: options.includeDocs,
+    useStyles: options.useStyles,
+    withCommitlint: options.withCommitlint,
+  });
+
+  printSummary(summary);
+
+  if (options.autoScaffold && !options.dryRun) {
+    console.log(subtle('upstream scaffold -> generator apply 흐름까지 완료되었습니다.'));
+    console.log('');
+  }
+
+  if (dependencySyncResult.packageManager) {
+    console.log(
+      subtle(
+        `${dependencySyncResult.packageManager}로 deps ${dependencySyncResult.dependencyCount}개 / devDeps ${dependencySyncResult.devDependencyCount}개 최신 버전 동기화를 마쳤습니다.`,
+      ),
+    );
+    console.log('');
+  }
+
+  if (!options.dryRun && options.includeDocs) {
+    console.log(subtle('docs/개발원칙 문서를 생성물에 함께 복사했습니다.'));
+    console.log('');
+  }
+}
+
+main().catch((error) => {
+  console.log('');
+  console.log(danger(error instanceof Error ? error.message : String(error)));
+  console.log('');
+  process.exit(1);
+});