@ryuenn3123/agentic-senior-core 3.0.19 → 3.0.20

package/lib/cli/commands/upgrade.mjs

@@ -11,7 +11,8 @@ import {
   CLI_VERSION,
   AGENT_CONTEXT_DIR,
   PROFILE_PRESETS,
-  BLUEPRINT_RECOMMENDATIONS,
+  AGENT_DECISION_STACK_FILE_NAME,
+  AGENT_DECISION_BLUEPRINT_FILE_NAME,
 } from '../constants.mjs';
 
 import {
@@ -103,8 +104,8 @@ export function parseUpgradeArguments(commandArguments) {
 function buildExistingProjectMajorConstraints() {
   return [
     'Preserve existing project markers and avoid forced stack migration.',
-    'Keep stack rule loading lazy and scoped to touched code.',
-    'Upgrade keeps prior onboarding choices unless user overrides them.',
+    '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.',
   ];
 }
 
@@ -172,9 +173,11 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
 
   try {
     console.log(`\nAgentic-Senior-Core CLI v${CLI_VERSION}`);
-    console.log('Running rules operations upgrade assistant (Federated Governance baseline) for an existing repository.');
+    console.log('Running managed guidance upgrade for an existing repository.');
 
-    const managedSurfacePlan = await analyzeManagedGovernanceSurface(resolvedTargetDirectoryPath);
+    const managedSurfacePlan = await analyzeManagedGovernanceSurface(resolvedTargetDirectoryPath, {
+      includeMcpTemplate: upgradeOptions.includeMcpTemplate === true,
+    });
 
     const stackFileNames = await collectFileNames(path.join(AGENT_CONTEXT_DIR, 'stacks'));
     const blueprintFileNames = await collectFileNames(path.join(AGENT_CONTEXT_DIR, 'blueprints'));
@@ -184,29 +187,28 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       ? existingOnboardingReport.selectedProfile
       : 'balanced';
 
-    const selectedStackFileName = stackFileNames.includes(existingOnboardingReport?.selectedStack)
+    const hasExplicitRuntimeConstraint = existingOnboardingReport?.runtimeDecision?.mode === 'explicit-constraint';
+    const hasExplicitArchitectureConstraint = existingOnboardingReport?.architectureDecision?.mode === 'explicit-constraint';
+
+    const selectedStackFileName = hasExplicitRuntimeConstraint && stackFileNames.includes(existingOnboardingReport?.selectedStack)
       ? existingOnboardingReport.selectedStack
-      : projectDetection.recommendedStackFileName || 'typescript.md';
+      : AGENT_DECISION_STACK_FILE_NAME;
 
-    const selectedAdditionalStackFileNames = Array.isArray(existingOnboardingReport?.selectedAdditionalStacks)
+    const selectedAdditionalStackFileNames = hasExplicitRuntimeConstraint && Array.isArray(existingOnboardingReport?.selectedAdditionalStacks)
       ? Array.from(new Set(existingOnboardingReport.selectedAdditionalStacks.filter(
         (stackFileName) => stackFileNames.includes(stackFileName) && stackFileName !== selectedStackFileName
       )))
-      : Array.from(new Set((projectDetection.secondaryStackFileNames || []).filter(
-        (stackFileName) => stackFileNames.includes(stackFileName) && stackFileName !== selectedStackFileName
-      )));
+      : [];
 
-    const selectedBlueprintFileName = blueprintFileNames.includes(existingOnboardingReport?.selectedBlueprint)
+    const selectedBlueprintFileName = hasExplicitArchitectureConstraint && blueprintFileNames.includes(existingOnboardingReport?.selectedBlueprint)
       ? existingOnboardingReport.selectedBlueprint
-      : BLUEPRINT_RECOMMENDATIONS[selectedStackFileName] || 'api-nextjs.md';
+      : AGENT_DECISION_BLUEPRINT_FILE_NAME;
 
-    const selectedAdditionalBlueprintFileNames = Array.isArray(existingOnboardingReport?.selectedAdditionalBlueprints)
+    const selectedAdditionalBlueprintFileNames = hasExplicitArchitectureConstraint && Array.isArray(existingOnboardingReport?.selectedAdditionalBlueprints)
       ? Array.from(new Set(existingOnboardingReport.selectedAdditionalBlueprints.filter(
         (blueprintFileName) => blueprintFileNames.includes(blueprintFileName) && blueprintFileName !== selectedBlueprintFileName
       )))
-      : Array.from(new Set(selectedAdditionalStackFileNames
-        .map((stackFileName) => BLUEPRINT_RECOMMENDATIONS[stackFileName] || null)
-        .filter((blueprintFileName) => blueprintFileName && blueprintFileName !== selectedBlueprintFileName)));
+      : [];
 
     const includeCiGuardrails = typeof existingOnboardingReport?.ciGuardrailsEnabled === 'boolean'
       ? existingOnboardingReport.ciGuardrailsEnabled
@@ -269,10 +271,10 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
     };
 
     console.log('\nExisting project detection transparency:');
-    if (projectDetection.recommendedStackFileName) {
+    if (projectDetection.detectedStackFileName) {
       const confidenceScoreLabel = Number(projectDetection.confidenceScore || 0).toFixed(2);
       console.log(
-        `- Detected stack: ${toTitleCase(projectDetection.recommendedStackFileName)} (${projectDetection.confidenceLabel}, score ${confidenceScoreLabel})`
+        `- Detected stack: ${toTitleCase(projectDetection.detectedStackFileName)} (${projectDetection.confidenceLabel}, score ${confidenceScoreLabel})`
       );
     } else {
       console.log('- Detected stack: unresolved (insufficient markers).');
@@ -312,11 +314,11 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
 
     console.log('\nUpgrade preview:');
     console.log(`- Target directory: ${resolvedTargetDirectoryPath}`);
-    console.log(`- Stack: ${toTitleCase(selectedStackFileName)}`);
+    console.log(`- Runtime decision: ${selectedStackFileName === AGENT_DECISION_STACK_FILE_NAME ? 'agent recommendation required from repo evidence' : toTitleCase(selectedStackFileName)}`);
     if (selectedAdditionalStackFileNames.length > 0) {
       console.log(`- Additional stacks: ${selectedAdditionalStackFileNames.map((stackFileName) => toTitleCase(stackFileName)).join(', ')}`);
     }
-    console.log(`- Blueprint: ${toTitleCase(selectedBlueprintFileName)}`);
+    console.log(`- Architecture decision: ${selectedBlueprintFileName === AGENT_DECISION_BLUEPRINT_FILE_NAME ? 'agent recommendation required from repo evidence' : toTitleCase(selectedBlueprintFileName)}`);
     if (selectedAdditionalBlueprintFileNames.length > 0) {
       console.log(`- Additional blueprints: ${selectedAdditionalBlueprintFileNames.map((blueprintFileName) => toTitleCase(blueprintFileName)).join(', ')}`);
     }
@@ -355,7 +357,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
         const detectedVersionLabel = staleDoc.detectedTemplateVersion || 'missing';
         console.log(`- docs/${staleDoc.fileName} (detected: ${detectedVersionLabel}, expected: ${projectDocStalenessReport.expectedTemplateVersion})`);
       }
-      console.log('Recommendation: regenerate docs with init --scaffold-docs or update the files manually to match the latest template version.');
+      console.log('Required action: regenerate docs with init --scaffold-docs or update the files manually to match the latest template version.');
     }
 
     if (uiScopeSignals.isUiScopeLikely && missingDesignContractPaths.length > 0) {
@@ -372,7 +374,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       if (shouldSeedDesignIntentOnApply) {
         console.log('- Planned seed on apply: docs/design-intent.json');
       }
-      console.log('Recommendation: create or refresh docs/DESIGN.md and docs/design-intent.json before allowing UI implementation work.');
+      console.log('Required action: create or refresh docs/DESIGN.md and docs/design-intent.json before allowing UI implementation work.');
       console.log('Upgrade synchronizes governance assets and can seed docs/design-intent.json, but it does not author project-specific docs/DESIGN.md automatically.');
     }
 

package/lib/cli/compiler.mjs

@@ -8,7 +8,8 @@ import path from 'node:path';
 import {
   CLI_VERSION,
   POLICY_FILE_NAME,
-  BLUEPRINT_RECOMMENDATIONS,
+  AGENT_DECISION_STACK_FILE_NAME,
+  AGENT_DECISION_BLUEPRINT_FILE_NAME,
 } from './constants.mjs';
 
 import {
@@ -49,10 +50,11 @@ export async function writeOnboardingReport({
   operationMode = 'init',
   tokenOptimization = undefined,
   memoryContinuity = undefined,
-  architectRecommendation = null,
   detectionTransparency = null,
   uiScopeSignals = null,
 }) {
+  const hasExplicitRuntimeDecision = selectedStackFileName && selectedStackFileName !== AGENT_DECISION_STACK_FILE_NAME;
+  const hasExplicitArchitectureDecision = selectedBlueprintFileName && selectedBlueprintFileName !== AGENT_DECISION_BLUEPRINT_FILE_NAME;
   const onboardingReportPath = path.join(targetDirectoryPath, '.agent-context', 'state', 'onboarding-report.json');
   const resolvedTokenOptimization = typeof tokenOptimization === 'undefined'
     ? await readTokenOptimizationState(targetDirectoryPath)
@@ -68,32 +70,39 @@ export async function writeOnboardingReport({
     selectedPreset,
     projectScope,
     projectTopology,
-    selectedStack: selectedStackFileName,
-    selectedAdditionalStacks: selectedAdditionalStackFileNames,
-    selectedBlueprint: selectedBlueprintFileName,
-    selectedAdditionalBlueprints: selectedAdditionalBlueprintFileNames,
+    runtimeDecision: {
+      mode: hasExplicitRuntimeDecision ? 'explicit-constraint' : 'agent-decision-required',
+      explicitStack: hasExplicitRuntimeDecision ? selectedStackFileName : null,
+      detectedStackEvidence: projectDetection.detectedStackFileName || null,
+      detectedAdditionalStackEvidence: projectDetection.secondaryStackFileNames || [],
+    },
+    architectureDecision: {
+      mode: hasExplicitArchitectureDecision ? 'explicit-constraint' : 'agent-decision-required',
+      explicitBlueprint: hasExplicitArchitectureDecision ? selectedBlueprintFileName : null,
+      detectedBlueprintEvidence: projectDetection.detectedBlueprintFileName || null,
+    },
+    selectedStack: hasExplicitRuntimeDecision ? selectedStackFileName : null,
+    selectedAdditionalStacks: hasExplicitRuntimeDecision ? selectedAdditionalStackFileNames : [],
+    selectedBlueprint: hasExplicitArchitectureDecision ? selectedBlueprintFileName : null,
+    selectedAdditionalBlueprints: hasExplicitArchitectureDecision ? selectedAdditionalBlueprintFileNames : [],
     ruleLoadingPolicy: {
       canonicalSource: '.instructions.md',
       stackLoadingMode: 'lazy',
       loadedOnDemand: true,
-      primaryStack: selectedStackFileName,
-      additionalStacks: selectedAdditionalStackFileNames,
+      primaryStack: hasExplicitRuntimeDecision ? selectedStackFileName : null,
+      additionalStacks: hasExplicitRuntimeDecision ? selectedAdditionalStackFileNames : [],
+      agentDecisionRequired: !hasExplicitRuntimeDecision,
     },
     ciGuardrailsEnabled: includeCiGuardrails,
     setupDurationMs,
     runtimeEnvironment,
     tokenOptimization: resolvedTokenOptimization,
     memoryContinuity: resolvedMemoryContinuity,
-    architectRecommendation,
     autoDetection: {
-      recommendedStack: projectDetection.recommendedStackFileName,
-      recommendedAdditionalStacks: projectDetection.secondaryStackFileNames || [],
-      recommendedBlueprint: projectDetection.recommendedBlueprintFileName,
-      recommendedAdditionalBlueprints: Array.isArray(projectDetection.secondaryStackFileNames)
-        ? projectDetection.secondaryStackFileNames
-          .map((secondaryStackFileName) => BLUEPRINT_RECOMMENDATIONS[secondaryStackFileName] || null)
-          .filter(Boolean)
-        : [],
+      detectedStack: projectDetection.detectedStackFileName,
+      detectedAdditionalStacks: projectDetection.secondaryStackFileNames || [],
+      detectedBlueprint: projectDetection.detectedBlueprintFileName,
+      detectedAdditionalBlueprints: [],
       confidenceLabel: projectDetection.confidenceLabel,
       confidenceScore: projectDetection.confidenceScore,
       confidenceGap: projectDetection.confidenceGap,
@@ -151,6 +160,8 @@ export async function buildCompiledRulesContent({
   const availableStackProfileFileNames = new Set(await collectFileNames(selectedStacksDirectoryPath));
   const availableBlueprintProfileFileNames = new Set(await collectFileNames(selectedBlueprintsDirectoryPath));
   const contextBlocks = [];
+  const hasExplicitRuntimeDecision = selectedStackFileName && selectedStackFileName !== AGENT_DECISION_STACK_FILE_NAME;
+  const hasExplicitArchitectureDecision = selectedBlueprintFileName && selectedBlueprintFileName !== AGENT_DECISION_BLUEPRINT_FILE_NAME;
 
   function firstMarkdownHeading(content, fallbackLabel) {
     const headingLine = content
@@ -174,11 +185,11 @@ export async function buildCompiledRulesContent({
   contextBlocks.push(
     [
       '## BOOTSTRAP CHAIN (MANDATORY)',
-      'Load every layer before responding. Do not skip steps:',
+      'Resolve the smallest relevant layer set before responding. Do not eagerly load unrelated layers:',
       '1. .agent-context/rules/',
-      '2. Resolve architecture and stack signals from project context and live evidence.',
+      '2. Resolve runtime and architecture signals from project context, repo evidence, and live research.',
       '3. .agent-context/prompts/',
-      '4. Dynamic architecture and stack signals (from project context + research evidence)',
+      '4. Dynamic runtime and architecture decision signals (from project context + research evidence)',
       '5. .agent-context/state/',
       `6. .agent-context/policies/${POLICY_FILE_NAME}`,
       '7. docs/ project context (or bootstrap prompts when docs are not materialized)',
@@ -191,31 +202,43 @@ export async function buildCompiledRulesContent({
 
   contextBlocks.push(
     [
-      '## LAYER 1: UNIVERSAL RULES (MANDATORY)',
-      'Read every file under .agent-context/rules/ before implementation:',
+      '## LAYER 1: RULES (SCOPE-RESOLVED)',
+      'Available rule files under .agent-context/rules/:',
       ...universalRuleFileNames.map((universalRuleFileName, index) => `${index + 1}. .agent-context/rules/${universalRuleFileName}`),
       '',
-      'Conflict resolution: prioritize data safety and API contract integrity first, then writing polish.',
+      'Resolution policy: load only the rule files relevant to the current task and prioritize data safety and API contract integrity first, then writing polish.',
     ].join('\n')
   );
 
-  const stackFilePath = path.join(selectedStacksDirectoryPath, selectedStackFileName);
-  const hasStackProfileFile = availableStackProfileFileNames.has(selectedStackFileName);
-  const stackSummary = hasStackProfileFile
-    ? firstMarkdownHeading(await fs.readFile(stackFilePath, 'utf8'), selectedStackFileName)
-    : `Dynamic stack strategy signal for ${humanizeProfileName(selectedStackFileName)}.`;
-  contextBlocks.push(
-    [
-      `## LAYER 2: STACK PROFILE (${selectedStackFileName})`,
-      hasStackProfileFile
-        ? `Source: stack-profile:${selectedStackFileName}`
-        : 'Source: dynamic-research-signal (static stack profile file not required)',
-      `Summary: ${stackSummary}`,
-      'Load this stack profile to enforce language-specific conventions.',
-    ].join('\n')
-  );
+  if (hasExplicitRuntimeDecision) {
+    const stackFilePath = path.join(selectedStacksDirectoryPath, selectedStackFileName);
+    const hasStackProfileFile = availableStackProfileFileNames.has(selectedStackFileName);
+    const stackSummary = hasStackProfileFile
+      ? firstMarkdownHeading(await fs.readFile(stackFilePath, 'utf8'), selectedStackFileName)
+      : `Explicit runtime constraint for ${humanizeProfileName(selectedStackFileName)}.`;
+    contextBlocks.push(
+      [
+        `## LAYER 2: RUNTIME CONSTRAINT (${selectedStackFileName})`,
+        hasStackProfileFile
+          ? `Source: stack-profile:${selectedStackFileName}`
+          : 'Source: explicit user constraint',
+        `Summary: ${stackSummary}`,
+        'Use this only as a constraint when the task touches that runtime. Do not treat it as design direction.',
+      ].join('\n')
+    );
+  } else {
+    contextBlocks.push(
+      [
+        '## LAYER 2: RUNTIME DECISION REQUIRED',
+        'No runtime stack was selected by the user.',
+        'For a fresh project, the first implementation step is to ask the AI agent to recommend a runtime/framework from the brief, constraints, and live official documentation.',
+        'For an existing project, inspect repo markers and current files directly before editing. Detection evidence is not a migration instruction.',
+        'Do not silently choose a stack from offline defaults.',
+      ].join('\n')
+    );
+  }
 
-  if (normalizedAdditionalStackFileNames.length > 0) {
+  if (hasExplicitRuntimeDecision && normalizedAdditionalStackFileNames.length > 0) {
     contextBlocks.push(
       [
         '## LAYER 2B: ADDITIONAL STACK PROFILES',
@@ -234,9 +257,9 @@ export async function buildCompiledRulesContent({
   contextBlocks.push(
     [
       '## LAYER 2 POLICY: LAZY RULE LOADING',
-      hasStackProfileFile
-        ? `Primary stack profile is always loaded for this project: stack-profile:${selectedStackFileName}`
-        : `Primary stack strategy is always loaded for this project: ${selectedStackFileName} (dynamic mode)`,
+      hasExplicitRuntimeDecision
+        ? `Primary runtime constraint: ${selectedStackFileName}`
+        : 'Primary runtime constraint: unresolved until agent recommendation is approved',
       normalizedAdditionalStackFileNames.length > 0
         ? `Additional stack profiles load on demand: ${normalizedAdditionalStackFileNames.map((stackFileName) => {
           if (availableStackProfileFileNames.has(stackFileName)) {
@@ -245,9 +268,9 @@ export async function buildCompiledRulesContent({
 
           return `${stackFileName} (dynamic signal)`;
         }).join(', ')}`
-        : 'Additional stack profiles load only when explicitly selected or detected.',
-      'Load stack guidance only when task scope touches that stack.',
-      'Avoid eager loading unrelated stack profiles to prevent instruction conflicts.',
+        : 'Additional runtime guidance loads only when explicitly selected by the user or required by touched code.',
+      'Load runtime-specific guidance only when task scope touches that runtime.',
+      'Avoid eager loading unrelated runtime guidance to prevent instruction conflicts.',
     ].join('\n')
   );
 
@@ -261,28 +284,39 @@ export async function buildCompiledRulesContent({
       '4. .agent-context/prompts/bootstrap-design.md -> ui, ux, layout, screen, tailwind, frontend, redesign',
       'UI trigger policy:',
       '- Load .agent-context/prompts/bootstrap-design.md and .agent-context/rules/frontend-architecture.md first.',
-      '- Keep UI-only requests context-isolated and do not eagerly load backend-only rules such as database-design.md, docker-runtime.md, or microservices.md unless the task explicitly crosses those boundaries.',
+      '- Keep UI-only requests context-isolated and do not eagerly load backend-only rules such as database-design.md, docker-runtime.md, microservices.md, git-workflow.md, or general implementation-theory rules unless the task explicitly crosses those boundaries.',
       '- For UI scope, materialize docs/DESIGN.md and docs/design-intent.json before implementing UI surfaces.',
     ].join('\n')
   );
 
-  const blueprintFilePath = path.join(selectedBlueprintsDirectoryPath, selectedBlueprintFileName);
-  const hasBlueprintProfileFile = availableBlueprintProfileFileNames.has(selectedBlueprintFileName);
-  const blueprintSummary = hasBlueprintProfileFile
-    ? firstMarkdownHeading(await fs.readFile(blueprintFilePath, 'utf8'), selectedBlueprintFileName)
-    : `Dynamic architecture strategy signal for ${humanizeProfileName(selectedBlueprintFileName)}.`;
-  contextBlocks.push(
-    [
-      `## LAYER 3: BLUEPRINT PROFILE (${selectedBlueprintFileName})`,
-      hasBlueprintProfileFile
-        ? `Source: architecture-profile:${selectedBlueprintFileName}`
-        : 'Source: dynamic-research-signal (static blueprint profile file not required)',
-      `Summary: ${blueprintSummary}`,
-      'Load this blueprint when scaffolding or changing architecture boundaries.',
-    ].join('\n')
-  );
+  if (hasExplicitArchitectureDecision) {
+    const blueprintFilePath = path.join(selectedBlueprintsDirectoryPath, selectedBlueprintFileName);
+    const hasBlueprintProfileFile = availableBlueprintProfileFileNames.has(selectedBlueprintFileName);
+    const blueprintSummary = hasBlueprintProfileFile
+      ? firstMarkdownHeading(await fs.readFile(blueprintFilePath, 'utf8'), selectedBlueprintFileName)
+      : `Explicit architecture constraint for ${humanizeProfileName(selectedBlueprintFileName)}.`;
+    contextBlocks.push(
+      [
+        `## LAYER 3: ARCHITECTURE CONSTRAINT (${selectedBlueprintFileName})`,
+        hasBlueprintProfileFile
+          ? `Source: architecture-profile:${selectedBlueprintFileName}`
+          : 'Source: explicit user constraint',
+        `Summary: ${blueprintSummary}`,
+        'Use this only as an explicit constraint when scaffolding or changing architecture boundaries.',
+      ].join('\n')
+    );
+  } else {
+    contextBlocks.push(
+      [
+        '## LAYER 3: ARCHITECTURE DECISION REQUIRED',
+        'No architecture blueprint was selected by the user.',
+        'The AI agent must propose the architecture from the product brief, repo evidence, required docs, and live research before implementation.',
+        'Do not map detected runtime markers into a blueprint automatically.',
+      ].join('\n')
+    );
+  }
 
-  if (normalizedAdditionalBlueprintFileNames.length > 0) {
+  if (hasExplicitArchitectureDecision && normalizedAdditionalBlueprintFileNames.length > 0) {
     contextBlocks.push(
       [
         '## LAYER 3A: ADDITIONAL BLUEPRINT PROFILES',

package/lib/cli/constants.mjs

@@ -17,128 +17,54 @@ export const POLICY_FILE_NAME = 'llm-judge-threshold.json';
 
 export const ALLOWED_SEVERITY_LEVELS = new Set(['critical', 'high', 'medium', 'low']);
 
-export const BLUEPRINT_RECOMMENDATIONS = {
-  'typescript.md': 'api-nextjs.md',
-  'python.md': 'fastapi-service.md',
-  'java.md': 'spring-boot-api.md',
-  'php.md': 'laravel-api.md',
-  'go.md': 'go-service.md',
-  'csharp.md': 'aspnet-api.md',
-  'react-native.md': 'mobile-app.md',
-  'flutter.md': 'mobile-app.md',
-};
-
-export const FALLBACK_STACK_FILE_NAMES = [
-  'typescript.md',
-  'python.md',
-  'go.md',
-  'java.md',
-  'php.md',
-  'csharp.md',
-  'rust.md',
-  'ruby.md',
-  'react-native.md',
-  'flutter.md',
-];
-
-export const FALLBACK_BLUEPRINT_FILE_NAMES = [
-  'api-nextjs.md',
-  'nestjs-logic.md',
-  'fastapi-service.md',
-  'spring-boot-api.md',
-  'go-service.md',
-  'aspnet-api.md',
-  'laravel-api.md',
-  'graphql-grpc-api.md',
-  'ci-github-actions.md',
-  'ci-gitlab.md',
-  'kubernetes-manifests.md',
-  'infrastructure-as-code.md',
-  'observability.md',
-  'mobile-app.md',
-];
+export const AGENT_DECISION_STACK_FILE_NAME = 'agent-decision-runtime.md';
+export const AGENT_DECISION_BLUEPRINT_FILE_NAME = 'agent-decision-architecture.md';
 
 export const INIT_PRESETS = {
-  'frontend-web': {
-    stack: 'typescript.md',
-    blueprint: 'api-nextjs.md',
+  'frontend-ui': {
+    stack: null,
+    blueprint: null,
     ci: true,
-    description: 'Frontend-first web app starter',
+    description: 'Frontend/UI scope hint; agent recommends runtime and architecture before coding',
   },
-  'backend-api': {
-    stack: 'python.md',
-    blueprint: 'fastapi-service.md',
+  'backend-service': {
+    stack: null,
+    blueprint: null,
     ci: true,
-    description: 'Backend API starter with safe defaults',
+    description: 'Backend/API scope hint; agent recommends runtime and architecture before coding',
   },
   'fullstack-product': {
-    stack: 'typescript.md',
-    blueprint: 'api-nextjs.md',
-    ci: true,
-    description: 'Product delivery starter with fullstack governance',
-  },
-  'platform-governance': {
-    stack: 'go.md',
-    blueprint: 'go-service.md',
-    ci: true,
-    description: 'Platform and delivery starter with Go service defaults',
-  },
-  'mobile-react-native': {
-    stack: 'react-native.md',
-    blueprint: 'mobile-app.md',
-    ci: true,
-    description: 'Mobile app starter for React Native',
-  },
-  'mobile-flutter': {
-    stack: 'flutter.md',
-    blueprint: 'mobile-app.md',
-    ci: true,
-    description: 'Mobile app starter for Flutter',
-  },
-  'observability-platform': {
-    stack: 'go.md',
-    blueprint: 'observability.md',
-    ci: true,
-    description: 'Observability and platform starter',
-  },
-  'typescript-nestjs-service': {
-    stack: 'typescript.md',
-    blueprint: 'nestjs-logic.md',
-    ci: true,
-    description: 'TypeScript service starter with NestJS module blueprint',
-  },
-  'java-enterprise-api': {
-    stack: 'java.md',
-    blueprint: 'spring-boot-api.md',
+    stack: null,
+    blueprint: null,
     ci: true,
-    description: 'Enterprise API starter for JVM teams',
+    description: 'Fullstack product scope hint; agent recommends runtime and architecture before coding',
   },
-  'dotnet-enterprise-api': {
-    stack: 'csharp.md',
-    blueprint: 'aspnet-api.md',
+  'mobile-app': {
+    stack: null,
+    blueprint: null,
     ci: true,
-    description: '.NET API starter with enterprise-friendly defaults',
+    description: 'Mobile app scope hint; agent recommends native strategy before coding',
   },
-  'php-laravel-api': {
-    stack: 'php.md',
-    blueprint: 'laravel-api.md',
+  'platform-ops': {
+    stack: null,
+    blueprint: null,
     ci: true,
-    description: 'Laravel API starter with current framework defaults',
+    description: 'Platform operations scope hint; agent recommends runtime and architecture before coding',
   },
-  'kubernetes-platform': {
-    stack: 'go.md',
-    blueprint: 'kubernetes-manifests.md',
+  observability: {
+    stack: null,
+    blueprint: null,
     ci: true,
-    description: 'Platform starter focused on Kubernetes delivery assets',
+    description: 'Observability scope hint; agent recommends runtime and architecture before coding',
   },
 };
 
 export const PROFILE_PRESETS = {
   beginner: {
     displayName: 'Beginner',
-    description: 'Safest path. Minimal decisions, TypeScript defaults, and CI enabled.',
-    defaultStackFileName: 'typescript.md',
-    defaultBlueprintFileName: 'api-nextjs.md',
+    description: 'Safest path. Minimal decisions, agent-led stack decision, and CI enabled.',
+    defaultStackFileName: null,
+    defaultBlueprintFileName: null,
     defaultCi: true,
     lockCi: true,
     blockingSeverities: ['critical'],
@@ -180,40 +106,6 @@ export const PROJECT_SCOPE_CHOICES = [
   },
 ];
 
-export const PROJECT_SCOPE_STACK_FILTERS = {
-  'frontend-only': ['typescript.md'],
-  'backend-only': ['typescript.md', 'python.md', 'go.md', 'java.md', 'php.md', 'csharp.md', 'ruby.md', 'rust.md'],
-  both: ['typescript.md', 'python.md', 'go.md', 'java.md', 'php.md', 'csharp.md', 'ruby.md', 'rust.md'],
-};
-
-export const WEB_FRONTEND_STACK_CANDIDATES = ['typescript.md'];
-
-export const WEB_BACKEND_STACK_CANDIDATES = [
-  'typescript.md',
-  'python.md',
-  'go.md',
-  'java.md',
-  'php.md',
-  'csharp.md',
-  'ruby.md',
-  'rust.md',
-];
-
-export const WEB_FRONTEND_BLUEPRINT_CANDIDATES = [
-  'api-nextjs.md',
-];
-
-export const WEB_BACKEND_BLUEPRINT_CANDIDATES = [
-  'nestjs-logic.md',
-  'fastapi-service.md',
-  'go-service.md',
-  'spring-boot-api.md',
-  'laravel-api.md',
-  'aspnet-api.md',
-  'graphql-grpc-api.md',
-  'api-nextjs.md',
-];
-
 export const RUNTIME_ENVIRONMENT_CHOICES = [
   {
     key: 'linux-wsl',