@ryuenn3123/agentic-senior-core 3.0.7 → 3.0.9

package/.agent-context/prompts/bootstrap-design.md

@@ -10,10 +10,12 @@ This contract is a structure and reasoning system, not a fixed visual template.
 The agent must:
 1. Read [AGENTS.md](../../AGENTS.md) for project context and team roles.
 2. Scan all files in [.agent-context/rules/](../rules/) for UI/UX and accessibility standards.
-3. Reference [docs/deep-dive.md](../../docs/deep-dive.md) and [docs/faq.md](../../docs/faq.md) for architecture and product background.
+3. Use repository evidence from [.agent-context/state/onboarding-report.json](../state/onboarding-report.json), existing UI code, product copy, route names, component names, and any existing `docs/*` project docs to infer architecture and product background.
 4. If [docs/DESIGN.md](../../docs/DESIGN.md) or `docs/design-intent.json` already exists, check for drift and improve them instead of rewriting blindly.
-5. Treat any example structure or stylistic inspiration as non-normative. Use it only to judge depth and clarity, never to copy a visual language directly.
-6. All references to docs or rules must be clickable markdown links.
+5. If context is incomplete, write explicit assumptions and reversible design bets instead of defaulting to generic SaaS output.
+6. Explore multiple plausible design directions internally, then commit to one cohesive direction with clear rationale tied to the product context.
+7. Treat any example structure or stylistic inspiration as non-normative. Use it only to judge depth and clarity, never to copy a visual language directly.
+8. All references to docs or rules must be clickable markdown links.
 
 Required `docs/DESIGN.md` sections:
 1. Design Intent and Product Personality
@@ -44,5 +46,5 @@ Required `docs/design-intent.json` fields:
 Output:
 - Create or update both `docs/DESIGN.md` and `docs/design-intent.json`.
 - Keep both files synchronized: the markdown explains the why, the JSON captures the contract in machine-readable form.
-- Use practical, modern, accessible language grounded in the project, not generic SaaS defaults.
+- Use practical, modern, accessible language grounded in the project, not generic SaaS defaults or copycat brand systems.
 - Wait for user approval before generating Figma or code assets.

package/.agent-context/prompts/init-project.md

