@ryuenn3123/agentic-senior-core 3.0.35 → 3.0.36

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

@@ -96,10 +96,13 @@ In reset mode:
 ## Design Quality Bar
 
 The UI must feel authored by a strong UI/UX designer, not assembled from default cards and safe framework chrome.
+The UI must not look like a first-pass AI template. "Readable" and "safe" are not enough when the brief calls for an authored product experience.
 
 Do:
 - Synthesize a visual direction from the project context and explain why it fits.
 - Choose color, typography, spacing, motion, density, and component morphology dynamically from the product and audience.
+- Make at least three at-a-glance product-specific signals visible on new screens or broad redesigns: for example a data treatment, physical metaphor, motion behavior, iconography system, spatial structure, or state language that would not transfer cleanly to a different product.
+- Use visually exploratory, product-derived palettes while preserving WCAG contrast and status clarity. The design may be quiet, but it must not hide inside safe cream, slate, monochrome, or gradient defaults.
 - Use modern, expressive interaction and motion as part of the core design language, especially when it improves hierarchy, feedback, delight, confidence, or memorability.
 - Use 3D or spatial/canvas experiences as primary UI only when they improve product understanding or exploration while preserving navigation, content clarity, user actions, performance, accessibility, and non-3D fallbacks.
 - Keep frontend code clean, componentized, accessible, and easy to maintain.
@@ -107,7 +110,9 @@ Do:
 - Make design decisions explicit before coding, then implement consistently.
 
 Do not:
+- Ship AI-safe UI: predictable card stacks, rounded template panels, generic abstract marks, decorative grid wallpaper, beige or slate safety palettes, soft glow backgrounds, or first-output composition with only local copy swapped in.
 - Default to generic SaaS heroes, balanced card grids, soft startup gradients, or dashboard chrome without product rationale.
+- Use background lines, grids, scanlines, noise, glows, blobs, logos, or geometric decoration unless each motif has a named product function such as alignment, measurement, navigation, crop guidance, timeline reading, status, or motion continuity.
 - Let desktop, tablet, and mobile be the same design merely scaled down.
 - Let heading, body, data, and metadata collapse into one safe typographic treatment without rationale.
 - Reuse colors, layout shapes, or motion signatures from unrelated memory.
@@ -145,6 +150,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
+- an `aiSafeUiAudit` or equivalent review signal that states why the screen is not interchangeable with a generic AI-generated template
 - `motionPaletteDecision` with motion density source, required interaction states, palette autopilot risk, and whether 3D/canvas is useful or unnecessary
 - `conceptualAnchor` and how typography, spacing, morphology, motion, and responsive composition derive from it when no external research was provided
 - `derivedTokenLogic` with exact `anchorReference` traceability for color, spacing, typography, and motion tokens
@@ -166,6 +172,8 @@ The review must block or flag:
 - inaccessible contrast, focus, target size, keyboard, auth, or dynamic-status behavior
 - scale-only responsive behavior
 - unresearched dependency choices
+- AI-safe UI drift: interchangeable card grids, safe cream/slate/monochrome palettes, generic abstract logos, decorative grid wallpaper, or a screen that can be renamed to another product without visual changes
+- palette choices that use readability as a reason to stay in safe defaults instead of deriving a richer but accessible palette from the product
 - 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

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

@@ -47,10 +47,12 @@ Do not use this file to teach generic frontend basics the model already knows.
 ## Anti-Generic UI Boundaries
 
 - Do not default to interchangeable dashboard chrome, balanced card grids, centered marketing shells, or generic component-kit surfaces unless the product explicitly needs them.
+- Do not ship "AI-safe UI": predictable card stacks, rounded rectangles, generic abstract logos, decorative grids, beige or slate safety palettes, soft glow backgrounds, and first-output template composition are review findings when they are not directly required by the product.
 - Do not let repeated surfaces share the same visual treatment by habit. Repetition is allowed only when the contract explains the product reason.
 - Do not use default framework button and input treatment as the final UI language.
 - 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.
+- At least three visual, interaction, content, motion, or state behaviors must read as project-specific at a glance for new screens or broad redesigns. For a narrow component edit, at least one touched behavior must preserve or improve project specificity.
+- If the UI could be renamed to another product category without changing its composition, palette, iconography, and motion language, treat that as genericity drift and revise before implementation is considered complete.
 
 ## Dynamic Avant-Garde Anchor Boundary
 
