@ryuenn3123/agentic-senior-core 3.0.22 → 3.0.25

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

@@ -27,6 +27,22 @@ The agent must summarize what it used from that research, discard what does not
 
 User-supplied research may influence the candidate set for motion, scroll, UI primitives, canvas/3D, charts, icons, typography, and interaction patterns, but the final choice must still be project-fit, accessible, performant, and maintainable.
 
+## Dynamic Avant-Garde Anchor Engine
+
+If the user requests UI work but provides no user-supplied research, design reference, screenshot study, or library note, do not start coding immediately. This is not permission to fall back to the scaffold, prior UI, or generic software metaphors. First synthesize one advanced conceptual anchor that will unify the interface.
+
+User-supplied research means current-task evidence from the user. The scaffold seed, this repo's offline examples, old design docs, and prior UI do not count as research. If live research is available, perform agent-led research into current official docs for any technology choices and current premium interaction/design patterns before selecting the anchor. If live research is unavailable, state that limitation in the design docs and synthesize from product context plus broad design knowledge without pretending the seed was research.
+
+Do not use basic software UI labels as the final anchor, including "dashboard", "portal", "cards", "admin panel", "SaaS shell", "web app shell", or "minimalist interface".
+
+The agent must internally consider at least three substantially different, high-variance candidate anchors, discard the two most obvious, safest, or easiest-to-predict options, and record only the surviving anchor and concise rationale. Do not expose hidden deliberation or the rejected candidate list.
+
+The final anchor must come from broad non-template domains such as complex physical engineering, high-end industrial design, cinematic spatial interfaces, experimental editorial structure, advanced architecture, scientific instrumentation, advanced data visualization, exhibition/wayfinding systems, or premium interactive web experiences. These are search domains, not style presets.
+
+Write the chosen anchor into `docs/design-intent.json` as `conceptualAnchor`, including agentResearchMode, sourceDomain, rationale, derivedTokenLogic, visualRiskBudget, motionRiskBudget, and cohesionChecks. Typography, spacing, density, color behavior, morphology, motion, and responsive composition must logically derive from that single anchor. If a later design choice does not follow from the anchor, revise the contract before coding.
+
+Motion is not a garnish. The agent may use rich animation, fluid transitions, spatial reveals, scroll choreography, micro-interactions, and modern motion libraries when they support the anchor, remain performant, and include reduced-motion fallbacks. Do not suppress motion merely to look safe.
+
 ## Zero-Based Redesign Protocol
 
 If the user says "redesign from zero", "redesain dari 0", "ulang dari 0", "research ulang", or equivalent reset language, activate reset mode.
@@ -89,6 +105,7 @@ For every UI task, define how major surfaces change across mobile, tablet, and d
 The JSON must stay machine-readable and project-specific. It should record:
 - the confirmed project context and assumptions to validate
 - agent-chosen visual direction, not scaffold-chosen direction
+- `conceptualAnchor` and how typography, spacing, morphology, motion, and responsive composition derive from it when no external research was provided
 - agent-chosen semantic color roles, typography system, spacing rhythm, and motion approach
 - token layering with primitive, semantic, and component tokens
 - viewport mutation rules for mobile, tablet, and desktop
@@ -107,6 +124,7 @@ The review must block or flag:
 - scale-only responsive behavior
 - unresearched dependency choices
 - default component-kit styling without product rationale
+- missing or disconnected `conceptualAnchor` when no external design research was provided
 - visual direction copied from unrelated memory or external references
 - genericity findings that cannot name the exact drift signal
 

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

@@ -52,6 +52,14 @@ Do not use this file to teach generic frontend basics the model already knows.
 - Do not let heading, body, and data/meta roles collapse into one safe typographic family without explicit rationale.
 - At least one visual, interaction, content, motion, or state behavior must read as project-specific at a glance.
 
+## Dynamic Avant-Garde Anchor Boundary
+
+- If the user gives no current-task visual research or reference, the scaffold, old UI, and existing design docs do not count as research.
+- Before UI code, choose one agent-synthesized conceptual anchor from high-variance non-software domains and record only the final anchor in `docs/design-intent.json`.
+- Internally reject the safest dashboard, portal, card-grid, admin-shell, or minimalist-web-app mental model before writing CSS.
+- Typography, spacing, morphology, motion, and responsive recomposition must derive from the chosen anchor, not from framework defaults.
+- Rich motion, spatial transitions, and micro-interactions are allowed when they support the anchor and include reduced-motion and performance safeguards.
+
 ## Responsive Mutation Requirements
 
 - Responsive quality is not allowed to be scale-only. At least one surface must materially change position, grouping, priority, or disclosure strategy between mobile and desktop.

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

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-24T11:30:00.104Z",
+  "generatedAt": "2026-04-24T17:20:37.769Z",
   "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.22
+Generated by Agentic-Senior-Core CLI v3.0.25
 Timestamp: 2026-04-24T06:02:48.303Z
 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.22
