sh-ui-cli 0.56.4 → 0.58.0

package/src/create/generator.js

@@ -4,6 +4,11 @@ import fs from 'fs-extra';
 import os from 'node:os';
 import path from 'node:path';
 import { getPluginChoices, getPluginsByNames } from './plugins/index.js';
+import {
+  assertArchPlatformCompat,
+  getArchesForPlatform,
+  DEFAULT_ARCH,
+} from './architectures/index.js';
 import { resolveTheme } from './theme/decode.js';
 import { THEME_PRESETS, getThemePreset } from './theme/presets.js';
 import {
@@ -90,6 +95,19 @@ export async function createProject(options = {}) {
     ],
   });
 
+  // arch 결정 — platform 확정 후. 사용자가 --arch 미지정 시:
+  //   - next  → DEFAULT_ARCH ('fsd')
+  //   - flutter → 현재 Flutter arch 디스크립터 없음 → null. 미래에 flutter arch 추가되면
+  //     해당 platform 의 첫 번째 arch 또는 별도 default 로 변경.
+  // 명시한 경우 platform 호환성 검증 후 디스크립터 resolve. 잘못된 조합은 친절한 에러.
+  let arch = null;
+  if (platform === 'next') {
+    const archName = options.arch ?? DEFAULT_ARCH;
+    arch = assertArchPlatformCompat(archName, 'next');
+  } else if (platform === 'flutter' && options.arch) {
+    arch = assertArchPlatformCompat(options.arch, 'flutter');
+  }
+
   // CSS 프레임워크 — 현재는 plain 만 지원하지만, 곧 추가될 옵션을 disabled 로
   // 미리 노출해 사용자가 변종 시스템의 존재를 인지할 수 있게 한다.
   // Flutter 는 CSS 프레임워크 개념이 무의미하므로 자동 plain.
@@ -186,9 +204,9 @@ export async function createProject(options = {}) {
   plugins.sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0));
 
   if (projectType === 'standalone') {
-    await generateStandalone(targetDir, projectName, plugins, theme, cssFramework);
+    await generateStandalone(targetDir, projectName, plugins, theme, cssFramework, arch);
   } else {
-    await generateMonorepo(targetDir, projectName, plugins, { yes: options.yes, theme, css: cssFramework });
+    await generateMonorepo(targetDir, projectName, plugins, { yes: options.yes, theme, css: cssFramework, arch });
   }
 
   await finalizeProject(targetDir, { dryRun: options.dryRun });
@@ -267,7 +285,13 @@ export async function addApp() {
     return;
   }
 
-  await generateApp(appsDir, appName, port, plugins);
+  // addApp 은 기존 monorepo 의 새 앱 추가 — arch 는 일관성을 위해 모노레포가 처음
+  // 만들어질 때 정한 값과 같아야 한다. 현재는 root sh-ui.config.json 등에 별도 저장
+  // 안 해 두므로 일단 DEFAULT_ARCH (fsd) 로 fallback. 향후 root config 에 arch 박아두고
+  // 여기서 읽어오는 흐름으로 개선 가능.
+  const arch = assertArchPlatformCompat(DEFAULT_ARCH, 'next');
+
+  await generateApp(appsDir, appName, port, plugins, arch);
 
   console.log(`\n✅ apps/${appName} 이 추가되었습니다!`);
   console.log('\n  pnpm install');
@@ -355,8 +379,16 @@ async function generateFlutter(targetDir, projectName, theme, css) {
   await patchShUiConfig(path.join(targetDir, 'sh-ui.config.json'), css);
 }
 
