@ryuenn3123/agentic-senior-core 3.0.5 → 3.0.7

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

@@ -1,22 +1,48 @@
 
-# Bootstrap DESIGN.md (UI/UX Art Direction)
+# Bootstrap Dynamic Design Contract
 
-When a user requests frontend design or redesign, the agent should automatically synthesize a complete DESIGN.md covering:
-- Visual identity (color palette, typography, spacing, iconography)
-- Layout and navigation principles
-- Component library and atomic design system
-- Accessibility and responsive guidelines
-- User journey and interaction flows
-- Design tokens and handoff notes for developers
+When a user requests frontend design or redesign, the agent should automatically synthesize a dynamic design contract made of:
+- `docs/DESIGN.md` for human-readable design direction and implementation rationale
+- `docs/design-intent.json` for machine-readable intent, anti-generic constraints, and validation hints
+
+This contract is a structure and reasoning system, not a fixed visual template. It must adapt to product context, user needs, platform constraints, and current design signals.
 
 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.
-4. If [docs/DESIGN.md](../../docs/DESIGN.md) exists, check for drift and propose improvements instead of rewriting from scratch.
-5. All references to docs or rules must be clickable markdown links.
+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.
+
+Required `docs/DESIGN.md` sections:
+1. Design Intent and Product Personality
+2. Audience and Use-Context Signals
+3. Visual Direction and Distinctive Moves
+4. Color System and Semantic Roles
+5. Typography System and Hierarchy
+6. Spacing, Layout Rhythm, and Density Strategy
+7. Interaction, Motion, and Feedback Rules
+8. Component Language and Shared Patterns
+9. Accessibility Non-Negotiables
+10. Responsive Strategy
+11. Anti-Patterns to Avoid
+12. Implementation Notes for Future UI Tasks
+
+Required `docs/design-intent.json` fields:
+- `mode`
+- `status`
+- `project`
+- `brandAdjectives`
+- `antiAdjectives`
+- `visualDirection`
+- `experiencePrinciples`
+- `forbiddenPatterns`
+- `requiredDesignSections`
+- `implementation`
 
 Output:
-- Write a full DESIGN.md in markdown, with clear sections and clickable links to referenced docs/rules.
-- Use practical, modern, and accessible design language.
+- 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.
 - Wait for user approval before generating Figma or code assets.

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

@@ -35,7 +35,7 @@ If the user specifies a framework/blueprint, the agent should:
 See [docs/roadmap.md](../../docs/roadmap.md) and [docs/deep-dive.md](../../docs/deep-dive.md) for the latest stack and blueprint list.
 
 ## 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 DESIGN.md.