+Generated by Agentic-Senior-Core CLI v3.0.25
 Timestamp: 2026-04-24T06:02:48.303Z
 Selected policy file: .agent-context/policies/llm-judge-threshold.json
 

package/README.md

@@ -10,12 +10,13 @@
 **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.9 (2026-04-20).
+Latest release: 3.0.25 (2026-04-25).
 
-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 brand systems.
-- Init prompts now point agents at the active onboarding and compiled-rule context that actually exists in target projects.
+Highlights in 3.0.25:
+- UI design bootstrap now forces a dynamic conceptual anchor when no current-task visual research is provided.
+- Agents must use live/current-year research for ecosystem, framework, dependency, Docker, and modern UI/library claims instead of offline repository guesses.
+- Frontend guidance now rejects safe dashboard/admin-panel defaults, requires responsive recomposition, and allows rich modern motion when it supports the chosen concept.
+- Generated design-intent seeds are more compact, leaving the LLM room to synthesize project-specific visual direction instead of inheriting verbose scaffold bias.
 
 </div>
 
@@ -37,6 +38,20 @@ One command to initialize rules, checklists, and strict AI coding guidelines con
 
 ---
 
+## Design Direction
+
+For UI, UX, layout, screen, Tailwind, frontend, or redesign work, the pack routes agents through the design bootstrap and frontend architecture rules before code changes.
+
+The intended behavior is agent-led, not offline-template-led:
+
+- Existing projects: read the real repository, docs, UI surface, and current user brief before changing design.
+- Fresh projects: ask the LLM agent to recommend the stack and design approach from current evidence instead of silently choosing a hardcoded framework.
+- No visual reference provided: synthesize one modern conceptual anchor first, then derive typography, spacing, morphology, motion, and responsive behavior from that anchor.
+- Modern UI claims: research current-year libraries and patterns when relevant; 2026 work should use 2026 evidence, and future years should update automatically through agent research.
+- Anti-generic rule: avoid safe dashboard shells, admin panels, card grids, scale-only mobile layouts, and static no-motion interfaces unless the product context explicitly justifies them.
+
+---
+
 ## MCP Quick Setup (VS Code)
 
 1. Generate workspace MCP config:

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