@@ -6,7 +6,7 @@ This prompt boots a repository with strict rules operations context (Federated G
 When a new project is created or initialized, the agent should automatically:
 1. Read [AGENTS.md](../../AGENTS.md) to understand available roles and knowledge base.
 2. Scan all files in [.agent-context/rules/](../rules/) for mandatory engineering standards.
-3. Review dynamic stack and architecture signals from [docs/deep-dive.md](../../docs/deep-dive.md), [docs/faq.md](../../docs/faq.md), and task constraints.
+3. Review dynamic stack and architecture signals from [.agent-context/state/onboarding-report.json](../state/onboarding-report.json), [.agent-context/state/stack-research-snapshot.json](../state/stack-research-snapshot.json), available stack and blueprint sources, and task constraints.
 
 ## Architect Mode (Recommended)
 If the user describes a project or feature, the agent should:
@@ -19,7 +19,7 @@ If the user describes a project or feature, the agent should:
 If the user specifies a framework/blueprint, the agent should:
 1. Read [AGENTS.md](../../AGENTS.md) for role context.
 2. Scan all files in [.agent-context/rules/](../rules/) for engineering standards.
-3. Reference [docs/deep-dive.md](../../docs/deep-dive.md) and [docs/faq.md](../../docs/faq.md) for stack/blueprint guidance.
+3. Reference [.agent-context/state/onboarding-report.json](../state/onboarding-report.json), [.cursorrules](../../.cursorrules), and [.windsurfrules](../../.windsurfrules) for the active stack and blueprint guidance already applied to this project.
 4. Scaffold the initial project structure following the blueprint exactly:
 	- Create all directories and files from the blueprint
 	- Set up environment config and validation (e.g., Zod, Pydantic, FluentValidation)
@@ -32,7 +32,7 @@ If the user specifies a framework/blueprint, the agent should:
 	- Every dependency must be justified per [efficiency-vs-hype.md](../rules/efficiency-vs-hype.md)
 
 ## Stacks & Blueprints Reference
-See [docs/roadmap.md](../../docs/roadmap.md) and [docs/deep-dive.md](../../docs/deep-dive.md) for the latest stack and blueprint list.
+See [.agent-context/state/onboarding-report.json](../state/onboarding-report.json), [.cursorrules](../../.cursorrules), and [.windsurfrules](../../.windsurfrules) for the latest shipped stack and blueprint context.
 
 ## UI/UX Bootstrap
 When a user requests frontend or UI/UX design, the agent should automatically execute the [bootstrap-design.md](./bootstrap-design.md) prompt to synthesize a dynamic design contract (`docs/DESIGN.md` + `docs/design-intent.json`).
@@ -93,7 +93,7 @@ Every dependency must be justified per [efficiency-vs-hype.md](../rules/efficien
 
 ## Stacks & Blueprints Reference
 
-See [docs/roadmap.md](../../docs/roadmap.md) and [docs/deep-dive.md](../../docs/deep-dive.md) for the latest stack and blueprint list.
+See [.agent-context/state/onboarding-report.json](../state/onboarding-report.json), [.cursorrules](../../.cursorrules), and [.windsurfrules](../../.windsurfrules) for the latest shipped stack and blueprint context.
 
 ---
 

package/.agent-context/state/memory-continuity-benchmark.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-20T00:30:26.121Z",
+  "generatedAt": "2026-04-20T02:01:47.871Z",
   "reportName": "memory-continuity-benchmark",
   "schemaVersion": "1.0.0",
   "passed": true,

package/.cursorrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v3.0.7
+Generated by Agentic-Senior-Core CLI v3.0.9
 Timestamp: 2026-04-18T00:00:00.000Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/.windsurfrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v3.0.7
+Generated by Agentic-Senior-Core CLI v3.0.9
 Timestamp: 2026-04-18T00:00:00.000Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/README.md

@@ -10,12 +10,12 @@
 **Production-grade Rules Engine (Governance Engine) for AI coding agents.**
 Works with Cursor, Windsurf, GitHub Copilot, Claude Code, Gemini, and other LLM-powered IDE workflows.
 
-Latest release: 3.0.7 (2026-04-20).
+Latest release: 3.0.9 (2026-04-20).
 
-Highlights in 3.0.7:
-- Dynamic UI design contract bootstrap now ships paired markdown and machine-readable intent.
-- Upgrade warns when existing UI repositories are missing required design contract files.
-- Init discovery stays slimmer by reusing architecture context and removing redundant wizard branches.
+Highlights in 3.0.9:
+- Design bootstrap prompts now rely on shipped project evidence instead of assuming extra docs exist in every initialized repository.
+- Dynamic UI design guidance now emphasizes structure, rationale, and anti-generic constraints without anchoring to example brand systems.
+- Init prompts now point agents at the active onboarding and compiled-rule context that actually exists in target projects.
 
 </div>
 

package/lib/cli/commands/init.mjs

@@ -4,6 +4,7 @@
  */
 import { createInterface } from 'node:readline/promises';
 import { stdin, stdout } from 'node:process';
+import fs from 'node:fs/promises';
 import path from 'node:path';
 
 import {
@@ -29,10 +30,16 @@ import {
   formatBlockingSeverities,
   formatDuration,
   copyGovernanceAssetsToTarget,
+  pathExists,
 } from '../utils.mjs';
 
 import { collectProfilePacks, findProfilePackByInput } from '../profile-packs.mjs';
-import { detectProjectContext, buildDetectionSummary, formatDetectionCandidates } from '../detector.mjs';
+import {
+  detectProjectContext,
+  buildDetectionSummary,
+  formatDetectionCandidates,
+  detectUiScopeSignals,
+} from '../detector.mjs';
 import { compileDynamicContext, writeSelectedPolicy, writeOnboardingReport } from '../compiler.mjs';
 import {
   filterBlueprintFileNamesByCandidates,
@@ -55,6 +62,7 @@ import {
   hasExistingProjectDocs,
   loadProjectConfig,
   normalizeDocsLanguage,
+  buildDesignIntentSeedFromSignals,
 } from '../project-scaffolder.mjs';
 import { performRollback } from '../rollback.mjs';
 import {
@@ -162,6 +170,41 @@ async function askBlueprintSelection(promptMessage, selectableBlueprintFileNames
   return selectableBlueprintFileNames[selectedIndex] || selectableBlueprintFileNames[0] || null;
 }
 
+function buildInitExistingProjectDesignIntentSeed({
+  targetDirectoryPath,
+  packageManifest,
+  selectedStackFileName,
+  selectedBlueprintFileName,
+  uiScopeSignals,
+  architectureProjectDescription,
+}) {
+  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 || architectureProjectDescription || '').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',
+      },
+    },
+  });
+}
+
 export async function runInitCommand(targetDirectoryArgument, initOptions = {}) {
   const resolvedTargetDirectoryPath = path.resolve(targetDirectoryArgument || '.');
   const isTokenOptimizationEnabled = typeof initOptions.tokenOptimize === 'boolean'
@@ -580,6 +623,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
 
     // --- Project Documentation Scaffolding ---
     let scaffoldingResult = null;
+    const supplementalMaterializedDocFileNames = [];
     const isFreshProjectTarget = wasDirectoryEffectivelyEmpty && !hadExistingProjectDocsBeforeInit;
     const shouldOfferScaffolding = initOptions.scaffoldDocs === true
       || Boolean(initOptions.projectConfig)
@@ -661,6 +705,36 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       }
     }
 