+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`).
 
 ---
 
@@ -97,6 +97,6 @@ See [docs/roadmap.md](../../docs/roadmap.md) and [docs/deep-dive.md](../../docs/
 
 ---
 
-## Bootstrap UI/UX (DESIGN.md)
+## Bootstrap UI/UX (Dynamic Design Contract)
 
-To start UI/UX design from scratch, use the [bootstrap-design.md](./bootstrap-design.md) prompt to synthesize `docs/DESIGN.md`.
+To start UI/UX design from scratch, use the [bootstrap-design.md](./bootstrap-design.md) prompt to synthesize `docs/DESIGN.md` and `docs/design-intent.json`.

package/.agent-context/prompts/refactor.md

@@ -15,7 +15,7 @@ Before making changes:
 3. Read .agent-context/rules/error-handling.md — fix error handling patterns.
 4. Resolve active language guidance from dynamic stack signals (TypeScript in this repository).
 5. Enforce backend universal principles: no clever hacks, no premature abstraction, readability over brevity.
-6. Enforce Universal SOP hard gate: stop implementation if `docs/architecture-decision-record.md` is missing, and for UI scope stop if `docs/DESIGN.md` is missing.
+6. Enforce Universal SOP hard gate: stop implementation if `docs/architecture-decision-record.md` is missing, and for UI scope stop if `docs/DESIGN.md` or `docs/design-intent.json` is missing.
 
 For every change you make, provide a Reasoning Chain:
 - What was wrong (rule reference)

package/.agent-context/prompts/review-code.md

@@ -20,7 +20,7 @@ Use these checklists:
 7. Enforce cross-session consistency guardian: session handoff must include active architecture contract summary, drift detection must warn before direction changes, and direction changes require explicit user confirmation.
 8. Enforce explain-on-demand state visibility: default responses must avoid unnecessary state-file internals, state internals are exposed only on explicit request, and diagnostic mode must explain relevant state decisions when needed.
 9. Enforce single-source and lazy-loading policy: canonical rule source must be explicitly enforced, language-specific guidance must load lazily based on detected scope, and conflicting duplicate rule instructions must not appear during normal flow.
-10. Enforce Universal SOP hard gate: block coding flow when required project docs are missing (`docs/architecture-decision-record.md`, and for UI scope `docs/DESIGN.md`).
+10. Enforce Universal SOP hard gate: block coding flow when required project docs are missing (`docs/architecture-decision-record.md`, and for UI scope `docs/DESIGN.md` plus `docs/design-intent.json`).
 
 For EVERY violation found:
 - State the exact file and line

package/.agent-context/review-checklists/pr-checklist.md

@@ -135,4 +135,4 @@ VERDICT: PASS / FAIL (X/Y items passed)
 - [ ] Backend and frontend mindset checks are both applied when scope spans API and UI boundaries
 - [ ] Security and testing requirements remain mandatory after static template purge
 - [ ] Coding flow is blocked if `docs/architecture-decision-record.md` (or `docs/Architecture-Decision-Record.md`) is missing
-- [ ] UI implementation flow is blocked if `docs/DESIGN.md` is missing
+- [ ] UI implementation flow is blocked if `docs/DESIGN.md` or `docs/design-intent.json` is missing

package/.agent-context/rules/architecture.md

@@ -21,7 +21,7 @@ The `.agent-context/rules/` directory is the default guidance source for impleme
 - Security and testing are non-negotiable baseline requirements.
 - Hard block before coding:
   - `docs/architecture-decision-record.md` (alias: `docs/Architecture-Decision-Record.md`) must exist.
-  - For UI scope, `docs/DESIGN.md` must exist.
+  - For UI scope, `docs/DESIGN.md` and `docs/design-intent.json` must exist.
 - If required project context docs are missing, stop implementation and bootstrap docs before writing application code.
 
 ## Rules as Guardian (Cross-Session Consistency)

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

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-18T13:45:51.853Z",
+  "generatedAt": "2026-04-20T00:30:26.121Z",
   "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.5
+Generated by Agentic-Senior-Core CLI v3.0.7
 Timestamp: 2026-04-18T00:00:00.000Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json
@@ -46,4 +46,4 @@ Do not claim done before checklist pass.
 
 ## UNIVERSAL SOP HARD GATES
 - Stop coding if docs/architecture-decision-record.md (or docs/Architecture-Decision-Record.md) is missing.
-- For UI scope, stop coding if docs/DESIGN.md is missing.
+- For UI scope, stop coding if docs/DESIGN.md or docs/design-intent.json is missing.

package/.gemini/instructions.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 354edbbfaedec284ddcc6d4a5bb5393a7f5385650d1a6ae84a2d9633b5a6d10d
+Canonical Snapshot SHA256: 08c326d79f2c0f4bd7ef106da3542ab0f78f4d02bc205d63598db34cf3f40731
 
 Canonical policy source: [.instructions.md](../.instructions.md).
 

package/.github/copilot-instructions.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 354edbbfaedec284ddcc6d4a5bb5393a7f5385650d1a6ae84a2d9633b5a6d10d
+Canonical Snapshot SHA256: 08c326d79f2c0f4bd7ef106da3542ab0f78f4d02bc205d63598db34cf3f40731
 
 The canonical policy source for this repository is [.instructions.md](../.instructions.md).
 

package/.windsurfrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v3.0.5
+Generated by Agentic-Senior-Core CLI v3.0.7
 Timestamp: 2026-04-18T00:00:00.000Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json
@@ -46,4 +46,4 @@ Do not claim done before checklist pass.
 
 ## UNIVERSAL SOP HARD GATES
 - Stop coding if docs/architecture-decision-record.md (or docs/Architecture-Decision-Record.md) is missing.
-- For UI scope, stop coding if docs/DESIGN.md is missing.
+- For UI scope, stop coding if docs/DESIGN.md or docs/design-intent.json is missing.

package/AGENTS.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 354edbbfaedec284ddcc6d4a5bb5393a7f5385650d1a6ae84a2d9633b5a6d10d
+Canonical Snapshot SHA256: 08c326d79f2c0f4bd7ef106da3542ab0f78f4d02bc205d63598db34cf3f40731
 
 This file is an adapter entrypoint for agent discovery.
 The canonical policy source is [.instructions.md](.instructions.md).

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.5 (2026-04-18).
+Latest release: 3.0.7 (2026-04-20).
 
-Highlights in 3.0.0:
-- Universal IDE adapter surface is completed and synchronized through thin adapters.
-- Scoped auto-docs sync rollout is active with explicit phase-1 boundaries and precision/recall evidence.
-- Init and scaffolding flow is slimmer, template-free on active path, and validated by deterministic release gates.
+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.
 
 </div>
 

package/lib/cli/commands/init.mjs

@@ -399,6 +399,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     )?.label || 'Both (frontend + backend)';
 
     let architectureRecommendation = null;
+    let architectureProjectDescription = '';
     let architectPreferenceState = await readArchitectPreferenceState();
     let architectPreferenceUpdated = false;
 
@@ -457,6 +458,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     selectedProjectScopeLabel = architectureSelection.selectedProjectScopeLabel;
     selectedManualStackFileName = architectureSelection.selectedManualStackFileName;
     selectedManualBlueprintFileName = architectureSelection.selectedManualBlueprintFileName;
+    architectureProjectDescription = architectureSelection.architectureProjectDescription;
     architectureRecommendation = architectureSelection.architectureRecommendation;
     architectPreferenceState = architectureSelection.architectPreferenceState;
     architectPreferenceUpdated = architectureSelection.architectPreferenceUpdated;
@@ -607,6 +609,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
         } else {
           discoveryAnswers = await runProjectDiscovery(userInterface, {
             defaultProjectName: path.basename(resolvedTargetDirectoryPath),
+            defaultProjectDescription: architectureProjectDescription,
           });
         }
 
@@ -645,6 +648,9 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
           for (const generatedPromptFileName of scaffoldingResult.generatedPromptFileNames || []) {
             console.log(`  - .agent-context/prompts/${generatedPromptFileName}`);
           }
+          for (const materializedFileName of scaffoldingResult.materializedFileNames || []) {
+            console.log(`  - docs/${materializedFileName}`);
+          }
           console.log('Project docs will be authored dynamically by your IDE assistant from these prompts.');
         } else {
           console.log(`\nProject documentation generated in docs/:`);
@@ -674,6 +680,10 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       selectedProfileName,
       selectedProfilePack,
       selectedPreset: initOptions.preset || null,
+      projectScope: {
+        key: selectedProjectScopeKey,
+        label: selectedProjectScopeLabel,
+      },
       selectedStackFileName: selectedResolvedStackFileName,
       selectedAdditionalStackFileNames,
       selectedBlueprintFileName: selectedResolvedBlueprintFileName,
@@ -746,6 +756,9 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     console.log('- Generated files: .agent-instructions.md, .cursorrules, .windsurfrules, .clauderc, and .agent-context/state/onboarding-report.json');
     if (scaffoldingResult?.bootstrapMode === 'ai-synthesis') {
       console.log(`- Bootstrap prompts: ${(scaffoldingResult.generatedPromptFileNames || []).length} files generated in .agent-context/prompts/`);
+      if ((scaffoldingResult.materializedFileNames || []).length > 0) {
+        console.log(`- Seed docs: ${(scaffoldingResult.materializedFileNames || []).length} files generated in docs/`);
+      }
       console.log(`- Bootstrap docs language: ${scaffoldingResult.docsLanguage}`);
       console.log(`- Expected project docs after synthesis: ${scaffoldingResult.generatedFileNames.length} files in docs/`);
     } else if (scaffoldingResult) {
@@ -779,7 +792,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       console.log('\nPrompt starter examples (copy and adapt in your IDE):');
       console.log('- If docs/project-brief.md is missing, execute .agent-context/prompts/bootstrap-project-context.md now and create all required docs files.');
       if ((scaffoldingResult.generatedPromptFileNames || []).includes('bootstrap-design.md')) {
-        console.log('- If docs/DESIGN.md is missing, execute .agent-context/prompts/bootstrap-design.md now before building UI components.');
+        console.log('- If docs/DESIGN.md or docs/design-intent.json is missing, execute .agent-context/prompts/bootstrap-design.md now before building UI components.');
       }
       console.log(`- Build an MVP for ${promptProjectName} using the newly synthesized docs as strict project context.`);
       console.log('- When scope changes, update docs/* in the same change so future prompts stay aligned.');

package/lib/cli/commands/upgrade.mjs

@@ -29,6 +29,7 @@ import {
   detectProjectContext,
   buildDetectionSummary,
   formatDetectionCandidates,
+  collectProjectMarkers,
 } from '../detector.mjs';
 import {
   buildCompiledRulesContent,
@@ -103,6 +104,102 @@ 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({
+  targetDirectoryPath,
+  existingOnboardingReport,
+  selectedStackFileName,
+  selectedBlueprintFileName,
+}) {
+  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,
+  };
+}
+
 export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions = {}) {
   const resolvedTargetDirectoryPath = path.resolve(targetDirectoryArgument || '.');
 
@@ -167,6 +264,21 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
     const includeCiGuardrails = typeof existingOnboardingReport?.ciGuardrailsEnabled === 'boolean'
       ? existingOnboardingReport.ciGuardrailsEnabled
       : true;
+    const uiScopeSignals = await detectUiScopeSignals({
+      targetDirectoryPath: resolvedTargetDirectoryPath,
+      existingOnboardingReport,
+      selectedStackFileName,
+      selectedBlueprintFileName,
+    });
+    const designContractPaths = ['docs/DESIGN.md', 'docs/design-intent.json'];
+    const missingDesignContractPaths = [];
+
+    for (const designContractPath of designContractPaths) {
+      const absoluteDesignContractPath = path.join(resolvedTargetDirectoryPath, ...designContractPath.split('/'));
+      if (!(await pathExists(absoluteDesignContractPath))) {
+        missingDesignContractPaths.push(designContractPath);
+      }
+    }
 
     const detectionMajorConstraints = buildExistingProjectMajorConstraints();
     const detectionTransparency = {
@@ -256,6 +368,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
     console.log(`- Rules changed: ${isRulesContentChanged ? 'yes' : 'no'}`);
     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)'}`);
     if (projectDocStalenessReport.hasProjectDocs) {
@@ -287,6 +400,18 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       console.log('Recommendation: regenerate docs with init --scaffold-docs or update the files manually to match the latest template version.');
     }
 
