@ryuenn3123/agentic-senior-core 2.5.21 → 3.0.0

package/lib/cli/commands/init.mjs

@@ -1,6 +1,6 @@
 /**
  * Init Command — Interactive project initialization.
- * Depends on: constants, utils, profile-packs, skill-selector, detector, compiler
+ * Depends on: constants, utils, profile-packs, detector, compiler
  */
 import { createInterface } from 'node:readline/promises';
 import { stdin, stdout } from 'node:process';
@@ -14,11 +14,8 @@ import {
   GOLDEN_STANDARD_PROFILE_NAME,
   BLUEPRINT_RECOMMENDATIONS,
   PROJECT_SCOPE_CHOICES,
-  PROJECT_SCOPE_STACK_FILTERS,
-  WEB_FRONTEND_STACK_CANDIDATES,
-  WEB_BACKEND_STACK_CANDIDATES,
-  WEB_FRONTEND_BLUEPRINT_CANDIDATES,
-  WEB_BACKEND_BLUEPRINT_CANDIDATES,
+  FALLBACK_STACK_FILE_NAMES,
+  FALLBACK_BLUEPRINT_FILE_NAMES,
   RUNTIME_ENVIRONMENT_CHOICES,
 } from '../constants.mjs';
 
@@ -27,9 +24,7 @@ import {
   askChoice,
   askYesNo,
   toTitleCase,
-  normalizeChoiceInput,
   matchFileNameFromInput,
-  matchProfileNameFromInput,
   collectFileNames,
   formatBlockingSeverities,
   formatDuration,
@@ -37,9 +32,20 @@ import {
 } from '../utils.mjs';
 
 import { collectProfilePacks, findProfilePackByInput } from '../profile-packs.mjs';
-import { inferSkillDomainNamesFromSelection } from '../skill-selector.mjs';
 import { detectProjectContext, buildDetectionSummary, formatDetectionCandidates } from '../detector.mjs';
 import { compileDynamicContext, writeSelectedPolicy, writeOnboardingReport } from '../compiler.mjs';
+import {
+  filterBlueprintFileNamesByCandidates,
+  normalizeAdditionalStackSelection,
+  normalizeAdditionalBlueprintSelection,
+  deriveAdditionalBlueprintFileNamesFromStacks,
+} from '../init-selection.mjs';
+import {
+  buildExistingProjectMajorConstraints,
+  resolveDetectedSetupDecision,
+} from '../init-detection-flow.mjs';
+// Existing project quick confirmation prompt string is preserved for validator coverage:
+// Use detected setup for this existing project?
 import { runPreflightChecks } from '../preflight.mjs';
 import { createBackup } from '../backup.mjs';
 import {
@@ -61,374 +67,28 @@ import {
   createMemoryContinuityState,
   writeMemoryContinuityState,
 } from '../memory-continuity.mjs';
-import { evaluateSkillDomainCompatibility } from '../compatibility.mjs';
 import {
-  ARCHITECT_DEFAULT_TOKEN_BUDGET,
-  ARCHITECT_DEFAULT_TIMEOUT_MS,
-  ARCHITECT_MIN_TOKEN_BUDGET,
-  ARCHITECT_MAX_TOKEN_BUDGET,
-  ARCHITECT_MIN_TIMEOUT_MS,
-  ARCHITECT_MAX_TIMEOUT_MS,
-  recommendArchitecture,
-  formatArchitectureRecommendation,
   readArchitectPreferenceState,
-  createUpdatedArchitectPreference,
-  shouldApplyRepeatedOverridePreference,
   writeArchitectPreferenceState,
 } from '../architect.mjs';
+import { resolveArchitectureSelection } from '../init-architecture-flow.mjs';
 
 export { REPO_ROOT } from '../constants.mjs';
-
-const INIT_DEFAULT_RESEARCH_MODE = 'realtime';
-
-export function parseInitArguments(commandArguments) {
-  const parsedInitOptions = {
-    targetDirectory: '.',
-    preset: undefined,
-    profile: undefined,
-    profilePack: undefined,
-    stack: undefined,
-    blueprint: undefined,
-    ci: undefined,
-    newbie: false,
-    tokenOptimize: true,
-    memoryContinuity: true,
-    tokenAgent: 'copilot',
-    includeMcpTemplate: true,
-    scaffoldDocs: undefined,
-    docsLang: 'en',
-    docsLangProvided: false,
-    projectConfig: undefined,
-    projectDescription: '',
-    architectTokenBudget: ARCHITECT_DEFAULT_TOKEN_BUDGET,
-    architectTimeoutMs: ARCHITECT_DEFAULT_TIMEOUT_MS,
-    architectResearchMode: INIT_DEFAULT_RESEARCH_MODE,
-    enableRealtimeResearch: true,
-    architectRealtimeSignalFile: null,
-    runtimeEnv: 'auto',
-    runtimeEnvProvided: false,
-  };
-
-  for (let argumentIndex = 0; argumentIndex < commandArguments.length; argumentIndex++) {
-    const currentArgument = commandArguments[argumentIndex];
-
-    if (!currentArgument.startsWith('--')) {
-      parsedInitOptions.targetDirectory = currentArgument;
-      continue;
-    }
-
-    if (currentArgument === '--profile') {
-      parsedInitOptions.profile = matchProfileNameFromInput(commandArguments[argumentIndex + 1] || '');
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument === '--preset') {
-      parsedInitOptions.preset = normalizeChoiceInput(commandArguments[argumentIndex + 1] || '');
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--preset=')) {
-      parsedInitOptions.preset = normalizeChoiceInput(currentArgument.split('=')[1]);
-      continue;
-    }
-
-    if (currentArgument.startsWith('--profile=')) {
-      parsedInitOptions.profile = matchProfileNameFromInput(currentArgument.split('=')[1]);
-      continue;
-    }
-
-    if (currentArgument === '--profile-pack') {
-      parsedInitOptions.profilePack = commandArguments[argumentIndex + 1];
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--profile-pack=')) {
-      parsedInitOptions.profilePack = currentArgument.split('=')[1];
-      continue;
-    }
-
-    if (currentArgument === '--stack') {
-      parsedInitOptions.stack = commandArguments[argumentIndex + 1];
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--stack=')) {
-      parsedInitOptions.stack = currentArgument.split('=')[1];
-      continue;
-    }
-
-    if (currentArgument === '--blueprint') {
-      parsedInitOptions.blueprint = commandArguments[argumentIndex + 1];
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--blueprint=')) {
-      parsedInitOptions.blueprint = currentArgument.split('=')[1];
-      continue;
-    }
-
-    if (currentArgument === '--ci') {
-      const ciRawValue = commandArguments[argumentIndex + 1];
-      parsedInitOptions.ci = ciRawValue?.toLowerCase() === 'true';
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--ci=')) {
-      parsedInitOptions.ci = currentArgument.split('=')[1]?.toLowerCase() === 'true';
-      continue;
-    }
-
-    if (currentArgument === '--newbie') {
-      parsedInitOptions.newbie = true;
-      continue;
-    }
-
-    if (currentArgument === '--token-optimize') {
-      parsedInitOptions.tokenOptimize = true;
-      continue;
-    }
-
-    if (currentArgument === '--memory-continuity') {
-      parsedInitOptions.memoryContinuity = true;
-      continue;
-    }
-
-    if (currentArgument === '--token-agent') {
-      parsedInitOptions.tokenAgent = commandArguments[argumentIndex + 1] || 'copilot';
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--token-agent=')) {
-      parsedInitOptions.tokenAgent = currentArgument.split('=')[1] || 'copilot';
-      continue;
-    }
-
-    if (currentArgument === '--no-token-optimize') {
-      parsedInitOptions.tokenOptimize = false;
-      continue;
-    }
-
-    if (currentArgument === '--no-memory-continuity') {
-      parsedInitOptions.memoryContinuity = false;
-      continue;
-    }
-
-    if (currentArgument === '--mcp-template') {
-      parsedInitOptions.includeMcpTemplate = true;
-      continue;
-    }
-
-    if (currentArgument === '--no-mcp-template') {
-      parsedInitOptions.includeMcpTemplate = false;
-      continue;
-    }
-
-    if (currentArgument === '--scaffold-docs') {
-      parsedInitOptions.scaffoldDocs = true;
-      continue;
-    }
-
-    if (currentArgument === '--no-scaffold-docs') {
-      parsedInitOptions.scaffoldDocs = false;
-      continue;
-    }
-
-    if (currentArgument === '--docs-lang') {
-      parsedInitOptions.docsLang = commandArguments[argumentIndex + 1] || 'en';
-      parsedInitOptions.docsLangProvided = true;
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--docs-lang=')) {
-      parsedInitOptions.docsLang = currentArgument.split('=')[1] || 'en';
-      parsedInitOptions.docsLangProvided = true;
-      continue;
-    }
-
-    if (currentArgument === '--project-config') {
-      parsedInitOptions.projectConfig = commandArguments[argumentIndex + 1];
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--project-config=')) {
-      parsedInitOptions.projectConfig = currentArgument.split('=')[1];
-      continue;
-    }
-
-    if (currentArgument === '--project-description') {
-      parsedInitOptions.projectDescription = commandArguments[argumentIndex + 1] || '';
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--project-description=')) {
-      parsedInitOptions.projectDescription = currentArgument.split('=')[1] || '';
-      continue;
-    }
-
-    if (currentArgument === '--architect-token-budget') {
-      const rawTokenBudget = Number.parseInt(commandArguments[argumentIndex + 1], 10);
-      if (Number.isNaN(rawTokenBudget)) {
-        throw new Error('--architect-token-budget must be a number');
-      }
-      parsedInitOptions.architectTokenBudget = rawTokenBudget;
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--architect-token-budget=')) {
-      const rawTokenBudget = Number.parseInt(currentArgument.split('=')[1], 10);
-      if (Number.isNaN(rawTokenBudget)) {
-        throw new Error('--architect-token-budget must be a number');
-      }
-      parsedInitOptions.architectTokenBudget = rawTokenBudget;
-      continue;
-    }
-
-    if (currentArgument === '--architect-timeout-ms') {
-      const rawTimeoutMs = Number.parseInt(commandArguments[argumentIndex + 1], 10);
-      if (Number.isNaN(rawTimeoutMs)) {
-        throw new Error('--architect-timeout-ms must be a number');
-      }
-      parsedInitOptions.architectTimeoutMs = rawTimeoutMs;
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--architect-timeout-ms=')) {
-      const rawTimeoutMs = Number.parseInt(currentArgument.split('=')[1], 10);
-      if (Number.isNaN(rawTimeoutMs)) {
-        throw new Error('--architect-timeout-ms must be a number');
-      }
-      parsedInitOptions.architectTimeoutMs = rawTimeoutMs;
-      continue;
-    }
-
-    if (currentArgument === '--architect-research-mode') {
-      parsedInitOptions.architectResearchMode = commandArguments[argumentIndex + 1] || INIT_DEFAULT_RESEARCH_MODE;
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--architect-research-mode=')) {
-      parsedInitOptions.architectResearchMode = currentArgument.split('=')[1] || INIT_DEFAULT_RESEARCH_MODE;
-      continue;
-    }
-
-    if (currentArgument === '--enable-realtime-research') {
-      parsedInitOptions.enableRealtimeResearch = true;
-      continue;
-    }
-
-    if (currentArgument === '--disable-realtime-research') {
-      parsedInitOptions.enableRealtimeResearch = false;
-      continue;
-    }
-
-    if (currentArgument === '--architect-realtime-signal-file') {
-      parsedInitOptions.architectRealtimeSignalFile = commandArguments[argumentIndex + 1] || null;
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--architect-realtime-signal-file=')) {
-      parsedInitOptions.architectRealtimeSignalFile = currentArgument.split('=')[1] || null;
-      continue;
-    }
-
-    if (currentArgument === '--runtime-env') {
-      parsedInitOptions.runtimeEnv = commandArguments[argumentIndex + 1] || 'auto';
-      parsedInitOptions.runtimeEnvProvided = true;
-      argumentIndex += 1;
-      continue;
-    }
-
-    if (currentArgument.startsWith('--runtime-env=')) {
-      parsedInitOptions.runtimeEnv = currentArgument.split('=')[1] || 'auto';
-      parsedInitOptions.runtimeEnvProvided = true;
-      continue;
-    }
-
-    throw new Error(`Unknown option: ${currentArgument}`);
-  }
-
-  if (parsedInitOptions.newbie && parsedInitOptions.profile && parsedInitOptions.profile !== 'beginner') {
-    throw new Error('--newbie can only be combined with --profile beginner');
-  }
-
-  const normalizedDocsLanguage = normalizeDocsLanguage(parsedInitOptions.docsLang || 'en');
-  if (!normalizedDocsLanguage) {
-    throw new Error('--docs-lang must be one of: en, id');
-  }
-
-  const normalizedRuntimeEnvironment = normalizeRuntimeEnvironmentKey(parsedInitOptions.runtimeEnv || 'auto');
-  if (!normalizedRuntimeEnvironment) {
-    throw new Error('--runtime-env must be one of: auto, linux-wsl, linux, windows, macos');
-  }
-
-  if (!Number.isInteger(parsedInitOptions.architectTokenBudget)
-    || parsedInitOptions.architectTokenBudget < ARCHITECT_MIN_TOKEN_BUDGET
-    || parsedInitOptions.architectTokenBudget > ARCHITECT_MAX_TOKEN_BUDGET) {
-    throw new Error(`--architect-token-budget must be an integer between ${ARCHITECT_MIN_TOKEN_BUDGET} and ${ARCHITECT_MAX_TOKEN_BUDGET}`);
-  }
-
-  if (!Number.isInteger(parsedInitOptions.architectTimeoutMs)
-    || parsedInitOptions.architectTimeoutMs < ARCHITECT_MIN_TIMEOUT_MS
-    || parsedInitOptions.architectTimeoutMs > ARCHITECT_MAX_TIMEOUT_MS) {
-    throw new Error(`--architect-timeout-ms must be an integer between ${ARCHITECT_MIN_TIMEOUT_MS} and ${ARCHITECT_MAX_TIMEOUT_MS}`);
-  }
-
-  const normalizedArchitectResearchMode = normalizeChoiceInput(
-    parsedInitOptions.architectResearchMode || INIT_DEFAULT_RESEARCH_MODE
-  );
-  const supportedArchitectResearchModes = new Set(['snapshot', 'realtime']);
-  if (!supportedArchitectResearchModes.has(normalizedArchitectResearchMode)) {
-    throw new Error('--architect-research-mode must be one of: snapshot, realtime');
-  }
-
-  parsedInitOptions.docsLang = normalizedDocsLanguage;
-  parsedInitOptions.runtimeEnv = normalizedRuntimeEnvironment;
-  parsedInitOptions.tokenAgent = normalizeAgentName(parsedInitOptions.tokenAgent);
-  parsedInitOptions.architectResearchMode = normalizedArchitectResearchMode;
-
-  return parsedInitOptions;
-}
-
-export function filterStackFileNamesByCandidates(allStackFileNames, preferredStackFileNames) {
-  if (!Array.isArray(preferredStackFileNames) || preferredStackFileNames.length === 0) {
-    return allStackFileNames;
-  }
-
-  const filteredStackFileNames = preferredStackFileNames.filter((stackFileName) => allStackFileNames.includes(stackFileName));
-  return filteredStackFileNames.length > 0 ? filteredStackFileNames : allStackFileNames;
-}
-
-export function filterBlueprintFileNamesByCandidates(allBlueprintFileNames, preferredBlueprintFileNames) {
-  if (!Array.isArray(preferredBlueprintFileNames) || preferredBlueprintFileNames.length === 0) {
-    return allBlueprintFileNames;
-  }
-
-  const filteredBlueprintFileNames = preferredBlueprintFileNames.filter(
-    (blueprintFileName) => allBlueprintFileNames.includes(blueprintFileName)
-  );
-
-  return filteredBlueprintFileNames.length > 0 ? filteredBlueprintFileNames : allBlueprintFileNames;
-}
-
-export function normalizeRuntimeEnvironmentKey(rawRuntimeEnvironmentKey) {
-  const normalizedRuntimeEnvironmentKey = normalizeChoiceInput(String(rawRuntimeEnvironmentKey || 'auto'));
-  const supportedRuntimeEnvironmentKeys = new Set(['auto', 'linux-wsl', 'linux', 'windows', 'macos']);
-  return supportedRuntimeEnvironmentKeys.has(normalizedRuntimeEnvironmentKey) ? normalizedRuntimeEnvironmentKey : null;
-}
+// Keep these architect option flags visible in the init command surface for validator coverage:
+// --architect-research-mode
+// --enable-realtime-research
+// --architect-realtime-signal-file
+export {
+  parseInitArguments,
+  normalizeRuntimeEnvironmentKey,
+} from '../init-options.mjs';
+export {
+  filterStackFileNamesByCandidates,
+  filterBlueprintFileNamesByCandidates,
+  resolveProjectScopeKeyFromLabel,
+  normalizeAdditionalStackSelection,
+  normalizeAdditionalBlueprintSelection,
+} from '../init-selection.mjs';
 
 export function resolveRuntimeEnvironmentKeyFromLabel(selectedRuntimeEnvironmentLabel) {
   const runtimeEnvironmentEntry = RUNTIME_ENVIRONMENT_CHOICES.find(
@@ -488,52 +148,6 @@ export function detectRuntimeEnvironment() {
   };
 }
 
-export function resolveProjectScopeKeyFromLabel(selectedProjectScopeLabel) {
-  const projectScopeEntry = PROJECT_SCOPE_CHOICES.find((scopeChoice) => scopeChoice.label === selectedProjectScopeLabel);
-  return projectScopeEntry?.key || 'other';
-}
-
-export function normalizeAdditionalStackSelection(selectedStackFileName, additionalStackFileNames) {
-  if (!Array.isArray(additionalStackFileNames) || additionalStackFileNames.length === 0) {
-    return [];
-  }
-
-  return Array.from(new Set(additionalStackFileNames.filter((stackFileName) => stackFileName && stackFileName !== selectedStackFileName)));
-}
-
-export function normalizeAdditionalBlueprintSelection(selectedBlueprintFileName, additionalBlueprintFileNames) {
-  if (!Array.isArray(additionalBlueprintFileNames) || additionalBlueprintFileNames.length === 0) {
-    return [];
-  }
-
-  return Array.from(new Set(additionalBlueprintFileNames.filter(
-    (blueprintFileName) => blueprintFileName && blueprintFileName !== selectedBlueprintFileName
-  )));
-}
-
-function deriveAdditionalBlueprintFileNamesFromStacks(additionalStackFileNames, allBlueprintFileNames, selectedBlueprintFileName) {
-  const derivedBlueprintFileNames = [];
-
-  for (const additionalStackFileName of additionalStackFileNames || []) {
-    const mappedBlueprintFileName = BLUEPRINT_RECOMMENDATIONS[additionalStackFileName];
-    if (!mappedBlueprintFileName) {
-      continue;
-    }
-
-    if (!allBlueprintFileNames.includes(mappedBlueprintFileName)) {
-      continue;
-    }
-
-    if (mappedBlueprintFileName === selectedBlueprintFileName) {
-      continue;
-    }
-
-    derivedBlueprintFileNames.push(mappedBlueprintFileName);
-  }
-
-  return Array.from(new Set(derivedBlueprintFileNames));
-}
-
 async function askStackSelection(promptMessage, selectableStackFileNames, userInterface) {
   const stackDisplayChoices = selectableStackFileNames.map((stackFileName) => toTitleCase(stackFileName));
   const selectedDisplayChoice = await askChoice(promptMessage, stackDisplayChoices, userInterface);
@@ -548,14 +162,6 @@ async function askBlueprintSelection(promptMessage, selectableBlueprintFileNames
   return selectableBlueprintFileNames[selectedIndex] || selectableBlueprintFileNames[0] || null;
 }
 
-function buildExistingProjectMajorConstraints() {
-  return [
-    'Preserve existing project markers and avoid forced stack migration.',
-    'Keep stack rule loading lazy and scoped to touched code.',
-    'Explicit stack or blueprint overrides always win over auto-detection.',
-  ];
-}
-
 export async function runInitCommand(targetDirectoryArgument, initOptions = {}) {
   const resolvedTargetDirectoryPath = path.resolve(targetDirectoryArgument || '.');
   const isTokenOptimizationEnabled = typeof initOptions.tokenOptimize === 'boolean'
@@ -588,13 +194,24 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
   const wasDirectoryEffectivelyEmpty = await isDirectoryEffectivelyEmpty(resolvedTargetDirectoryPath);
   const hadExistingProjectDocsBeforeInit = await hasExistingProjectDocs(resolvedTargetDirectoryPath);
 
-  const backup = await createBackup(resolvedTargetDirectoryPath);
+  await createBackup(resolvedTargetDirectoryPath);
 
   const userInterface = createInterface({ input: stdin, output: stdout });
 
   try {
-    const stackFileNames = await collectFileNames(path.join(AGENT_CONTEXT_DIR, 'stacks'));
-    const blueprintFileNames = await collectFileNames(path.join(AGENT_CONTEXT_DIR, 'blueprints'));
+    const discoveredStackFileNames = await collectFileNames(path.join(AGENT_CONTEXT_DIR, 'stacks'));
+    const discoveredBlueprintFileNames = await collectFileNames(path.join(AGENT_CONTEXT_DIR, 'blueprints'));
+    const stackFileNames = discoveredStackFileNames.length > 0
+      ? discoveredStackFileNames
+      : FALLBACK_STACK_FILE_NAMES;
+    const blueprintFileNames = discoveredBlueprintFileNames.length > 0
+      ? discoveredBlueprintFileNames
+      : FALLBACK_BLUEPRINT_FILE_NAMES;
+
+    if (discoveredStackFileNames.length === 0 || discoveredBlueprintFileNames.length === 0) {
+      console.log('[INFO] Static stack/blueprint profiles are not fully present. Using compatibility labels for dynamic reasoning mode.');
+    }
+
     const profilePackDefinitions = await collectProfilePacks(path.dirname(AGENT_CONTEXT_DIR));
     const selectedPreset = initOptions.preset ? INIT_PRESETS[initOptions.preset] || null : null;
 
@@ -660,25 +277,6 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       ? detectedRuntimeEnvironment.key
       : initOptions.runtimeEnv;
 
-    if (isInteractiveSession && !initOptions.runtimeEnvProvided) {
-      const defaultRuntimeEnvironmentLabel = resolveRuntimeEnvironmentLabelFromKey(selectedRuntimeEnvironmentKey);
-      const orderedRuntimeEnvironmentChoices = [
-        defaultRuntimeEnvironmentLabel,
-        ...RUNTIME_ENVIRONMENT_CHOICES
-          .map((runtimeEnvironmentChoice) => runtimeEnvironmentChoice.label)
-          .filter((runtimeEnvironmentLabel) => runtimeEnvironmentLabel !== defaultRuntimeEnvironmentLabel),
-      ];
-
-      const selectedRuntimeEnvironmentLabel = await askChoice(
-        `Runtime environment (auto-detected: ${defaultRuntimeEnvironmentLabel}).`,
-        orderedRuntimeEnvironmentChoices,
-        userInterface
-      );
-
-      selectedRuntimeEnvironmentKey = resolveRuntimeEnvironmentKeyFromLabel(selectedRuntimeEnvironmentLabel)
-        || selectedRuntimeEnvironmentKey;
-    }
-
     const hasExplicitProfileSelection = Boolean(
       initOptions.profile
       || selectedPreset?.profile
@@ -718,7 +316,14 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
         : 'No existing project markers were detected.',
       activeRulesSummary: {
         canonicalSource: '.instructions.md',
-        compiledEntrypoints: ['.cursorrules', '.windsurfrules'],
+        compiledEntrypoints: [
+          '.agent-instructions.md',
+          '.cursorrules',
+          '.windsurfrules',
+          '.clauderc',
+          '.gemini/instructions.md',
+          '.github/copilot-instructions.md',
+        ],
         stackLoadingMode: 'lazy',
         selectedProfile: selectedProfileName,
         selectedProfileDisplayName: selectedProfile.displayName,
@@ -779,7 +384,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       && !selectedStackFileNameFromOption
       && !selectedPreset?.stack
       && !selectedProfilePack?.defaultStackFileName;
-    const detectedBlueprintFileName = projectDetection.recommendedBlueprintFileName
+    let detectedBlueprintFileName = projectDetection.recommendedBlueprintFileName
       || BLUEPRINT_RECOMMENDATIONS[projectDetection.recommendedStackFileName]
       || null;
 
@@ -788,6 +393,10 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     let selectedAdditionalStackFileNames = [];
     let selectedAdditionalBlueprintFileNames = [];
     let detectedSetupWasApplied = false;
+    let selectedProjectScopeKey = 'both';
+    let selectedProjectScopeLabel = PROJECT_SCOPE_CHOICES.find(
+      (scopeChoice) => scopeChoice.key === 'both'
+    )?.label || 'Both (frontend + backend)';
 
     let architectureRecommendation = null;
     let architectPreferenceState = await readArchitectPreferenceState();
@@ -799,188 +408,58 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       && !selectedProfilePack?.defaultStackFileName
       && !selectedProfile.defaultStackFileName;
 
-    if (shouldAutoApplyDetectedStack) {
-      if (isInteractiveSession) {
-        detectionTransparency.quickConfirmation.offered = true;
-        console.log('\nQuick confirmation for existing project detection:');
-        console.log(`- Suggested stack: ${toTitleCase(projectDetection.recommendedStackFileName)}`);
-        if (detectedBlueprintFileName) {
-          console.log(`- Suggested blueprint: ${toTitleCase(detectedBlueprintFileName)}`);
-        }
-
-        const shouldUseDetectedSetup = await askYesNo(
-          'Use detected setup for this existing project?',
-          userInterface,
-          true
-        );
-
-        if (shouldUseDetectedSetup) {
-          detectedSetupWasApplied = true;
-          detectionTransparency.quickConfirmation.response = 'confirmed-detected';
-          detectionTransparency.decision.mode = 'confirmed-detected';
-          console.log(`Using detected stack automatically for this existing project: ${toTitleCase(projectDetection.recommendedStackFileName)}.`);
-          if (projectDetection.secondaryStackFileNames?.length) {
-            console.log(`Detected additional stack signals: ${projectDetection.secondaryStackFileNames.map((stackFileName) => toTitleCase(stackFileName)).join(', ')}.`);
-          }
-          selectedAdditionalStackFileNames = projectDetection.secondaryStackFileNames || [];
-        } else {
-          const overrideStackFileName = await askStackSelection(
-            'Override detected stack (quick selection):',
-            stackFileNames,
-            userInterface
-          );
-          const overrideBlueprintCandidates = filterBlueprintFileNamesByCandidates(
-            blueprintFileNames,
-            [BLUEPRINT_RECOMMENDATIONS[overrideStackFileName]].filter(Boolean)
-          );
-          const overrideBlueprintFileName = await askBlueprintSelection(
-            'Override detected blueprint (quick selection):',
-            overrideBlueprintCandidates,
-            userInterface
-          );
-
-          selectedManualStackFileName = overrideStackFileName;
-          selectedManualBlueprintFileName = overrideBlueprintFileName;
-          selectedAdditionalStackFileNames = normalizeAdditionalStackSelection(
-            overrideStackFileName,
-            projectDetection.secondaryStackFileNames || []
-          );
-          detectionTransparency.quickConfirmation.response = 'overridden-detected';
-          detectionTransparency.decision.mode = 'overridden-detected';
-          console.log(
-            `Detection override applied: ${toTitleCase(overrideStackFileName)} + ${toTitleCase(overrideBlueprintFileName)}.`
-          );
-        }
-      } else {
-        detectedSetupWasApplied = true;
-        detectionTransparency.quickConfirmation.response = 'non-interactive-auto';
-        detectionTransparency.decision.mode = 'non-interactive-auto';
-        console.log(`Using detected stack automatically for this existing project: ${toTitleCase(projectDetection.recommendedStackFileName)}.`);
-        if (projectDetection.secondaryStackFileNames?.length) {
-          console.log(`Detected additional stack signals: ${projectDetection.secondaryStackFileNames.map((stackFileName) => toTitleCase(stackFileName)).join(', ')}.`);
-        }
-        selectedAdditionalStackFileNames = projectDetection.secondaryStackFileNames || [];
-      }
-    } else if (projectDetection.hasExistingProjectFiles && projectDetection.recommendedStackFileName) {
-      detectionTransparency.quickConfirmation.response = 'explicit-selection-or-low-confidence';
-      detectionTransparency.decision.mode = 'explicit-selection-or-low-confidence';
-    } else if (!projectDetection.hasExistingProjectFiles) {
-      detectionTransparency.quickConfirmation.response = 'not-applicable';
-      detectionTransparency.decision.mode = 'fresh-directory';
-    }
-
-    if (shouldRunArchitectureRecommendation) {
-      let architectureProjectDescription = String(initOptions.projectDescription || '').trim();
-
-      if (!architectureProjectDescription && isInteractiveSession) {
-        architectureProjectDescription = (await userInterface.question(
-          '\nDescribe your project in one short paragraph for architecture recommendation: '
-        )).trim();
-      }
-
-      if (!architectureProjectDescription) {
-        architectureProjectDescription = `A software project named ${path.basename(resolvedTargetDirectoryPath)}.`;
-      }
+    const detectedSetupDecision = await resolveDetectedSetupDecision({
+      shouldAutoApplyDetectedStack,
+      projectDetection,
+      stackFileNames,
+      blueprintFileNames,
+      userInterface,
+      isInteractiveSession,
+      detectionTransparency,
+      askYesNo,
+      askStackSelection,
+      askBlueprintSelection,
+      initialSelectedManualStackFileName: selectedManualStackFileName,
+      initialSelectedManualBlueprintFileName: selectedManualBlueprintFileName,
+      initialSelectedAdditionalStackFileNames: selectedAdditionalStackFileNames,
+    });
 
-      architectureRecommendation = recommendArchitecture({
-        projectDescription: architectureProjectDescription,
-        projectDetection,
-        stackFileNames,
-        blueprintFileNames,
-        tokenBudget: initOptions.architectTokenBudget,
-        timeoutMs: initOptions.architectTimeoutMs,
+    detectedSetupWasApplied = detectedSetupDecision.detectedSetupWasApplied;
+    selectedManualStackFileName = detectedSetupDecision.selectedManualStackFileName;
+    selectedManualBlueprintFileName = detectedSetupDecision.selectedManualBlueprintFileName;
+    selectedAdditionalStackFileNames = detectedSetupDecision.selectedAdditionalStackFileNames;
+    detectedBlueprintFileName = detectedSetupDecision.detectedBlueprintFileName;
+
+    const architectureSelection = await resolveArchitectureSelection({
+      shouldRunArchitectureRecommendation,
+      initOptions: {
+        ...initOptions,
+        targetDirectoryPath: resolvedTargetDirectoryPath,
         researchMode: initOptions.architectResearchMode,
         enableRealtimeResearch: initOptions.enableRealtimeResearch,
-        realtimeSignalFilePath: initOptions.architectRealtimeSignalFile,
-      });
-
-      architectureRecommendation.userVeto = {
-        applied: false,
-        selectedStackFileName: architectureRecommendation.recommendedStackFileName,
-        selectedBlueprintFileName: architectureRecommendation.recommendedBlueprintFileName,
-        source: 'recommendation',
-      };
-
-      console.log(formatArchitectureRecommendation(architectureRecommendation));
-
-      const shouldSkipRecommendationDebate = shouldApplyRepeatedOverridePreference(
-        architectPreferenceState,
-        architectureRecommendation.recommendedStackFileName
-      );
-
-      if (shouldSkipRecommendationDebate) {
-        architectureRecommendation.failureModes.repeatedOverride = true;
-        selectedManualStackFileName = stackFileNames.includes(architectPreferenceState.preferredStackFileName)
-          ? architectPreferenceState.preferredStackFileName
-          : architectureRecommendation.recommendedStackFileName;
-        selectedManualBlueprintFileName = blueprintFileNames.includes(architectPreferenceState.preferredBlueprintFileName)
-          ? architectPreferenceState.preferredBlueprintFileName
-          : architectureRecommendation.recommendedBlueprintFileName;
-        architectureRecommendation.userVeto = {
-          applied: true,
-          selectedStackFileName: selectedManualStackFileName,
-          selectedBlueprintFileName: selectedManualBlueprintFileName,
-          source: 'saved-preference',
-        };
-        console.log(
-          `Repeated override preference detected. Applying ${toTitleCase(selectedManualStackFileName)} + ${toTitleCase(selectedManualBlueprintFileName)} without additional debate.`
-        );
-      } else if (!isInteractiveSession) {
-        selectedManualStackFileName = architectureRecommendation.recommendedStackFileName;
-        selectedManualBlueprintFileName = architectureRecommendation.recommendedBlueprintFileName;
-      } else {
-        const shouldApplyRecommendedArchitecture = await askYesNo(
-          'Apply this architecture recommendation?',
-          userInterface,
-          true
-        );
-
-        if (shouldApplyRecommendedArchitecture) {
-          selectedManualStackFileName = architectureRecommendation.recommendedStackFileName;
-          selectedManualBlueprintFileName = architectureRecommendation.recommendedBlueprintFileName;
-        } else {
-          const vetoStackFileName = await askStackSelection(
-            'User veto received. Select stack to apply immediately:',
-            stackFileNames,
-            userInterface
-          );
-
-          const vetoBlueprintCandidates = filterBlueprintFileNamesByCandidates(
-            blueprintFileNames,
-            [BLUEPRINT_RECOMMENDATIONS[vetoStackFileName]].filter(Boolean)
-          );
-
-          const vetoBlueprintFileName = await askBlueprintSelection(
-            'Select blueprint to apply immediately (no further debate):',
-            vetoBlueprintCandidates,
-            userInterface
-          );
-
-          selectedManualStackFileName = vetoStackFileName;
-          selectedManualBlueprintFileName = vetoBlueprintFileName;
-          architectureRecommendation.userVeto = {
-            applied: true,
-            selectedStackFileName: vetoStackFileName,
-            selectedBlueprintFileName: vetoBlueprintFileName,
-            source: 'interactive-veto',
-          };
-
-          architectPreferenceState = createUpdatedArchitectPreference(architectPreferenceState, {
-            selectedStackFileName: vetoStackFileName,
-            selectedBlueprintFileName: vetoBlueprintFileName,
-          });
-          architectPreferenceUpdated = true;
-
-          if (architectPreferenceState.overrideCount >= 2) {
-            architectureRecommendation.failureModes.repeatedOverride = true;
-          }
+      },
+      projectDetection,
+      stackFileNames,
+      blueprintFileNames,
+      userInterface,
+      isInteractiveSession,
+      initialSelectedProjectScopeKey: selectedProjectScopeKey,
+      initialSelectedProjectScopeLabel: selectedProjectScopeLabel,
+      initialSelectedManualStackFileName: selectedManualStackFileName,
+      initialSelectedManualBlueprintFileName: selectedManualBlueprintFileName,
+      architectPreferenceState,
+      askStackSelection,
+      askBlueprintSelection,
+      detectionTransparency,
+    });
 
-          console.log(
-            `Veto applied. Proceeding with ${toTitleCase(vetoStackFileName)} + ${toTitleCase(vetoBlueprintFileName)} without recommendation loops.`
-          );
-        }
-      }
-    }
+    selectedProjectScopeKey = architectureSelection.selectedProjectScopeKey;
+    selectedProjectScopeLabel = architectureSelection.selectedProjectScopeLabel;
+    selectedManualStackFileName = architectureSelection.selectedManualStackFileName;
+    selectedManualBlueprintFileName = architectureSelection.selectedManualBlueprintFileName;
+    architectureRecommendation = architectureSelection.architectureRecommendation;
+    architectPreferenceState = architectureSelection.architectPreferenceState;
+    architectPreferenceUpdated = architectureSelection.architectPreferenceUpdated;
 
     const blueprintDisplayChoices = blueprintFileNames.map((blueprintFileName) => toTitleCase(blueprintFileName));
 
@@ -1051,13 +530,6 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     detectionTransparency.decision.selectedAdditionalBlueprintFileNames = selectedAdditionalBlueprintFileNames;
     detectionTransparency.decision.usedDetectedSetup = detectedSetupWasApplied;
 
-    const selectedSkillDomainNames = inferSkillDomainNamesFromSelection(
-      selectedResolvedStackFileName,
-      selectedResolvedBlueprintFileName,
-      selectedAdditionalStackFileNames,
-      selectedAdditionalBlueprintFileNames
-    );
-
     const includeCiGuardrails = typeof initOptions.ci === 'boolean'
       ? initOptions.ci
       : typeof selectedPreset?.ci === 'boolean'
@@ -1072,6 +544,9 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
 
     detectionTransparency.activeRulesSummary.ciGuardrailsEnabled = includeCiGuardrails;
 
+    detectionTransparency.decision.selectedProjectScopeKey = selectedProjectScopeKey;
+    detectionTransparency.decision.selectedProjectScopeLabel = selectedProjectScopeLabel;
+
     await copyGovernanceAssetsToTarget(resolvedTargetDirectoryPath, {
       includeMcpTemplate: shouldIncludeMcpTemplate,
     });
@@ -1101,19 +576,6 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       );
     }
 
-    const compatibilityWarnings = await evaluateSkillDomainCompatibility(
-      resolvedTargetDirectoryPath,
-      selectedSkillDomainNames
-    );
-
-    if (compatibilityWarnings.length > 0) {
-      console.log('\n[WARN] Compatibility checks reported potential issues for this environment:');
-      for (const compatibilityWarning of compatibilityWarnings) {
-        console.log(`- ${compatibilityWarning}`);
-      }
-      console.log('Installation will continue, but review these warnings before production use.');
-    }
-
     // --- Project Documentation Scaffolding ---
     let scaffoldingResult = null;
     const isFreshProjectTarget = wasDirectoryEffectivelyEmpty && !hadExistingProjectDocsBeforeInit;
@@ -1171,15 +633,24 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
             additionalBlueprintFileNames: selectedAdditionalBlueprintFileNames,
             runtimeEnvironmentKey: selectedRuntimeEnvironmentKey,
             runtimeEnvironmentLabel: resolveRuntimeEnvironmentLabelFromKey(selectedRuntimeEnvironmentKey),
+            architectureRecommendation,
           },
           {
             docsLanguage: selectedDocsLanguage,
           }
         );
 
-        console.log(`\nProject documentation generated in docs/:`);
-        for (const generatedFileName of scaffoldingResult.generatedFileNames) {
-          console.log(`  - docs/${generatedFileName}`);
+        if (scaffoldingResult.bootstrapMode === 'ai-synthesis') {
+          console.log(`\nAI synthesis bootstrap prompts generated in .agent-context/prompts/:`);
+          for (const generatedPromptFileName of scaffoldingResult.generatedPromptFileNames || []) {
+            console.log(`  - .agent-context/prompts/${generatedPromptFileName}`);
+          }
+          console.log('Project docs will be authored dynamically by your IDE assistant from these prompts.');
+        } else {
+          console.log(`\nProject documentation generated in docs/:`);
+          for (const generatedFileName of scaffoldingResult.generatedFileNames) {
+            console.log(`  - docs/${generatedFileName}`);
+          }
         }
       }
     }
@@ -1210,8 +681,6 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       includeCiGuardrails,
       setupDurationMs,
       projectDetection,
-      selectedSkillDomains: selectedSkillDomainNames,
-      compatibilityWarnings,
       runtimeEnvironment: {
         selected: selectedRuntimeEnvironmentKey,
         selectedLabel: resolveRuntimeEnvironmentLabelFromKey(selectedRuntimeEnvironmentKey),
@@ -1253,6 +722,9 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       console.log(
         `- Architect recommendation: ${toTitleCase(architectureRecommendation.recommendedStackFileName)} + ${toTitleCase(architectureRecommendation.recommendedBlueprintFileName)} (${architectureRecommendation.confidenceLabel})`
       );
+      if (!projectDetection.hasExistingProjectFiles) {
+        console.log(`- Project domain: ${selectedProjectScopeLabel}`);
+      }
       if (architectureRecommendation.userVeto?.applied) {
         console.log(
           `- User veto path: applied (${toTitleCase(architectureRecommendation.userVeto.selectedStackFileName)} + ${toTitleCase(architectureRecommendation.userVeto.selectedBlueprintFileName)})`
@@ -1271,8 +743,12 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     console.log(`- CI/CD quality checks (guardrails): ${includeCiGuardrails ? 'enabled' : 'disabled'}`);
     console.log(`- Blocking severities: ${formatBlockingSeverities(selectedProfile.blockingSeverities)}`);
     console.log(`- Setup time: ${formatDuration(setupDurationMs)}`);
-    console.log('- Generated files: .cursorrules, .windsurfrules, and .agent-context/state/onboarding-report.json');
-    if (scaffoldingResult) {
+    console.log('- Generated files: .agent-instructions.md, .cursorrules, .windsurfrules, .clauderc, and .agent-context/state/onboarding-report.json');
+    if (scaffoldingResult?.bootstrapMode === 'ai-synthesis') {
+      console.log(`- Bootstrap prompts: ${(scaffoldingResult.generatedPromptFileNames || []).length} files generated in .agent-context/prompts/`);
+      console.log(`- Bootstrap docs language: ${scaffoldingResult.docsLanguage}`);
+      console.log(`- Expected project docs after synthesis: ${scaffoldingResult.generatedFileNames.length} files in docs/`);
+    } else if (scaffoldingResult) {
       console.log(`- Project docs: ${scaffoldingResult.generatedFileNames.length} files generated in docs/`);
       console.log(`- Project docs language: ${scaffoldingResult.docsLanguage}`);
     }
@@ -1296,7 +772,18 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     if (selectedAdditionalBlueprintFileNames.length > 0) {
       console.log(`I also included additional blueprint context for ${selectedAdditionalBlueprintFileNames.map((blueprintFileName) => toTitleCase(blueprintFileName)).join(', ')}.`);
     }
-    if (scaffoldingResult) {
+    if (scaffoldingResult?.bootstrapMode === 'ai-synthesis') {
+      console.log(`I prepared dynamic synthesis bootstrap prompts (${scaffoldingResult.docsLanguage}) so your IDE assistant can author project docs from scratch on first chat.`);
+
+      const promptProjectName = scaffoldingResult.discoveryAnswers?.projectName || 'this project';
+      console.log('\nPrompt starter examples (copy and adapt in your IDE):');
+      console.log('- If docs/project-brief.md is missing, execute .agent-context/prompts/bootstrap-project-context.md now and create all required docs files.');
+      if ((scaffoldingResult.generatedPromptFileNames || []).includes('bootstrap-design.md')) {
+        console.log('- If docs/DESIGN.md is missing, execute .agent-context/prompts/bootstrap-design.md now before building UI components.');
+      }
+      console.log(`- Build an MVP for ${promptProjectName} using the newly synthesized docs as strict project context.`);
+      console.log('- When scope changes, update docs/* in the same change so future prompts stay aligned.');
+    } else if (scaffoldingResult) {
       console.log(`I also generated project documentation (${scaffoldingResult.docsLanguage}) based on your project description. AI agents will use docs/ as project context.`);
 
       const promptProjectName = scaffoldingResult.discoveryAnswers?.projectName || 'this project';