+    const existingProjectUiScopeSignals = projectDetection.hasExistingProjectFiles
+      ? await detectUiScopeSignals({
+        targetDirectoryPath: resolvedTargetDirectoryPath,
+        selectedStackFileName: selectedResolvedStackFileName,
+        selectedBlueprintFileName: selectedResolvedBlueprintFileName,
+      })
+      : null;
+    const designIntentTargetPath = path.join(resolvedTargetDirectoryPath, 'docs', 'design-intent.json');
+    const shouldSeedExistingUiDesignIntent = projectDetection.hasExistingProjectFiles
+      && existingProjectUiScopeSignals?.isUiScopeLikely === true
+      && !(await pathExists(designIntentTargetPath));
+
+    if (shouldSeedExistingUiDesignIntent) {
+      const docsDirectoryPath = path.join(resolvedTargetDirectoryPath, 'docs');
+      const designIntentSeedContent = buildInitExistingProjectDesignIntentSeed({
+        targetDirectoryPath: resolvedTargetDirectoryPath,
+        packageManifest: existingProjectUiScopeSignals.packageManifest,
+        selectedStackFileName: selectedResolvedStackFileName,
+        selectedBlueprintFileName: selectedResolvedBlueprintFileName,
+        uiScopeSignals: existingProjectUiScopeSignals,
+        architectureProjectDescription,
+      });
+
+      await ensureDirectory(docsDirectoryPath);
+      await fs.writeFile(designIntentTargetPath, designIntentSeedContent, 'utf8');
+      supplementalMaterializedDocFileNames.push('design-intent.json');
+
+      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,
       selectedProfileName,
@@ -765,6 +839,9 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       console.log(`- Project docs: ${scaffoldingResult.generatedFileNames.length} files generated in docs/`);
       console.log(`- Project docs language: ${scaffoldingResult.docsLanguage}`);
     }
