@ryuenn3123/agentic-senior-core 3.0.47 → 3.0.49

package/lib/cli/commands/init.mjs

@@ -34,7 +34,7 @@ import {
   formatDetectionCandidates,
   detectUiScopeSignals,
 } from '../detector.mjs';
-import { compileDynamicContext, writeSelectedPolicy, writeOnboardingReport } from '../compiler.mjs';
+import { writeSelectedPolicy, writeOnboardingReport } from '../compiler.mjs';
 import {
   normalizeAdditionalStackSelection,
   normalizeAdditionalBlueprintSelection,
@@ -153,7 +153,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     }
 
     console.log(`\nAgentic-Senior-Core CLI v${CLI_VERSION}`);
-    console.log('I will copy the project guidance pack into your target folder and compile a single rulebook for your AI tools.');
+    console.log('I will copy the project guidance pack into your target folder with AGENTS.md and native import bridges for your AI tools.');
 
     if (selectedPreset) {
       console.log(`Using preset: ${initOptions.preset} (${selectedPreset.description}).`);
@@ -198,19 +198,10 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
         ? buildDetectionSummary(projectDetection)
         : 'No existing project markers were detected.',
       activeRulesSummary: {
-        canonicalSource: '.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',
-        ],
+        canonicalSource: 'AGENTS.md',
+        compiledRulebook: null,
+        legacyThinAdapters: [],
+        generatedBridgeAdapters: ['CLAUDE.md', 'GEMINI.md'],
         stackLoadingMode: 'lazy',
         domainRuleLoadingMode: 'lazy',
         selectedProfile: selectedPolicyProfileName,
@@ -249,7 +240,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
         console.log('- Detected stack: unresolved (insufficient markers).');
       }
 
-      console.log('- Active rules baseline: canonical .instructions.md -> compiled .agent-instructions.md + legacy thin root adapters');
+      console.log('- Active rules baseline: canonical AGENTS.md + .agent-context/ lazy rule library');
       console.log(
         `- Active review thresholds: ${formatBlockingSeverities(selectedPolicyProfile.blockingSeverities)}`
       );
@@ -493,15 +484,6 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       console.log('\nExisting UI/frontend scope detected. Seeded docs/design-intent.json so the machine-readable design contract exists before UI implementation work continues.');
     }
 
-    await compileDynamicContext({
-      targetDirectoryPath: resolvedTargetDirectoryPath,
-      selectedStackFileName: selectedResolvedStackFileName,
-      selectedAdditionalStackFileNames,
-      selectedBlueprintFileName: selectedResolvedBlueprintFileName,
-      selectedAdditionalBlueprintFileNames,
-      includeCiGuardrails,
-    });
-
     await writeSelectedPolicy(resolvedTargetDirectoryPath, selectedPolicyProfileName);
 
     const setupDurationMs = Date.now() - setupStartedAt;
@@ -570,7 +552,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, legacy thin adapters, generated bridge adapters, and .agent-context/state/onboarding-report.json');
+    console.log('- Generated files: AGENTS.md, CLAUDE.md, GEMINI.md, .agent-context/, 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) {
@@ -586,7 +568,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       console.log(`- Design seed docs: ${supplementalMaterializedDocFileNames.length} files generated in docs/`);
     }
     console.log(`- Repository workflows copied: no (workflows remain source-repo assets)`);
