@ryuenn3123/agentic-senior-core 3.0.37 → 3.0.39

package/lib/cli/commands/init.mjs

@@ -8,7 +8,6 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 
 import {
-  PROJECT_SCOPE_CHOICES,
   CLI_VERSION,
   AGENT_CONTEXT_DIR,
   INIT_PRESETS,
@@ -16,15 +15,12 @@ import {
   GOLDEN_STANDARD_PROFILE_NAME,
   AGENT_DECISION_STACK_FILE_NAME,
   AGENT_DECISION_BLUEPRINT_FILE_NAME,
-  RUNTIME_ENVIRONMENT_CHOICES,
 } from '../constants.mjs';
 
 import {
   ensureDirectory,
   askYesNo,
   toTitleCase,
-  matchFileNameFromInput,
-  normalizeChoiceInput,
   collectFileNames,
   formatBlockingSeverities,
   formatDuration,
@@ -56,7 +52,6 @@ import {
   hasExistingProjectDocs,
   loadProjectConfig,
   normalizeDocsLanguage,
-  buildDesignIntentSeedFromSignals,
 } from '../project-scaffolder.mjs';
 import { performRollback } from '../rollback.mjs';
 import {
@@ -70,6 +65,21 @@ import {
   ensureActiveMemorySnapshot,
   writeMemoryContinuityState,
 } from '../memory-continuity.mjs';
+import {
+  buildInitExistingProjectDesignIntentSeed,
+  inferExistingProjectDescriptionHint,
+} from './init/project-context.mjs';
+import {
+  detectRuntimeEnvironment,
+  resolveRuntimeEnvironmentKeyFromLabel,
+  resolveRuntimeEnvironmentLabelFromKey,
+} from './init/runtime-environment.mjs';
+import {
+  inferProjectScopeFromDiscoveryAnswers,
+  normalizeExplicitProfileFileName,
+  resolveProjectScopeLabelFromKey,
+  resolveSilentCiGuardrailsDefault,
+} from './init/setup-decisions.mjs';
 
 export { REPO_ROOT } from '../constants.mjs';
 export {
@@ -81,242 +91,11 @@ export {
   normalizeAdditionalStackSelection,
   normalizeAdditionalBlueprintSelection,
 } from '../init-selection.mjs';
-
-function normalizeContextLine(rawText) {
-  return String(rawText || '')
-    .replace(/\s+/g, ' ')
-    .trim();
-}
-
-async function readTextIfExists(filePath) {
-  try {
-    return await fs.readFile(filePath, 'utf8');
-  } catch {
-    return '';
-  }
-}
-
-function extractMarkdownContext(rawMarkdown) {
-  return String(rawMarkdown || '')
-    .split(/\r?\n/)
-    .map((line) => normalizeContextLine(line.replace(/^#+\s*/, '')))
-    .filter((line) => line && !line.startsWith('---') && !line.startsWith('```'))
-    .slice(0, 3)
-    .join(' ');
-}
-
-async function inferExistingProjectDescriptionHint(targetDirectoryPath) {
-  const evidence = [];
-  const packageJsonContent = await readTextIfExists(path.join(targetDirectoryPath, 'package.json'));
-
-  if (packageJsonContent) {
-    try {
-      const packageManifest = JSON.parse(packageJsonContent);
-      const packageSummary = [
-        normalizeContextLine(packageManifest.name),
-        normalizeContextLine(packageManifest.description),
-      ].filter(Boolean).join(': ');
-
-      if (packageSummary) {
-        evidence.push(`package.json: ${packageSummary}`);
-      }
-    } catch {
-      // Invalid package metadata should not block init; other files can still provide context.
-    }
-  }
-
-  for (const relativeDocPath of ['docs/project-brief.md', 'docs/README.md', 'README.md']) {
-    const docContext = extractMarkdownContext(
-      await readTextIfExists(path.join(targetDirectoryPath, relativeDocPath))
-    );
-
-    if (docContext) {
-      evidence.push(`${relativeDocPath}: ${docContext}`);
-    }
-  }
-
-  return evidence.slice(0, 3).join(' | ');
-}
-
-export function resolveRuntimeEnvironmentKeyFromLabel(selectedRuntimeEnvironmentLabel) {
-  const runtimeEnvironmentEntry = RUNTIME_ENVIRONMENT_CHOICES.find(
-    (runtimeEnvironmentChoice) => runtimeEnvironmentChoice.label === selectedRuntimeEnvironmentLabel
-  );
-
-  return runtimeEnvironmentEntry?.key || null;
-}
-
-export function resolveRuntimeEnvironmentLabelFromKey(runtimeEnvironmentKey) {
-  const runtimeEnvironmentEntry = RUNTIME_ENVIRONMENT_CHOICES.find(
-    (runtimeEnvironmentChoice) => runtimeEnvironmentChoice.key === runtimeEnvironmentKey
-  );
-
-  return runtimeEnvironmentEntry?.label || runtimeEnvironmentKey;
-}
-
-export function detectRuntimeEnvironment() {
-  const isWslEnvironment = Boolean(process.env.WSL_DISTRO_NAME || process.env.WSL_INTEROP || process.env.__IS_WSL_TEST__);
-
-  if (isWslEnvironment) {
-    return {
-      key: 'linux-wsl',
-      label: resolveRuntimeEnvironmentLabelFromKey('linux-wsl'),
-      shellFamily: 'bash',
-      isAutoDetected: true,
-      source: 'WSL environment markers',
-    };
-  }
-
-  if (process.platform === 'win32') {
-    return {
-      key: 'windows',
-      label: resolveRuntimeEnvironmentLabelFromKey('windows'),
-      shellFamily: 'powershell',
-      isAutoDetected: true,
-      source: 'process.platform',
-    };
-  }
-
-  if (process.platform === 'darwin') {
-    return {
-      key: 'macos',
-      label: resolveRuntimeEnvironmentLabelFromKey('macos'),
-      shellFamily: 'bash',
-      isAutoDetected: true,
-      source: 'process.platform',
-    };
-  }
-
-  return {
-    key: 'linux',
-    label: resolveRuntimeEnvironmentLabelFromKey('linux'),
-    shellFamily: 'bash',
-    isAutoDetected: true,
-    source: 'process.platform',
-  };
-}
-
-function resolveProjectScopeLabelFromKey(projectScopeKey) {
-  return PROJECT_SCOPE_CHOICES.find((scopeChoice) => scopeChoice.key === projectScopeKey)?.label
-    || PROJECT_SCOPE_CHOICES.find((scopeChoice) => scopeChoice.key === 'both')?.label
-    || 'Both (frontend + backend)';
-}
-
-function inferProjectScopeFromDiscoveryAnswers(discoveryAnswers) {
-  const normalizedDomain = String(discoveryAnswers?.primaryDomain || '').trim().toLowerCase();
-  const normalizedDescription = [
-    discoveryAnswers?.projectDescription,
-    ...(Array.isArray(discoveryAnswers?.features) ? discoveryAnswers.features : []),
-  ].join(' ').toLowerCase();
-
-  if (
-    normalizedDomain.includes('api service')
-    || normalizedDomain.includes('cli tool')
-    || normalizedDomain.includes('library')
-  ) {
-    return 'backend-only';
-  }
-
-  if (normalizedDomain.includes('mobile app')) {
-    return 'frontend-only';
-  }
-
-  if (normalizedDomain.includes('web application')) {
-    if (/(landing page|marketing site|showcase|portfolio|brochure|company profile)/.test(normalizedDescription)) {
-      return 'frontend-only';
-    }
-
-    return 'both';
-  }
-
-  return 'both';
-}
-
-function resolveSilentCiGuardrailsDefault({
-  initOptions,
-  selectedPreset,
-  selectedPolicyProfile,
-}) {
-  if (typeof initOptions.ci === 'boolean') {
-    return {
-      value: initOptions.ci,
-      shouldAsk: false,
-    };
-  }
-
-  if (typeof selectedPreset?.ci === 'boolean') {
-    return {
-      value: selectedPreset.ci,
-      shouldAsk: false,
-    };
-  }
-
-  if (selectedPolicyProfile.lockCi) {
-    return {
-      value: selectedPolicyProfile.defaultCi,
-      shouldAsk: false,
-    };
-  }
-
-  return {
-    value: selectedPolicyProfile.defaultCi,
-    shouldAsk: true,
-  };
-}
-
-function normalizeExplicitProfileFileName(rawInput, discoveredFileNames) {
-  const matchedFileName = Array.isArray(discoveredFileNames) && discoveredFileNames.length > 0
-    ? matchFileNameFromInput(rawInput, discoveredFileNames)
-    : null;
-
-  if (matchedFileName) {
-    return matchedFileName;
-  }
-
-  const normalizedBaseName = normalizeChoiceInput(String(rawInput || '').replace(/\.md$/i, ''));
-  return normalizedBaseName ? `${normalizedBaseName}.md` : null;
-}
-
-function buildInitExistingProjectDesignIntentSeed({
-  targetDirectoryPath,
-  packageManifest,
-  selectedStackFileName,
-  selectedBlueprintFileName,
-  uiScopeSignals,
-  projectDescriptionHint,
-}) {
-  const projectName = String(packageManifest?.name || path.basename(targetDirectoryPath)).trim() || 'existing-ui-project';
-  const isMobileUiProject = String(selectedStackFileName || '').toLowerCase().includes('react-native')
-    || String(selectedStackFileName || '').toLowerCase().includes('flutter')
-    || uiScopeSignals.signalReasons.some((signalReason) => signalReason.includes('android') || signalReason.includes('ios'));
-  const resolvedDomain = isMobileUiProject ? 'Mobile app' : 'Web application';
-  const projectDescription = String(packageManifest?.description || projectDescriptionHint || '').trim()
-    || `Existing ${resolvedDomain.toLowerCase()} detected during init. Create a project-specific dynamic design contract before shipping new UI work.`;
-
-  return buildDesignIntentSeedFromSignals({
-    projectName,
-    projectDescription,
-    primaryDomain: resolvedDomain,
-    features: [],
-    initContext: {
-      stackFileName: selectedStackFileName,
-      blueprintFileName: selectedBlueprintFileName,
-    },
-    status: 'seed-generated-during-init',
-    supplementalFields: {
-      initSignals: {
-        detectedFrom: uiScopeSignals.signalReasons,
-        generatedBy: 'init-existing-project-seed',
-      },
-      repoEvidence: {
-        uiSignalReasons: uiScopeSignals.signalReasons,
-        frontendMetrics: uiScopeSignals.frontendEvidenceMetrics || null,
-        designEvidenceSummary: uiScopeSignals.designEvidenceSummary || null,
-        workspaceUiEntries: uiScopeSignals.workspaceUiEntries || [],
-      },
-    },
-  });
-}
+export {
+  detectRuntimeEnvironment,
+  resolveRuntimeEnvironmentKeyFromLabel,
+  resolveRuntimeEnvironmentLabelFromKey,
+} from './init/runtime-environment.mjs';
 
 export async function runInitCommand(targetDirectoryArgument, initOptions = {}) {
   const resolvedTargetDirectoryPath = path.resolve(targetDirectoryArgument || '.');
@@ -420,13 +199,17 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
         : 'No existing project markers were detected.',
       activeRulesSummary: {
         canonicalSource: '.instructions.md',
-        compiledEntrypoints: [
-          '.agent-instructions.md',
-          '.cursorrules',
-          '.windsurfrules',
-          '.clauderc',
-          '.gemini/instructions.md',
+        compiledRulebook: '.agent-instructions.md',
+        legacyThinAdapters: ['.cursorrules', '.windsurfrules', '.clauderc'],
+        generatedBridgeAdapters: [
+          'AGENTS.md',
+          'CLAUDE.md',
+          'GEMINI.md',
+          '.cursor/rules/agentic-senior-core.mdc',
+          '.windsurf/rules/agentic-senior-core.md',
           '.github/copilot-instructions.md',
+          '.github/instructions/agentic-senior-core.instructions.md',
+          '.gemini/instructions.md',
         ],
         stackLoadingMode: 'lazy',
         domainRuleLoadingMode: 'lazy',
@@ -466,7 +249,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
         console.log('- Detected stack: unresolved (insufficient markers).');
       }
 
-      console.log('- Active rules baseline: canonical .instructions.md -> compiled .cursorrules/.windsurfrules');
+      console.log('- Active rules baseline: canonical .instructions.md -> compiled .agent-instructions.md + legacy thin root adapters');
       console.log(
         `- Active review thresholds: ${formatBlockingSeverities(selectedPolicyProfile.blockingSeverities)}`
       );
@@ -782,7 +565,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     console.log(`- CI/CD quality checks (guardrails): ${includeCiGuardrails ? 'enabled' : 'disabled'}`);
     console.log(`- Review thresholds: ${formatBlockingSeverities(selectedPolicyProfile.blockingSeverities)}`);
     console.log(`- Setup time: ${formatDuration(setupDurationMs)}`);
-    console.log('- Generated files: .instructions.md, .agent-instructions.md, compiled adapters, and .agent-context/state/onboarding-report.json');
+    console.log('- Generated files: .instructions.md, .agent-instructions.md, legacy thin adapters, generated bridge adapters, 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/`);
       if ((scaffoldingResult.materializedFileNames || []).length > 0) {
@@ -846,7 +629,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       console.log('- If docs/DESIGN.md is missing, execute .agent-context/prompts/bootstrap-design.md now and refine docs/design-intent.json into a complete design contract before building UI components.');
       console.log('- Keep docs/design-intent.json and docs/DESIGN.md synchronized whenever the UI direction changes.');
     }
-    console.log('Your AI tools will now receive one compiled rulebook plus the original source rules, and your review threshold is stored in .agent-context/policies/llm-judge-threshold.json.');
+    console.log('Your AI tools will now receive one compiled rulebook, thin discovery adapters, and the original source rules. Your review threshold is stored in .agent-context/policies/llm-judge-threshold.json.');
     console.log('MCP server registration is manual inside your IDE settings, even when mcp.json exists.');
   } catch (error) {
     console.error('\n[FATAL] An error occurred during initialization. Attempting automatic rollback...');

package/lib/cli/commands/optimize.mjs

@@ -174,7 +174,7 @@ export async function runOptimizeCommand(targetDirectoryArgument, optimizeOption
   console.log(`- Agent profile: ${tokenOptimizationState.selectedAgent}`);
   console.log(`- Preferred shell proxy: ${tokenOptimizationState.preferredShellProxy}`);
   console.log(`- Setup time: ${formatDuration(optimizationDurationMs)}`);
-  console.log('- Updated files: .cursorrules, .windsurfrules, .agent-context/state/token-optimization.json');
+  console.log('- Updated files: .agent-instructions.md, legacy thin adapters, and .agent-context/state/token-optimization.json');
 
   if (tokenOptimizationState.enabled) {
     if (rtkDetection.isAvailable) {

package/lib/cli/commands/upgrade.mjs

@@ -48,6 +48,7 @@ import {
   buildDesignIntentSeedFromSignals,
 } from '../project-scaffolder.mjs';
 import { ensureActiveMemorySnapshot } from '../memory-continuity.mjs';
+import { buildExistingProjectMajorConstraints } from '../init-detection-flow.mjs';
 
 export function parseUpgradeArguments(commandArguments) {
   const parsedUpgradeOptions = {
@@ -102,14 +103,6 @@ export function parseUpgradeArguments(commandArguments) {
   return parsedUpgradeOptions;
 }
 
-function buildExistingProjectMajorConstraints() {
-  return [
-    'Preserve existing project markers and avoid forced stack migration.',
-    'Use runtime markers as evidence only unless the user already recorded an explicit runtime constraint.',
-    'Upgrade keeps prior explicit onboarding constraints but does not create new stack or blueprint decisions.',
-  ];
-}
-
 function buildUpgradeDesignIntentSeed({
   targetDirectoryPath,
   packageManifest,
@@ -243,7 +236,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       })
       : null;
 
-    const detectionMajorConstraints = buildExistingProjectMajorConstraints();
+    const detectionMajorConstraints = buildExistingProjectMajorConstraints({ mode: 'upgrade' });
     const detectionTransparency = {
       declaredAt: new Date().toISOString(),
       declarationType: 'existing-project',
@@ -251,7 +244,18 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       detectionSummary: buildDetectionSummary(projectDetection),
       activeRulesSummary: {
         canonicalSource: '.instructions.md',
-        compiledEntrypoints: ['.cursorrules', '.windsurfrules'],
+        compiledRulebook: '.agent-instructions.md',
+        legacyThinAdapters: ['.cursorrules', '.windsurfrules', '.clauderc'],
+        generatedBridgeAdapters: [
+          'AGENTS.md',
+          'CLAUDE.md',
+          'GEMINI.md',
+          '.cursor/rules/agentic-senior-core.mdc',
+          '.windsurf/rules/agentic-senior-core.md',
+          '.github/copilot-instructions.md',
+          '.github/instructions/agentic-senior-core.instructions.md',
+          '.gemini/instructions.md',
+        ],
         stackLoadingMode: 'lazy',
         domainRuleLoadingMode: 'lazy',
         selectedProfile: selectedProfileName,
@@ -281,7 +285,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
     } else {
       console.log('- Detected stack: unresolved (insufficient markers).');
     }
-    console.log('- Active rules baseline: canonical .instructions.md -> compiled .cursorrules/.windsurfrules');
+    console.log('- Active rules baseline: canonical .instructions.md -> compiled .agent-instructions.md + legacy thin root adapters');
     console.log(
       `- Active review thresholds: ${(
         PROFILE_PRESETS[selectedProfileName]?.blockingSeverities || []
@@ -296,7 +300,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
 
     const projectDocStalenessReport = await detectProjectDocTemplateStaleness(resolvedTargetDirectoryPath);
 
-    const currentRulesPath = path.join(resolvedTargetDirectoryPath, '.cursorrules');
+    const currentRulesPath = path.join(resolvedTargetDirectoryPath, '.agent-instructions.md');
     const currentRulesContent = await pathExists(currentRulesPath)
       ? await fs.readFile(currentRulesPath, 'utf8')
       : '';
@@ -423,13 +427,14 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
         }
       }
 
-      await compileDynamicContext({
+      const compileResult = await compileDynamicContext({
         targetDirectoryPath: resolvedTargetDirectoryPath,
         selectedStackFileName,
         selectedAdditionalStackFileNames,
         selectedBlueprintFileName,
         selectedAdditionalBlueprintFileNames,
         includeCiGuardrails,
+        preserveUserOwnedEntrypoints: true,
       });
       await writeSelectedPolicy(resolvedTargetDirectoryPath, selectedProfileName);
 
@@ -454,25 +459,38 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       console.log('\nUpgrade complete.');
       console.log(`- Governance surface sync: 1:1 (${governanceSyncResult.updatedFiles.length} updated, ${governanceSyncResult.createdFiles.length} new, ${governanceSyncResult.deletedManagedFiles.length} deleted, ${governanceSyncResult.unchangedFiles.length} unchanged)`);
       console.log(`- Rules rewritten: ${isRulesContentChanged ? 'yes' : 'no (metadata refreshed)'}`);
+      const preservedInstructionEntrypoints = Array.from(new Set([
+        ...(governanceSyncResult.preservedFiles || []),
+        ...(compileResult.preservedEntrypoints || []),
+      ])).sort();
+      if (preservedInstructionEntrypoints.length > 0) {
+        console.log(`- User-owned instruction entrypoints preserved: ${preservedInstructionEntrypoints.length}`);
+      }
       if (governanceSyncResult.deletedManagedDirectories.length > 0) {
         console.log(`- Managed stale directories removed: ${governanceSyncResult.deletedManagedDirectories.length}`);
       }
       console.log(`- Setup time: ${formatDuration(setupDurationMs)}`);
 
-      if (governanceSyncResult.updatedFiles.length > 0 || governanceSyncResult.createdFiles.length > 0 || governanceSyncResult.deletedManagedFiles.length > 0) {
+      const hasDetailedGovernanceChanges = governanceSyncResult.updatedFiles.length > 0
+        || governanceSyncResult.createdFiles.length > 0
+        || governanceSyncResult.deletedManagedFiles.length > 0
+        || preservedInstructionEntrypoints.length > 0;
+
+      if (hasDetailedGovernanceChanges) {
         console.log('\nDetailed changes:');
         governanceSyncResult.createdFiles.forEach((fileName) => console.log(`  [NEW]     ${fileName}`));
         governanceSyncResult.updatedFiles.forEach((fileName) => console.log(`  [UPDATED] ${fileName}`));
         governanceSyncResult.deletedManagedFiles.forEach((fileName) => console.log(`  [DELETED] ${fileName}`));
+        preservedInstructionEntrypoints.forEach((fileName) => console.log(`  [PRESERVE] ${fileName}`));
       }
       if (supplementalCreatedFileNames.length > 0) {
-        if (!(governanceSyncResult.updatedFiles.length > 0 || governanceSyncResult.createdFiles.length > 0 || governanceSyncResult.deletedManagedFiles.length > 0)) {
+        if (!hasDetailedGovernanceChanges) {
           console.log('\nDetailed changes:');
         }
         supplementalCreatedFileNames.forEach((fileName) => console.log(`  [NEW]     ${fileName} (seed)`));
       }
 
-      console.log('\nRefreshed files: .instructions.md, .agent-instructions.md, compiled adapters, and .agent-context/state/onboarding-report.json');
+      console.log('\nRefreshed files: .instructions.md, .agent-instructions.md, legacy thin adapters, generated bridge adapters, and .agent-context/state/onboarding-report.json');
     } catch (error) {
       console.error('\n[FATAL] An error occurred during upgrade. Attempting automatic rollback...');
       try {

package/lib/cli/compiler.mjs

@@ -15,6 +15,7 @@ import {
 import {
   pathExists,
   collectFileNames,
+  isAgenticManagedContent,
 } from './utils.mjs';
 
 import {
@@ -95,6 +96,38 @@ function buildAnchorCommitmentHeader(designIntent) {
   ].join('\n');
 }
 
+function buildLegacyRootAdapterContent(adapterFileName, toolLabel) {
+  return [
+    `# ${adapterFileName} - Legacy Thin Adapter`,
+    '',
+    `Generated by Agentic-Senior-Core CLI v${CLI_VERSION}`,
+    'Adapter Mode: legacy-thin',
+    'Adapter Source: .agent-instructions.md when present; fallback .instructions.md',
+    'Canonical baseline: .instructions.md',
+    '',
+    `This file is kept only for older ${toolLabel} discovery.`,
+    'Read .agent-instructions.md for the compiled rulebook when present.',
+    'Use .instructions.md as the canonical policy source.',
+    '',
+    'Mandatory load floor:',
+    '1. Read .agent-instructions.md when present; otherwise read .instructions.md.',
+    '2. Load only relevant .agent-context/rules/ by task scope.',
+    '3. Apply matching .agent-context/prompts/ contracts.',
+    '4. Enforce .agent-context/review-checklists/ before completion.',
+    '5. Use .agent-context/state/ and .agent-context/policies/ only when relevant.',
+    '6. Resolve Runtime Decision Signals from repo evidence and live official docs.',
+    '7. Resolve Structural Planning Signals from constraints and architecture boundaries.',
+    '',
+    'Current bridges:',
+    '- Cursor: .cursor/rules/agentic-senior-core.mdc',
+    '- Windsurf: .windsurf/rules/agentic-senior-core.md',
+    '- Claude: CLAUDE.md',
+    '- Gemini: GEMINI.md and .gemini/instructions.md',
+    '- Copilot: .github/copilot-instructions.md and .github/instructions/agentic-senior-core.instructions.md',
+    '',
+  ].join('\n');
+}
+
 export async function writeSelectedPolicy(targetDirectoryPath, selectedProfileName) {
   const policyFilePath = path.join(targetDirectoryPath, '.agent-context', 'policies', POLICY_FILE_NAME);
   const parsedPolicy = JSON.parse(await fs.readFile(policyFilePath, 'utf8'));
@@ -265,7 +298,9 @@ export async function buildCompiledRulesContent({
       '7. docs/ project context (or bootstrap prompts when docs are not materialized)',
       '',
       'Project-specific compiled snapshot: .agent-instructions.md',
-      'Compiled adapter entrypoints: .cursorrules, .windsurfrules, .clauderc, .gemini/instructions.md, .github/copilot-instructions.md',
+      'Compiled rulebook: .agent-instructions.md',
+      'Legacy thin root adapters: .cursorrules, .windsurfrules, .clauderc',
+      'Generated bridge adapters: AGENTS.md, CLAUDE.md, GEMINI.md, .cursor/rules/agentic-senior-core.mdc, .windsurf/rules/agentic-senior-core.md, .github/copilot-instructions.md, .github/instructions/agentic-senior-core.instructions.md, .gemini/instructions.md',
       'Canonical baseline: .instructions.md',
     ].join('\n')
   );
@@ -591,6 +626,7 @@ export async function compileDynamicContext({
   selectedBlueprintFileName,
   selectedAdditionalBlueprintFileNames = [],
   includeCiGuardrails,
+  preserveUserOwnedEntrypoints = true,
 }) {
   const resolvedTargetDirectoryPath = path.resolve(targetDirectoryPath);
   const compiledRules = await buildCompiledRulesContent({
@@ -601,23 +637,29 @@ export async function compileDynamicContext({
     selectedAdditionalBlueprintFileNames,
     includeCiGuardrails,
   });
+  const preservedEntrypoints = [];
 
-  await fs.writeFile(path.join(resolvedTargetDirectoryPath, '.agent-instructions.md'), compiledRules, 'utf8');
-  await fs.writeFile(path.join(resolvedTargetDirectoryPath, '.cursorrules'), compiledRules, 'utf8');
-  await fs.writeFile(path.join(resolvedTargetDirectoryPath, '.windsurfrules'), compiledRules, 'utf8');
-  await fs.writeFile(path.join(resolvedTargetDirectoryPath, '.clauderc'), compiledRules, 'utf8');
-  
-  // Gemini (Antigravity Editor) instructions
-  const geminiDir = path.join(resolvedTargetDirectoryPath, '.gemini');
-  if (!(await pathExists(geminiDir))) {
-    await fs.mkdir(geminiDir, { recursive: true });
-  }
-  await fs.writeFile(path.join(geminiDir, 'instructions.md'), compiledRules, 'utf8');
+  async function writeGeneratedEntrypointFile(relativeFilePath, content) {
+    const targetFilePath = path.join(resolvedTargetDirectoryPath, relativeFilePath);
+
+    if (preserveUserOwnedEntrypoints && await pathExists(targetFilePath)) {
+      const existingContent = await fs.readFile(targetFilePath, 'utf8');
+      if (!isAgenticManagedContent(existingContent)) {
+        preservedEntrypoints.push(relativeFilePath);
+        return;
+      }
+    }
 
-  // Copilot instructions (also used by some generic IDE extensions)
-  const githubDir = path.join(resolvedTargetDirectoryPath, '.github');
-  if (!(await pathExists(githubDir))) {
-    await fs.mkdir(githubDir, { recursive: true });
+    await fs.mkdir(path.dirname(targetFilePath), { recursive: true });
+    await fs.writeFile(targetFilePath, content, 'utf8');
   }
-  await fs.writeFile(path.join(githubDir, 'copilot-instructions.md'), compiledRules, 'utf8');
+
+  await fs.writeFile(path.join(resolvedTargetDirectoryPath, '.agent-instructions.md'), compiledRules, 'utf8');
+  await writeGeneratedEntrypointFile('.cursorrules', buildLegacyRootAdapterContent('.cursorrules', 'Cursor'));
+  await writeGeneratedEntrypointFile('.windsurfrules', buildLegacyRootAdapterContent('.windsurfrules', 'Windsurf'));
+  await writeGeneratedEntrypointFile('.clauderc', buildLegacyRootAdapterContent('.clauderc', 'Claude'));
+
+  return {
+    preservedEntrypoints,
+  };
 }

package/lib/cli/constants.mjs

@@ -130,7 +130,12 @@ export const entryPointFiles = [
   '.cursorrules',
   '.windsurfrules',
   'AGENTS.md',
+  'CLAUDE.md',
+  'GEMINI.md',
+  '.cursor/rules/agentic-senior-core.mdc',
   '.github/copilot-instructions.md',
+  '.github/instructions/agentic-senior-core.instructions.md',
+  '.windsurf/rules/agentic-senior-core.md',
   '.agent-override.md',
 ];
 

package/lib/cli/detector.mjs

@@ -22,6 +22,7 @@ const WORKSPACE_SCAN_IGNORE_DIRECTORY_NAMES = new Set([
   '.github',
   '.idea',
   '.vscode',
+  '.windsurf',
   '.zed',
 ]);
 const WORKSPACE_CONTAINER_DIRECTORY_NAMES = new Set([
@@ -111,9 +112,12 @@ const INTERNAL_GOVERNANCE_SURFACE_NAMES = new Set([
   '.github',
   '.instructions.md',
   '.vscode',
+  '.windsurf',
   '.windsurfrules',
   '.zed',
   'AGENTS.md',
+  'CLAUDE.md',
+  'GEMINI.md',
   'mcp.json',
 ]);
 

package/lib/cli/init-detection-flow.mjs

@@ -1,4 +1,12 @@
-export function buildExistingProjectMajorConstraints() {
+export function buildExistingProjectMajorConstraints({ mode = 'init' } = {}) {
+  if (mode === 'upgrade') {
+    return [
+      'Preserve existing project markers and avoid forced stack migration.',
+      'Use runtime markers as evidence only unless the user already recorded an explicit runtime constraint.',
+      'Upgrade keeps prior explicit onboarding constraints but does not create new stack or blueprint decisions.',
+    ];
+  }
+
   return [
     'Preserve existing project markers and avoid forced stack migration.',
     'Use detected runtime markers as evidence only; do not convert them into stack migration or design direction.',

package/lib/cli/init-selection.mjs

@@ -27,8 +27,3 @@ export function normalizeAdditionalBlueprintSelection(selectedBlueprintFileName,
     (blueprintFileName) => blueprintFileName && blueprintFileName !== selectedBlueprintFileName
   )));
 }
-
-export function resolveScopeBlueprintCandidates(projectScopeKey) {
-  void projectScopeKey;
-  return null;
-}