@qazuor/claude-code-config 0.5.0 → 0.6.0

package/dist/bin.cjs

@@ -274,15 +274,10 @@ var BUNDLES = [
     moduleDetails: {
       agents: [
         {
-          id: "react-senior-dev",
-          role: "React Architecture",
+          id: "frontend-engineer",
+          role: "Frontend Development",
           responsibilities: ["Component design", "State management", "Performance optimization"]
         },
-        {
-          id: "tanstack-start-engineer",
-          role: "TanStack Specialist",
-          responsibilities: ["Router setup", "Query patterns", "SSR configuration"]
-        },
         {
           id: "ux-ui-designer",
           role: "UI/UX Design",
@@ -290,6 +285,8 @@ var BUNDLES = [
         }
       ],
       skills: [
+        { id: "react-patterns", purpose: "React component patterns" },
+        { id: "tanstack-start-patterns", purpose: "TanStack Router/Start patterns" },
         { id: "web-app-testing", purpose: "React Testing Library patterns" },
         { id: "shadcn-specialist", purpose: "Shadcn UI component usage" },
         { id: "accessibility-audit", purpose: "WCAG compliance" },
@@ -301,9 +298,10 @@ var BUNDLES = [
       docs: [{ id: "design-standards", topic: "UI/UX design standards" }]
     },
     modules: [
-      { id: "react-senior-dev", category: "agents" },
-      { id: "tanstack-start-engineer", category: "agents" },
+      { id: "frontend-engineer", category: "agents" },
       { id: "ux-ui-designer", category: "agents" },
+      { id: "react-patterns", category: "skills" },
+      { id: "tanstack-start-patterns", category: "skills" },
       { id: "web-app-testing", category: "skills" },
       { id: "shadcn-specialist", category: "skills" },
       { id: "accessibility-audit", category: "skills" },
@@ -339,15 +337,10 @@ var BUNDLES = [
     moduleDetails: {
       agents: [
         {
-          id: "astro-engineer",
-          role: "Astro Specialist",
+          id: "frontend-engineer",
+          role: "Frontend Development",
           responsibilities: ["Routing", "Islands architecture", "Build optimization"]
         },
-        {
-          id: "react-senior-dev",
-          role: "React Components",
-          responsibilities: ["Interactive components", "Client hydration"]
-        },
         {
           id: "seo-ai-specialist",
           role: "SEO Optimization",
@@ -355,6 +348,8 @@ var BUNDLES = [
         }
       ],
       skills: [
+        { id: "astro-patterns", purpose: "Astro-specific patterns" },
+        { id: "react-patterns", purpose: "React island components" },
         { id: "web-app-testing", purpose: "Component testing" },
         { id: "vercel-specialist", purpose: "Deployment optimization" },
         { id: "performance-audit", purpose: "Core Web Vitals" }
@@ -363,9 +358,10 @@ var BUNDLES = [
       docs: []
     },
     modules: [
-      { id: "astro-engineer", category: "agents" },
-      { id: "react-senior-dev", category: "agents" },
+      { id: "frontend-engineer", category: "agents" },
       { id: "seo-ai-specialist", category: "agents" },
+      { id: "astro-patterns", category: "skills" },
+      { id: "react-patterns", category: "skills" },
       { id: "web-app-testing", category: "skills" },
       { id: "vercel-specialist", category: "skills" },
       { id: "performance-audit", category: "skills" }
@@ -398,17 +394,12 @@ var BUNDLES = [
     moduleDetails: {
       agents: [
         {
-          id: "nextjs-engineer",
-          role: "Next.js Specialist",
-          responsibilities: ["App Router", "Server Actions", "Caching strategies"]
-        },
-        {
-          id: "react-senior-dev",
-          role: "React Components",
-          responsibilities: ["Client components", "State management"]
+          id: "frontend-engineer",
+          role: "Frontend Development",
+          responsibilities: ["App Router", "Server Actions", "Client components"]
         },
         {
-          id: "prisma-engineer",
+          id: "database-engineer",
           role: "Database",
           responsibilities: ["Schema design", "Migrations", "Query optimization"]
         },
@@ -419,6 +410,9 @@ var BUNDLES = [
         }
       ],
       skills: [
+        { id: "nextjs-patterns", purpose: "Next.js App Router patterns" },
+        { id: "react-patterns", purpose: "React component patterns" },
+        { id: "prisma-patterns", purpose: "Prisma ORM patterns" },
         { id: "web-app-testing", purpose: "Next.js testing patterns" },
         { id: "shadcn-specialist", purpose: "UI components" },
         { id: "vercel-specialist", purpose: "Deployment" },
@@ -430,10 +424,12 @@ var BUNDLES = [
       docs: []
     },
     modules: [
-      { id: "nextjs-engineer", category: "agents" },
-      { id: "react-senior-dev", category: "agents" },
-      { id: "prisma-engineer", category: "agents" },
+      { id: "frontend-engineer", category: "agents" },
+      { id: "database-engineer", category: "agents" },
       { id: "ux-ui-designer", category: "agents" },
+      { id: "nextjs-patterns", category: "skills" },
+      { id: "react-patterns", category: "skills" },
+      { id: "prisma-patterns", category: "skills" },
       { id: "web-app-testing", category: "skills" },
       { id: "shadcn-specialist", category: "skills" },
       { id: "vercel-specialist", category: "skills" },
@@ -469,12 +465,12 @@ var BUNDLES = [
     moduleDetails: {
       agents: [
         {
-          id: "express-engineer",
-          role: "Express Specialist",
+          id: "api-engineer",
+          role: "API Development",
           responsibilities: ["Route design", "Middleware", "Error handling"]
         },
         {
-          id: "prisma-engineer",
+          id: "database-engineer",
           role: "Database",
           responsibilities: ["Schema", "Migrations", "Queries"]
         },
@@ -485,6 +481,8 @@ var BUNDLES = [
         }
       ],
       skills: [
+        { id: "express-patterns", purpose: "Express.js patterns" },
+        { id: "prisma-patterns", purpose: "Prisma ORM patterns" },
         { id: "api-app-testing", purpose: "API testing with supertest" },
         { id: "error-handling-patterns", purpose: "Error middleware" },
         { id: "security-testing", purpose: "Security best practices" }
@@ -493,9 +491,11 @@ var BUNDLES = [
       docs: [{ id: "architecture-patterns", topic: "API architecture patterns" }]
     },
     modules: [
-      { id: "express-engineer", category: "agents" },
-      { id: "prisma-engineer", category: "agents" },
+      { id: "api-engineer", category: "agents" },
+      { id: "database-engineer", category: "agents" },
       { id: "node-typescript-engineer", category: "agents" },
+      { id: "express-patterns", category: "skills" },
+      { id: "prisma-patterns", category: "skills" },
       { id: "api-app-testing", category: "skills" },
       { id: "error-handling-patterns", category: "skills" },
       { id: "security-testing", category: "skills" },
@@ -529,13 +529,13 @@ var BUNDLES = [
     moduleDetails: {
       agents: [
         {
-          id: "hono-engineer",
-          role: "Hono Specialist",
+          id: "api-engineer",
+          role: "API Development",
           responsibilities: ["Route handlers", "Middleware", "OpenAPI integration"]
         },
         {
-          id: "db-drizzle-engineer",
-          role: "Drizzle Database",
+          id: "database-engineer",
+          role: "Database",
           responsibilities: ["Schema design", "Migrations", "Type-safe queries"]
         },
         {
@@ -545,6 +545,8 @@ var BUNDLES = [
         }
       ],
       skills: [
+        { id: "hono-patterns", purpose: "Hono framework patterns" },
+        { id: "drizzle-patterns", purpose: "Drizzle ORM patterns" },
         { id: "api-app-testing", purpose: "Hono testing patterns" },
         { id: "error-handling-patterns", purpose: "Error middleware" },
         { id: "security-testing", purpose: "Security validation" }
@@ -553,9 +555,11 @@ var BUNDLES = [
       docs: [{ id: "architecture-patterns", topic: "API architecture patterns" }]
     },
     modules: [
-      { id: "hono-engineer", category: "agents" },
-      { id: "db-drizzle-engineer", category: "agents" },
+      { id: "api-engineer", category: "agents" },
+      { id: "database-engineer", category: "agents" },
       { id: "node-typescript-engineer", category: "agents" },
+      { id: "hono-patterns", category: "skills" },
+      { id: "drizzle-patterns", category: "skills" },
       { id: "api-app-testing", category: "skills" },
       { id: "error-handling-patterns", category: "skills" },
       { id: "security-testing", category: "skills" },
@@ -786,7 +790,8 @@ var BUNDLES = [
     tags: ["database", "drizzle", "orm"],
     alternativeTo: ["prisma-database", "mongoose-database"],
     modules: [
-      { id: "db-drizzle-engineer", category: "agents" },
+      { id: "database-engineer", category: "agents" },
+      { id: "drizzle-patterns", category: "skills" },
       { id: "json-data-auditor", category: "skills" }
     ]
   },
@@ -800,7 +805,8 @@ var BUNDLES = [
     tags: ["database", "prisma", "orm"],
     alternativeTo: ["drizzle-database", "mongoose-database"],
     modules: [
-      { id: "prisma-engineer", category: "agents" },
+      { id: "database-engineer", category: "agents" },
+      { id: "prisma-patterns", category: "skills" },
       { id: "json-data-auditor", category: "skills" }
     ]
   },
@@ -814,7 +820,8 @@ var BUNDLES = [
     tags: ["database", "mongodb", "mongoose", "nosql"],
     alternativeTo: ["drizzle-database", "prisma-database"],
     modules: [
-      { id: "mongoose-engineer", category: "agents" },
+      { id: "database-engineer", category: "agents" },
+      { id: "mongoose-patterns", category: "skills" },
       { id: "json-data-auditor", category: "skills" }
     ]
   },
@@ -831,7 +838,8 @@ var BUNDLES = [
     tags: ["api", "hono", "backend"],
     alternativeTo: ["express-api", "fastify-api", "nestjs-api"],
     modules: [
-      { id: "hono-engineer", category: "agents" },
+      { id: "api-engineer", category: "agents" },
+      { id: "hono-patterns", category: "skills" },
       { id: "api-app-testing", category: "skills" },
       { id: "error-handling-patterns", category: "skills" }
     ]
@@ -846,7 +854,8 @@ var BUNDLES = [
     tags: ["api", "express", "backend"],
     alternativeTo: ["hono-api", "fastify-api", "nestjs-api"],
     modules: [
-      { id: "express-engineer", category: "agents" },
+      { id: "api-engineer", category: "agents" },
+      { id: "express-patterns", category: "skills" },
       { id: "api-app-testing", category: "skills" },
       { id: "error-handling-patterns", category: "skills" }
     ]
@@ -861,7 +870,8 @@ var BUNDLES = [
     tags: ["api", "fastify", "backend", "performance"],
     alternativeTo: ["hono-api", "express-api", "nestjs-api"],
     modules: [
-      { id: "fastify-engineer", category: "agents" },
+      { id: "api-engineer", category: "agents" },
+      { id: "fastify-patterns", category: "skills" },
       { id: "api-app-testing", category: "skills" },
       { id: "error-handling-patterns", category: "skills" }
     ]
@@ -876,7 +886,8 @@ var BUNDLES = [
     tags: ["api", "nestjs", "backend", "enterprise"],
     alternativeTo: ["hono-api", "express-api", "fastify-api"],
     modules: [
-      { id: "nestjs-engineer", category: "agents" },
+      { id: "api-engineer", category: "agents" },
+      { id: "nestjs-patterns", category: "skills" },
       { id: "api-app-testing", category: "skills" },
       { id: "error-handling-patterns", category: "skills" }
     ]
@@ -893,8 +904,9 @@ var BUNDLES = [
     techStack: ["React", "Shadcn UI", "Tailwind CSS", "Radix UI"],
     tags: ["react", "ui", "components"],
     modules: [
-      { id: "react-senior-dev", category: "agents" },
+      { id: "frontend-engineer", category: "agents" },
       { id: "ux-ui-designer", category: "agents" },
+      { id: "react-patterns", category: "skills" },
       { id: "shadcn-specialist", category: "skills" },
       { id: "brand-guidelines", category: "skills" },
       { id: "accessibility-audit", category: "skills" }
@@ -909,7 +921,8 @@ var BUNDLES = [
     techStack: ["React Hook Form", "Zod", "React", "TypeScript"],
     tags: ["react", "forms", "validation"],
     modules: [
-      { id: "react-senior-dev", category: "agents" },
+      { id: "frontend-engineer", category: "agents" },
+      { id: "react-patterns", category: "skills" },
       { id: "react-hook-form-patterns", category: "skills" },
       { id: "shadcn-specialist", category: "skills" }
     ]
@@ -924,7 +937,8 @@ var BUNDLES = [
     tags: ["react", "state", "zustand"],
     alternativeTo: ["react-state-redux"],
     modules: [
-      { id: "react-senior-dev", category: "agents" },
+      { id: "frontend-engineer", category: "agents" },
+      { id: "react-patterns", category: "skills" },
       { id: "zustand-patterns", category: "skills" },
       { id: "tanstack-query-patterns", category: "skills" }
     ]
@@ -939,7 +953,8 @@ var BUNDLES = [
     tags: ["react", "state", "redux"],
     alternativeTo: ["react-state-zustand"],
     modules: [
-      { id: "react-senior-dev", category: "agents" },
+      { id: "frontend-engineer", category: "agents" },
+      { id: "react-patterns", category: "skills" },
       { id: "redux-toolkit-patterns", category: "skills" },
       { id: "tanstack-query-patterns", category: "skills", optional: true }
     ]
@@ -953,7 +968,8 @@ var BUNDLES = [
     techStack: ["NextAuth.js", "Auth.js", "Next.js", "Prisma"],
     tags: ["nextjs", "auth", "oauth"],
     modules: [
-      { id: "nextjs-engineer", category: "agents" },
+      { id: "frontend-engineer", category: "agents" },
+      { id: "nextjs-patterns", category: "skills" },
       { id: "nextauth-patterns", category: "skills" },
       { id: "security-testing", category: "skills" }
     ]
@@ -967,8 +983,9 @@ var BUNDLES = [
     techStack: ["next-intl", "Next.js", "React", "TypeScript"],
     tags: ["nextjs", "i18n", "internationalization"],
     modules: [
-      { id: "nextjs-engineer", category: "agents" },
+      { id: "frontend-engineer", category: "agents" },
       { id: "i18n-specialist", category: "agents", optional: true },
+      { id: "nextjs-patterns", category: "skills" },
       { id: "i18n-patterns", category: "skills" }
     ]
   },
@@ -1088,7 +1105,7 @@ var BUNDLES = [
         }
       ],
       skills: [
-        { id: "documentation-writer", purpose: "Documentation best practices" },
+        { id: "markdown-formatter", purpose: "Markdown formatting" },
         { id: "mermaid-diagram-specialist", purpose: "Diagram creation" }
       ],
       commands: [
@@ -1103,7 +1120,7 @@ var BUNDLES = [
     },
     modules: [
       { id: "tech-writer", category: "agents" },
-      { id: "documentation-writer", category: "skills" },
+      { id: "markdown-formatter", category: "skills" },
       { id: "mermaid-diagram-specialist", category: "skills" },
       { id: "update-docs", category: "commands" },
       { id: "markdown-format", category: "commands" },
@@ -6124,11 +6141,13 @@ function processTemplate(template, projectInfo, options) {
   const commands = options?.templateConfig?.commands;
   const targets = options?.templateConfig?.targets;
   const preferences = options?.claudeConfig?.preferences;
+  const standards = options?.claudeConfig?.extras?.standards;
   content = content.replace(/\{\{PROJECT_NAME\}\}/g, projectInfo.name).replace(/\{\{PROJECT_DESCRIPTION\}\}/g, projectInfo.description).replace(/\{\{ORG\}\}/g, projectInfo.org).replace(/\{\{REPO\}\}/g, projectInfo.repo).replace(/\{\{ENTITY_TYPE\}\}/g, projectInfo.entityType).replace(/\{\{ENTITY_TYPE_PLURAL\}\}/g, projectInfo.entityTypePlural).replace(/\{\{LOCATION\}\}/g, projectInfo.location || "");
   const packageManager = preferences?.packageManager || "pnpm";
   content = content.replace(/\{\{PACKAGE_MANAGER\}\}/g, packageManager);
-  const coverageTarget = targets && "coverage" in targets ? String(targets.coverage) : "90";
+  const coverageTarget = standards?.testing?.coverageTarget ? String(standards.testing.coverageTarget) : targets && "coverage" in targets ? String(targets.coverage) : "90";
   content = content.replace(/\{\{COVERAGE_TARGET\}\}/g, coverageTarget);
+  content = processStandardsPlaceholders(content, standards, preferences);
   if (projectInfo.domain) {
     content = content.replace(/\{\{#if DOMAIN\}\}/g, "").replace(/\{\{\/if\}\}/g, "").replace(/\{\{DOMAIN\}\}/g, projectInfo.domain);
   } else {
@@ -6225,6 +6244,55 @@ function generateCommandsSection(commands, packageManager) {
   lines.push("```");
   return lines.join("\n");
 }
+function processStandardsPlaceholders(content, standards, preferences) {
+  let result = content;
+  const primaryLanguage = "TypeScript";
+  result = result.replace(/\{\{PRIMARY_LANGUAGE\}\}/g, primaryLanguage);
+  const maxFileLines = standards?.code?.maxFileLines?.toString() || "500";
+  result = result.replace(/\{\{MAX_FILE_LINES\}\}/g, maxFileLines);
+  const testPattern = standards?.testing?.testPattern === "gwt" ? "GWT (Given-When-Then)" : "AAA (Arrange, Act, Assert)";
+  result = result.replace(/\{\{TEST_PATTERN\}\}/g, testPattern);
+  const responseLanguage = preferences?.responseLanguage === "es" ? "Spanish" : preferences?.responseLanguage === "en" ? "English" : "Spanish";
+  result = result.replace(/\{\{RESPONSE_LANGUAGE\}\}/g, responseLanguage);
+  if (standards?.code?.namedExportsOnly) {
+    result = result.replace(/\{\{#if NAMED_EXPORTS_ONLY\}\}/g, "").replace(/\{\{\/if\}\}/g, "");
+  } else {
+    result = result.replace(/\{\{#if NAMED_EXPORTS_ONLY\}\}[\s\S]*?\{\{\/if\}\}/g, "");
+  }
+  if (standards?.code?.jsDocRequired) {
+    result = result.replace(/\{\{#if JSDOC_REQUIRED\}\}/g, "").replace(/\{\{\/if\}\}/g, "");
+  } else {
+    result = result.replace(/\{\{#if JSDOC_REQUIRED\}\}[\s\S]*?\{\{\/if\}\}/g, "");
+  }
+  if (standards?.code?.roroPattern) {
+    result = result.replace(/\{\{#if RORO_PATTERN\}\}/g, "").replace(/\{\{\/if\}\}/g, "");
+  } else {
+    result = result.replace(/\{\{#if RORO_PATTERN\}\}[\s\S]*?\{\{\/if\}\}/g, "");
+  }
+  if (standards?.testing?.tddRequired) {
+    result = result.replace(/\{\{#if TDD_REQUIRED\}\}/g, "").replace(/\{\{else\}\}[\s\S]*?\{\{\/if\}\}/g, "");
+  } else {
+    result = result.replace(/\{\{#if TDD_REQUIRED\}\}[\s\S]*?\{\{else\}\}/g, "").replace(/\{\{\/if\}\}/g, "");
+  }
+  const testLocation = standards?.testing?.testLocation;
+  if (testLocation) {
+    const testLocationText = testLocation === "colocated" ? "Co-located with source" : "Separate test directory";
+    result = result.replace(/\{\{#if TEST_LOCATION\}\}/g, "").replace(/\{\{\/if\}\}/g, "").replace(/\{\{TEST_LOCATION\}\}/g, testLocationText);
+  } else {
+    result = result.replace(/\{\{#if TEST_LOCATION\}\}[\s\S]*?\{\{\/if\}\}/g, "");
+  }
+  if (preferences?.includeCoAuthor) {
+    result = result.replace(/\{\{#if INCLUDE_CO_AUTHOR\}\}/g, "").replace(/\{\{\/if\}\}/g, "");
+  } else {
+    result = result.replace(/\{\{#if INCLUDE_CO_AUTHOR\}\}[\s\S]*?\{\{\/if\}\}/g, "");
+  }
+  if (preferences?.responseLanguage) {
+    result = result.replace(/\{\{#if RESPONSE_LANGUAGE\}\}/g, "").replace(/\{\{\/if\}\}/g, "");
+  } else {
+    result = result.replace(/\{\{#if RESPONSE_LANGUAGE\}\}[\s\S]*?\{\{\/if\}\}/g, "");
+  }
+  return result;
+}
 function getMinimalTemplate() {
   return `# CLAUDE.md
 
@@ -6770,6 +6838,242 @@ async function generateScaffoldWithProgress(projectPath, options) {
   );
 }
 
+// src/lib/scaffold/settings-generator.ts
+init_cjs_shims();
+
+// src/constants/claude-settings-defaults.ts
+init_cjs_shims();
+var DEFAULT_CLAUDE_SETTINGS = {
+  model: "sonnet",
+  alwaysThinkingEnabled: false,
+  sandbox: {
+    enabled: false,
+    autoAllowBashIfSandboxed: true
+  },
+  permissions: {
+    allow: [],
+    deny: [],
+    ask: [],
+    defaultMode: "acceptEdits"
+  },
+  attribution: {
+    commit: "\u{1F916} Generated with [Claude Code](https://claude.com/claude-code)\n\n   Co-Authored-By: Claude <noreply@anthropic.com>",
+    pr: "\u{1F916} Generated with [Claude Code](https://claude.com/claude-code)"
+  },
+  cleanupPeriodDays: 30,
+  stopNotification: "beep"
+};
+var ATTRIBUTION_NO_COAUTHOR = {
+  commit: "\u{1F916} Generated with [Claude Code](https://claude.com/claude-code)",
+  pr: "\u{1F916} Generated with [Claude Code](https://claude.com/claude-code)"
+};
+var ATTRIBUTION_WITH_COAUTHOR = {
+  commit: "\u{1F916} Generated with [Claude Code](https://claude.com/claude-code)\n\n   Co-Authored-By: Claude <noreply@anthropic.com>",
+  pr: "\u{1F916} Generated with [Claude Code](https://claude.com/claude-code)"
+};
+var BEEP_COMMAND = "echo -ne '\\007'";
+var MODEL_DESCRIPTIONS = {
+  sonnet: "Claude Sonnet - Balanced performance and speed (recommended)",
+  opus: "Claude Opus - Most capable, best for complex tasks",
+  haiku: "Claude Haiku - Fastest, best for simple tasks",
+  default: "Default - Let Claude Code decide based on task"
+};
+var PERMISSION_MODE_DESCRIPTIONS = {
+  acceptEdits: "Accept edits automatically, ask for other operations",
+  askAlways: "Ask for confirmation on all operations",
+  viewOnly: "Read-only mode, no modifications allowed"
+};
+var STOP_NOTIFICATION_DESCRIPTIONS = {
+  beep: "Play a beep sound when task completes",
+  custom: "Run a custom command when task completes",
+  none: "No notification"
+};
+var CLAUDE_SETTINGS_PRESETS = {
+  /** Default preset - balanced settings */
+  default: {
+    ...DEFAULT_CLAUDE_SETTINGS
+  },
+  /** Performance preset - faster model, less confirmations */
+  performance: {
+    ...DEFAULT_CLAUDE_SETTINGS,
+    model: "haiku",
+    permissions: {
+      ...DEFAULT_CLAUDE_SETTINGS.permissions,
+      defaultMode: "acceptEdits"
+    }
+  },
+  /** Quality preset - best model, extended thinking */
+  quality: {
+    ...DEFAULT_CLAUDE_SETTINGS,
+    model: "opus",
+    alwaysThinkingEnabled: true
+  },
+  /** Secure preset - sandbox enabled, more confirmations */
+  secure: {
+    ...DEFAULT_CLAUDE_SETTINGS,
+    sandbox: {
+      enabled: true,
+      autoAllowBashIfSandboxed: true
+    },
+    permissions: {
+      ...DEFAULT_CLAUDE_SETTINGS.permissions,
+      defaultMode: "askAlways"
+    }
+  }
+};
+var PRESET_DESCRIPTIONS2 = {
+  default: "Balanced settings for most projects",
+  performance: "Faster responses with Haiku model",
+  quality: "Best quality with Opus model and extended thinking",
+  secure: "Enhanced security with sandbox and confirmations"
+};
+
+// src/lib/scaffold/settings-generator.ts
+init_fs();
+async function generateSettings(projectPath, options) {
+  const settingsPath = joinPath(projectPath, ".claude", "settings.json");
+  const exists = await pathExists(settingsPath);
+  if (exists && !options?.overwrite) {
+    return {
+      created: false,
+      skipped: true,
+      path: settingsPath
+    };
+  }
+  try {
+    const settings = buildSettingsJson(options);
+    await writeJson(settingsPath, settings, { spaces: 2 });
+    return {
+      created: true,
+      skipped: false,
+      path: settingsPath
+    };
+  } catch (error) {
+    return {
+      created: false,
+      skipped: false,
+      path: settingsPath,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+async function generateSettingsWithSpinner(projectPath, options) {
+  return withSpinner("Generating settings.json...", () => generateSettings(projectPath, options), {
+    successText: "Created settings.json"
+  });
+}
+async function generateSettingsLocal(projectPath, options) {
+  const settingsPath = joinPath(projectPath, ".claude", "settings.local.json");
+  const exists = await pathExists(settingsPath);
+  if (exists && !options?.overwrite) {
+    return {
+      created: false,
+      skipped: true,
+      path: settingsPath
+    };
+  }
+  try {
+    const settings = buildSettingsLocalJson(options);
+    await writeJson(settingsPath, settings, { spaces: 2 });
+    return {
+      created: true,
+      skipped: false,
+      path: settingsPath
+    };
+  } catch (error) {
+    return {
+      created: false,
+      skipped: false,
+      path: settingsPath,
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+}
+async function generateSettingsLocalWithSpinner(projectPath, options) {
+  return withSpinner(
+    "Generating settings.local.json...",
+    () => generateSettingsLocal(projectPath, options),
+    {
+      successText: "Created settings.local.json"
+    }
+  );
+}
+function buildSettingsJson(options) {
+  const claudeSettings = options?.claudeSettings || DEFAULT_CLAUDE_SETTINGS;
+  const includeCoAuthor = options?.includeCoAuthor ?? true;
+  const settings = {
+    $schema: "https://json.schemastore.org/claude-code-settings.json"
+  };
+  if (claudeSettings.model && claudeSettings.model !== "default") {
+    settings.model = claudeSettings.model;
+  }
+  if (claudeSettings.alwaysThinkingEnabled) {
+    settings.alwaysThinkingEnabled = true;
+  }
+  if (claudeSettings.cleanupPeriodDays !== 30) {
+    settings.cleanupPeriodDays = claudeSettings.cleanupPeriodDays;
+  }
+  settings.attribution = includeCoAuthor ? ATTRIBUTION_WITH_COAUTHOR : ATTRIBUTION_NO_COAUTHOR;
+  settings.permissions = {
+    allow: [],
+    deny: []
+  };
+  if (claudeSettings.sandbox?.enabled) {
+    settings.sandbox = {
+      enabled: true,
+      autoAllowBashIfSandboxed: claudeSettings.sandbox.autoAllowBashIfSandboxed ?? true
+    };
+  }
+  return settings;
+}
+function buildSettingsLocalJson(options) {
+  const claudeSettings = options?.claudeSettings || DEFAULT_CLAUDE_SETTINGS;
+  const settings = {};
+  const allow = [...options?.additionalAllow || []];
+  const deny = [...options?.additionalDeny || []];
+  if (claudeSettings.permissions?.allow) {
+    allow.push(...claudeSettings.permissions.allow);
+  }
+  if (claudeSettings.permissions?.deny) {
+    deny.push(...claudeSettings.permissions.deny);
+  }
+  settings.permissions = {
+    allow: [...new Set(allow)],
+    // Deduplicate
+    deny: [...new Set(deny)],
+    ask: claudeSettings.permissions?.ask || [],
+    defaultMode: claudeSettings.permissions?.defaultMode || "acceptEdits"
+  };
+  if (claudeSettings.stopNotification && claudeSettings.stopNotification !== "none") {
+    const command = claudeSettings.stopNotification === "custom" && claudeSettings.customStopCommand ? claudeSettings.customStopCommand : BEEP_COMMAND;
+    settings.hooks = {
+      Stop: [
+        {
+          hooks: [
+            {
+              type: "command",
+              command,
+              timeout: 5
+            }
+          ]
+        }
+      ],
+      SubagentStop: [
+        {
+          hooks: [
+            {
+              type: "command",
+              command,
+              timeout: 5
+            }
+          ]
+        }
+      ]
+    };
+  }
+  return settings;
+}
+
 // src/lib/templates/config-replacer.ts
 init_cjs_shims();
 var fs4 = __toESM(require("fs/promises"), 1);
@@ -8717,6 +9021,142 @@ async function promptCICDConfig(options) {
   };
 }
 
+// src/cli/prompts/claude-settings.ts
+init_cjs_shims();
+async function promptClaudeSettings(options) {
+  logger.section("Claude Code Settings", "\u{1F916}");
+  const wantToConfigure = await confirm({
+    message: "Would you like to configure Claude Code settings?",
+    default: true
+  });
+  if (!wantToConfigure) {
+    return {
+      ...DEFAULT_CLAUDE_SETTINGS,
+      attribution: options?.includeCoAuthor ? DEFAULT_CLAUDE_SETTINGS.attribution : {
+        commit: "\u{1F916} Generated with [Claude Code](https://claude.com/claude-code)",
+        pr: "\u{1F916} Generated with [Claude Code](https://claude.com/claude-code)"
+      }
+    };
+  }
+  const setupMode = await select({
+    message: "How would you like to configure?",
+    choices: [
+      { name: "Use a preset", value: "preset" },
+      { name: "Customize settings", value: "custom" }
+    ],
+    default: "preset"
+  });
+  if (setupMode === "preset") {
+    return promptClaudeSettingsPreset(options);
+  }
+  return promptClaudeSettingsCustom(options);
+}
+async function promptClaudeSettingsPreset(options) {
+  const preset = await select({
+    message: "Choose a settings preset:",
+    choices: Object.entries(PRESET_DESCRIPTIONS2).map(([key, description]) => ({
+      name: `${key.charAt(0).toUpperCase() + key.slice(1)} - ${description}`,
+      value: key
+    })),
+    default: "default"
+  });
+  const config = { ...CLAUDE_SETTINGS_PRESETS[preset] };
+  if (options?.includeCoAuthor === false) {
+    config.attribution = {
+      commit: "\u{1F916} Generated with [Claude Code](https://claude.com/claude-code)",
+      pr: "\u{1F916} Generated with [Claude Code](https://claude.com/claude-code)"
+    };
+  }
+  return config;
+}
+async function promptClaudeSettingsCustom(options) {
+  const defaults = options?.defaults || DEFAULT_CLAUDE_SETTINGS;
+  const model = await select({
+    message: "Default Claude model:",
+    choices: Object.entries(MODEL_DESCRIPTIONS).map(([key, description]) => ({
+      name: description,
+      value: key
+    })),
+    default: defaults.model || "sonnet"
+  });
+  const alwaysThinkingEnabled = await confirm({
+    message: "Enable extended thinking by default? (better for complex tasks)",
+    default: defaults.alwaysThinkingEnabled ?? false
+  });
+  const sandboxEnabled = await confirm({
+    message: "Enable bash sandboxing? (isolates shell commands for security)",
+    default: defaults.sandbox?.enabled ?? false
+  });
+  const permissionMode = await select({
+    message: "Default permission mode:",
+    choices: Object.entries(PERMISSION_MODE_DESCRIPTIONS).map(([key, description]) => ({
+      name: description,
+      value: key
+    })),
+    default: defaults.permissions?.defaultMode || "acceptEdits"
+  });
+  const cleanupPeriodStr = await input({
+    message: "Session cleanup period (days, 0 = delete all immediately):",
+    default: String(defaults.cleanupPeriodDays ?? 30),
+    validate: (value) => {
+      const num = Number.parseInt(value, 10);
+      if (Number.isNaN(num) || num < 0 || num > 365) {
+        return "Please enter a number between 0 and 365";
+      }
+      return true;
+    }
+  });
+  const cleanupPeriodDays = Number.parseInt(cleanupPeriodStr, 10);
+  const stopNotification = await select({
+    message: "Notification when task completes:",
+    choices: Object.entries(STOP_NOTIFICATION_DESCRIPTIONS).map(([key, description]) => ({
+      name: description,
+      value: key
+    })),
+    default: defaults.stopNotification || "beep"
+  });
+  let customStopCommand;
+  if (stopNotification === "custom") {
+    customStopCommand = await input({
+      message: "Custom command to run on task completion:",
+      default: defaults.customStopCommand || ""
+    });
+  }
+  const config = {
+    model,
+    alwaysThinkingEnabled,
+    sandbox: {
+      enabled: sandboxEnabled,
+      autoAllowBashIfSandboxed: true
+    },
+    permissions: {
+      allow: defaults.permissions?.allow || [],
+      deny: defaults.permissions?.deny || [],
+      ask: defaults.permissions?.ask || [],
+      defaultMode: permissionMode
+    },
+    attribution: options?.includeCoAuthor === false ? {
+      commit: "\u{1F916} Generated with [Claude Code](https://claude.com/claude-code)",
+      pr: "\u{1F916} Generated with [Claude Code](https://claude.com/claude-code)"
+    } : DEFAULT_CLAUDE_SETTINGS.attribution,
+    cleanupPeriodDays,
+    stopNotification,
+    customStopCommand
+  };
+  if (stopNotification === "beep") {
+    config.hooks = {
+      Stop: [{ hooks: [{ type: "command", command: BEEP_COMMAND, timeout: 5 }] }],
+      SubagentStop: [{ hooks: [{ type: "command", command: BEEP_COMMAND, timeout: 5 }] }]
+    };
+  } else if (stopNotification === "custom" && customStopCommand) {
+    config.hooks = {
+      Stop: [{ hooks: [{ type: "command", command: customStopCommand, timeout: 10 }] }],
+      SubagentStop: [{ hooks: [{ type: "command", command: customStopCommand, timeout: 10 }] }]
+    };
+  }
+  return config;
+}
+
 // src/cli/prompts/code-style.ts
 init_cjs_shims();
 var CODE_STYLE_TOOLS = [
@@ -9854,7 +10294,95 @@ async function promptSubagentStopHook() {
 
 // src/cli/prompts/item-select.ts
 init_cjs_shims();
-async function promptBatchAction(category, totalItems, hasPreset) {
+
+// src/cli/prompts/mutual-exclusivity.ts
+init_cjs_shims();
+function getConflictingSelections(module2, selectedIds) {
+  if (!module2.alternativeTo) {
+    return [];
+  }
+  return module2.alternativeTo.filter((altId) => selectedIds.includes(altId));
+}
+function createChoicesWithExclusivity(modules, selectedIds, options) {
+  const choices = [];
+  for (const module2 of modules) {
+    const conflicts = getConflictingSelections(module2, selectedIds);
+    const isConflicting = conflicts.length > 0;
+    const isPreselected = options?.preselected?.includes(module2.id);
+    const isSelected = selectedIds.includes(module2.id);
+    let name = module2.name;
+    let description = module2.description;
+    let disabled = false;
+    if (isConflicting) {
+      const conflictNames = conflicts.join(", ");
+      disabled = options?.showConflictReason ? `Conflicts with: ${conflictNames}` : `Alternative to ${conflictNames} (already selected)`;
+      name = colors.muted(`${module2.name} (incompatible)`);
+      description = `${colors.muted("\u26A0")} ${disabled}`;
+    }
+    choices.push({
+      name,
+      value: module2.id,
+      description,
+      disabled: isConflicting ? disabled : false,
+      checked: isSelected || isPreselected && !isConflicting
+    });
+  }
+  return choices;
+}
+function validateNoConflicts(selectedIds, allModules) {
+  const conflicts = [];
+  for (const id of selectedIds) {
+    const module2 = allModules.find((m) => m.id === id);
+    if (!module2?.alternativeTo) continue;
+    for (const altId of module2.alternativeTo) {
+      if (selectedIds.includes(altId)) {
+        const existingConflict = conflicts.find(
+          (c) => c.selected === id && c.conflictsWith === altId || c.selected === altId && c.conflictsWith === id
+        );
+        if (!existingConflict) {
+          conflicts.push({ selected: id, conflictsWith: altId });
+        }
+      }
+    }
+  }
+  return conflicts;
+}
+function groupByExclusivity(modules) {
+  const groups = /* @__PURE__ */ new Map();
+  const processedIds = /* @__PURE__ */ new Set();
+  for (const module2 of modules) {
+    if (processedIds.has(module2.id)) continue;
+    const groupMembers = /* @__PURE__ */ new Set([module2.id]);
+    const toProcess = [...module2.alternativeTo || []];
+    while (toProcess.length > 0) {
+      const altId = toProcess.pop();
+      if (!altId || groupMembers.has(altId)) continue;
+      const altModule = modules.find((m) => m.id === altId);
+      if (altModule) {
+        groupMembers.add(altId);
+        for (const transitiveAlt of altModule.alternativeTo || []) {
+          if (!groupMembers.has(transitiveAlt)) {
+            toProcess.push(transitiveAlt);
+          }
+        }
+      }
+    }
+    if (groupMembers.size > 1) {
+      const sortedMembers = Array.from(groupMembers).sort();
+      const groupId = `exclusivity-group-${sortedMembers[0]}`;
+      groups.set(groupId, sortedMembers);
+      for (const memberId of groupMembers) {
+        processedIds.add(memberId);
+      }
+    } else {
+      processedIds.add(module2.id);
+    }
+  }
+  return groups;
+}
+
+// src/cli/prompts/item-select.ts
+async function promptBatchAction(category, totalItems, options) {
   const choices = [
     {
       name: "Install all (recommended)",
@@ -9872,7 +10400,14 @@ async function promptBatchAction(category, totalItems, hasPreset) {
       description: `Skip all ${category}`
     }
   ];
-  if (hasPreset) {
+  if (options?.hasExclusivityGroups && options.exclusivityGroupCount) {
+    choices.splice(1, 0, {
+      name: colors.primary("Smart selection (handles conflicts)"),
+      value: "smart",
+      description: `Intelligent selection with ${options.exclusivityGroupCount} mutually exclusive group(s)`
+    });
+  }
+  if (options?.hasPreset) {
     choices.splice(1, 0, {
       name: "Use preset for this category",
       value: "preset",
@@ -9882,27 +10417,43 @@ async function promptBatchAction(category, totalItems, hasPreset) {
   return select({
     message: `${capitalize(category)} selection (${totalItems} available):`,
     choices,
-    default: "all"
+    default: options?.hasExclusivityGroups ? "smart" : "all"
   });
 }
 async function selectItemsFromCategory(category, items, options) {
-  const selectedItems = [];
-  const skippedItems = [];
   logger.newline();
   logger.subtitle(`${capitalize(category)} Selection`);
   logger.info(`${items.length} ${category} available`);
+  const exclusivityGroups = groupByExclusivity(items);
+  const hasExclusivityGroups = exclusivityGroups.size > 0;
+  if (hasExclusivityGroups) {
+    logger.info(
+      colors.warning(
+        `${exclusivityGroups.size} group(s) of mutually exclusive ${category} detected`
+      )
+    );
+  }
   logger.newline();
-  const batchAction = await promptBatchAction(
-    category,
-    items.length,
-    options?.preselected && options.preselected.length > 0
-  );
+  const batchAction = await promptBatchAction(category, items.length, {
+    hasPreset: options?.preselected && options.preselected.length > 0,
+    hasExclusivityGroups,
+    exclusivityGroupCount: exclusivityGroups.size
+  });
   if (batchAction === "all") {
-    return {
-      category,
-      selectedItems: items.map((i) => i.id),
-      skippedItems: []
-    };
+    const conflicts = validateNoConflicts(
+      items.map((i) => i.id),
+      items
+    );
+    if (conflicts.length > 0) {
+      logger.warn("Cannot install all: some modules are mutually exclusive.");
+      logger.info("Switching to smart selection mode...");
+    } else {
+      return {
+        category,
+        selectedItems: items.map((i) => i.id),
+        skippedItems: []
+      };
+    }
   }
   if (batchAction === "none") {
     return {
@@ -9913,24 +10464,106 @@ async function selectItemsFromCategory(category, items, options) {
   }
   if (batchAction === "preset" && options?.preselected) {
     const preselectedSet = new Set(options.preselected);
-    return {
+    const preselectedIds = items.filter((i) => preselectedSet.has(i.id)).map((i) => i.id);
+    const conflicts = validateNoConflicts(preselectedIds, items);
+    if (conflicts.length > 0) {
+      logger.warn("Preset contains conflicting modules. Switching to smart selection...");
+    } else {
+      return {
+        category,
+        selectedItems: preselectedIds,
+        skippedItems: items.filter((i) => !preselectedSet.has(i.id)).map((i) => i.id)
+      };
+    }
+  }
+  if (batchAction === "smart" || batchAction === "all" || batchAction === "preset") {
+    return selectItemsWithExclusivity(category, items, options);
+  }
+  return selectItemsOneByOne(category, items, options);
+}
+async function selectItemsWithExclusivity(category, items, options) {
+  let selectedIds = options?.preselected?.filter((id) => items.some((i) => i.id === id)) || [];
+  let confirmed = false;
+  while (!confirmed) {
+    const choices = createChoicesWithExclusivity(items, selectedIds, {
+      preselected: options?.preselected,
+      showConflictReason: true
+    });
+    logger.newline();
+    logger.info(
+      colors.muted("Items marked as incompatible are disabled based on your selections.")
+    );
+    logger.info(colors.muted("Uncheck items to enable their alternatives."));
+    logger.newline();
+    const newSelection = await checkbox({
+      message: `Select ${category} (Space to toggle, Enter to confirm):`,
+      choices: choices.map((c) => ({
+        name: c.name,
+        value: c.value,
+        description: c.description,
+        disabled: c.disabled,
+        checked: c.checked
+      })),
+      required: false
+    });
+    const conflicts = validateNoConflicts(newSelection, items);
+    if (conflicts.length > 0) {
+      logger.warn("Your selection contains conflicts:");
+      for (const conflict of conflicts) {
+        const module1 = items.find((i) => i.id === conflict.selected)?.name || conflict.selected;
+        const module2 = items.find((i) => i.id === conflict.conflictsWith)?.name || conflict.conflictsWith;
+        logger.info(`  ${colors.error("\u2022")} ${module1} and ${module2} are mutually exclusive`);
+      }
+      logger.info("Please adjust your selection.");
+      selectedIds = newSelection;
+      continue;
+    }
+    selectedIds = newSelection;
+    showCategorySelectionSummary({
       category,
-      selectedItems: items.filter((i) => preselectedSet.has(i.id)).map((i) => i.id),
-      skippedItems: items.filter((i) => !preselectedSet.has(i.id)).map((i) => i.id)
-    };
+      selectedItems: selectedIds,
+      skippedItems: items.filter((i) => !selectedIds.includes(i.id)).map((i) => i.id)
+    });
+    confirmed = await confirm({
+      message: "Is this selection correct?",
+      default: true
+    });
   }
+  return {
+    category,
+    selectedItems: selectedIds,
+    skippedItems: items.filter((i) => !selectedIds.includes(i.id)).map((i) => i.id)
+  };
+}
+async function selectItemsOneByOne(category, items, options) {
+  const selectedItems = [];
+  const skippedItems = [];
   const remainingItems = [...items];
   let currentIndex = 0;
   while (currentIndex < remainingItems.length) {
     const item = remainingItems[currentIndex];
     const remaining = remainingItems.length - currentIndex - 1;
     const isPreselected = options?.preselected?.includes(item.id);
+    const conflicts = item.alternativeTo?.filter((altId) => selectedItems.includes(altId)) || [];
+    if (conflicts.length > 0) {
+      const conflictNames = conflicts.map((id) => items.find((i) => i.id === id)?.name || id).join(", ");
+      logger.info(
+        colors.muted(`Skipping ${item.name} (conflicts with selected: ${conflictNames})`)
+      );
+      skippedItems.push(item.id);
+      currentIndex++;
+      continue;
+    }
     const progress = colors.muted(`[${currentIndex + 1}/${remainingItems.length}]`);
     console.log(`
 ${progress} ${colors.bold(item.name)}`);
     if (options?.showDescriptions && item.description) {
       logger.note(item.description);
     }
+    if (item.alternativeTo && item.alternativeTo.length > 0) {
+      const altNames = item.alternativeTo.map((id) => items.find((i) => i.id === id)?.name || id).join(", ");
+      logger.info(colors.warning(`\u26A0 Selecting this will disable: ${altNames}`));
+    }
     const action = await promptItemWithShortcuts(item, {
       defaultInstall: isPreselected,
       remainingCount: remaining
@@ -9947,7 +10580,13 @@ ${progress} ${colors.bold(item.name)}`);
       case "install-rest":
         selectedItems.push(item.id);
         for (let i = currentIndex + 1; i < remainingItems.length; i++) {
-          selectedItems.push(remainingItems[i].id);
+          const nextItem = remainingItems[i];
+          const nextConflicts = nextItem.alternativeTo?.filter((altId) => selectedItems.includes(altId)) || [];
+          if (nextConflicts.length === 0) {
+            selectedItems.push(nextItem.id);
+          } else {
+            skippedItems.push(nextItem.id);
+          }
         }
         currentIndex = remainingItems.length;
         break;
@@ -9989,6 +10628,17 @@ async function promptItemWithShortcuts(item, options) {
     default: options.defaultInstall !== false ? "install" : "skip"
   });
 }
+function showCategorySelectionSummary(result) {
+  const { category, selectedItems, skippedItems } = result;
+  logger.newline();
+  logger.subtitle(`${capitalize(category)} Summary`);
+  if (selectedItems.length > 0) {
+    logger.success(`Selected (${selectedItems.length}): ${selectedItems.join(", ")}`);
+  }
+  if (skippedItems.length > 0) {
+    logger.info(`Skipped (${skippedItems.length}): ${colors.muted(skippedItems.join(", "))}`);
+  }
+}
 function capitalize(str) {
   return str.charAt(0).toUpperCase() + str.slice(1);
 }
@@ -10752,6 +11402,122 @@ async function confirmProjectInfo(info) {
   });
 }
 
+// src/cli/prompts/related-skills.ts
+init_cjs_shims();
+function getAllRelatedSkillIds(agentModules) {
+  const relatedIds = /* @__PURE__ */ new Set();
+  for (const agent of agentModules) {
+    if (agent.relatedSkills) {
+      for (const skillId of agent.relatedSkills) {
+        relatedIds.add(skillId);
+      }
+    }
+  }
+  return Array.from(relatedIds);
+}
+function getAgentsWithRelatedSkills(selectedAgentIds, agentModules) {
+  return agentModules.filter(
+    (agent) => selectedAgentIds.includes(agent.id) && agent.relatedSkills && agent.relatedSkills.length > 0
+  );
+}
+async function promptRelatedSkillsForAgent(agent, skillModules, options) {
+  if (!agent.relatedSkills || agent.relatedSkills.length === 0) {
+    return [];
+  }
+  const relatedSkillDefs = agent.relatedSkills.map((skillId) => skillModules.find((s) => s.id === skillId)).filter((s) => s !== void 0);
+  if (relatedSkillDefs.length === 0) {
+    return [];
+  }
+  if (relatedSkillDefs.length === 1) {
+    const skill = relatedSkillDefs[0];
+    const action = await select({
+      message: `${colors.primary(agent.name)} has a related skill. Install it?`,
+      choices: [
+        {
+          name: `Install ${skill.name}`,
+          value: "install",
+          description: skill.description
+        },
+        {
+          name: "Skip",
+          value: "skip",
+          description: "Do not install this skill"
+        }
+      ],
+      default: "install"
+    });
+    return action === "install" ? [skill.id] : [];
+  }
+  const choices = relatedSkillDefs.map((skill) => ({
+    name: skill.name,
+    value: skill.id,
+    description: skill.description,
+    checked: options?.preselected?.includes(skill.id) ?? false
+  }));
+  if (options?.allowMultiple !== false) {
+    const selected2 = await checkbox({
+      message: `${colors.primary(agent.name)} supports multiple frameworks. Select which patterns to install:`,
+      choices,
+      required: false
+    });
+    return selected2;
+  }
+  const choicesWithSkip = [
+    ...choices.map((c) => ({ name: c.name, value: c.value, description: c.description })),
+    {
+      name: colors.muted("Skip (none)"),
+      value: "__skip__",
+      description: "Do not install any related skill for this agent"
+    }
+  ];
+  const selected = await select({
+    message: `${colors.primary(agent.name)} supports multiple frameworks. Select which patterns to use:`,
+    choices: choicesWithSkip,
+    default: choicesWithSkip[0]?.value
+  });
+  return selected === "__skip__" ? [] : [selected];
+}
+async function promptAllRelatedSkills(selectedAgentIds, registry, options) {
+  const agentsWithRelated = getAgentsWithRelatedSkills(selectedAgentIds, registry.agents);
+  const allRelatedSkillIds = getAllRelatedSkillIds(registry.agents);
+  if (agentsWithRelated.length === 0) {
+    return {
+      relatedSkillsSelected: [],
+      relatedSkillsSkipped: [],
+      allRelatedSkillIds
+    };
+  }
+  logger.newline();
+  logger.subtitle("Framework-Specific Skills");
+  logger.info(
+    "The selected agents support framework-specific patterns. Select which ones to install."
+  );
+  logger.newline();
+  const selectedSkills = [];
+  const skippedSkills = [];
+  for (const agent of agentsWithRelated) {
+    const selected = await promptRelatedSkillsForAgent(agent, registry.skills, {
+      preselected: options?.preselectedSkills,
+      allowMultiple: options?.allowMultiplePerAgent
+    });
+    selectedSkills.push(...selected);
+    const agentRelatedIds = agent.relatedSkills || [];
+    const skipped = agentRelatedIds.filter((id) => !selected.includes(id));
+    skippedSkills.push(...skipped);
+  }
+  const uniqueSelected = [...new Set(selectedSkills)];
+  const uniqueSkipped = [...new Set(skippedSkills)].filter((id) => !uniqueSelected.includes(id));
+  return {
+    relatedSkillsSelected: uniqueSelected,
+    relatedSkillsSkipped: uniqueSkipped,
+    allRelatedSkillIds
+  };
+}
+function filterOutRelatedSkills(skillModules, relatedSkillIds) {
+  const relatedSet = new Set(relatedSkillIds);
+  return skillModules.filter((skill) => !relatedSet.has(skill.id));
+}
+
 // src/cli/prompts/scaffold.ts
 init_cjs_shims();
 async function promptScaffoldType(options) {
@@ -11513,11 +12279,66 @@ function createBundleSelectionStep() {
       }
       if (mode === "individual" || mode === "both") {
         const preselectedFromBundles = resolveBundles(result.selectedBundles);
-        const categories = ["agents", "skills", "commands", "docs"];
         if (ctx.registry) {
           logger.newline();
           logger.subtitle("Individual Module Selection");
-          for (const category of categories) {
+          const agentPreselected = mode === "both" ? preselectedFromBundles.agents : [];
+          const agentResult = await selectItemsFromCategory("agents", ctx.registry.agents, {
+            preselected: agentPreselected,
+            showDescriptions: true
+          });
+          if (mode === "both") {
+            result.additionalModules.agents = agentResult.selectedItems.filter(
+              (id) => !agentPreselected.includes(id)
+            );
+          } else {
+            result.additionalModules.agents = agentResult.selectedItems;
+          }
+          const allSelectedAgents = [
+            ...preselectedFromBundles.agents,
+            ...result.additionalModules.agents
+          ];
+          const relatedSkillsResult = await promptAllRelatedSkills(
+            allSelectedAgents,
+            ctx.registry,
+            {
+              preselectedSkills: mode === "both" ? preselectedFromBundles.skills : [],
+              allowMultiplePerAgent: true
+            }
+          );
+          const skillPreselected = mode === "both" ? preselectedFromBundles.skills : [];
+          const independentSkills = filterOutRelatedSkills(
+            ctx.registry.skills,
+            relatedSkillsResult.allRelatedSkillIds
+          );
+          const independentPreselected = skillPreselected.filter(
+            (id) => !relatedSkillsResult.allRelatedSkillIds.includes(id)
+          );
+          let independentSkillsSelected = [];
+          if (independentSkills.length > 0) {
+            logger.newline();
+            logger.info(
+              colors.muted("Now selecting general-purpose skills (not framework-specific):")
+            );
+            const skillResult = await selectItemsFromCategory("skills", independentSkills, {
+              preselected: independentPreselected,
+              showDescriptions: true
+            });
+            independentSkillsSelected = skillResult.selectedItems;
+          }
+          const allSelectedSkills = [
+            ...relatedSkillsResult.relatedSkillsSelected,
+            ...independentSkillsSelected
+          ];
+          if (mode === "both") {
+            result.additionalModules.skills = allSelectedSkills.filter(
+              (id) => !skillPreselected.includes(id)
+            );
+          } else {
+            result.additionalModules.skills = allSelectedSkills;
+          }
+          const otherCategories = ["commands", "docs"];
+          for (const category of otherCategories) {
             const preselected = mode === "both" ? preselectedFromBundles[category] : [];
             const categoryResult = await selectItemsFromCategory(category, ctx.registry[category], {
               preselected,
@@ -11689,6 +12510,28 @@ function createTemplateConfigStep() {
     }
   };
 }
+function createClaudeSettingsStep() {
+  return {
+    metadata: {
+      id: "claudeSettings",
+      name: "Claude Code Settings",
+      description: "Configure Claude Code model, permissions, and behavior",
+      required: false
+    },
+    computeDefaults: (ctx) => ctx.claudeSettings,
+    execute: async (ctx, defaults) => {
+      const goBack = await promptBackOption(11, "Configure Claude Code settings or go back?");
+      if (goBack) {
+        return createResult(defaults, "back");
+      }
+      const value = await promptClaudeSettings({
+        defaults,
+        includeCoAuthor: ctx.preferences?.includeCoAuthor
+      });
+      return createResult(value, "next");
+    }
+  };
+}
 function createInitWizardConfig(projectPath, detection, registry) {
   void projectPath;
   void detection;
@@ -11737,6 +12580,10 @@ function createInitWizardConfig(projectPath, detection, registry) {
     {
       id: "templateConfig",
       definition: createTemplateConfigStep()
+    },
+    {
+      id: "claudeSettings",
+      definition: createClaudeSettingsStep()
     }
   ];
   return {
@@ -12061,7 +12908,7 @@ async function runInit(path10, options) {
       logger.warn("Configuration cancelled");
       return;
     }
-    const { config, skippedMcpConfigs, templateConfig, cicdConfig } = buildResult;
+    const { config, skippedMcpConfigs, templateConfig, cicdConfig, claudeSettings } = buildResult;
     if (templateConfig) {
       config.templateConfig = templateConfig;
     }
@@ -12078,7 +12925,15 @@ async function runInit(path10, options) {
       showConfigSummary(config);
       return;
     }
-    await executeInstallation(projectPath, config, registry, templatesPath, options, cicdConfig);
+    await executeInstallation(
+      projectPath,
+      config,
+      registry,
+      templatesPath,
+      options,
+      cicdConfig,
+      claudeSettings
+    );
     if (templateConfig && !options.noPlaceholders) {
       const claudePath = joinPath(projectPath, ".claude");
       await replaceTemplateConfigWithSpinner(claudePath, templateConfig);
@@ -12295,7 +13150,8 @@ async function buildInteractiveConfig(projectPath, detection, registry, options,
     codeStyleConfig,
     cicdConfig,
     folderPreferences,
-    templateConfig: templateConfigResult
+    templateConfig: templateConfigResult,
+    claudeSettings
   } = wizardResult.values;
   let mcpConfig = { level: "project", servers: [] };
   let skippedMcpConfigs = [];
@@ -12353,10 +13209,11 @@ async function buildInteractiveConfig(projectPath, detection, registry, options,
     config,
     skippedMcpConfigs,
     templateConfig: templateConfigResult,
-    cicdConfig
+    cicdConfig,
+    claudeSettings
   };
 }
-async function executeInstallation(projectPath, config, registry, templatesPath, options, cicdConfig) {
+async function executeInstallation(projectPath, config, registry, templatesPath, options, cicdConfig, claudeSettings) {
   logger.newline();
   logger.title("Installing Configuration");
   if (config.scaffold.type === "full-project") {
@@ -12378,6 +13235,28 @@ async function executeInstallation(projectPath, config, registry, templatesPath,
   } else if (claudeMdResult.skipped) {
     logger.info("CLAUDE.md already exists, skipped");
   }
+  if (claudeSettings) {
+    const settingsResult = await generateSettingsWithSpinner(projectPath, {
+      claudeSettings,
+      includeCoAuthor: config.preferences.includeCoAuthor,
+      overwrite: options.force
+    });
+    if (settingsResult.error) {
+      logger.warn(`settings.json generation warning: ${settingsResult.error}`);
+    } else if (settingsResult.skipped) {
+      logger.info("settings.json already exists, skipped");
+    }
+    const settingsLocalResult = await generateSettingsLocalWithSpinner(projectPath, {
+      claudeSettings,
+      includeCoAuthor: config.preferences.includeCoAuthor,
+      overwrite: options.force
+    });
+    if (settingsLocalResult.error) {
+      logger.warn(`settings.local.json generation warning: ${settingsLocalResult.error}`);
+    } else if (settingsLocalResult.skipped) {
+      logger.info("settings.local.json already exists, skipped");
+    }
+  }
   const modulesByCategory = {
     agents: filterModules(registry, "agents", config.modules.agents.selected),
     skills: filterModules(registry, "skills", config.modules.skills.selected),