-    console.log(`- MCP configuration: ${shouldIncludeMcpTemplate ? 'auto-configured for your IDEs (VS Code, Cursor, Zed, Gemini)' : 'disabled (--no-mcp-template)'}`);
+    console.log(`- MCP configuration: ${shouldIncludeMcpTemplate ? 'auto-configured for your IDEs (VS Code, Cursor, Zed, Gemini)' : 'disabled (use --mcp-template to enable)'}`);
     if (isMemoryContinuityEnabled) {
       console.log('- Memory continuity policy: enabled (index + selective hydration; host support required)');
     } else {
@@ -634,7 +616,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, thin discovery adapters, and the original source rules. Your review threshold is stored in .agent-context/policies/llm-judge-threshold.json.');
+    console.log('Your AI tools will now receive AGENTS.md, native import bridges, and the lazy-loaded .agent-context rule library. 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

@@ -2,11 +2,7 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 
 import { ensureDirectory, formatDuration } from '../utils.mjs';
-import { compileDynamicContext, loadOnboardingReportIfExists } from '../compiler.mjs';
-import {
-  AGENT_DECISION_STACK_FILE_NAME,
-  AGENT_DECISION_BLUEPRINT_FILE_NAME,
-} from '../constants.mjs';
+import { loadOnboardingReportIfExists } from '../compiler.mjs';
 import {
   TOKEN_OPTIMIZATION_REPORT_FILE_NAME,
   normalizeAgentName,
@@ -18,17 +14,6 @@ import {
   writeTokenOptimizationState,
 } from '../token-optimization.mjs';
 
-function normalizeMarkdownFileName(rawFileName, fallbackFileName) {
-  if (typeof rawFileName !== 'string' || rawFileName.trim().length === 0) {
-    return fallbackFileName;
-  }
-
-  const normalizedFileName = rawFileName.trim();
-  return normalizedFileName.endsWith('.md')
-    ? normalizedFileName
-    : `${normalizedFileName}.md`;
-}
-
 export function parseOptimizeArguments(commandArguments) {
   const parsedOptimizeOptions = {
     targetDirectory: '.',
@@ -119,37 +104,6 @@ export async function runOptimizeCommand(targetDirectoryArgument, optimizeOption
 
   await writeTokenOptimizationState(resolvedTargetDirectoryPath, tokenOptimizationState);
 
-  const hasExplicitRuntimeConstraint = onboardingReport?.runtimeDecision?.mode === 'explicit-constraint';
-  const hasExplicitArchitectureConstraint = onboardingReport?.architectureDecision?.mode === 'explicit-constraint';
-  const selectedStackFileName = hasExplicitRuntimeConstraint
-    ? normalizeMarkdownFileName(onboardingReport.selectedStack, AGENT_DECISION_STACK_FILE_NAME)
-    : AGENT_DECISION_STACK_FILE_NAME;
-  const selectedAdditionalStackFileNames = hasExplicitRuntimeConstraint && Array.isArray(onboardingReport.selectedAdditionalStacks)
-    ? onboardingReport.selectedAdditionalStacks
-      .map((stackFileName) => normalizeMarkdownFileName(stackFileName, ''))
-      .filter((stackFileName) => stackFileName && stackFileName !== selectedStackFileName)
-    : [];
-  const selectedBlueprintFileName = hasExplicitArchitectureConstraint
-    ? normalizeMarkdownFileName(onboardingReport.selectedBlueprint, AGENT_DECISION_BLUEPRINT_FILE_NAME)
-    : AGENT_DECISION_BLUEPRINT_FILE_NAME;
-  const selectedAdditionalBlueprintFileNames = hasExplicitArchitectureConstraint && Array.isArray(onboardingReport.selectedAdditionalBlueprints)
-    ? onboardingReport.selectedAdditionalBlueprints
-      .map((blueprintFileName) => normalizeMarkdownFileName(blueprintFileName, ''))
-      .filter((blueprintFileName) => blueprintFileName && blueprintFileName !== selectedBlueprintFileName)
-    : [];
-  const includeCiGuardrails = typeof onboardingReport.ciGuardrailsEnabled === 'boolean'
-    ? onboardingReport.ciGuardrailsEnabled
-    : true;
-
-  await compileDynamicContext({
-    targetDirectoryPath: resolvedTargetDirectoryPath,
-    selectedStackFileName,
-    selectedAdditionalStackFileNames,
-    selectedBlueprintFileName,
-    selectedAdditionalBlueprintFileNames,
-    includeCiGuardrails,
-  });
-
   const optimizationDurationMs = Date.now() - optimizationStartedAt;
   const tokenOptimizationReport = {
     generatedAt: new Date().toISOString(),
@@ -174,7 +128,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: .agent-instructions.md, legacy thin adapters, and .agent-context/state/token-optimization.json');
+  console.log('- Updated files: .agent-context/state/token-optimization.json and .agent-context/state/token-optimization-report.json');
 
   if (tokenOptimizationState.enabled) {
     if (rtkDetection.isAvailable) {

package/lib/cli/commands/upgrade.mjs

@@ -33,8 +33,6 @@ import {
   detectUiScopeSignals,
 } from '../detector.mjs';
 import {
-  buildCompiledRulesContent,
-  compileDynamicContext,
   writeSelectedPolicy,
   writeOnboardingReport,
   loadOnboardingReportIfExists,
@@ -55,7 +53,7 @@ export function parseUpgradeArguments(commandArguments) {
     targetDirectory: '.',
     dryRun: false,
     skipConfirmation: false,
-    includeMcpTemplate: true,
+    includeMcpTemplate: false,
     pruneManagedSurface: true,
   };
 
@@ -243,19 +241,10 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       declarationShown: true,
       detectionSummary: buildDetectionSummary(projectDetection),
       activeRulesSummary: {
-        canonicalSource: '.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',
-        ],
+        canonicalSource: 'AGENTS.md',
+        compiledRulebook: null,
+        legacyThinAdapters: [],
+        generatedBridgeAdapters: ['CLAUDE.md', 'GEMINI.md'],
         stackLoadingMode: 'lazy',
         domainRuleLoadingMode: 'lazy',
         selectedProfile: selectedProfileName,
@@ -285,7 +274,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
     } else {
       console.log('- Detected stack: unresolved (insufficient markers).');
     }
-    console.log('- Active rules baseline: canonical .instructions.md -> compiled .agent-instructions.md + legacy thin root adapters');
+    console.log('- Active rules baseline: canonical AGENTS.md + .agent-context/ lazy rule library');
     console.log(
       `- Active review thresholds: ${(
         PROFILE_PRESETS[selectedProfileName]?.blockingSeverities || []
@@ -300,24 +289,6 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
 
     const projectDocStalenessReport = await detectProjectDocTemplateStaleness(resolvedTargetDirectoryPath);
 
-    const currentRulesPath = path.join(resolvedTargetDirectoryPath, '.agent-instructions.md');
-    const currentRulesContent = await pathExists(currentRulesPath)
-      ? await fs.readFile(currentRulesPath, 'utf8')
-      : '';
-
-    const plannedRulesContent = await buildCompiledRulesContent({
-      targetDirectoryPath: resolvedTargetDirectoryPath,
-      selectedStackFileName,
-      selectedAdditionalStackFileNames,
-      selectedBlueprintFileName,
-      selectedAdditionalBlueprintFileNames,
-      includeCiGuardrails,
-    });
-
-    const isRulesContentChanged = currentRulesContent !== plannedRulesContent;
-    const currentRuleLineCount = currentRulesContent ? currentRulesContent.split(/\r?\n/).length : 0;
-    const plannedRuleLineCount = plannedRulesContent.split(/\r?\n/).length;
-
     console.log('\nUpgrade preview:');
     console.log(`- Target directory: ${resolvedTargetDirectoryPath}`);
     console.log(`- Runtime decision: ${selectedStackFileName === AGENT_DECISION_STACK_FILE_NAME ? 'agent recommendation required from repo evidence' : toTitleCase(selectedStackFileName)}`);
@@ -329,14 +300,12 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       console.log(`- Additional blueprints: ${selectedAdditionalBlueprintFileNames.map((blueprintFileName) => toTitleCase(blueprintFileName)).join(', ')}`);
     }
     console.log(`- CI/CD quality checks (guardrails): ${includeCiGuardrails ? 'enabled' : 'disabled'}`);
-    console.log(`- Existing rules lines: ${currentRuleLineCount}`);
-    console.log(`- Planned rules lines: ${plannedRuleLineCount}`);
-    console.log(`- Rules changed: ${isRulesContentChanged ? 'yes' : 'no'}`);
+    console.log('- Instruction surface: AGENTS.md canonical with CLAUDE.md and GEMINI.md import bridges');
     console.log(`- Managed surface stale files: ${managedSurfacePlan.staleFiles.length}`);
     console.log(`- Managed surface stale directories: ${managedSurfacePlan.staleDirectories.length}`);
     console.log(`- Managed surface sync mode: 1:1 (prune enabled)`);
     console.log(`- Managed surface prune mode: ${upgradeOptions.pruneManagedSurface === true ? 'enabled (default)' : 'disabled (--no-prune)'}`);
-    console.log(`- MCP config write mode: ${upgradeOptions.includeMcpTemplate === true ? 'enabled (default)' : 'disabled (--no-mcp-template)'}`);
+    console.log(`- MCP config write mode: ${upgradeOptions.includeMcpTemplate === true ? 'enabled (--mcp-template)' : 'disabled (default)'}`);
     if (projectDocStalenessReport.hasProjectDocs) {
       console.log(`- Project docs detected: ${projectDocStalenessReport.checkedFileNames.length}`);
       console.log(`- Project docs expected template version: ${projectDocStalenessReport.expectedTemplateVersion}`);
@@ -431,15 +400,6 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
         }
       }
 
-      const compileResult = await compileDynamicContext({
-        targetDirectoryPath: resolvedTargetDirectoryPath,
-        selectedStackFileName,
-        selectedAdditionalStackFileNames,
-        selectedBlueprintFileName,
-        selectedAdditionalBlueprintFileNames,
-        includeCiGuardrails,
-        preserveUserOwnedEntrypoints: true,
-      });
       await writeSelectedPolicy(resolvedTargetDirectoryPath, selectedProfileName);
 
       const setupDurationMs = Date.now() - setupStartedAt;
@@ -462,10 +422,8 @@ 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}`);
@@ -494,7 +452,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
         supplementalCreatedFileNames.forEach((fileName) => console.log(`  [NEW]     ${fileName} (seed)`));
       }
 
-      console.log('\nRefreshed files: .instructions.md, .agent-instructions.md, legacy thin adapters, generated bridge adapters, and .agent-context/state/onboarding-report.json');
+      console.log('\nRefreshed files: AGENTS.md, CLAUDE.md, GEMINI.md, .agent-context/, 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,7 +15,6 @@ import {
 import {
   pathExists,
   collectFileNames,
-  isAgenticManagedContent,
 } from './utils.mjs';
 
 import {
@@ -106,38 +105,6 @@ 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');
-}
-
 function buildContainerizationStrategySnapshot(dockerStrategy) {
   const selectedDockerStrategy = String(dockerStrategy || '').trim();
   const normalizedDockerStrategy = selectedDockerStrategy.toLowerCase();
@@ -220,7 +187,7 @@ export async function writeOnboardingReport({
     selectedBlueprint: hasExplicitArchitectureDecision ? selectedBlueprintFileName : null,
     selectedAdditionalBlueprints: hasExplicitArchitectureDecision ? selectedAdditionalBlueprintFileNames : [],
     ruleLoadingPolicy: {
-      canonicalSource: '.instructions.md',
+      canonicalSource: 'AGENTS.md',
       stackLoadingMode: 'lazy',
       domainRuleLoadingMode: 'lazy',
       loadedOnDemand: true,
@@ -330,11 +297,10 @@ export async function buildCompiledRulesContent({
       `6. .agent-context/policies/${POLICY_FILE_NAME}`,
       '7. docs/ project context (or bootstrap prompts when docs are not materialized)',
       '',
-      'Project-specific compiled snapshot: .agent-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',
+      'Canonical instruction source: AGENTS.md',
+      'Native import bridges: CLAUDE.md, GEMINI.md',
+      'Managed rule library: .agent-context/',
+      'Project decisions and dynamic state: .agent-context/state/onboarding-report.json',
     ].join('\n')
   );
 
@@ -659,62 +625,11 @@ export async function buildCompiledRulesContent({
     `Selected policy file: .agent-context/policies/${POLICY_FILE_NAME}`,
     '',
     '## GOVERNANCE PRECEDENCE',
-    '1. Follow this compiled rulebook as the primary source.',
-    '2. Resolve exceptions from .agent-override.md only when explicitly defined.',
-    '3. Use architecture-map.md and dependency-map.md as change safety boundaries.',
-    '4. Enforce pr-checklist.md before declaring completion.',
-    '',
-    '## OVERRIDE PROTOCOL',
-    '- Default: strict compliance with this file.',
-    '- Exception path: .agent-override.md may explicitly allow narrow deviations.',
-    '- Scope policy: every override must include module scope, rationale, and expiry date.',
+    '1. Follow AGENTS.md as the primary source.',
+    '2. Use architecture-map.md and dependency-map.md as change safety boundaries.',
+    '3. Enforce pr-checklist.md before declaring completion.',
     '',
     ...contextBlocks,
     '',
   ].join('\n');
 }
-
-export async function compileDynamicContext({
-  targetDirectoryPath,
-  selectedStackFileName,
-  selectedAdditionalStackFileNames = [],
-  selectedBlueprintFileName,
-  selectedAdditionalBlueprintFileNames = [],
-  includeCiGuardrails,
-  preserveUserOwnedEntrypoints = true,
-}) {
-  const resolvedTargetDirectoryPath = path.resolve(targetDirectoryPath);
-  const compiledRules = await buildCompiledRulesContent({
-    targetDirectoryPath: resolvedTargetDirectoryPath,
-    selectedStackFileName,
-    selectedAdditionalStackFileNames,
-    selectedBlueprintFileName,
-    selectedAdditionalBlueprintFileNames,
-    includeCiGuardrails,
-  });
-  const preservedEntrypoints = [];
-
-  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;
-      }
-    }
-
-    await fs.mkdir(path.dirname(targetFilePath), { recursive: true });
-    await fs.writeFile(targetFilePath, content, '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

@@ -126,19 +126,11 @@ export const RUNTIME_ENVIRONMENT_CHOICES = [
 ];
 
 export const entryPointFiles = [
-  '.instructions.md',
-  '.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',
 ];
 
-export const directoryCopies = ['.agent-context', '.gemini', '.agents'];
+export const directoryCopies = ['.agent-context'];
 
 export const BACKUP_DIR_NAME = '.agentic-backup';

package/lib/cli/detector.mjs

@@ -102,7 +102,6 @@ const PROJECT_MARKER_FILE_NAMES = new Set([
 const INTERNAL_GOVERNANCE_SURFACE_NAMES = new Set([
   '.agent-context',
   '.agent-instructions.md',
-  '.agent-override.md',
   '.agentic-backup',
   '.agents',
   '.clauderc',

package/lib/cli/init-options.mjs

@@ -23,7 +23,7 @@ export function parseInitArguments(commandArguments) {
     tokenOptimize: true,
     memoryContinuity: true,
     tokenAgent: 'copilot',
-    includeMcpTemplate: true,
+    includeMcpTemplate: false,
     scaffoldDocs: undefined,
     docsLang: 'en',
     docsLangProvided: false,

package/lib/cli/project-scaffolder/design-contract/validation.mjs

@@ -27,6 +27,10 @@ export function validateDesignContractCompleteness(designIntentContract) {
       'spacingDerivationSource',
       'typographyDerivationSource',
       'motionDerivationSource',
+      'colorSpace',
+      'spatialBaseUnit',
+      'typeScaleMethod',
+      'motionBudget',
       'validationRule',
     ]) {
       if (!hasNonEmptyString(derivedTokenLogic[requiredFieldName])) {

package/lib/cli/project-scaffolder/design-contract.mjs

@@ -334,6 +334,10 @@ function buildDesignIntentContractObject({
       spacingDerivationSource: 'Explain spacing rhythm, density, and exceptions from anchorReference. Spacing grids are layout math, not decorative background lines.',
       typographyDerivationSource: 'Explain display, body, metadata, and data roles from anchorReference.',
       motionDerivationSource: 'Explain duration, easing, choreography, and reduced-motion from anchorReference.',
+      colorSpace: 'Prefer OKLCH for newly generated CSS tokens when supported; preserve existing design-system token formats and document fallback color space.',
+      spatialBaseUnit: 'Name the base spacing unit, major multiples, density exceptions, and optical exceptions before writing spacing values.',
+      typeScaleMethod: 'Prefer fluid clamp() type scales when supported; name ratio, role contrast, balance/wrap behavior, and numeric typography needs.',
+      motionBudget: 'Name micro, layout, entrance, easing, stagger, and reduced-motion budgets; prefer transform/opacity for high-frequency motion.',
       validationRule: 'Every semantic token role must trace to anchorReference; keep exact primitive values flexible unless locked by repo evidence, accessibility validation, implementation constraints, or explicit user approval.',
     },
     motionPaletteDecision: {

package/lib/cli/project-scaffolder/prompt-builders.mjs

@@ -245,10 +245,14 @@ export function buildDesignBootstrapPrompt({
     'Use reduced-motion fallbacks instead of suppressing motion.',
     '',
     '## Token Derivation Audit',
-    'Before implementation, docs/design-intent.json must include derivedTokenLogic.anchorReference plus colorDerivationSource, spacingDerivationSource, typographyDerivationSource, motionDerivationSource, and validationRule.',
+    'Before implementation, docs/design-intent.json must include derivedTokenLogic.anchorReference plus colorDerivationSource, spacingDerivationSource, typographyDerivationSource, motionDerivationSource, colorSpace, spatialBaseUnit, typeScaleMethod, motionBudget, and validationRule.',
     'Every semantic token role must be explainable from anchorReference. If the rationale is only looks good, common practice, modern default, or framework default, derive the token again before UI code.',
     'Keep exact primitive values flexible until repo evidence, accessibility validation, implementation constraints, or explicit user approval locks them.',
     '',
+    '## Implementation Craft Layer',
+    'Record explicit CSS craft decisions before UI code: color space and commitment level, fluid typography method, spacing base unit, motion budget, and the default CSS reflex this project rejects.',
+    'Prefer OKLCH, tinted neutrals, clamp() type scales, transform/opacity motion, and responsive recomposition when supported by the stack; preserve existing design-system tokens and document fallbacks instead of forcing rewrites.',
+    '',
     '## Library Research Protocol',
     'If web search is available, verify every new UI, animation, scroll, 3D, canvas, chart, icon, styling, or primitive library against current official docs and record source URL, fetched date, stable compatible version, purpose, risk, and fallback.',
     'If web search is unavailable or fails, set libraryResearchStatus to pending-verification, record LIBRARY_TO_VERIFY notes, and use native CSS, browser APIs, or already-present project dependencies only when they can preserve the intended ambition until verification is possible.',

package/lib/cli/utils/filesystem.mjs

@@ -51,6 +51,8 @@ export function isAgenticManagedContent(content) {
     'Adapter Mode: legacy-thin',
     'Canonical Snapshot SHA256',
     'Canonical baseline: .instructions.md',
+    'canonical instruction source for this repository',
+    '@AGENTS.md',
   ].some((managedSignal) => normalizedContent.includes(managedSignal));
 }
 

package/lib/cli/utils/managed-surface.mjs

@@ -6,7 +6,10 @@ import {
   entryPointFiles,
   directoryCopies,
 } from '../constants.mjs';
-import { pathExists } from './filesystem.mjs';
+import {
+  isAgenticManagedContent,
+  pathExists,
+} from './filesystem.mjs';
 
 function toPosixRelativePath(relativePath) {
   return relativePath.split(path.sep).join('/');
@@ -29,6 +32,34 @@ const localOnlyGovernanceFiles = new Set([
   '.agent-context/state/v3-purge-audit.json',
 ]);
 
+const legacyManagedInstructionFiles = [
+  '.instructions.md',
+  '.agent-instructions.md',
+  '.cursorrules',
+  '.windsurfrules',
+  '.clauderc',
+  '.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',
+  '.agents/workflows/init-project.md',
+  '.agents/workflows/refactor.md',
+  '.agents/workflows/review-code.md',
+];
+
+export const legacyManagedInstructionDirectories = [
+  '.agents/workflows',
+  '.agents',
+  '.cursor/rules',
+  '.cursor',
+  '.windsurf/rules',
+  '.windsurf',
+  '.github/instructions',
+  '.github',
+  '.gemini',
+];
+
 function isLocalOnlyGovernanceFile(relativePath) {
   return localOnlyGovernanceFiles.has(toPosixRelativePath(relativePath));
 }
@@ -171,6 +202,18 @@ async function collectManagedTargetManifest(resolvedTargetDirectoryPath, options
     targetDirectories.add(targetDirectoryPath);
   }
 
+  for (const legacyManagedFile of legacyManagedInstructionFiles) {
+    const targetFilePath = path.join(resolvedTargetDirectoryPath, ...legacyManagedFile.split('/'));
+    if (!(await pathExists(targetFilePath))) {
+      continue;
+    }
+
+    const targetFileContent = await fs.readFile(targetFilePath);
+    if (isAgenticManagedContent(targetFileContent)) {
+      targetFiles.add(legacyManagedFile);
+    }
+  }
+
   return {
     files: targetFiles,
     directories: targetDirectories,
@@ -183,7 +226,7 @@ export async function analyzeManagedGovernanceSurface(
 ) {
   const preservePathPrefixes = Array.isArray(options.preservePathPrefixes)
     ? options.preservePathPrefixes
-    : ['.agent-context/state', '.gemini'];
+    : ['.agent-context/state'];
 
   const sourceManifest = await buildManagedSourceManifest(options);
   const targetManifest = await collectManagedTargetManifest(resolvedTargetDirectoryPath, options);