@wooojin/forgen 0.4.7 → 0.4.9

package/dist/host/install-claude.d.ts

@@ -1,14 +1,15 @@
 /**
  * Claude InstallPlan — feat/codex-support Phase 1 (P1-2)
  *
- * `npm install` postinstall.js 의 *Claude 측* 4 작업을 module 로 분리.
+ * `npm install` postinstall.js 의 *Claude 측* 5 작업을 module 로 분리.
  * `forgen install claude` CLI 가 호출 + (P1-6 에서) postinstall.js 도 위임.
  *
- * 4 작업:
+ * 5 작업:
  *   1. Plugin cache: ~/.claude/plugins/cache/forgen-local/forgen/<ver>/ 작성 + installed_plugins.json 등록
  *   2. Slash commands: ~/.claude/commands/forgen/*.md 생성 (forgen-managed marker)
  *   3. Settings hooks injection: ~/.claude/settings.json 의 hooks 머지 (forgen entry idempotent)
  *   4. MCP register: ~/.claude.json 에 mcpServers.forgen-compound 추가
+ *   5. Dev-guide skills: ~/.claude/skills/forgen-<stack>-<skill>/ 설치 (forgen-managed only)
  *
  * 사용자 비-forgen 자산 보존 + 재실행 idempotent.
  */
@@ -31,5 +32,8 @@ export interface ClaudeInstallResult {
     hooksInjected: number;
     mcpRegistered: boolean;
     mcpAlreadyPresent: boolean;
+    skillsPath: string;
+    skillsInstalled: number;
+    skillsRemoved: number;
 }
 export declare function planClaudeInstall(opts: ClaudeInstallOptions): ClaudeInstallResult;

package/dist/host/install-claude.js

@@ -1,14 +1,15 @@
 /**
  * Claude InstallPlan — feat/codex-support Phase 1 (P1-2)
  *
- * `npm install` postinstall.js 의 *Claude 측* 4 작업을 module 로 분리.
+ * `npm install` postinstall.js 의 *Claude 측* 5 작업을 module 로 분리.
  * `forgen install claude` CLI 가 호출 + (P1-6 에서) postinstall.js 도 위임.
  *
- * 4 작업:
+ * 5 작업:
  *   1. Plugin cache: ~/.claude/plugins/cache/forgen-local/forgen/<ver>/ 작성 + installed_plugins.json 등록
  *   2. Slash commands: ~/.claude/commands/forgen/*.md 생성 (forgen-managed marker)
  *   3. Settings hooks injection: ~/.claude/settings.json 의 hooks 머지 (forgen entry idempotent)
  *   4. MCP register: ~/.claude.json 에 mcpServers.forgen-compound 추가
+ *   5. Dev-guide skills: ~/.claude/skills/forgen-<stack>-<skill>/ 설치 (forgen-managed only)
  *
  * 사용자 비-forgen 자산 보존 + 재실행 idempotent.
  */
@@ -234,6 +235,72 @@ function registerMcpInClaudeJson(opts) {
     fs.writeFileSync(claudeJsonPath, `${JSON.stringify(claudeJson, null, 2)}\n`);
     return { registered: !alreadyPresent, alreadyPresent };
 }