+    if (uiScopeSignals.isUiScopeLikely && missingDesignContractPaths.length > 0) {
+      console.log('\n[WARN] UI/frontend scope was detected, but the dynamic design contract is incomplete:');
+      for (const missingDesignContractPath of missingDesignContractPaths) {
+        console.log(`- Missing ${missingDesignContractPath}`);
+      }
+      if (uiScopeSignals.signalReasons.length > 0) {
+        console.log(`- Detection signals: ${uiScopeSignals.signalReasons.join('; ')}`);
+      }
+      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.');
+    }
+
     if (upgradeOptions.dryRun) {
       console.log('\nDry run enabled. No files were modified.');
       return;
@@ -319,6 +444,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
         targetDirectoryPath: resolvedTargetDirectoryPath,
         selectedProfileName,
         selectedProfilePack: existingOnboardingReport?.selectedProfilePack || null,
+        projectScope: existingOnboardingReport?.projectScope || null,
         selectedStackFileName,
         selectedAdditionalStackFileNames,
         selectedBlueprintFileName,
@@ -332,11 +458,21 @@ 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)'}`);
-      console.log(`- Managed stale files removed: ${governanceSyncResult.deletedManagedFiles.length}`);
-      console.log(`- Managed stale directories removed: ${governanceSyncResult.deletedManagedDirectories.length}`);
+      if (governanceSyncResult.deletedManagedDirectories.length > 0) {
+        console.log(`- Managed stale directories removed: ${governanceSyncResult.deletedManagedDirectories.length}`);
+      }
       console.log(`- Setup time: ${formatDuration(setupDurationMs)}`);