@@ -74,7 +76,9 @@ Do not use this file to teach generic frontend basics the model already knows.
 - Product categories are heuristics, not style presets. Use them only as a starting signal, then choose motion density from user task, content density, brand intent, device/performance budget, and accessibility needs.
 - If the category is unclear, infer from the dominant task: reading, scanning, form completion, data comparison, product inspection, storytelling, learning, play, or spatial exploration.
 - For interactive UI, map the required states before coding: default, hover, focus-visible, active/pressed, disabled, loading, empty, error, success, and transition.
-- Do not default to dark slate, cream/beige/tan, purple-blue gradients, monochrome palettes, or uniform card surfaces unless current project evidence supports them. If one of those palettes is used, document why it fits and add enough role contrast that the UI does not read as a template.
+- Prefer visually exploratory, product-derived palettes over safe template palettes. High readability is mandatory, but readability must not be used as an excuse for cream/beige/tan, dark slate, purple-blue gradients, monochrome palettes, or uniform card surfaces.
+- Do not default to dark slate, cream/beige/tan, purple-blue gradients, monochrome palettes, or uniform card surfaces unless current project evidence supports them. If one of those palettes is used, document why it fits, add enough role contrast that the UI does not read as a template, and include at least one product-specific color behavior that would not make sense in a generic SaaS screen.
+- Background lines, grids, scanlines, noise, glows, blobs, abstract logos, and decorative geometry are invalid when used as wallpaper. They must serve a named product function such as alignment, crop guidance, map/route orientation, timeline reading, measurement, status, or motion continuity.
 - Use the existing motion stack first. Add animation, 3D, canvas, or scroll dependencies only when they materially improve delivery speed, interaction quality, maintainability, or product understanding.
 - Motion should be absent only for a named reason: repeated high-frequency workflow, long-form reading focus, data-density scanning, reduced-motion need, or performance constraint.
 

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

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-27T02:24:13.742Z",
+  "generatedAt": "2026-04-27T06:06:55.854Z",
   "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.35
+Generated by Agentic-Senior-Core CLI v3.0.36
 Timestamp: 2026-04-26T23:31:29.580Z
 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.35
+Generated by Agentic-Senior-Core CLI v3.0.36
 Timestamp: 2026-04-26T23:31:29.580Z
 Selected policy file: .agent-context/policies/llm-judge-threshold.json
 

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