+// ── 5. Dev-guide skills ────────────────────────────────────────────────
+const FORGEN_SKILL_PREFIX = 'forgen-';
+function installDevGuideSkills(opts) {
+    const { pkgRoot, skillsDir, dryRun } = opts;
+    const devGuideRoot = path.join(pkgRoot, 'assets', 'dev-guide');
+    // Collect all SKILL.md entries: assets/dev-guide/{tier}/skills/{stack}/{skill}/SKILL.md
+    const entries = [];
+    if (fs.existsSync(devGuideRoot)) {
+        for (const tier of fs.readdirSync(devGuideRoot)) {
+            const skillsBase = path.join(devGuideRoot, tier, 'skills');
+            if (!fs.existsSync(skillsBase))
+                continue;
+            for (const stack of fs.readdirSync(skillsBase)) {
+                const stackDir = path.join(skillsBase, stack);
+                if (!fs.statSync(stackDir).isDirectory())
+                    continue;
+                for (const skill of fs.readdirSync(stackDir)) {
+                    const skillMd = path.join(stackDir, skill, 'SKILL.md');
+                    if (fs.existsSync(skillMd)) {
+                        entries.push({ name: `${FORGEN_SKILL_PREFIX}${stack}-${skill}`, src: skillMd });
+                    }
+                }
+            }
+        }
+    }
+    if (dryRun) {
+        return { skillsPath: skillsDir, skillsInstalled: entries.length, skillsRemoved: 0 };
+    }
+    fs.mkdirSync(skillsDir, { recursive: true });
+    // Remove stale forgen-* skill dirs (idempotent re-install, do not touch user's own skills)
+    let removed = 0;
+    for (const entry of fs.readdirSync(skillsDir)) {
+        if (!entry.startsWith(FORGEN_SKILL_PREFIX))
+            continue;
+        const fullPath = path.join(skillsDir, entry);
+        if (fs.statSync(fullPath).isDirectory()) {
+            fs.rmSync(fullPath, { recursive: true, force: true });
+            removed += 1;
+        }
+    }
+    // Install each skill via symlink → cpSync fallback (mirrors plugin cache pattern)
+    let installed = 0;
+    for (const { name, src } of entries) {
+        const targetDir = path.join(skillsDir, name);
+        fs.mkdirSync(targetDir, { recursive: true });
+        const targetFile = path.join(targetDir, 'SKILL.md');
+        let linked = false;
+        let symlinkErr = null;
+        try {
+            fs.symlinkSync(src, targetFile, 'file');
+            linked = true;
+        }
+        catch (e) {
+            symlinkErr = e;
+        }
+        if (!linked && symlinkErr) {
+            const code = symlinkErr.code ?? 'UNKNOWN';
+            process.stderr.write(`[forgen] symlink ${src} → ${targetFile} failed (${code}); falling back to copyFile.\n`);
+        }
+        if (!linked) {
+            fs.copyFileSync(src, targetFile);
+        }
+        installed += 1;
+    }
+    return { skillsPath: skillsDir, skillsInstalled: installed, skillsRemoved: removed };
+}
 // ── public ─────────────────────────────────────────────────────────────
 export function planClaudeInstall(opts) {
     if (!opts.pkgRoot || !fs.existsSync(opts.pkgRoot)) {
@@ -249,12 +316,14 @@ export function planClaudeInstall(opts) {
     const slashCommandsDir = path.join(claudeDir, 'commands', 'forgen');
     const settingsPath = path.join(claudeDir, 'settings.json');
     const claudeJsonPath = path.join(homeDir, '.claude.json');
+    const skillsDir = path.join(claudeDir, 'skills');
     const pluginCacheWritten = writePluginCache({ pkgRoot: opts.pkgRoot, cacheDir, pluginsDir, version, dryRun });
     const slashCommandsCount = writeSlashCommands({ pkgRoot: opts.pkgRoot, targetDir: slashCommandsDir, dryRun });
     const hooksInjected = injectHooksIntoSettings({ pkgRoot: opts.pkgRoot, settingsPath, dryRun });
     const mcp = registerMcp
         ? registerMcpInClaudeJson({ pkgRoot: opts.pkgRoot, claudeJsonPath, dryRun })
         : { registered: false, alreadyPresent: false };
+    const skills = installDevGuideSkills({ pkgRoot: opts.pkgRoot, skillsDir, dryRun });
     return {
         homeDir,
         pluginCachePath: cacheDir,
@@ -265,5 +334,8 @@ export function planClaudeInstall(opts) {
         hooksInjected,
         mcpRegistered: mcp.registered,
         mcpAlreadyPresent: mcp.alreadyPresent,
+        skillsPath: skills.skillsPath,
+        skillsInstalled: skills.skillsInstalled,
+        skillsRemoved: skills.skillsRemoved,
     };
 }

package/dist/host/install-codex.d.ts

@@ -40,5 +40,9 @@ export interface CodexInstallResult {
     /** P3-3: AGENTS.md (cwd) 에 forgen rule block 인젝션 여부 */
     agentsMdPath: string;
     agentsMdInjected: boolean;
+    /** v0.4.9: dev-guide skills (~/.codex/skills) 설치 결과 */
+    devGuideSkillsPath: string;
+    devGuideSkillsInstalled: number;
+    devGuideSkillsRemoved: number;
 }
 export declare function planCodexInstall(opts: CodexInstallOptions): CodexInstallResult;

package/dist/host/install-codex.js

@@ -150,6 +150,12 @@ export function planCodexInstall(opts) {
     //    pkgRoot 의 git repo root 의 AGENTS.md, 또는 explicit override.
     const agentsMdPath = opts.agentsMdPath ?? resolveAgentsMdPath(opts.pkgRoot);
     const agentsResult = upsertForgenRulesInAgentsMd({ agentsMdPath, pkgRoot: opts.pkgRoot, dryRun: opts.dryRun ?? false });
+    // 8) v0.4.9: dev-guide skills → ~/.codex/skills/forgen-<stack>-<skill>/SKILL.md
+    const devGuideResult = installDevGuideSkillsToCodex({
+        pkgRoot: opts.pkgRoot,
+        codexHome,
+        dryRun: opts.dryRun ?? false,
+    });
     return {
         codexHome,
         hooksPath,
@@ -163,8 +169,73 @@ export function planCodexInstall(opts) {
         skillsPath,
         agentsMdPath,
         agentsMdInjected: agentsResult.injected,
+        devGuideSkillsPath: devGuideResult.devGuideSkillsPath,
+        devGuideSkillsInstalled: devGuideResult.devGuideSkillsInstalled,
+        devGuideSkillsRemoved: devGuideResult.devGuideSkillsRemoved,
     };
 }
+// ── v0.4.9: dev-guide skills → ~/.codex/skills ────────────────────────
+// dev-guide prefix pattern: forgen-<stack>-<skill> (e.g. forgen-react-fe-build)
+// 반드시 stack 이 react|vue|node|go 인 것만 매칭 — forgen 자체 commands 보존
+const DEV_GUIDE_SKILL_PATTERN = /^forgen-(react|vue|node|go)-/;
+function installDevGuideSkillsToCodex(opts) {
+    const devGuideRoot = path.join(opts.pkgRoot, 'assets', 'dev-guide');
+    const codexSkillsDir = path.join(opts.codexHome, 'skills');
+    if (!fs.existsSync(devGuideRoot)) {
+        return { devGuideSkillsPath: codexSkillsDir, devGuideSkillsInstalled: 0, devGuideSkillsRemoved: 0 };
+    }
+    // Collect entries: assets/dev-guide/{tier}/skills/{stack}/{skill}/SKILL.md
+    const entries = [];
+    for (const tier of fs.readdirSync(devGuideRoot)) {
+        const skillsBase = path.join(devGuideRoot, tier, 'skills');
+        if (!fs.existsSync(skillsBase))
+            continue;
+        for (const stack of fs.readdirSync(skillsBase)) {
+            const stackDir = path.join(skillsBase, stack);
+            if (!fs.statSync(stackDir).isDirectory())
+                continue;
+            for (const skill of fs.readdirSync(stackDir)) {
+                const skillMd = path.join(stackDir, skill, 'SKILL.md');
+                if (fs.existsSync(skillMd)) {
+                    entries.push({ name: `forgen-${stack}-${skill}`, src: skillMd });
+                }
+            }
+        }
+    }
+    if (opts.dryRun) {
+        return { devGuideSkillsPath: codexSkillsDir, devGuideSkillsInstalled: entries.length, devGuideSkillsRemoved: 0 };
+    }
+    fs.mkdirSync(codexSkillsDir, { recursive: true });
+    // Stale cleanup: dev-guide pattern 만 정리 (forgen 자체 commands 보존)
+    let removed = 0;
+    for (const entry of fs.readdirSync(codexSkillsDir)) {
+        if (DEV_GUIDE_SKILL_PATTERN.test(entry)) {
+            try {
+                fs.rmSync(path.join(codexSkillsDir, entry), { recursive: true, force: true });
+                removed++;
+            }
+            catch { /* best-effort */ }
+        }
+    }
+    // Install via symlink → copyFileSync fallback
+    let installed = 0;
+    for (const { name, src } of entries) {
+        const dstDir = path.join(codexSkillsDir, name);
+        fs.mkdirSync(dstDir, { recursive: true });
+        const dst = path.join(dstDir, 'SKILL.md');
+        let linked = false;
+        try {
+            fs.symlinkSync(src, dst, 'file');
+            linked = true;
+        }
+        catch { /* fallback */ }
+        if (!linked) {
+            fs.copyFileSync(src, dst);
+        }
+        installed++;
+    }
+    return { devGuideSkillsPath: codexSkillsDir, devGuideSkillsInstalled: installed, devGuideSkillsRemoved: removed };
+}
 // ── P3-3: Codex skills install ────────────────────────────────────────
 function installCodexSkills(opts) {
     const { sourceDir, targetDir, dryRun } = opts;
@@ -202,7 +273,7 @@ function installCodexSkills(opts) {
     return { installed: count };
 }
 // ── P3-3: AGENTS.md inject ────────────────────────────────────────────
-function resolveAgentsMdPath(pkgRoot) {
+function resolveAgentsMdPath(_pkgRoot) {
     // Phase 3 critic fix: pkgRoot 기반 walk-up 은 `npm install -g` 시 시스템 디렉토리
     // (예: /usr/local/lib/node_modules/forgen) 에 fallback AGENTS.md 작성 위험.
     // *cwd 기반* 으로 변경 — 사용자 작업 디렉토리의 git root, 없으면 cwd 자체.

package/dist/host/install-orchestrator.js

@@ -109,6 +109,7 @@ export function renderResult(result, dryRun) {
         lines.push(`    slash commands: ${result.claude.slashCommandsCount} → ${result.claude.slashCommandsPath}`);
         lines.push(`    settings.json hooks: ${result.claude.hooksInjected}`);
         lines.push(`    MCP: ${result.claude.mcpAlreadyPresent ? 'already present' : (result.claude.mcpRegistered ? 'registered' : 'skipped')}`);
+        lines.push(`    skills: ${result.claude.skillsInstalled ?? 0} installed → ${result.claude.skillsPath ?? ''}`);
     }
     if (result.codex) {
         lines.push('');

package/dist/mcp/tools.js

@@ -239,7 +239,7 @@ export function registerTools(server) {
                     }],
             };
         }
-        catch (e) {
+        catch (_e) {
             return {
                 content: [{
                         type: 'text',

package/dist/preset/facet-catalog.js

@@ -29,8 +29,8 @@ export const COMMUNICATION_CENTROIDS = {
     '상세형': { verbosity: 0.85, structure: 0.80, teaching_bias: 0.80 },
 };
 // ── Defaults (backward compat) ──
-export const DEFAULT_JUDGMENT_FACETS = JUDGMENT_CENTROIDS['균형형'];
-export const DEFAULT_COMMUNICATION_FACETS = COMMUNICATION_CENTROIDS['균형형'];
+export const DEFAULT_JUDGMENT_FACETS = JUDGMENT_CENTROIDS.균형형;
+export const DEFAULT_COMMUNICATION_FACETS = COMMUNICATION_CENTROIDS.균형형;
 // ── Utilities ──
 export function qualityCentroid(pack) {
     return { ...QUALITY_CENTROIDS[pack] };

package/dist/renderer/rule-renderer.js

@@ -171,28 +171,28 @@ export function renderRules(rules, state, profile, ctx = DEFAULT_CONTEXT) {
     for (const name of SECTION_ORDER)
         sections.set(name, []);
     for (const rule of hardRules) {
-        sections.get('Must Not').push(ruleToText(rule));
+        sections.get('Must Not')?.push(ruleToText(rule));
     }
     for (const rule of otherRules) {
         const section = CATEGORY_TO_SECTION[rule.category] ?? 'Working Defaults';
-        sections.get(section).push(ruleToText(rule));
+        sections.get(section)?.push(ruleToText(rule));
     }
     // 5. trust policy + pack 기본 규칙 주입
     if (ctx.include_pack_summary) {
-        sections.get('Working Defaults').unshift(`Trust: ${trustPolicySummary(state.effective_trust_policy)}`);
+        sections.get('Working Defaults')?.unshift(`Trust: ${trustPolicySummary(state.effective_trust_policy)}`);
         // judgment pack 기본 규칙
         for (const rule of judgmentPackRules(state.judgment_pack)) {
-            sections.get('Working Defaults').push(rule);
+            sections.get('Working Defaults')?.push(rule);
         }
         // communication pack 기본 규칙
         for (const rule of communicationPackRules(state.communication_pack)) {
-            sections.get('How To Report').push(rule);
+            sections.get('How To Report')?.push(rule);
         }
         // 4축 facet 극단값 → 추가 규칙 (12-bucket pack 위에 연속 값 차별화).
         // 각 facet 0.5 default 이고 자동 갱신 ±0.1 단위이므로, 0.85/0.15 임계값은
         // 여러 세션에 걸친 강한 신호 누적 후에만 발화한다.
         for (const fr of facetDrivenRules(profile)) {
-            sections.get(fr.section).push(fr.rule);
+            sections.get(fr.section)?.push(fr.rule);
         }
     }
     // 6. 섹션 조립 (AI-optimized: 간결한 태그 형식)
@@ -200,7 +200,7 @@ export function renderRules(rules, state, profile, ctx = DEFAULT_CONTEXT) {
     let totalChars = 0;
     let totalRules = 0;
     for (const name of SECTION_ORDER) {
-        const items = sections.get(name);
+        const items = sections.get(name) ?? [];
         if (items.length === 0)
             continue;
         const header = `## ${name}`;

package/dist/store/compound-usage-store.js

@@ -27,7 +27,7 @@ export function recordUsage(name, via = 'mcp') {
     try {
         fs.mkdirSync(STATE_DIR, { recursive: true });
         const entry = { at: new Date().toISOString(), name, via };
-        fs.appendFileSync(COMPOUND_USAGE_LOG, JSON.stringify(entry) + '\n');
+        fs.appendFileSync(COMPOUND_USAGE_LOG, `${JSON.stringify(entry)}\n`);
     }
     catch {
         // fail-open: 신호 수집 실패가 사용자 경험을 방해하면 안 됨

package/dist/store/implicit-feedback-store.js

@@ -67,7 +67,7 @@ export function appendImplicitFeedback(entry) {
         return false;
     try {
         fs.mkdirSync(STATE_DIR, { recursive: true });
-        fs.appendFileSync(IMPLICIT_FEEDBACK_LOG, JSON.stringify(normalized) + '\n');
+        fs.appendFileSync(IMPLICIT_FEEDBACK_LOG, `${JSON.stringify(normalized)}\n`);
         return true;
     }
     catch {
@@ -147,7 +147,7 @@ export function migrateImplicitFeedbackLog() {
     }
     // atomic replace via temp file
     const tmp = `${IMPLICIT_FEEDBACK_LOG}.migrate.${process.pid}`;
-    fs.writeFileSync(tmp, out.length > 0 ? out.join('\n') + '\n' : '');
+    fs.writeFileSync(tmp, out.length > 0 ? `${out.join('\n')}\n` : '');
     fs.renameSync(tmp, IMPLICIT_FEEDBACK_LOG);
     return { migrated, dropped };
 }

package/dist/store/profile-store.d.ts

@@ -18,6 +18,17 @@ export declare function saveProfile(profile: Profile): void;
  * whether to run `runLegacyCutover`).
  */
 export declare function profileExists(): boolean;
+/**
+ * profile.json 이 존재하지만 parse 실패 / v1 shape 위반인 경우, 사용자가
+ * 다음 onboarding 으로 매끄럽게 복구되도록 corrupt 파일을 timestamp 백업
+ * 으로 옆에 치워둔다. 백업 경로를 반환.
+ *
+ * v0.4.8 — bootstrapV1Session 의 loadProfile()=null early-return 보강.
+ * 이전엔 needsOnboarding=true 만 반환했고 corrupt 파일이 그대로 남아
+ * 다음 실행 때도 동일 분기로 빠지면서 사용자가 정체 원인을 모른 채
+ * onboarding 안내만 반복 받는 패턴이었음.
+ */
+export declare function backupCorruptProfile(): string | null;
 export declare function isV1Profile(data: unknown): data is Profile;
 /**
  * D2 fix (2026-04-27): explicit_correction 누적 시 해당 축의 confidence 를 점진

package/dist/store/profile-store.js

@@ -66,6 +66,29 @@ export function saveProfile(profile) {
 export function profileExists() {
     return fs.existsSync(FORGE_PROFILE);
 }
+/**
+ * profile.json 이 존재하지만 parse 실패 / v1 shape 위반인 경우, 사용자가
+ * 다음 onboarding 으로 매끄럽게 복구되도록 corrupt 파일을 timestamp 백업
+ * 으로 옆에 치워둔다. 백업 경로를 반환.
+ *
+ * v0.4.8 — bootstrapV1Session 의 loadProfile()=null early-return 보강.
+ * 이전엔 needsOnboarding=true 만 반환했고 corrupt 파일이 그대로 남아
+ * 다음 실행 때도 동일 분기로 빠지면서 사용자가 정체 원인을 모른 채
+ * onboarding 안내만 반복 받는 패턴이었음.
+ */
+export function backupCorruptProfile() {
+    if (!fs.existsSync(FORGE_PROFILE))
+        return null;
+    const ts = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupPath = `${FORGE_PROFILE}.corrupt-${ts}`;
+    try {
+        fs.renameSync(FORGE_PROFILE, backupPath);
+        return backupPath;
+    }
+    catch {
+        return null;
+    }
+}
 export function isV1Profile(data) {
     if (!data || typeof data !== 'object')
         return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wooojin/forgen",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "preferGlobal": true,
   "main": "dist/lib.js",
   "types": "./dist/lib.d.ts",
@@ -47,19 +47,19 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/forgen-team/forgen.git"
+    "url": "git+https://github.com/forgen-team/forgen.git"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "type": "module",
   "workspaces": [
     "packages/*"
   ],
   "bin": {
-    "forgen": "./dist/cli.js",
-    "fgx": "./dist/fgx.js",
-    "forgen-mcp": "./dist/mcp/server.js"
+    "forgen": "dist/cli.js",
+    "fgx": "dist/fgx.js",
+    "forgen-mcp": "dist/mcp/server.js"
   },
   "files": [
     "dist/",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://claude.ai/schemas/claude-plugin.json",
   "name": "forgen",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "description": "Claude Code harness — the more you use Claude, the better it gets",
   "author": {
     "name": "jang-ujin",

package/scripts/postinstall.js

@@ -746,6 +746,125 @@ function cleanLegacyMcpFromSettings(settings) {
   }
 }
 
+/**
+ * dev-guide 스킬 14개 자동 설치 — assets/dev-guide/{fe,be}/skills/{stack}/{skill}/SKILL.md
+ *   → ~/.claude/skills/forgen-<stack>-<skill>/SKILL.md
+ *
+ * forgen- prefix 로 사용자 own skills 와 격리. idempotent 재실행 시 forgen-* 만 정리 후 재설치.
+ */
+function installDevGuideSkills(home) {
+  const devGuideRoot = join(PKG_ROOT, 'assets', 'dev-guide');
+  if (!existsSync(devGuideRoot)) {
+    console.log('[forgen] dev-guide assets not found — skipping skill install');
+    return 0;
+  }
+
+  const userSkillsDir = join(home, '.claude', 'skills');
+  mkdirSync(userSkillsDir, { recursive: true });
+
+  // 1. 기존 forgen-* 디렉토리 정리 (사용자 own 보존)
+  let removed = 0;
+  for (const entry of readdirSync(userSkillsDir)) {
+    if (entry.startsWith('forgen-')) {
+      try { rmSync(join(userSkillsDir, entry), { recursive: true, force: true }); removed++; } catch { /* best-effort */ }
+    }
+  }
+
+  // 2. assets/dev-guide/{side}/skills/{stack}/{skill}/SKILL.md 수집
+  let installed = 0;
+  for (const side of ['fe', 'be']) {
+    const sideSkillsDir = join(devGuideRoot, side, 'skills');
+    if (!existsSync(sideSkillsDir)) continue;
+    for (const stack of readdirSync(sideSkillsDir)) {
+      const stackDir = join(sideSkillsDir, stack);
+      if (!statSync(stackDir).isDirectory()) continue;
+      for (const skill of readdirSync(stackDir)) {
+        const skillSrc = join(stackDir, skill);
+        const skillFile = join(skillSrc, 'SKILL.md');
+        if (!existsSync(skillFile)) continue;
+
+        // 대상: ~/.claude/skills/forgen-<stack>-<skill>/SKILL.md
+        const dstDir = join(userSkillsDir, `forgen-${stack}-${skill}`);
+        mkdirSync(dstDir, { recursive: true });
+        const dst = join(dstDir, 'SKILL.md');
+
+        // symlink → fallback cpSync
+        try {
+          if (existsSync(dst)) rmSync(dst);
+          symlinkSync(skillFile, dst, 'file');
+        } catch {
+          cpSync(skillFile, dst);
+        }
+        installed++;
+      }
+    }
+  }
+
+  // 3. sudo 케이스 ownership 회복
+  fixOwnership(userSkillsDir);
+
+  console.log(`[forgen] dev-guide skills: ${installed} installed${removed > 0 ? ` (${removed} stale removed)` : ''}`);
+  return installed;
+}
+
+/**
+ * v0.4.9: dev-guide 14 skills → ~/.codex/skills/forgen-<stack>-<skill>/SKILL.md
+ * forgen 자체 commands(forgen-compound 등) 와 prefix 겹치지 않도록
+ * DEV_GUIDE_SKILL_PATTERN(/^forgen-(react|vue|node|go)-/) 으로 stale 정리.
+ */
+const DEV_GUIDE_SKILL_PATTERN = /^forgen-(react|vue|node|go)-/;
+
+function installDevGuideSkillsToCodex(home) {
+  const devGuideRoot = join(PKG_ROOT, 'assets', 'dev-guide');
+  if (!existsSync(devGuideRoot)) {
+    console.log('[forgen] dev-guide assets not found — codex skill install skipped');
+    return 0;
+  }
+
+  const codexSkillsDir = join(home, '.codex', 'skills');
+  mkdirSync(codexSkillsDir, { recursive: true });
+
+  // 1. stale forgen-<stack>-<skill> 정리 (forgen 자체 commands 보존)
+  let removed = 0;
+  for (const entry of readdirSync(codexSkillsDir)) {
+    if (DEV_GUIDE_SKILL_PATTERN.test(entry)) {
+      try { rmSync(join(codexSkillsDir, entry), { recursive: true, force: true }); removed++; } catch { /* best-effort */ }
+    }
+  }
+
+  // 2. assets/dev-guide/{tier}/skills/{stack}/{skill}/SKILL.md 수집
+  let installed = 0;
+  for (const tier of readdirSync(devGuideRoot)) {
+    const sideSkillsDir = join(devGuideRoot, tier, 'skills');
+    if (!existsSync(sideSkillsDir)) continue;
+    for (const stack of readdirSync(sideSkillsDir)) {
+      const stackDir = join(sideSkillsDir, stack);
+      if (!statSync(stackDir).isDirectory()) continue;
+      for (const skill of readdirSync(stackDir)) {
+        const skillFile = join(stackDir, skill, 'SKILL.md');
+        if (!existsSync(skillFile)) continue;
+
+        const dstDir = join(codexSkillsDir, `forgen-${stack}-${skill}`);
+        mkdirSync(dstDir, { recursive: true });
+        const dst = join(dstDir, 'SKILL.md');
+
+        // symlink → fallback cpSync
+        try {
+          if (existsSync(dst)) rmSync(dst);
+          symlinkSync(skillFile, dst, 'file');
+        } catch {
+          cpSync(skillFile, dst);
+        }
+        installed++;
+      }
+    }
+  }
+
+  fixOwnership(codexSkillsDir);
+  console.log(`[forgen] codex dev-guide skills: ${installed} installed${removed > 0 ? ` (${removed} stale removed)` : ''}`);
+  return installed;
+}
+
 // ── Main ──
 
 /**
@@ -927,6 +1046,21 @@ async function main() {
     console.error(`[forgen] starter pack failed: ${err?.message ?? err}`);
   }
 
+  // ── 8b. dev-guide 스킬 자동 설치 (claude) ──
+  try {
+    installDevGuideSkills(HOME);
+  } catch (e) {
+    // postinstall 의 "fail-open" 원칙 — npm install 깨뜨리지 않음
+    console.log(`[forgen] dev-guide skills 설치 스킵 (${e?.message ?? e})`);
+  }
+
+  // ── 8c. dev-guide 스킬 자동 설치 (codex) ──
+  try {
+    installDevGuideSkillsToCodex(HOME);
+  } catch (e) {
+    console.log(`[forgen] codex dev-guide skills 설치 스킵 (${e?.message ?? e})`);
+  }
+
   // sudo 실행 시 파일 소유권을 실제 유저로 변경
   fixOwnership(join(HOME, '.claude'), join(HOME, '.forgen'));