-async function generateStandalone(targetDir, projectName, plugins, theme, css) {
-  await fs.copy(path.join(TEMPLATES_DIR, 'nextjs-standalone'), targetDir);
+async function generateStandalone(targetDir, projectName, plugins, theme, css, arch) {
+  // 베이스 (arch-neutral) + arch 오버레이 — generateApp 과 같은 패턴.
+  await fs.copy(path.join(TEMPLATES_DIR, 'nextjs-standalone'), targetDir, {
+    filter: (src) => !src.includes(`${path.sep}_arch${path.sep}`) && !src.endsWith(`${path.sep}_arch`),
+  });
+  await fs.copy(
+    path.join(TEMPLATES_DIR, 'nextjs-standalone', '_arch', arch.name),
+    targetDir,
+    { overwrite: true },
+  );
 
   // Update package.json
   const pkgPath = path.join(targetDir, 'package.json');
@@ -372,16 +404,16 @@ async function generateStandalone(targetDir, projectName, plugins, theme, css) {
   }
   await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 
-  await writeNextConfig(targetDir, plugins, { isMonorepo: false });
+  await writeNextConfig(targetDir, plugins, { isMonorepo: false, arch });
   await appendEnvVars(path.join(targetDir, '.env.example'), plugins);
-  await writePluginFiles(targetDir, plugins);
-  await composeProviders(targetDir, plugins);
-  await applyTransforms(targetDir, plugins);
+  await writePluginFiles(targetDir, plugins, arch);
+  await composeProviders(targetDir, plugins, arch);
+  await applyTransforms(targetDir, plugins, arch);
   await injectCssTheme(targetDir, theme);
   await patchShUiConfig(path.join(targetDir, 'sh-ui.config.json'), css);
 }
 
-async function generateMonorepo(targetDir, projectName, plugins, { yes = false, theme, css } = {}) {
+async function generateMonorepo(targetDir, projectName, plugins, { yes = false, theme, css, arch } = {}) {
   await fs.copy(path.join(TEMPLATES_DIR, 'monorepo'), targetDir);
 
   // Update root package.json
@@ -412,14 +444,24 @@ async function generateMonorepo(targetDir, projectName, plugins, { yes = false,
   });
 
   const appsDir = path.join(targetDir, 'apps', appName);
-  await generateApp(appsDir, appName, port, plugins);
+  await generateApp(appsDir, appName, port, plugins, arch);
   const uiAppDir = path.join(targetDir, 'packages', 'ui', 'ui-apps', `ui-${appName}`);
   await injectCssTheme(uiAppDir, theme);
   await patchShUiConfig(path.join(uiAppDir, 'sh-ui.config.json'), css);
 }
 
-async function generateApp(targetDir, appName, port, plugins) {
-  await fs.copy(path.join(TEMPLATES_DIR, 'nextjs-app'), targetDir);
+async function generateApp(targetDir, appName, port, plugins, arch) {
+  // 베이스 템플릿 (arch-neutral 파일들) 만 카피 — _arch/ 디렉토리는 스킵.
+  // 그 후 선택된 arch 의 오버레이를 위에 머지해 arch-coupled 파일들 (layout.tsx,
+  // src/ 또는 lib+components/, tsconfig.json paths 블록 등) 을 떨어뜨린다.
+  await fs.copy(path.join(TEMPLATES_DIR, 'nextjs-app'), targetDir, {
+    filter: (src) => !src.includes(`${path.sep}_arch${path.sep}`) && !src.endsWith(`${path.sep}_arch`),
+  });
+  await fs.copy(
+    path.join(TEMPLATES_DIR, 'nextjs-app', '_arch', arch.name),
+    targetDir,
+    { overwrite: true },
+  );
 
   // Replace ui-app-name placeholder with actual app name in all files
   await replaceInAllFiles(targetDir, 'ui-app-name', `ui-${appName}`);
@@ -440,7 +482,7 @@ async function generateApp(targetDir, appName, port, plugins) {
   }
   await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 
-  await writeNextConfig(targetDir, plugins, { isMonorepo: true, appName });
+  await writeNextConfig(targetDir, plugins, { isMonorepo: true, appName, arch });
 
   // Update Dockerfile
   const dockerPath = path.join(targetDir, 'Dockerfile');
@@ -461,9 +503,9 @@ async function generateApp(targetDir, appName, port, plugins) {
   }
 
   await appendEnvVars(path.join(targetDir, '.env.example'), plugins);
-  await writePluginFiles(targetDir, plugins);
-  await composeProviders(targetDir, plugins);
-  await applyTransforms(targetDir, plugins);
+  await writePluginFiles(targetDir, plugins, arch);
+  await composeProviders(targetDir, plugins, arch);
+  await applyTransforms(targetDir, plugins, arch);
 }
 
 // ─── Helpers ───
@@ -509,7 +551,7 @@ async function replaceInAllFiles(dir, search, replace) {
   }
 }
 
-async function writeNextConfig(targetDir, plugins, { isMonorepo, appName }) {
+async function writeNextConfig(targetDir, plugins, { isMonorepo, appName, arch }) {
   const imports = [`import type { NextConfig } from 'next';`];
   const preExport = [];
   let configBody;
@@ -535,7 +577,8 @@ async function writeNextConfig(targetDir, plugins, { isMonorepo, appName }) {
 
   for (const plugin of plugins) {
     if (plugin.imports) imports.push(...plugin.imports);
-    if (plugin.preExport) preExport.push(...plugin.preExport);
+    const pluginPreExport = resolveArchField(plugin.preExport, arch);
+    if (pluginPreExport) preExport.push(...pluginPreExport);
   }
 
   let exportExpr = 'nextConfig';
@@ -569,10 +612,25 @@ async function appendEnvVars(envPath, plugins) {
   }
 }
 
-async function writePluginFiles(targetDir, plugins) {
+/**
+ * 플러그인 manifest 의 함수형 필드를 arch 디스크립터로 평가해 정적 값으로 변환.
+ * Layer 1 에서는 모든 플러그인이 정적이라 사실상 no-op 분기. Layer 2 에서 플러그인이
+ * `files: (arch) => ({...})` 형태로 전환되면 이 헬퍼가 함수를 호출해 평가한다.
+ *
+ * arch 가 null (flutter 경로) 일 때는 함수형 필드는 빈 값으로 fallback —
+ * Flutter 에는 next-arch 가 없으므로 이런 플러그인이 호출되지 않아야 정상이지만
+ * 방어적 처리.
+ */
+function resolveArchField(field, arch) {
+  if (typeof field === 'function') return field(arch);
+  return field;
+}
+
+async function writePluginFiles(targetDir, plugins, arch) {
   for (const plugin of plugins) {
-    if (plugin.files) {
-      for (const [filePath, content] of Object.entries(plugin.files)) {
+    const files = resolveArchField(plugin.files, arch);
+    if (files) {
+      for (const [filePath, content] of Object.entries(files)) {
         const fullPath = path.join(targetDir, filePath);
         await fs.ensureDir(path.dirname(fullPath));
         await fs.writeFile(fullPath, content);
@@ -582,12 +640,15 @@ async function writePluginFiles(targetDir, plugins) {
 
   // auth-jwt + next-intl 동시 활성화 시 proxy.ts 병합
   // (각 플러그인이 단독으로 깐 proxy.ts 를 합친 버전으로 덮어쓴다)
+  // i18n routing import 는 arch.aliases.config 기준 — FSD 면 @/src/shared/config,
+  // flat 이면 @/lib/config 로 해석.
   const names = new Set(plugins.map((p) => p.name));
   if (names.has('auth-jwt') && names.has('next-intl')) {
+    const configAlias = arch ? arch.aliases.config : '@/src/shared/config';
     const mergedProxy = `import createIntlMiddleware from 'next-intl/middleware';
 import { NextRequest, NextResponse } from 'next/server';
 
-import { routing } from '@/src/shared/config/i18n/routing';
+import { routing } from '${configAlias}/i18n/routing';
 
 const AUTH_ROUTES = ['/sign-in', '/sign-up'];
 
@@ -635,18 +696,24 @@ export const config = {
   }
 }
 
-async function composeProviders(targetDir, plugins) {
+async function composeProviders(targetDir, plugins, arch) {
   const extraImports = [];
   const wrappers = [];
 
   for (const plugin of plugins) {
-    if (plugin.providerImports) extraImports.push(...plugin.providerImports);
-    if (plugin.providerWrappers) wrappers.push(...plugin.providerWrappers);
+    const providerImports = resolveArchField(plugin.providerImports, arch);
+    const providerWrappers = resolveArchField(plugin.providerWrappers, arch);
+    if (providerImports) extraImports.push(...providerImports);
+    if (providerWrappers) wrappers.push(...providerWrappers);
   }
 
   if (extraImports.length === 0 && wrappers.length === 0) return;
 
-  const globalProviderPath = path.join(targetDir, 'src/app/providers/GlobalProvider/index.tsx');
+  // GlobalProvider 위치는 arch.paths.providers 기준 — Layer 2 에서 플러그인이
+  // arch.aliases.providers 를 import 에 사용하게 되면 이 경로도 일관됨.
+  // arch 미지정 (legacy) 시 FSD 디폴트 fallback.
+  const providersDir = arch ? arch.paths.providers : 'src/app/providers';
+  const globalProviderPath = path.join(targetDir, providersDir, 'GlobalProvider', 'index.tsx');
   if (!(await fs.pathExists(globalProviderPath))) return;
 
   let content = await fs.readFile(globalProviderPath, 'utf-8');
@@ -674,11 +741,12 @@ async function composeProviders(targetDir, plugins) {
   await fs.writeFile(globalProviderPath, content);
 }
 
-async function applyTransforms(targetDir, plugins) {
+async function applyTransforms(targetDir, plugins, arch) {
   for (const plugin of plugins) {
-    if (!plugin.transforms) continue;
+    const transforms = resolveArchField(plugin.transforms, arch);
+    if (!transforms) continue;
 
-    for (const transform of plugin.transforms) {
+    for (const transform of transforms) {
       const { type } = transform;
 
       if (type === 'move') {
@@ -746,8 +814,9 @@ const OPTIONAL_DART_INJECTORS = [
 async function injectCssTheme(projectDir, theme) {
   if (!theme) return;
   const candidates = [
-    'src/shared/styles/tokens.css',
-    'src/styles/tokens.css',
+    'src/shared/styles/tokens.css',  // FSD standalone
+    'src/styles/tokens.css',          // monorepo ui-app-template (arch-neutral)
+    'lib/styles/tokens.css',          // flat standalone
   ];
   for (const rel of candidates) {
     const abs = path.join(projectDir, rel);

package/src/create/index.mjs

@@ -3,11 +3,15 @@
 import { parseArgs } from './cli-args.js';
 import { createProject, addApp, addComponent } from './generator.js';
 import { allPlugins } from './plugins/index.js';
+import { allArchitectures, getArchesForPlatform } from './architectures/index.js';
 import { CREATE_PLATFORMS, CREATE_STRUCTURES, CSS_FRAMEWORKS_SUPPORTED } from '../constants.js';
 import { THEME_PRESET_NAMES } from './theme/presets.js';
 
 const PLUGIN_NAMES = allPlugins.map((p) => p.name);
 const PLUGINS_LIST = PLUGIN_NAMES.join(', ');
+const ARCH_NAMES = allArchitectures.map((a) => a.name);
+const ARCHES_LIST = ARCH_NAMES.join('|');
+const NEXT_ARCHES = getArchesForPlatform('next').map((a) => a.name).join(', ');
 const THEME_PRESETS_LIST = THEME_PRESET_NAMES.join('|');
 
 export const HELP_TEXT = `sh-ui create — sh-ui 프로젝트 스캐폴드 (Next.js / Flutter)
@@ -20,6 +24,7 @@ export const HELP_TEXT = `sh-ui create — sh-ui 프로젝트 스캐폴드 (Next
 옵션:
   --platform <${CREATE_PLATFORMS.join('|')}>          타겟 플랫폼
   --structure <${CREATE_STRUCTURES.join('|')}>  Next.js 프로젝트 구조 (next 일 때)
+  --arch <${ARCHES_LIST}>                  프로젝트 아키텍처 — 폴더 구조/import alias 컨벤션. next 에서 사용 가능: ${NEXT_ARCHES}. 기본 fsd
   --plugins <a,b>                    플러그인 (${PLUGINS_LIST}). 미지정/"" → 없음
   --theme <preset|base64>            프리셋 이름(${THEME_PRESETS_LIST}) 또는 playground base64. 선택
   --css <${CSS_FRAMEWORKS_SUPPORTED.join('|')}>                        CSS 프레임워크 (현재 plain만 지원, 향후 tailwind 등 추가 예정)
@@ -33,6 +38,7 @@ export const HELP_TEXT = `sh-ui create — sh-ui 프로젝트 스캐폴드 (Next
 예 (비대화형 / 에이전트 / CI):
   sh-ui create my-app --platform next --structure standalone --yes
   sh-ui create my-app --platform next --structure monorepo --plugins ${PLUGIN_NAMES.slice(0, 3).join(',')} --yes
+  sh-ui create my-app --platform next --structure standalone --arch flat --yes
   sh-ui create my-app --platform next --structure standalone --theme rose --yes
   sh-ui create my-app --platform flutter --yes
 
@@ -70,6 +76,7 @@ export async function runCreate(rest) {
       platform: flags.platform,
       structure: flags.structure,
       plugins: flags.plugins,
+      arch: flags.arch,
       theme: flags.theme,
       css: flags.css,
       yes: flags.yes,

package/src/create/plugins/authJwt.js

@@ -1,3 +1,9 @@
+/**
+ * auth-jwt 플러그인 — Layer 2 부터 arch-aware.
+ *
+ * fs 경로 / import alias 가 arch.paths.api / arch.aliases.api 에서 파생.
+ * FSD 기준 v0.57 까지의 하드코딩과 1:1 일치 (회귀 가드는 smoke).
+ */
 export const authJwtPlugin = {
   name: 'auth-jwt',
   label: '쿠키 기반 JWT 인증 (refresh 자리표시자 포함)',
@@ -26,7 +32,7 @@ export const authJwtPlugin = {
   // refreshSession.ts 는 v1 placeholder — 백엔드 명세 확정 후 본문만 채우면
   // BFF 와 withAuthRetry 가 자동 활용한다.
 
-  files: {
+  files: (arch) => ({
     'proxy.ts': `import { NextRequest, NextResponse } from 'next/server';
 
 const AUTH_ROUTES = ['/sign-in', '/sign-up'];
@@ -57,7 +63,7 @@ export const config = {
 };
 `,
 
-    'src/shared/api/refreshSession.ts': `type RefreshResult =
+    [`${arch.paths.api}/refreshSession.ts`]: `type RefreshResult =
   | { ok: true; accessToken: string; refreshToken: string }
   | { ok: false };
 
@@ -109,7 +115,7 @@ export async function refreshSession(
 }
 `,
 
-    'src/shared/api/withAuthRetry.ts': `import { cookies } from 'next/headers';
+    [`${arch.paths.api}/withAuthRetry.ts`]: `import { cookies } from 'next/headers';
 
 import { ApiError } from './error';
 import { refreshSession } from './refreshSession';
@@ -135,8 +141,8 @@ const COOKIE = {
  * 사용 예 (Server Action):
  *
  *   'use server';
- *   import { serverFetch } from '@/src/shared/api/serverFetch';
- *   import { withAuthRetry } from '@/src/shared/api/withAuthRetry';
+ *   import { serverFetch } from '${arch.aliases.api}/serverFetch';
+ *   import { withAuthRetry } from '${arch.aliases.api}/withAuthRetry';
  *
  *   export async function toggleFavoriteAction(id: number) {
  *     return withAuthRetry(() =>
@@ -171,8 +177,8 @@ import { NextResponse, type NextRequest } from 'next/server';
 import {
   captureApiError,
   logApiError,
-} from '@/src/shared/api/observability';
-import { refreshSession } from '@/src/shared/api/refreshSession';
+} from '${arch.aliases.api}/observability';
+import { refreshSession } from '${arch.aliases.api}/refreshSession';
 
 const API_URL = process.env.API_URL ?? 'http://localhost:8080/api';
 const ACCESS_TOKEN_COOKIE = 'accessToken';
@@ -338,5 +344,5 @@ export const DELETE = (
   ctx: { params: Promise<{ path: string[] }> },
 ) => proxyRequest(req, ctx, 'DELETE');
 `,
-  },
+  }),
 };

package/src/create/plugins/nextIntl.js

@@ -1,3 +1,13 @@
+/**
+ * next-intl 플러그인 — Layer 2 부터 arch-aware.
+ *
+ * 모든 fs 경로 / import alias 가 arch 디스크립터의 논리 키에서 파생된다:
+ *   - i18n 설정 (request/routing/navigation/messages) → arch.paths.config + '/i18n'
+ *   - 내부 import (RootLayout, GlobalProvider) → arch.aliases.layouts / providers
+ *
+ * FSD 에서는 v0.57 까지의 하드코딩과 1:1 일치 (회귀 가드는 smoke 시나리오 3).
+ * flat 에서는 자동으로 lib/config/i18n + components/layouts/RootLayout 로 emit.
+ */
 export const nextIntlPlugin = {
   name: 'next-intl',
   label: 'next-intl (다국어 지원)',
@@ -15,8 +25,8 @@ export const nextIntlPlugin = {
     `import createNextIntlPlugin from 'next-intl/plugin';`,
   ],
 
-  preExport: [
-    `const withNextIntl = createNextIntlPlugin('./src/shared/config/i18n/request.ts');`,
+  preExport: (arch) => [
+    `const withNextIntl = createNextIntlPlugin('./${arch.paths.config}/i18n/request.ts');`,
   ],
 
   wrapExport(expr) {
@@ -36,29 +46,47 @@ export const nextIntlPlugin = {
 
   // ─── 라우트 구조 변환 ───
 
-  transforms: [
+  transforms: (arch) => [
     { type: 'move', from: 'app/page.tsx', to: 'app/[locale]/page.tsx' },
     { type: 'move', from: 'app/error.tsx', to: 'app/[locale]/error.tsx' },
     {
-      // 기본 nextjs-app 템플릿의 app/layout.tsx 는 globals.css 를 side-effect import 한다 —
-      // next-intl 도입 시 layout 본체는 [locale]/layout.tsx 로 옮기지만, CSS import 는 root
-      // layout 에 살아 있어야 사용자 프로젝트의 Tailwind 스타일이 동작한다. content 통째 교체
-      // 대신 contentFn 으로 side-effect import (`import 'x';` 형태, binding 없음) 만 추출해
-      // 새 본체 앞에 prepend. 이름 있는 import (예: `import { RootLayout } from ...`) 는 새 본체와
-      // 식별자 충돌 가능성이 있어 제외.
+      // Next 16 부터 root layout (app/layout.tsx) 은 반드시 <html>/<body> 를 가져야 한다.
+      // next-intl 적용 시에는 [locale] 가 root 역할을 맡으므로, 기본 app/layout.tsx 를 그대로
+      // [locale]/layout.tsx 로 이동시켜 globals.css side-effect import 를 보존한 뒤,
+      // body 만 locale-aware 버전으로 교체한다. 결과적으로 app/layout.tsx 는 존재하지 않게 되고
+      // [locale]/layout.tsx 가 Next 의 root layout 으로 인식된다.
+      type: 'move',
+      from: 'app/layout.tsx',
+      to: 'app/[locale]/layout.tsx',
+    },
+    {
+      // 위에서 옮겨진 [locale]/layout.tsx 는 비-locale 버전 — body 를 locale-aware 로 갈아끼운다.
+      // side-effect import (`import 'x';` 형태, binding 없음) 만 보존하고 나머지는 통째 교체.
+      // 이름 있는 import (예: `import { RootLayout } from ...`) 는 새 본체와 식별자 충돌 가능성이
+      // 있어 제외.
       type: 'replace',
-      path: 'app/layout.tsx',
+      path: 'app/[locale]/layout.tsx',
       contentFn: (existing) => {
         const sideEffectImports = existing
           .split('\n')
           .filter((line) => /^\s*import\s+['"][^'"]+['"];?\s*$/.test(line))
           .join('\n');
-        const body = `export default async function RootLayout({
+        const body = `import type { Metadata } from 'next';
+import { RootLayout } from '${arch.aliases.layouts}/RootLayout';
+
+export const metadata: Metadata = {
+  title: 'My App',
+  description: 'My App Description',
+};
+
+export default function Layout({
   children,
-}: {
+  params,
+}: Readonly<{
   children: React.ReactNode;
-}) {
-  return children;
+  params: Promise<{ locale: string }>;
+}>) {
+  return <RootLayout params={params}>{children}</RootLayout>;
 }
 `;
         return sideEffectImports ? `${sideEffectImports}\n\n${body}` : body;
@@ -66,11 +94,11 @@ export const nextIntlPlugin = {
     },
     {
       type: 'replace',
-      path: 'src/app/layouts/RootLayout.tsx',
+      path: `${arch.paths.layouts}/RootLayout.tsx`,
       content: `import { hasLocale } from 'next-intl';
 import { notFound } from 'next/navigation';
-import { GlobalProvider } from '@/src/app/providers';
-import { routing } from '@/src/shared/config/i18n/routing';
+import { GlobalProvider } from '${arch.aliases.providers}';
+import { routing } from '${arch.aliases.config}/i18n/routing';
 
 export async function RootLayout({
   children,
@@ -99,8 +127,8 @@ export async function RootLayout({
 
   // ─── 독립 파일 ───
 
-  files: {
-    'src/shared/config/i18n/routing.ts': `import { defineRouting } from 'next-intl/routing';
+  files: (arch) => ({
+    [`${arch.paths.config}/i18n/routing.ts`]: `import { defineRouting } from 'next-intl/routing';
 
 export const routing = defineRouting({
   locales: ['ko', 'en'],
@@ -108,7 +136,7 @@ export const routing = defineRouting({
 });
 `,
 
-    'src/shared/config/i18n/request.ts': `import { getRequestConfig } from 'next-intl/server';
+    [`${arch.paths.config}/i18n/request.ts`]: `import { getRequestConfig } from 'next-intl/server';
 import { hasLocale } from 'next-intl';
 import { routing } from './routing';
 
@@ -125,14 +153,14 @@ export default getRequestConfig(async ({ requestLocale }) => {
 });
 `,
 
-    'src/shared/config/i18n/navigation.ts': `import { createNavigation } from 'next-intl/navigation';
+    [`${arch.paths.config}/i18n/navigation.ts`]: `import { createNavigation } from 'next-intl/navigation';
 import { routing } from './routing';
 
 export const { Link, redirect, usePathname, useRouter, getPathname } =
   createNavigation(routing);
 `,
 
-    'src/shared/config/i18n/messages/ko.json': `{
+    [`${arch.paths.config}/i18n/messages/ko.json`]: `{
   "common": {
     "loading": "로딩 중...",
     "error": "오류가 발생했습니다",
@@ -163,7 +191,7 @@ export const { Link, redirect, usePathname, useRouter, getPathname } =
 }
 `,
 
-    'src/shared/config/i18n/messages/en.json': `{
+    [`${arch.paths.config}/i18n/messages/en.json`]: `{
   "common": {
     "loading": "Loading...",
     "error": "An error occurred",
@@ -192,29 +220,10 @@ export const { Link, redirect, usePathname, useRouter, getPathname } =
     }
   }
 }
-`,
-
-    'app/[locale]/layout.tsx': `import type { Metadata } from 'next';
-import { RootLayout } from '@/src/app/layouts/RootLayout';
-
-export const metadata: Metadata = {
-  title: 'My App',
-  description: 'My App Description',
-};
-
-export default function Layout({
-  children,
-  params,
-}: Readonly<{
-  children: React.ReactNode;
-  params: Promise<{ locale: string }>;
-}>) {
-  return <RootLayout params={params}>{children}</RootLayout>;
-}
 `,
 
     'proxy.ts': `import createIntlMiddleware from 'next-intl/middleware';
-import { routing } from '@/src/shared/config/i18n/routing';
+import { routing } from '${arch.aliases.config}/i18n/routing';
 
 const intl = createIntlMiddleware(routing);
 
@@ -224,5 +233,5 @@ export const config = {
   matcher: '/((?!api|trpc|_next|_vercel|monitoring|.*\\\\..*).*)',
 };
 `,
-  },
+  }),
 };

package/src/create/plugins/pluginSchema.js

@@ -31,6 +31,13 @@ const wrapperFn = z
   })
   .optional();
 
+// arch-aware 필드. 정적 값 OR `(arch) => 정적 값` 함수 모두 허용.
+// 플러그인이 arch 디스크립터의 paths/aliases 를 조회해 자기 산출물의 fs 경로/import
+// alias 를 결정할 때 사용. Layer 2 이전엔 모든 플러그인이 정적, Layer 2 이후엔 함수형.
+const archAwareFn = z.custom((val) => typeof val === "function");
+const archAwareRecord = z.union([z.record(filePath, z.string()), archAwareFn]);
+const archAwareArray = z.union([z.array(z.any()), archAwareFn]);
+
 export const PluginSchema = z.object({
   name: z.string().regex(/^[a-z][a-z0-9-]*$/, {
     message: 'Plugin name must be lowercase kebab-case (e.g., "auth-jwt")',
@@ -43,26 +50,35 @@ export const PluginSchema = z.object({
   devDependencies: z.record(z.string(), z.string()).optional(),
 
   imports: z.array(z.string()).optional(),
+  // preExport 은 arch-aware (next.config.ts 의 export 직전 emit 되는 라인들 —
+  // 예: next-intl 의 `createNextIntlPlugin('./src/shared/config/i18n/request.ts')` 같이
+  // arch.paths.config 가 박혀야 하는 경로 포함).
+  preExport: z.union([z.array(z.string()), archAwareFn]).optional(),
   wrapExport: wrapperFn,
 
   envVars: z.array(z.string()).optional(),
   turboEnvVars: z.array(z.string()).optional(),
 
-  providerImports: z.array(z.string()).optional(),
+  // providerImports/providerWrappers/files/transforms 는 arch-aware —
+  // 정적 값 또는 (arch) => 정적 값 함수 형태 둘 다 허용.
+  providerImports: z.union([z.array(z.string()), archAwareFn]).optional(),
   providerWrappers: z
-    .array(
-      z.union([
-        z.object({ open: z.string(), close: z.string() }),
-        z.string(),
-      ]),
-    )
+    .union([
+      z.array(
+        z.union([
+          z.object({ open: z.string(), close: z.string() }),
+          z.string(),
+        ]),
+      ),
+      archAwareFn,
+    ])
     .optional(),
 
-  files: z.record(filePath, z.string()).optional(),
+  files: archAwareRecord.optional(),
 
   // 향후 확장 — moves, transforms, etc 는 nextIntl.js 에서 사용하므로 허용
-  moves: z.array(z.any()).optional(),
-  transforms: z.array(z.any()).optional(),
+  moves: archAwareArray.optional(),
+  transforms: archAwareArray.optional(),
 });
 
 /**

package/src/create/plugins/sentry.js

@@ -57,8 +57,12 @@ export const sentryPlugin = {
   // HTTP/proxy 인프라(http.ts, apiTypes.ts, error.ts, app/api/proxy 등)는
   // 베이스 템플릿이 소유한다. Sentry 는 베이스의 observability.ts 를
   // Sentry-aware 버전으로 덮어써서 캡처/로그를 활성화한다.
+  //
+  // arch 의존: FallbackBoundary 는 arch.paths.ui 에, observability 는 arch.paths.api 에
+  // 떨어진다. FallbackBoundary 안의 ApiError import 는 arch.aliases.api 로 fully-qualified —
+  // 상대 경로 (`../../api/error`) 는 FSD 에서만 동작하므로 alias 로 통일.
 
-  files: {
+  files: (arch) => ({
     'sentry.server.config.ts': `import * as Sentry from '@sentry/nextjs';
 
 Sentry.init({
@@ -280,7 +284,7 @@ export default function Error({
 }
 `,
 
-    'src/shared/ui/FallbackBoundary/index.tsx': `import React, {
+    [`${arch.paths.ui}/FallbackBoundary/index.tsx`]: `import React, {
   Component,
   ComponentType,
   ErrorInfo,
@@ -290,7 +294,7 @@ export default function Error({
 import * as Sentry from '@sentry/nextjs';
 import { QueryErrorResetBoundary } from '@tanstack/react-query';
 
-import { ApiError } from '../../api/error';
+import { ApiError } from '${arch.aliases.api}/error';
 
 interface ErrorFallbackProps {
   error: Error | null;
@@ -386,7 +390,7 @@ export function FallbackBoundary({
     // http.ts / serverFetch.ts / proxy/route.ts 가 이 모듈을 import 하므로,
     // Sentry 플러그인이 켜지면 자동으로 캡처가 활성화된다.
 
-    'src/shared/api/observability.ts': `import * as Sentry from '@sentry/nextjs';
+    [`${arch.paths.api}/observability.ts`]: `import * as Sentry from '@sentry/nextjs';
 
 type ApiCaptureParams = {
   url: string;
@@ -439,5 +443,5 @@ export const logApiError = (prefix: string, params: ApiLogParams): void => {
   if (responseBody) console.error('- Response Body:', responseBody);
 };
 `,
-  },
+  }),
 };