-      console.log('- Updated files: .cursorrules, .windsurfrules, .agent-context/state/onboarding-report.json');
+
+      if (governanceSyncResult.updatedFiles.length > 0 || governanceSyncResult.createdFiles.length > 0 || governanceSyncResult.deletedManagedFiles.length > 0) {
+        console.log('\nDetailed changes:');
+        governanceSyncResult.createdFiles.forEach((fileName) => console.log(`  [NEW]     ${fileName}`));
+        governanceSyncResult.updatedFiles.forEach((fileName) => console.log(`  [UPDATED] ${fileName}`));
+        governanceSyncResult.deletedManagedFiles.forEach((fileName) => console.log(`  [DELETED] ${fileName}`));
+      }
+
+      console.log('\nRefreshed files: .cursorrules, .windsurfrules, .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

@@ -37,6 +37,7 @@ export async function writeOnboardingReport({
   selectedProfileName,
   selectedProfilePack,
   selectedPreset,
+  projectScope = null,
   selectedStackFileName,
   selectedAdditionalStackFileNames = [],
   selectedBlueprintFileName,
@@ -70,6 +71,7 @@ export async function writeOnboardingReport({
       }
       : null,
     selectedPreset,
+    projectScope,
     selectedStack: selectedStackFileName,
     selectedAdditionalStacks: selectedAdditionalStackFileNames,
     selectedBlueprint: selectedBlueprintFileName,
@@ -351,6 +353,8 @@ export async function buildCompiledRulesContent({
       'database-schema.md',
       'api-contract.md',
       'flow-overview.md',
+      'DESIGN.md',
+      'design-intent.json',
     ];
 
     for (const candidateFileName of candidateDocFileNames) {
@@ -369,7 +373,7 @@ export async function buildCompiledRulesContent({
         '',
         'Universal SOP hard block policy:',
         '- Stop implementation if docs/architecture-decision-record.md (alias: docs/Architecture-Decision-Record.md) is missing.',
-        '- For UI scope, stop implementation if docs/DESIGN.md is missing.',
+        '- For UI scope, stop implementation if docs/DESIGN.md or docs/design-intent.json is missing.',
         '- Materialize missing docs first, then continue coding.',
         '',
         'These docs were generated during project initialization and reflect the architecture,',
@@ -402,7 +406,7 @@ export async function buildCompiledRulesContent({
         '- Hard block: do not write application code until docs/project-brief.md and docs/architecture-decision-record.md exist.',
         '- If docs/project-brief.md is missing, execute bootstrap-project-context prompt immediately.',
         hasBootstrapDesignPrompt
-          ? '- For UI scope: if docs/DESIGN.md is missing, execute bootstrap-design prompt before implementing UI surfaces.'
+          ? '- For UI scope: if docs/DESIGN.md or docs/design-intent.json is missing, execute bootstrap-design prompt before implementing UI surfaces.'
           : '- For UI scope: add a design bootstrap prompt before implementing UI surfaces.',
         '- Save generated docs under docs/ and keep them updated when feature scope changes.',
         'Latest user prompt defines current feature scope and product direction.',

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

@@ -62,6 +62,7 @@ export async function resolveArchitectureSelection({
       selectedProjectScopeLabel,
       selectedManualStackFileName,
       selectedManualBlueprintFileName,
+      architectureProjectDescription: '',
       architectureRecommendation,
       architectPreferenceState: nextArchitectPreferenceState,
       architectPreferenceUpdated,
@@ -224,6 +225,7 @@ export async function resolveArchitectureSelection({
     selectedProjectScopeLabel,
     selectedManualStackFileName,
     selectedManualBlueprintFileName,
+    architectureProjectDescription,
     architectureRecommendation,
     architectPreferenceState: nextArchitectPreferenceState,
     architectPreferenceUpdated,