@@ -229,9 +229,23 @@ function buildDesignIntentContractObject({
       productCategorySignal: 'agent-inferred-starting-heuristic',
       densityDecisionSource: 'Agent must choose motion density from task, content density, brand intent, device/performance, and accessibility evidence; product categories are heuristics, not style presets.',
       requiredInteractionStates: ['default', 'hover', 'focus-visible', 'active', 'disabled', 'loading', 'empty', 'error', 'success', 'transition'],
-      paletteAutopilotRisks: ['dark-slate-default', 'cream-beige-default', 'purple-blue-gradient-default', 'monochrome-template-default', 'uniform-card-surface-default'],
+      paletteAutopilotRisks: ['dark-slate-default', 'cream-beige-default', 'purple-blue-gradient-default', 'monochrome-template-default', 'uniform-card-surface-default', 'generic-grid-wallpaper-default', 'soft-glow-ai-template-default'],
       spatialDecision: 'Agent must state whether 3D/canvas/WebGL is useful or unnecessary for product understanding, exploration, or storytelling.',
     },
+    aiSafeUiAudit: {
+      status: 'agent-must-complete-before-ui-implementation',
+      failureDefinition: 'UI is AI-safe when it relies on predictable card stacks, rounded template panels, generic abstract logos, decorative grid wallpaper, beige or slate safety palettes, soft glow backgrounds, or first-output composition with only local copy swapped in.',
+      interchangeabilityTest: `If this UI can be renamed from ${projectName} to another product category without changing composition, palette, iconography, and motion language, the design is genericity drift and must be revised.`,
+      requiredProductSpecificSignals: [
+        'agent-defined-product-specific-data-treatment',
+        'agent-defined-product-specific-motion-or-state-behavior',
+        'agent-defined-product-specific-morphology-iconography-or-spatial-structure',
+      ],
+      paletteExplorationRule: 'Use a visually exploratory product-derived palette while preserving WCAG contrast and status clarity; do not use readability as an excuse for cream, slate, monochrome, or gradient defaults.',
+      backgroundPatternRule: 'Lines, grids, scanlines, noise, glows, blobs, logos, and geometric decoration must serve a named product function such as alignment, measurement, navigation, crop guidance, timeline reading, status, or motion continuity.',
+      reviewQuestion: 'What at-a-glance visual evidence proves this screen belongs to this product and not a generic AI-generated template?',
+      blockingByDefault: true,
+    },
     libraryResearchStatus: 'pending-verification',
     libraryDecisions: [
       {
@@ -502,6 +516,11 @@ function buildDesignIntentContractObject({
         'unresearched-library-or-framework-choice',
         'missing-conceptual-anchor-without-external-research',
         'visual-decisions-not-derived-from-conceptual-anchor',
+        'ai-safe-ui-template-look',
+        'interchangeable-product-renaming-test-fails',
+        'decorative-grid-or-glow-wallpaper-without-product-function',
+        'safe-cream-slate-or-monochrome-palette-used-as-readability-excuse',
+        'generic-abstract-logo-or-iconography',
         'timid-anchor-that-renames-dashboard-or-admin-shell',
         'motion-suppressed-without-accessibility-or-performance-reason',
         'scale-only-responsive-layout',
@@ -512,6 +531,9 @@ function buildDesignIntentContractObject({
         'single-cohesive-conceptual-anchor',
         'high-variance-candidate-selection',
         'context-derived-visual-direction',
+        'three-at-a-glance-product-specific-signals',
+        'visually-exploratory-accessible-palette-derived-from-product',
+        'background-or-geometry-serves-product-function',
         'responsive-recomposition-by-task-priority',
         'purposeful-motion-with-reduced-motion-path',
       ],
@@ -546,6 +568,7 @@ function buildDesignIntentContractObject({
     },
     experiencePrinciples: [
       'Design must feel project-specific, not interchangeable with generic SaaS templates.',
+      'Readable UI must still avoid AI-safe template look; safety is not a substitute for authored visual direction.',
       '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.',
@@ -557,6 +580,11 @@ function buildDesignIntentContractObject({
       'offline-prescribed-style-used-as-final-direction',
       'missing-conceptual-anchor-without-external-research',
       'visual-decisions-not-derived-from-conceptual-anchor',
+      'ai-safe-ui-template-look',
+      'interchangeable-product-renaming-test-fails',
+      'decorative-grid-or-glow-wallpaper-without-product-function',
+      'safe-cream-slate-or-monochrome-palette-used-as-readability-excuse',
+      'generic-abstract-logo-or-iconography',
       'timid-anchor-that-renames-dashboard-or-admin-shell',
       'motion-suppressed-without-accessibility-or-performance-reason',
       'scale-only-responsive-layout',
@@ -586,6 +614,10 @@ function buildDesignIntentContractObject({
       genericityAutoFail: true,
       requireSignatureMove: true,
       rejectTemplateNeutralLayout: true,
+      requireAiSafeUiAudit: true,
+      rejectAiSafeUiTemplateLook: true,
+      requireThreeProductSpecificSignals: true,
+      rejectDecorativeBackgroundPatternsWithoutProductFunction: true,
     },
     requiredDesignSections: DESIGN_REQUIRED_SECTIONS,
     implementation: {
@@ -893,6 +925,36 @@ export function validateDesignIntentContract(designIntentContract) {
     }
   }
 
+  if (!designIntentContract.aiSafeUiAudit || typeof designIntentContract.aiSafeUiAudit !== 'object') {
+    validationErrors.push('designIntent.aiSafeUiAudit must exist.');
+  } else {
+    const aiSafeUiAudit = designIntentContract.aiSafeUiAudit;
+    if (aiSafeUiAudit.status !== 'agent-must-complete-before-ui-implementation') {
+      validationErrors.push('designIntent.aiSafeUiAudit.status must require completion before UI implementation.');
+    }
+    if (!String(aiSafeUiAudit.failureDefinition || '').includes('AI-safe')) {
+      validationErrors.push('designIntent.aiSafeUiAudit.failureDefinition must define AI-safe UI drift.');
+    }
+    if (!String(aiSafeUiAudit.interchangeabilityTest || '').includes('renamed')) {
+      validationErrors.push('designIntent.aiSafeUiAudit.interchangeabilityTest must include the rename/interchangeability test.');
+    }
+    if (!Array.isArray(aiSafeUiAudit.requiredProductSpecificSignals) || aiSafeUiAudit.requiredProductSpecificSignals.length < 3) {
+      validationErrors.push('designIntent.aiSafeUiAudit.requiredProductSpecificSignals must list at least three product-specific signals.');
+    }
+    if (!String(aiSafeUiAudit.paletteExplorationRule || '').trim()) {
+      validationErrors.push('designIntent.aiSafeUiAudit.paletteExplorationRule must be a non-empty string.');
+    }
+    if (!String(aiSafeUiAudit.backgroundPatternRule || '').trim()) {
+      validationErrors.push('designIntent.aiSafeUiAudit.backgroundPatternRule must be a non-empty string.');
+    }
+    if (!String(aiSafeUiAudit.reviewQuestion || '').trim()) {
+      validationErrors.push('designIntent.aiSafeUiAudit.reviewQuestion must be a non-empty string.');
+    }
+    if (aiSafeUiAudit.blockingByDefault !== true) {
+      validationErrors.push('designIntent.aiSafeUiAudit.blockingByDefault must equal true.');
+    }
+  }
+
   if (!designIntentContract.tokenSystem || typeof designIntentContract.tokenSystem !== 'object') {
     validationErrors.push('designIntent.tokenSystem must exist.');
   } else {
@@ -1261,9 +1323,28 @@ export function validateDesignIntentContract(designIntentContract) {
     }
     if (!Array.isArray(designIntentContract.reviewRubric.genericitySignals) || designIntentContract.reviewRubric.genericitySignals.length < 3) {
       validationErrors.push('designIntent.reviewRubric.genericitySignals must list common genericity drift signals.');
+    } else {
+      for (const requiredSignal of [
+        'ai-safe-ui-template-look',
+        'interchangeable-product-renaming-test-fails',
+        'decorative-grid-or-glow-wallpaper-without-product-function',
+      ]) {
+        if (!designIntentContract.reviewRubric.genericitySignals.includes(requiredSignal)) {
+          validationErrors.push(`designIntent.reviewRubric.genericitySignals must include "${requiredSignal}".`);
+        }
+      }
     }
     if (!Array.isArray(designIntentContract.reviewRubric.validBoldSignals) || designIntentContract.reviewRubric.validBoldSignals.length < 3) {
       validationErrors.push('designIntent.reviewRubric.validBoldSignals must list legitimate authored signals.');
+    } else {
+      for (const requiredSignal of [
+        'three-at-a-glance-product-specific-signals',
+        'visually-exploratory-accessible-palette-derived-from-product',
+      ]) {
+        if (!designIntentContract.reviewRubric.validBoldSignals.includes(requiredSignal)) {
+          validationErrors.push(`designIntent.reviewRubric.validBoldSignals must include "${requiredSignal}".`);
+        }
+      }
     }
     if (!designIntentContract.reviewRubric.reportingRules || typeof designIntentContract.reviewRubric.reportingRules !== 'object') {
       validationErrors.push('designIntent.reviewRubric.reportingRules must exist.');
@@ -1292,6 +1373,16 @@ export function validateDesignIntentContract(designIntentContract) {
 
   if (!Array.isArray(designIntentContract.forbiddenPatterns) || designIntentContract.forbiddenPatterns.length < 4) {
     validationErrors.push('designIntent.forbiddenPatterns must list concrete anti-generic patterns.');
+  } else {
+    for (const requiredPattern of [
+      'ai-safe-ui-template-look',
+      'interchangeable-product-renaming-test-fails',
+      'decorative-grid-or-glow-wallpaper-without-product-function',
+    ]) {
+      if (!designIntentContract.forbiddenPatterns.includes(requiredPattern)) {
+        validationErrors.push(`designIntent.forbiddenPatterns must include "${requiredPattern}".`);
+      }
+    }
   }
 
   return validationErrors;

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

@@ -126,25 +126,26 @@ export function buildDesignBootstrapPrompt({
     '6. antiAdjectives',
     '7. visualDirection',
     '8. derivedTokenLogic',
-    '9. libraryResearchStatus',
-    '10. libraryDecisions',
-    '11. mathSystems',
-    '12. tokenSystem',
-    '13. colorTruth',
-    '14. crossViewportAdaptation',
-    '15. motionSystem',
-    '16. componentMorphology',
-    '17. accessibilityPolicy',
-    '18. designExecutionPolicy',
-    '19. designExecutionHandoff',
-    '20. reviewRubric',
-    '21. contextHygiene',
-    '22. experiencePrinciples',
-    '23. forbiddenPatterns',
-    '24. validationHints',
-    '25. requiredDesignSections',
-    '26. implementation',
-    '27. repoEvidence when onboarding or detector evidence exists',
+    '9. aiSafeUiAudit',
+    '10. libraryResearchStatus',
+    '11. libraryDecisions',
+    '12. mathSystems',
+    '13. tokenSystem',
+    '14. colorTruth',
+    '15. crossViewportAdaptation',
+    '16. motionSystem',
+    '17. componentMorphology',
+    '18. accessibilityPolicy',
+    '19. designExecutionPolicy',
+    '20. designExecutionHandoff',
+    '21. reviewRubric',
+    '22. contextHygiene',
+    '23. experiencePrinciples',
+    '24. forbiddenPatterns',
+    '25. validationHints',
+    '26. requiredDesignSections',
+    '27. implementation',
+    '28. repoEvidence when onboarding or detector evidence exists',
     '',
     '## Hard Rules',
     '1. No copy-paste from external style guides.',
@@ -171,6 +172,10 @@ export function buildDesignBootstrapPrompt({
     '22. Treat prior website memory, unrelated project aesthetics, and remembered screenshots as tainted context unless the user explicitly approves continuity.',
     '23. Design continuity is opt-in. If no approved continuity exists, synthesize from the current repo evidence, current brief, and current project docs only.',
     '24. Make at least one memorable visual bet so the resulting system is recognizable and not template-neutral.',
+    '24a. Do not ship AI-safe UI: predictable card stacks, rounded template panels, generic abstract logos, decorative grid wallpaper, beige or slate safety palettes, soft glow backgrounds, or first-output composition with only local copy swapped in are review findings.',
+    '24b. New screens and broad redesigns must expose at least three at-a-glance product-specific signals and pass the rename test: if the UI can be renamed to another product category without changing composition, palette, iconography, and motion language, revise it before coding.',
+    '24c. Background lines, grids, scanlines, noise, glows, blobs, logos, and geometric decoration must serve a named product function such as alignment, measurement, navigation, crop guidance, timeline reading, status, or motion continuity.',
+    '24d. Use visually exploratory, product-derived palettes while preserving WCAG contrast and status clarity; readability must not become an excuse for cream, slate, monochrome, or gradient defaults.',
     '25. Define a stable review rubric for distinctiveness, contract fidelity, visual consistency, heuristic UX quality, and motion discipline.',
     '26. Genericity findings must name the actual drift signal. Do not label something generic without explaining the anti-pattern or rubric dimension.',
     '27. Review rubric must support automatic genericity failure when named drift signals dominate a redesign or new UI surface.',

package/package.json

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

package/scripts/validate/config.mjs

@@ -320,6 +320,10 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'source of truth',
       'research current official docs',
       'motionPaletteDecision',
+      'AI-safe UI',
+      'visually exploratory, product-derived palettes',
+      'decorative grid wallpaper',
+      '`aiSafeUiAudit`',
       'product categories are heuristics',
       'Responsive design means recomposition, not resizing.',
       'agent-chosen visual direction',
@@ -379,6 +383,11 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'structure-first-scaffold',
       'colorTruth',
       'motionPaletteDecision',
+      'aiSafeUiAudit',
+      'ai-safe-ui-template-look',
+      'interchangeable-product-renaming-test-fails',
+      'decorative-grid-or-glow-wallpaper-without-product-function',
+      'requireAiSafeUiAudit',
       'forbidAutopilotPalettesWithoutEvidence',
       'rolesAreMinimumScaffold',
       'crossViewportAdaptation',