+    if (supplementalMaterializedDocFileNames.length > 0) {
+      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)'}`);
     if (isMemoryContinuityEnabled) {
@@ -804,6 +881,11 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       console.log(`- Build an MVP for ${promptProjectName}. Follow Layer 9 docs and keep the current stack, database, and auth constraints.`);
       console.log('- Add [new feature] and update docs/project-brief.md plus docs/flow-overview.md in the same change.');
       console.log('- If this change needs architecture migration, propose a migration plan first, then implement after approval.');
+    } else if (supplementalMaterializedDocFileNames.includes('design-intent.json')) {
+      console.log('I also seeded docs/design-intent.json for this existing UI repository so future UI work starts from a machine-readable design contract without forcing a canned visual concept.');
+      console.log('\nPrompt starter examples (copy and adapt in your IDE):');
+      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('MCP server registration is manual inside your IDE settings, even when mcp.json exists.');

package/lib/cli/commands/upgrade.mjs

@@ -29,7 +29,7 @@ import {
   detectProjectContext,
   buildDetectionSummary,
   formatDetectionCandidates,
-  collectProjectMarkers,
+  detectUiScopeSignals,
 } from '../detector.mjs';
 import {
   buildCompiledRulesContent,
@@ -41,7 +41,10 @@ import {
 import { runPreflightChecks } from '../preflight.mjs';
 import { createBackup } from '../backup.mjs';
 import { performRollback } from '../rollback.mjs';
-import { detectProjectDocTemplateStaleness } from '../project-scaffolder.mjs';
+import {
+  detectProjectDocTemplateStaleness,
+  buildDesignIntentSeedFromSignals,
+} from '../project-scaffolder.mjs';
 
 export function parseUpgradeArguments(commandArguments) {
   const parsedUpgradeOptions = {
@@ -104,100 +107,38 @@ function buildExistingProjectMajorConstraints() {
   ];
 }
 
-async function readPackageJsonIfExists(targetDirectoryPath) {
-  const packageJsonPath = path.join(targetDirectoryPath, 'package.json');
-  if (!(await pathExists(packageJsonPath))) {
-    return null;
-  }
-
-  try {
-    return JSON.parse(await fs.readFile(packageJsonPath, 'utf8'));
-  } catch {
-    return null;
-  }
-}
-
-async function detectUiScopeSignals({
+function buildUpgradeDesignIntentSeed({
   targetDirectoryPath,
-  existingOnboardingReport,
+  packageManifest,
   selectedStackFileName,
   selectedBlueprintFileName,
+  uiScopeSignals,
 }) {
-  const signalReasons = [];
-  const markerNames = await collectProjectMarkers(targetDirectoryPath);
-  const packageManifest = await readPackageJsonIfExists(targetDirectoryPath);
-
-  const persistedProjectScopeKey = String(existingOnboardingReport?.projectScope?.key || '').trim().toLowerCase();
-  if (persistedProjectScopeKey === 'frontend-only' || persistedProjectScopeKey === 'both') {
-    signalReasons.push(`onboarding project scope: ${persistedProjectScopeKey}`);
-  }
-
-  const selectedStackKey = String(selectedStackFileName || '').trim().toLowerCase();
-  if (selectedStackKey === 'react-native.md' || selectedStackKey === 'flutter.md') {
-    signalReasons.push(`selected stack implies UI runtime: ${selectedStackKey}`);
-  }
-
-  const selectedBlueprintKey = String(selectedBlueprintFileName || '').trim().toLowerCase();
-  if (selectedBlueprintKey.includes('frontend') || selectedBlueprintKey.includes('landing') || selectedBlueprintKey.includes('mobile-app')) {
-    signalReasons.push(`selected blueprint implies UI scope: ${selectedBlueprintKey}`);
-  }
-
-  const directUiMarkerNames = [
-    'next.config.js',
-    'next.config.mjs',
-    'next.config.ts',
-    'tailwind.config.js',
-    'tailwind.config.mjs',
-    'tailwind.config.ts',
-    'vite.config.js',
-    'vite.config.mjs',
-    'vite.config.ts',
-    'react-native.config.js',
-    'app',
-    'pages',
-    'components',
-    'public',
-    'styles',
-    'android',
-    'ios',
-    'index.html',
-  ];
-
-  const detectedUiMarkers = directUiMarkerNames.filter((markerName) => markerNames.has(markerName));
-  if (detectedUiMarkers.length > 0) {
-    signalReasons.push(`ui markers: ${detectedUiMarkers.join(', ')}`);
-  }
-
-  const dependencyMap = {
-    next: 'next',
-    react: 'react',
-    reactDom: 'react-dom',
-    reactNative: 'react-native',
-    expo: 'expo',
-    tailwindcss: 'tailwindcss',
-  };
-  const dependencySource = {
-    ...(packageManifest?.dependencies || {}),
-    ...(packageManifest?.devDependencies || {}),
-  };
-  const detectedUiDependencies = Object.values(dependencyMap).filter((dependencyName) => dependencySource[dependencyName]);
-  if (detectedUiDependencies.length > 0) {
-    signalReasons.push(`ui dependencies: ${detectedUiDependencies.join(', ')}`);
-  }
-
-  const hasStrongUiMarker = detectedUiMarkers.some((markerName) => (
-    markerName.startsWith('next.config')
-    || markerName === 'react-native.config.js'
-    || markerName === 'android'
-    || markerName === 'ios'
-  ));
-  const hasUiDependencies = detectedUiDependencies.length > 0;
-  const hasStructuralUiMarkers = detectedUiMarkers.length >= 2;
-
-  return {
-    isUiScopeLikely: signalReasons.length > 0 && (hasStrongUiMarker || hasUiDependencies || hasStructuralUiMarkers || persistedProjectScopeKey.length > 0),
-    signalReasons,
-  };
+  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 || '').trim()
+    || `Existing ${resolvedDomain.toLowerCase()} detected during upgrade. 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-upgrade',
+    supplementalFields: {
+      upgradeSignals: {
+        detectedFrom: uiScopeSignals.signalReasons,
+        generatedBy: 'upgrade-seed',
+      },
+    },
+  });
 }
 
 export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions = {}) {
@@ -232,7 +173,6 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
     const blueprintFileNames = await collectFileNames(path.join(AGENT_CONTEXT_DIR, 'blueprints'));
     const existingOnboardingReport = await loadOnboardingReportIfExists(resolvedTargetDirectoryPath);
     const projectDetection = await detectProjectContext(resolvedTargetDirectoryPath);
-
     const selectedProfileName = PROFILE_PRESETS[existingOnboardingReport?.selectedProfile]
       ? existingOnboardingReport.selectedProfile
       : 'balanced';
@@ -266,10 +206,12 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       : true;
     const uiScopeSignals = await detectUiScopeSignals({
       targetDirectoryPath: resolvedTargetDirectoryPath,
-      existingOnboardingReport,
       selectedStackFileName,
       selectedBlueprintFileName,
+      projectScopeKey: existingOnboardingReport?.projectScope?.key || null,
+      projectScopeSourceLabel: 'onboarding project scope',
     });
+    const packageManifest = uiScopeSignals.packageManifest;
     const designContractPaths = ['docs/DESIGN.md', 'docs/design-intent.json'];
     const missingDesignContractPaths = [];
 
@@ -279,6 +221,17 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
         missingDesignContractPaths.push(designContractPath);
       }
     }
+    const shouldSeedDesignIntentOnApply = uiScopeSignals.isUiScopeLikely
+      && missingDesignContractPaths.includes('docs/design-intent.json');
+    const designIntentSeedContent = shouldSeedDesignIntentOnApply
+      ? buildUpgradeDesignIntentSeed({
+        targetDirectoryPath: resolvedTargetDirectoryPath,
+        packageManifest,
+        selectedStackFileName,
+        selectedBlueprintFileName,
+        uiScopeSignals,
+      })
+      : null;
 
     const detectionMajorConstraints = buildExistingProjectMajorConstraints();
     const detectionTransparency = {
@@ -408,8 +361,11 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       if (uiScopeSignals.signalReasons.length > 0) {
         console.log(`- Detection signals: ${uiScopeSignals.signalReasons.join('; ')}`);
       }
+      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('Upgrade synchronizes governance assets, but it does not author project-specific design docs automatically.');
+      console.log('Upgrade synchronizes governance assets and can seed docs/design-intent.json, but it does not author project-specific docs/DESIGN.md automatically.');
     }
 
     if (upgradeOptions.dryRun) {
@@ -434,6 +390,15 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
         pruneManagedSurface: upgradeOptions.pruneManagedSurface === true,
         managedSurfacePlan,
       });
+      const supplementalCreatedFileNames = [];
+
+      if (shouldSeedDesignIntentOnApply && designIntentSeedContent) {
+        const docsDirectoryPath = path.join(resolvedTargetDirectoryPath, 'docs');
+        const designIntentTargetPath = path.join(docsDirectoryPath, 'design-intent.json');
+        await ensureDirectory(docsDirectoryPath);
+        await fs.writeFile(designIntentTargetPath, designIntentSeedContent, 'utf8');
+        supplementalCreatedFileNames.push('docs/design-intent.json');
+      }
 
       await fs.writeFile(currentRulesPath, plannedRulesContent, 'utf8');
       await fs.writeFile(path.join(resolvedTargetDirectoryPath, '.windsurfrules'), plannedRulesContent, 'utf8');
@@ -471,6 +436,12 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
         governanceSyncResult.updatedFiles.forEach((fileName) => console.log(`  [UPDATED] ${fileName}`));
         governanceSyncResult.deletedManagedFiles.forEach((fileName) => console.log(`  [DELETED] ${fileName}`));
       }
+      if (supplementalCreatedFileNames.length > 0) {
+        if (!(governanceSyncResult.updatedFiles.length > 0 || governanceSyncResult.createdFiles.length > 0 || governanceSyncResult.deletedManagedFiles.length > 0)) {
+          console.log('\nDetailed changes:');
+        }
+        supplementalCreatedFileNames.forEach((fileName) => console.log(`  [NEW]     ${fileName} (seed)`));
+      }
 
       console.log('\nRefreshed files: .cursorrules, .windsurfrules, .agent-context/state/onboarding-report.json');
     } catch (error) {

package/lib/cli/detector.mjs

@@ -3,6 +3,7 @@
  * Depends on: constants.mjs, utils.mjs
  */
 import fs from 'node:fs/promises';
+import path from 'node:path';
 
 import { BLUEPRINT_RECOMMENDATIONS } from './constants.mjs';
 import { toTitleCase } from './utils.mjs';
@@ -22,6 +23,106 @@ export async function collectProjectMarkers(targetDirectoryPath) {
   return markerNames;
 }
 
+async function readPackageJsonIfExists(targetDirectoryPath) {
+  const packageJsonPath = path.join(targetDirectoryPath, 'package.json');
+
+  try {
+    const packageJsonContent = await fs.readFile(packageJsonPath, 'utf8');
+    return JSON.parse(packageJsonContent);
+  } catch {
+    return null;
+  }
+}
+
+export async function detectUiScopeSignals({
+  targetDirectoryPath,
+  selectedStackFileName,
+  selectedBlueprintFileName,
+  packageManifest = null,
+  projectScopeKey = null,
+  projectScopeSourceLabel = 'project scope',
+}) {
+  const signalReasons = [];
+  const markerNames = await collectProjectMarkers(targetDirectoryPath);
+  const resolvedPackageManifest = packageManifest || await readPackageJsonIfExists(targetDirectoryPath);
+
+  const normalizedProjectScopeKey = String(projectScopeKey || '').trim().toLowerCase();
+  if (normalizedProjectScopeKey === 'frontend-only' || normalizedProjectScopeKey === 'both') {
+    signalReasons.push(`${projectScopeSourceLabel}: ${normalizedProjectScopeKey}`);
+  }
+
+  const selectedStackKey = String(selectedStackFileName || '').trim().toLowerCase();
+  if (selectedStackKey === 'react-native.md' || selectedStackKey === 'flutter.md') {
+    signalReasons.push(`selected stack implies UI runtime: ${selectedStackKey}`);
+  }
+
+  const selectedBlueprintKey = String(selectedBlueprintFileName || '').trim().toLowerCase();
+  if (selectedBlueprintKey.includes('frontend') || selectedBlueprintKey.includes('landing') || selectedBlueprintKey.includes('mobile-app')) {
+    signalReasons.push(`selected blueprint implies UI scope: ${selectedBlueprintKey}`);
+  }
+
+  const directUiMarkerNames = [
+    'next.config.js',
+    'next.config.mjs',
+    'next.config.ts',
+    'tailwind.config.js',
+    'tailwind.config.mjs',
+    'tailwind.config.ts',
+    'vite.config.js',
+    'vite.config.mjs',
+    'vite.config.ts',
+    'react-native.config.js',
+    'app',
+    'pages',
+    'components',
+    'public',
+    'styles',
+    'android',
+    'ios',
+    'index.html',
+  ];
+
+  const detectedUiMarkers = directUiMarkerNames.filter((markerName) => markerNames.has(markerName));
+  if (detectedUiMarkers.length > 0) {
+    signalReasons.push(`ui markers: ${detectedUiMarkers.join(', ')}`);
+  }
+
+  const dependencySource = {
+    ...(resolvedPackageManifest?.dependencies || {}),
+    ...(resolvedPackageManifest?.devDependencies || {}),
+  };
+  const detectableUiDependencies = [
+    'next',
+    'react',
+    'react-dom',
+    'react-native',
+    'expo',
+    'tailwindcss',
+  ];
+  const detectedUiDependencies = detectableUiDependencies.filter((dependencyName) => dependencySource[dependencyName]);
+  if (detectedUiDependencies.length > 0) {
+    signalReasons.push(`ui dependencies: ${detectedUiDependencies.join(', ')}`);
+  }
+
+  const hasStrongUiMarker = detectedUiMarkers.some((markerName) => (
+    markerName.startsWith('next.config')
+    || markerName === 'react-native.config.js'
+    || markerName === 'android'
+    || markerName === 'ios'
+  ));
+  const hasUiDependencies = detectedUiDependencies.length > 0;
+  const hasStructuralUiMarkers = detectedUiMarkers.length >= 2;
+
+  return {
+    isUiScopeLikely: signalReasons.length > 0
+      && (hasStrongUiMarker || hasUiDependencies || hasStructuralUiMarkers || normalizedProjectScopeKey.length > 0),
+    signalReasons,
+    detectedUiMarkers,
+    detectedUiDependencies,
+    packageManifest: resolvedPackageManifest,
+  };
+}
+
 export async function detectProjectContext(targetDirectoryPath) {
   const markerNames = await collectProjectMarkers(targetDirectoryPath);
   const detectionCandidates = [];

package/lib/cli/project-scaffolder.mjs

@@ -373,21 +373,30 @@ function inferDesignKeywords(discoveryAnswers) {
   };
 }
 
-function buildDesignIntentSeed({
-  discoveryAnswers,
+export function buildDesignIntentSeedFromSignals({
+  projectName,
+  projectDescription,
+  primaryDomain,
+  features = [],
   initContext,
-  architectureRecommendation,
+  architectureRecommendation = null,
+  status = 'seed-needs-design-synthesis',
+  supplementalFields = {},
 }) {
-  const inferredKeywords = inferDesignKeywords(discoveryAnswers);
+  const inferredKeywords = inferDesignKeywords({
+    projectDescription,
+    primaryDomain,
+    features,
+  });
   const designSignals = architectureRecommendation?.designGuidance?.normalizedSignals || null;
 
   return `${JSON.stringify({
     mode: 'dynamic',
-    status: 'seed-needs-design-synthesis',
+    status,
     project: {
-      name: discoveryAnswers.projectName,
-      context: discoveryAnswers.projectDescription,
-      domain: discoveryAnswers.primaryDomain,
+      name: projectName,
+      context: projectDescription,
+      domain: primaryDomain,
       stack: toTitleCase(initContext.stackFileName),
       blueprint: toTitleCase(initContext.blueprintFileName),
     },
@@ -431,9 +440,26 @@ function buildDesignIntentSeed({
       bootstrapPrompt: '.agent-context/prompts/bootstrap-design.md',
     },
     architectSignals: designSignals,
+    ...supplementalFields,
   }, null, 2)}\n`;
 }
 
+function buildDesignIntentSeed({
+  discoveryAnswers,
+  initContext,
+  architectureRecommendation,
+}) {
+  return buildDesignIntentSeedFromSignals({
+    projectName: discoveryAnswers.projectName,
+    projectDescription: discoveryAnswers.projectDescription,
+    primaryDomain: discoveryAnswers.primaryDomain,
+    features: discoveryAnswers.features,
+    initContext,
+    architectureRecommendation,
+    status: 'seed-needs-design-synthesis',
+  });
+}
+
 function buildProjectContextBootstrapPrompt({
   discoveryAnswers,
   initContext,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "3.0.7",
+  "version": "3.0.9",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {

package/scripts/validate.mjs

@@ -261,8 +261,10 @@ const REQUIRED_UPGRADE_UI_CONTRACT_WARNING_SNIPPETS = [
     snippets: [
       'UI/frontend scope was detected, but the dynamic design contract is incomplete:',
       'docs/design-intent.json',
-      'Upgrade synchronizes governance assets, but it does not author project-specific design docs automatically.',
-      'collectProjectMarkers',
+      'Planned seed on apply: docs/design-intent.json',
+      'Upgrade synchronizes governance assets and can seed docs/design-intent.json, but it does not author project-specific docs/DESIGN.md automatically.',
+      'detectUiScopeSignals',
+      'seed-generated-during-upgrade',
     ],
   },
 ];