@@ -51,8 +51,6 @@ function buildStructureFirstSeedSignals({
 
   return {
     designPhilosophy: `Use ${evidenceSourceLabel} to synthesize the design system for ${projectName || 'this project'}. This seed is only a decision scaffold: the LLM must choose the visual language, libraries, color system, typography, spacing, and interaction model from ${projectContextLabel}, current repo evidence, and live official documentation when a technology claim is needed.`,
-    brandAdjectives: ['agent-synthesized-from-current-context'],
-    antiAdjectives: ['offline-prescribed-style', 'template-by-default', 'scale-only-responsive', 'unresearched-library-choice'],
     typographyScaleRatio: 'agent-calibrated-from-content-platform-and-readability',
     baseGridUnit: 'agent-calibrated-from-platform-density-and-implementation-stack',
     spacingPattern: 'agent-defined-from-task-flow-and-viewport-needs',
@@ -60,16 +58,9 @@ function buildStructureFirstSeedSignals({
     colorIntent: `Choose semantic palette roles from ${projectContextLabel}, current repo evidence, and accessibility needs. Do not inherit fixed palettes or generic SaaS color defaults from this scaffold.`,
     paletteRoles: ['agent-defined-semantic-roles'],
     distinctiveMoves: [
-      'Research and choose a current, project-fit visual direction instead of inheriting any offline preset from this scaffold.',
-      'Define at least one recognizable design move from the product task, audience, content, and repo evidence before implementation.',
-      'Document why the chosen move belongs to this project and which common LLM bad habit it intentionally avoids.',
+      'Choose one recognizable design move from product task, audience, content, repo evidence, and current docs; do not inherit a scaffold preset.',
     ],
     motionPurpose: 'Use modern motion when it improves hierarchy, continuity, feedback, memorability, or perceived product quality. If implementation needs a motion library, the LLM must choose a current compatible option from official docs instead of relying on an offline default.',
-    motionChoreography: 'Define choreography from the product experience and implementation stack. Keep it performant and reduced-motion-safe; do not suppress rich interaction by default.',
-    motionDurations: {
-      desktop: 'agent-calibrated',
-      mobile: 'agent-calibrated',
-    },
     componentMorphology: {
       mobile: 'Recompose the experience for touch, task priority, and constrained attention. Mobile should be a deliberate mobile design, not a shrunken desktop.',
       tablet: 'Regroup surfaces for medium-width use, preserving task clarity without cloning either desktop or mobile blindly.',
@@ -121,8 +112,6 @@ function buildDesignIntentContractObject({
         : toTitleCase(initContext.blueprintFileName),
     },
     designPhilosophy: inferredKeywords.designPhilosophy,
-    brandAdjectives: inferredKeywords.brandAdjectives,
-    antiAdjectives: inferredKeywords.antiAdjectives,
     visualDirection: {
       seedMode: 'scaffold-only',
       requiresProjectSpecificSynthesis: true,
@@ -139,14 +128,78 @@ function buildDesignIntentContractObject({
       candidateDomains: [
         'visual-direction',
         'motion-and-scroll',
-        'ui-primitives',
-        'canvas-3d-or-rich-media',
-        'charts-and-data-visualization',
-        'icons-and-illustration',
-        'typography-and-interaction-patterns',
+        'ui-primitives-or-rich-media',
+        'typography-and-interaction',
       ],
       finalDecisionAuthority: 'agent-llm-from-project-fit-accessibility-performance-maintainability-and-current-official-docs',
     },
+    conceptualAnchor: {
+      mode: 'required-when-no-external-research',
+      seedMode: 'selection-policy-only',
+      requiresAgentSelectionBeforeUiImplementation: true,
+      userResearchAbsencePolicy: {
+        userSuppliedResearchOnly: true,
+        scaffoldSeedDoesNotCountAsResearch: true,
+        priorUiDoesNotCountAsResearch: true,
+        requireAgentLedResearchWhenAvailable: true,
+      },
+      candidateSelectionPolicy: {
+        considerAtLeast: 3,
+        discardObviousCandidateCount: 2,
+        minimumCandidateDistance: 'high',
+        discardPredictableCandidates: true,
+        preferDistinctiveOverSafe: true,
+        doNotRevealHiddenCandidateList: true,
+        outputOnlyChosenAnchor: true,
+      },
+      forbiddenFinalAnchorTerms: [
+        'dashboard',
+        'cards',
+        'admin-panel',
+        'saas-shell',
+        'minimalist-interface',
+        'safe-admin-layout',
+      ],
+      sourceDomains: [
+        'complex-physical-engineering',
+        'cinematic-spatial-interface',
+        'experimental-editorial-structure',
+        'scientific-instrumentation',
+        'premium-interactive-web-experiences',
+      ],
+      visualRiskBudget: {
+        mode: 'high-distinctiveness-with-accessibility-and-performance-guardrails',
+        allowRichMotionAndMicroInteraction: true,
+        rejectTimidDefaultWhenAnchorSupportsExpressiveUi: true,
+        requireReducedMotionFallback: true,
+      },
+      requiredDerivedAxes: [
+        'typography',
+        'morphology',
+        'motion',
+        'responsive-composition',
+      ],
+      finalAnchorContract: {
+        requiredFields: [
+          'name',
+          'agentResearchMode',
+          'sourceDomain',
+          'rationale',
+          'derivedTokenLogic',
+          'visualRiskBudget',
+          'motionRiskBudget',
+          'cohesionChecks',
+        ],
+        derivedTokenLogicAxes: [
+          'morphology',
+          'motion',
+        ],
+        cohesionChecks: [
+          'no-dashboard-mental-model',
+          'motion-derived-from-anchor',
+        ],
+      },
+    },
     mathSystems: {
       typographyScaleRatio: inferredKeywords.typographyScaleRatio,
       baseGridUnit: inferredKeywords.baseGridUnit,
@@ -163,7 +216,6 @@ function buildDesignIntentContractObject({
       componentTokensConsumeSemantic: true,
       forbidDirectComponentPrimitiveBypass: true,
       aliasReferenceStyle: 'brace-reference',
-      aliasingStrategy: 'Primitive tokens hold raw values, semantic tokens carry intent, and component tokens consume semantic aliases instead of raw values.',
       fallbackPolicy: {
         forbidRawHexOutsidePrimitives: true,
         forbidRawSpacingOutsidePrimitives: true,
@@ -174,12 +226,6 @@ function buildDesignIntentContractObject({
         forbidDotsInNames: true,
         forbidSquareBracketsInNames: true,
       },
-      tokenLayerRoles: {
-        primitive: 'Raw values such as colors, spacing, radius, typography, and motion primitives.',
-        semantic: 'Contextual intent tokens such as primary action, muted surface, emphasis text, or critical state.',
-        component: 'Component-scoped tokens that consume semantic aliases and preserve local consistency without redefining the system.',
-      },
-      platformOutputs: ['json-contract', 'css-variables'],
     },
     colorTruth: {
       format: 'OKLCH',
@@ -199,19 +245,14 @@ function buildDesignIntentContractObject({
     motionSystem: {
       allowMeaningfulMotion: true,
       purpose: inferredKeywords.motionPurpose,
-      choreography: inferredKeywords.motionChoreography,
-      desktopDurationMs: inferredKeywords.motionDurations.desktop,
-      mobileDurationMs: inferredKeywords.motionDurations.mobile,
       seedToneLocked: false,
       respectReducedMotion: true,
-      preferTransformAndOpacity: true,
-      avoidDecorativeMotionForItsOwnSake: true,
     },
     componentMorphology: {
       requireStateBehaviorMatrix: true,
       preserveIdentityAcrossViewports: true,
       seedBehaviorsRequireRefinement: true,
-      stateKeys: ['default', 'hover', 'focus', 'active', 'disabled', 'loading', 'error'],
+      stateKeys: ['default', 'focus', 'loading', 'error'],
       viewportBehavior: inferredKeywords.componentMorphology,
     },
     accessibilityPolicy: {
@@ -268,45 +309,33 @@ function buildDesignIntentContractObject({
       status: 'seed-needs-refinement',
       seedMode: 'structure-first-scaffold',
       requiresTaskSpecificRefinement: true,
-      primaryExperienceGoal: `Ask the LLM to define the main ${String(primaryDomain || 'product').toLowerCase()} journey in ${projectName} from repo evidence, product context, user goals, and current official documentation where technology choices matter. This scaffold must not prescribe the final visual layout.`,
+      primaryExperienceGoal: `Define the main ${String(primaryDomain || 'product').toLowerCase()} journey for ${projectName} from repo evidence, the brief, and current docs. The seed must not prescribe final layout.`,
       surfacePlan: [
         {
           surfaceId: 'agent-defined-primary-experience',
-          role: 'llm-synthesized-from-current-context',
-          goal: `Define the primary UI experience for ${projectName} from the actual product task, audience, data, and repo evidence before coding.`,
-          primaryAction: 'The LLM must choose the first decisive action or reading path and explain why it fits the project.',
-          supportingModules: ['agent-defined-from-current-context'],
-          layoutAntiPatternToAvoid: 'template-default-without-product-rationale',
-          signatureMoveHint: 'Choose and document one project-specific visual, interaction, or content move. Do not inherit it from this scaffold.',
-        },
-        {
-          surfaceId: 'agent-defined-supporting-experience',
-          role: 'llm-synthesized-supporting-context',
-          goal: 'Define supporting, proof, utility, or recovery surfaces from actual user needs instead of cloning generic cards or rails.',
-          primaryAction: 'The LLM must decide what belongs beside, below, hidden behind disclosure, or removed based on task priority.',
-          supportingModules: ['agent-defined-from-current-context'],
-          layoutAntiPatternToAvoid: 'scale-only-responsive-layout',
-          signatureMoveHint: 'Explain how supporting content changes across viewports and why the change improves the experience.',
+          role: 'primary-context-synthesized-by-agent',
+          goal: 'Choose the first task or reading path from product evidence and reject template shells.',
+          antiPatterns: ['dashboard-default', 'scale-only-responsive-layout'],
         },
       ],
       componentGraph: {
         nodes: [
           {
-            id: 'agent-defined-primary-experience',
-            role: 'primary-experience-after-synthesis',
+            id: 'primary-experience',
+            role: 'agent-defined-primary',
             priority: 'high',
           },
           {
-            id: 'agent-defined-supporting-experience',
-            role: 'supporting-experience-after-synthesis',
+            id: 'supporting-context',
+            role: 'agent-defined-support',
             priority: 'medium',
           },
         ],
         edges: [
           {
-            from: 'agent-defined-primary-experience',
-            to: 'agent-defined-supporting-experience',
-            relationship: 'agent-defined-from-task-priority',
+            from: 'primary-experience',
+            to: 'supporting-context',
+            relationship: 'task-priority-support',
           },
         ],
       },
@@ -325,25 +354,21 @@ function buildDesignIntentContractObject({
         mobile: {
           primaryOperation: 'agent-defined-mobile-recomposition',
           requiredSurfaceActions: [
-            'choose-mobile-specific-task-order',
-            'merge-disclose-or-remove-low-priority-content',
-            'adapt-interaction-model-for-touch',
+            'choose-mobile-task-order',
+            'disclose-or-remove-low-priority-content',
           ],
           forbiddenPatterns: [
             'scale-only-shrink',
-            'desktop-order-preserved-without-priority-shift',
           ],
           rationale: inferredKeywords.mutationRules.mobile,
         },
         tablet: {
           primaryOperation: 'agent-defined-tablet-regrouping',
           requiredSurfaceActions: [
-            'define-medium-width-information-architecture',
-            'avoid-cloning-desktop-by-width-only',
+            'define-medium-width-grouping',
             'preserve-task-clarity',
           ],
           forbiddenPatterns: [
-            'desktop-layout-reduced-by-width-only',
             'uniform-module-grid-without-role-change',
           ],
           rationale: inferredKeywords.mutationRules.tablet,
@@ -352,11 +377,9 @@ function buildDesignIntentContractObject({
           primaryOperation: 'agent-defined-desktop-composition',
           requiredSurfaceActions: [
             'use-space-to-improve-hierarchy',
-            'define-scan-pattern-and-action-priority',
             'avoid-equalizing-unrelated-content',
           ],
           forbiddenPatterns: [
-            'template-shell-without-product-rationale',
             'interchangeable-dashboard-or-landing-chrome',
           ],
           rationale: inferredKeywords.mutationRules.desktop,
@@ -364,33 +387,25 @@ function buildDesignIntentContractObject({
       },
       interactionStateMatrix: [
         {
-          componentId: 'primary-action-control',
-          states: ['default', 'hover', 'focus', 'loading', 'success', 'error'],
-          notes: 'Refine these states with project-specific feedback language and visual treatment, but keep them legible, decisive, and consistent across all supported viewports.',
-        },
-        {
-          componentId: 'primary-content-module',
-          states: ['default', 'focus', 'expanded', 'loading', 'error'],
-          notes: 'Refine this module so it preserves hierarchy and progressive disclosure without collapsing into anonymous cards or safe default dashboard panels.',
+          componentId: 'primary-interaction',
+          states: ['default', 'hover', 'focus', 'loading', 'error'],
+          notes: 'Refine states from project language and the conceptual anchor; do not use anonymous default panels.',
         },
       ],
       taskFlowNarrative: [
-        `Entry: the LLM must define how ${projectName} starts the user journey from real product evidence instead of a generic opening pattern.`,
-        'Decision: the LLM must define hierarchy, proof, state language, and interaction behavior from the actual task.',
-        'Resolution: the LLM must define feedback, recovery, and next-useful-action behavior without defaulting to leftover template chrome.',
+        `Entry: define how ${projectName} starts the journey from real evidence, not a generic opener.`,
+        'Resolution: define proof, feedback, recovery, and next action without leftover template chrome.',
       ],
       visualResetStrategy: {
         activatesWhenUserRequests: [
           'redesign from zero',
           'redesain dari 0',
-          'ulang dari 0',
-          'research ulang',
         ],
-        existingUiAllowedAs: ['content-evidence', 'behavior-evidence', 'accessibility-evidence', 'asset-source-evidence'],
-        existingUiForbiddenAs: ['palette-source', 'typography-source', 'layout-source', 'motion-source', 'component-morphology-source'],
-        requiredResetAxes: ['composition', 'hierarchy', 'palette-and-typography', 'motion-or-interaction', 'responsive-information-architecture'],
+        existingUiAllowedAs: ['content-evidence', 'behavior-evidence', 'asset-source-evidence'],
+        existingUiForbiddenAs: ['palette-source', 'layout-source', 'motion-source'],
+        requiredResetAxes: ['composition', 'hierarchy', 'motion-or-interaction', 'responsive-information-architecture'],
       },
-      signatureMoveRationale: 'The LLM must choose the project-specific visual, motion, typographic, compositional, or interaction move after reading current context and explain why a generic fallback would weaken the product.',
+      signatureMoveRationale: 'Agent must choose one project-specific visual, motion, typographic, or interaction move and explain why generic fallback weakens it.',
       implementationGuardrails: {
         requireBuildFromHandoff: true,
         requireGapNotesBeforeFallback: true,
@@ -430,20 +445,20 @@ function buildDesignIntentContractObject({
       genericitySignals: [
         'offline-prescribed-style-used-as-final-direction',
         'unresearched-library-or-framework-choice',
-        'default-component-kit-treatment-without-product-rationale',
+        'missing-conceptual-anchor-without-external-research',
+        'visual-decisions-not-derived-from-conceptual-anchor',
+        'timid-anchor-that-renames-dashboard-or-admin-shell',
+        'motion-suppressed-without-accessibility-or-performance-reason',
         'scale-only-responsive-layout',
-        'template-shell-without-product-rationale',
         'zero-based-redesign-kept-prior-visual-dna',
         'restyle-instead-of-recomposition',
-        'inaccessible-or-decorative-motion',
       ],
       validBoldSignals: [
+        'single-cohesive-conceptual-anchor',
+        'high-variance-candidate-selection',
         'context-derived-visual-direction',
-        'official-docs-backed-library-choice',
         'responsive-recomposition-by-task-priority',
         'purposeful-motion-with-reduced-motion-path',
-        'documented-design-rationale-before-code',
-        'clean-component-and-token-architecture',
       ],
       reportingRules: {
         mustExplainGenericity: true,
@@ -471,10 +486,7 @@ function buildDesignIntentContractObject({
       approvedExternalConstraintUsage: 'Convert explicit user-supplied external constraints into current-project rules without comparing against or imitating the source surface.',
       driftSignals: [
         'palette-reused-without-brief-support',
-        'motion-signature-reused-without-approval',
-        'layout-shape-matches-unrelated-project-memory',
         'prior-ui-visual-dna-carried-into-reset-request',
-        'existing-design-doc-treated-as-style-continuity-during-zero-based-redesign',
       ],
     },
     experiencePrinciples: [
@@ -482,17 +494,17 @@ function buildDesignIntentContractObject({
       'Major interface decisions must be explainable in product and user terms.',
       'Accessibility, responsiveness, and implementation realism are non-negotiable.',
       'Cross-viewport behavior must reorganize tasks and navigation, not just scale the desktop layout down.',
-      'Modern libraries and interaction patterns may be used when the LLM verifies they fit the project and current official docs.',
-      'Motion may be rich and memorable when it improves the product experience, but it must stay purposeful, performant, and optional for reduced-motion users.',
-      'At least one visual, interaction, content, or motion decision must be recognizable at a glance and justified from context.',
+      'A single agent-chosen conceptual anchor must unify typography, spacing, morphology, motion, and responsive composition when user research is absent.',
+      'Expressive motion and spatial interaction are allowed when they support the anchor and remain accessible and performant.',
       'When the user asks for a zero-based redesign, existing UI becomes content and behavior evidence only; prior visual DNA must be discarded unless explicitly approved.',
     ],
     forbiddenPatterns: [
       'offline-prescribed-style-used-as-final-direction',
-      'unresearched-library-or-framework-choice',
-      'default-component-kit-treatment-without-product-rationale',
+      'missing-conceptual-anchor-without-external-research',
+      'visual-decisions-not-derived-from-conceptual-anchor',
+      'timid-anchor-that-renames-dashboard-or-admin-shell',
+      'motion-suppressed-without-accessibility-or-performance-reason',
       'scale-only-responsive-layout',
-      'template-shell-without-product-rationale',
       'zero-based-redesign-kept-prior-visual-dna',
       'restyle-instead-of-recomposition',
       'single-safe-typographic-family-without-role-contrast-or-rationale',
@@ -511,6 +523,9 @@ function buildDesignIntentContractObject({
       requireStructuredDesignExecutionPolicy: true,
       requireStructuredDesignHandoff: true,
       requireVisualResetStrategyWhenZeroBasedRedesignRequested: true,
+      requireConceptualAnchorWhenNoExternalResearch: true,
+      requireAgentLedAnchorResearchWhenUserResearchMissing: true,
+      rejectTimidDashboardAnchor: true,
       requireReviewRubric: true,
       requireGenericityExplanation: true,
       genericityAutoFail: true,
@@ -526,6 +541,7 @@ function buildDesignIntentContractObject({
       requireViewportMutationRules: true,
       requirePurposefulMotionGuidelines: true,
       requireRecognizableVisualBet: true,
+      requireConceptualAnchor: true,
       bootstrapPrompt: '.agent-context/prompts/bootstrap-design.md',
       autoLoadedRuleFiles: [
         '.agent-context/prompts/bootstrap-design.md',
@@ -560,6 +576,151 @@ export function validateDesignIntentContract(designIntentContract) {
     validationErrors.push('designIntent.designPhilosophy must be a non-empty string.');
   }
 
+  if (!designIntentContract.externalResearchIntake || typeof designIntentContract.externalResearchIntake !== 'object') {
+    validationErrors.push('designIntent.externalResearchIntake must exist.');
+  } else {
+    if (designIntentContract.externalResearchIntake.userSuppliedResearchPolicy !== 'read-as-candidate-evidence-not-final-prescription') {
+      validationErrors.push('designIntent.externalResearchIntake.userSuppliedResearchPolicy must preserve user research as candidate evidence.');
+    }
+    if (designIntentContract.externalResearchIntake.requireOfficialDocsVerificationForTechnologyClaims !== true) {
+      validationErrors.push('designIntent.externalResearchIntake.requireOfficialDocsVerificationForTechnologyClaims must equal true.');
+    }
+    if (
+      !Array.isArray(designIntentContract.externalResearchIntake.candidateDomains)
+      || !designIntentContract.externalResearchIntake.candidateDomains.includes('motion-and-scroll')
+    ) {
+      validationErrors.push('designIntent.externalResearchIntake.candidateDomains must include motion-and-scroll.');
+    }
+  }
+
+  if (!designIntentContract.conceptualAnchor || typeof designIntentContract.conceptualAnchor !== 'object') {
+    validationErrors.push('designIntent.conceptualAnchor must exist.');
+  } else {
+    const conceptualAnchor = designIntentContract.conceptualAnchor;
+    if (conceptualAnchor.mode !== 'required-when-no-external-research') {
+      validationErrors.push('designIntent.conceptualAnchor.mode must equal "required-when-no-external-research".');
+    }
+    if (conceptualAnchor.seedMode !== 'selection-policy-only') {
+      validationErrors.push('designIntent.conceptualAnchor.seedMode must equal "selection-policy-only".');
+    }
+    if (conceptualAnchor.requiresAgentSelectionBeforeUiImplementation !== true) {
+      validationErrors.push('designIntent.conceptualAnchor.requiresAgentSelectionBeforeUiImplementation must equal true.');
+    }
+    const userResearchAbsencePolicy = conceptualAnchor.userResearchAbsencePolicy;
+    if (!userResearchAbsencePolicy || typeof userResearchAbsencePolicy !== 'object') {
+      validationErrors.push('designIntent.conceptualAnchor.userResearchAbsencePolicy must exist.');
+    } else {
+      if (userResearchAbsencePolicy.userSuppliedResearchOnly !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.userResearchAbsencePolicy.userSuppliedResearchOnly must equal true.');
+      }
+      if (userResearchAbsencePolicy.scaffoldSeedDoesNotCountAsResearch !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.userResearchAbsencePolicy.scaffoldSeedDoesNotCountAsResearch must equal true.');
+      }
+      if (userResearchAbsencePolicy.priorUiDoesNotCountAsResearch !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.userResearchAbsencePolicy.priorUiDoesNotCountAsResearch must equal true.');
+      }
+      if (userResearchAbsencePolicy.requireAgentLedResearchWhenAvailable !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.userResearchAbsencePolicy.requireAgentLedResearchWhenAvailable must equal true.');
+      }
+    }
+    const candidateSelectionPolicy = conceptualAnchor.candidateSelectionPolicy;
+    if (!candidateSelectionPolicy || typeof candidateSelectionPolicy !== 'object') {
+      validationErrors.push('designIntent.conceptualAnchor.candidateSelectionPolicy must exist.');
+    } else {
+      if (candidateSelectionPolicy.considerAtLeast < 3) {
+        validationErrors.push('designIntent.conceptualAnchor.candidateSelectionPolicy.considerAtLeast must be at least 3.');
+      }
+      if (candidateSelectionPolicy.discardObviousCandidateCount < 2) {
+        validationErrors.push('designIntent.conceptualAnchor.candidateSelectionPolicy.discardObviousCandidateCount must be at least 2.');
+      }
+      if (candidateSelectionPolicy.minimumCandidateDistance !== 'high') {
+        validationErrors.push('designIntent.conceptualAnchor.candidateSelectionPolicy.minimumCandidateDistance must equal "high".');
+      }
+      if (candidateSelectionPolicy.discardPredictableCandidates !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.candidateSelectionPolicy.discardPredictableCandidates must equal true.');
+      }
+      if (candidateSelectionPolicy.preferDistinctiveOverSafe !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.candidateSelectionPolicy.preferDistinctiveOverSafe must equal true.');
+      }
+      if (candidateSelectionPolicy.doNotRevealHiddenCandidateList !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.candidateSelectionPolicy.doNotRevealHiddenCandidateList must equal true.');
+      }
+      if (candidateSelectionPolicy.outputOnlyChosenAnchor !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.candidateSelectionPolicy.outputOnlyChosenAnchor must equal true.');
+      }
+    }
+    if (
+      !Array.isArray(conceptualAnchor.forbiddenFinalAnchorTerms)
+      || !conceptualAnchor.forbiddenFinalAnchorTerms.includes('dashboard')
+      || !conceptualAnchor.forbiddenFinalAnchorTerms.includes('cards')
+      || !conceptualAnchor.forbiddenFinalAnchorTerms.includes('safe-admin-layout')
+    ) {
+      validationErrors.push('designIntent.conceptualAnchor.forbiddenFinalAnchorTerms must reject basic UI labels.');
+    }
+    if (
+      !Array.isArray(conceptualAnchor.sourceDomains)
+      || conceptualAnchor.sourceDomains.length < 4
+      || !conceptualAnchor.sourceDomains.includes('complex-physical-engineering')
+      || !conceptualAnchor.sourceDomains.includes('cinematic-spatial-interface')
+      || !conceptualAnchor.sourceDomains.includes('premium-interactive-web-experiences')
+    ) {
+      validationErrors.push('designIntent.conceptualAnchor.sourceDomains must list broad non-template anchor domains.');
+    }
+    const visualRiskBudget = conceptualAnchor.visualRiskBudget;
+    if (!visualRiskBudget || typeof visualRiskBudget !== 'object') {
+      validationErrors.push('designIntent.conceptualAnchor.visualRiskBudget must exist.');
+    } else {
+      if (visualRiskBudget.mode !== 'high-distinctiveness-with-accessibility-and-performance-guardrails') {
+        validationErrors.push('designIntent.conceptualAnchor.visualRiskBudget.mode must preserve high-distinctiveness guardrails.');
+      }
+      if (visualRiskBudget.allowRichMotionAndMicroInteraction !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.visualRiskBudget.allowRichMotionAndMicroInteraction must equal true.');
+      }
+      if (visualRiskBudget.rejectTimidDefaultWhenAnchorSupportsExpressiveUi !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.visualRiskBudget.rejectTimidDefaultWhenAnchorSupportsExpressiveUi must equal true.');
+      }
+      if (visualRiskBudget.requireReducedMotionFallback !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.visualRiskBudget.requireReducedMotionFallback must equal true.');
+      }
+    }
+    if (
+      !Array.isArray(conceptualAnchor.requiredDerivedAxes)
+      || !conceptualAnchor.requiredDerivedAxes.includes('typography')
+      || !conceptualAnchor.requiredDerivedAxes.includes('responsive-composition')
+    ) {
+      validationErrors.push('designIntent.conceptualAnchor.requiredDerivedAxes must include typography and responsive-composition.');
+    }
+    const finalAnchorContract = conceptualAnchor.finalAnchorContract;
+    if (!finalAnchorContract || typeof finalAnchorContract !== 'object') {
+      validationErrors.push('designIntent.conceptualAnchor.finalAnchorContract must exist.');
+    } else {
+      if (
+        !Array.isArray(finalAnchorContract.requiredFields)
+        || !finalAnchorContract.requiredFields.includes('agentResearchMode')
+        || !finalAnchorContract.requiredFields.includes('derivedTokenLogic')
+        || !finalAnchorContract.requiredFields.includes('visualRiskBudget')
+        || !finalAnchorContract.requiredFields.includes('motionRiskBudget')
+        || !finalAnchorContract.requiredFields.includes('cohesionChecks')
+      ) {
+        validationErrors.push('designIntent.conceptualAnchor.finalAnchorContract.requiredFields must require agentResearchMode, derivedTokenLogic, visualRiskBudget, motionRiskBudget, and cohesionChecks.');
+      }
+      if (
+        !Array.isArray(finalAnchorContract.derivedTokenLogicAxes)
+        || !finalAnchorContract.derivedTokenLogicAxes.includes('motion')
+        || !finalAnchorContract.derivedTokenLogicAxes.includes('morphology')
+      ) {
+        validationErrors.push('designIntent.conceptualAnchor.finalAnchorContract.derivedTokenLogicAxes must include motion and morphology.');
+      }
+      if (
+        !Array.isArray(finalAnchorContract.cohesionChecks)
+        || !finalAnchorContract.cohesionChecks.includes('no-dashboard-mental-model')
+        || !finalAnchorContract.cohesionChecks.includes('motion-derived-from-anchor')
+      ) {
+        validationErrors.push('designIntent.conceptualAnchor.finalAnchorContract.cohesionChecks must reject dashboard mental models and require motion derivation.');
+      }
+    }
+  }
+
   if (!designIntentContract.mathSystems || typeof designIntentContract.mathSystems !== 'object') {
     validationErrors.push('designIntent.mathSystems must exist.');
   } else {

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

@@ -176,6 +176,9 @@ export function buildDesignBootstrapPrompt({
     '30. In zero-based redesign mode, the new contract must name the discarded prior visual DNA and materially reset composition, hierarchy, palette/typography, motion or interaction, and responsive information architecture.',
     '31. If modern UI, animation, scroll, 3D, canvas, chart, or icon libraries are useful, choose them from current official docs and record source URL, fetched date, reason, risk, and accessibility fallback.',
     '32. If the user supplies research files, library lists, screenshots, articles, or benchmark notes, read them as candidate evidence, summarize the useful signals, filter by project fit, and verify technology claims against current official docs before implementation.',
+    '33. If no user-supplied research or reference is supplied for UI work, activate the Dynamic Avant-Garde Anchor Engine before coding. User-supplied research means current-task evidence from the user; this scaffold, prior UI, and old design docs do not count as research.',
+    '34. In Dynamic Avant-Garde mode, perform agent-led research when available, then internally consider at least three high-variance conceptual anchors, discard the two safest or most predictable options, output only the chosen anchor and rationale, and forbid final anchors named dashboard, portal, cards, admin panel, SaaS shell, web app shell, or minimalist interface.',
+    '35. The chosen anchor must drive typography, spacing, density, color behavior, morphology, motion, and responsive composition. If expressive motion, spatial transitions, micro-interactions, or modern animation libraries support the anchor, use them with performance notes and reduced-motion fallbacks instead of suppressing motion to look safe.',
     '',
     '## Project Inputs',
     `- Project name: ${discoveryAnswers.projectName}`,
@@ -205,7 +208,9 @@ export function buildDesignBootstrapPrompt({
     '11. Ensure both files stay project-specific, dynamic, and practical for implementation and review. The seed may guide structure, but it must not decide style offline.',
     '12. Keep visualResetStrategy in the machine-readable handoff so reset-language tasks cannot quietly become restyles of the previous UI.',
     '13. Preserve externalResearchIntake so user-provided research becomes reviewed evidence without turning into an offline style or dependency preset.',
-    '14. After the contract exists, use it as a first-class source for future UI tasks.',
+    '14. Preserve conceptualAnchor so prompt-only UI work has one cohesive non-template concept instead of a mixed collection of bold but unrelated visual decisions.',
+    '15. Record conceptualAnchor.agentResearchMode, visualRiskBudget, motionRiskBudget, and cohesionChecks so the final UI cannot quietly fall back to a timid dashboard/admin mental model.',
+    '16. After the contract exists, use it as a first-class source for future UI tasks.',
     '',
   ].join('\n');
 }

package/package.json

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