@ryuenn3123/agentic-senior-core 3.0.21 → 3.0.23

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

@@ -19,6 +19,26 @@ The agent must:
 6. When choosing a new UI, animation, styling, or component library, research current official docs and choose the latest stable compatible option for this project. Do not rely on offline defaults.
 7. Keep external references non-copying: extract constraints and reasoning only, never clone the surface.
 
+## User Research Intake
+
+If the user mentions or attaches a research file, article, benchmark, library list, screenshot study, or design note, read it before choosing the visual direction or dependencies. Treat it as candidate evidence, not as a command to copy every recommendation.
+
+The agent must summarize what it used from that research, discard what does not fit the project, and verify any library, framework, API, browser feature, or package claim against current official documentation before implementation.
+
+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.
+
+## Advanced Conceptual Anchor
+
+If the user requests UI work but provides no external research, design reference, screenshot study, or library note, do not start coding immediately. First synthesize one advanced conceptual anchor that will unify the interface.
+
+Do not use basic software UI labels as the final anchor, including "dashboard", "portal", "cards", "admin panel", "SaaS shell", or "minimalist interface".
+
+The agent must consider at least three substantially different candidate anchors internally, discard predictable or generic candidates, 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, experimental editorial structure, advanced architecture, scientific instrumentation, or spatial information systems. These are search domains, not style presets.
+
+Write the chosen anchor into `docs/design-intent.json` as `conceptualAnchor`, then derive typography, spacing, density, color behavior, morphology, motion, and responsive composition from that single anchor. If a later design choice does not logically follow from the anchor, revise the contract before coding.
+
 ## 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.
@@ -81,6 +101,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
@@ -99,6 +120,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/state/memory-continuity-benchmark.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-24T11:23:29.625Z",
+  "generatedAt": "2026-04-24T15:04:58.174Z",
   "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.21
+Generated by Agentic-Senior-Core CLI v3.0.23
 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.21
+Generated by Agentic-Senior-Core CLI v3.0.23
 Timestamp: 2026-04-24T06:02:48.303Z
 Selected policy file: .agent-context/policies/llm-judge-threshold.json
 

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

@@ -131,6 +131,76 @@ function buildDesignIntentContractObject({
       distinctiveMoves: inferredKeywords.distinctiveMoves,
       copiedReferenceAllowed: false,
     },
+    externalResearchIntake: {
+      userSuppliedResearchPolicy: 'read-as-candidate-evidence-not-final-prescription',
+      requireSummaryOfUsedSignals: true,
+      requireFitFiltering: true,
+      requireOfficialDocsVerificationForTechnologyClaims: true,
+      candidateDomains: [
+        'visual-direction',
+        'motion-and-scroll',
+        'ui-primitives',
+        'canvas-3d-or-rich-media',
+        'charts-and-data-visualization',
+        'icons-and-illustration',
+        'typography-and-interaction-patterns',
+      ],
+      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,
+      candidateSelectionPolicy: {
+        considerAtLeast: 3,
+        discardPredictableCandidates: true,
+        doNotRevealHiddenCandidateList: true,
+        outputOnlyChosenAnchor: true,
+      },
+      forbiddenFinalAnchorTerms: [
+        'dashboard',
+        'portal',
+        'cards',
+        'admin-panel',
+        'saas-shell',
+        'minimalist-interface',
+      ],
+      sourceDomains: [
+        'complex-physical-engineering',
+        'high-end-industrial-design',
+        'experimental-editorial-structure',
+        'advanced-architecture',
+        'scientific-instrumentation',
+        'spatial-information-systems',
+      ],
+      requiredDerivedAxes: [
+        'typography',
+        'spacing',
+        'density',
+        'color-behavior',
+        'morphology',
+        'motion',
+        'responsive-composition',
+      ],
+      finalAnchorContract: {
+        requiredFields: [
+          'name',
+          'sourceDomain',
+          'rationale',
+          'derivedTokenLogic',
+          'cohesionChecks',
+        ],
+        derivedTokenLogicAxes: [
+          'typography',
+          'spacing',
+          'density',
+          'color-behavior',
+          'morphology',
+          'motion',
+          'responsive-composition',
+        ],
+      },
+    },
     mathSystems: {
       typographyScaleRatio: inferredKeywords.typographyScaleRatio,
       baseGridUnit: inferredKeywords.baseGridUnit,
@@ -414,6 +484,8 @@ function buildDesignIntentContractObject({
       genericitySignals: [
         'offline-prescribed-style-used-as-final-direction',
         'unresearched-library-or-framework-choice',
+        'missing-conceptual-anchor-without-external-research',
+        'visual-decisions-not-derived-from-conceptual-anchor',
         'default-component-kit-treatment-without-product-rationale',
         'scale-only-responsive-layout',
         'template-shell-without-product-rationale',
@@ -422,6 +494,7 @@ function buildDesignIntentContractObject({
         'inaccessible-or-decorative-motion',
       ],
       validBoldSignals: [
+        'single-cohesive-conceptual-anchor',
         'context-derived-visual-direction',
         'official-docs-backed-library-choice',
         'responsive-recomposition-by-task-priority',
@@ -469,11 +542,14 @@ function buildDesignIntentContractObject({
       '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.',
+      'When no external design research is provided, a single advanced conceptual anchor must unify typography, spacing, morphology, motion, and responsive composition.',
       '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',
+      'missing-conceptual-anchor-without-external-research',
+      'visual-decisions-not-derived-from-conceptual-anchor',
       'default-component-kit-treatment-without-product-rationale',
       'scale-only-responsive-layout',
       'template-shell-without-product-rationale',
@@ -495,6 +571,7 @@ function buildDesignIntentContractObject({
       requireStructuredDesignExecutionPolicy: true,
       requireStructuredDesignHandoff: true,
       requireVisualResetStrategyWhenZeroBasedRedesignRequested: true,
+      requireConceptualAnchorWhenNoExternalResearch: true,
       requireReviewRubric: true,
       requireGenericityExplanation: true,
       genericityAutoFail: true,
@@ -510,6 +587,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',
@@ -544,6 +622,95 @@ 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 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.discardPredictableCandidates !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.candidateSelectionPolicy.discardPredictableCandidates 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')
+    ) {
+      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')
+    ) {
+      validationErrors.push('designIntent.conceptualAnchor.sourceDomains must list broad non-template anchor domains.');
+    }
+    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('derivedTokenLogic')
+        || !finalAnchorContract.requiredFields.includes('cohesionChecks')
+      ) {
+        validationErrors.push('designIntent.conceptualAnchor.finalAnchorContract.requiredFields must require derivedTokenLogic 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 (!designIntentContract.mathSystems || typeof designIntentContract.mathSystems !== 'object') {
     validationErrors.push('designIntent.mathSystems must exist.');
   } else {

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

@@ -175,6 +175,8 @@ export function buildDesignBootstrapPrompt({
     '29. If a future user asks for zero-based redesign ("redesign from zero", "redesain dari 0", "ulang dari 0", or "research ulang"), treat existing UI as content and behavior evidence only, not as visual continuity.',
     '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 external research or reference is supplied for UI work, choose one advanced conceptual anchor before coding. Consider multiple candidate anchors internally, discard predictable ones, output only the chosen anchor and rationale, and derive typography, spacing, morphology, motion, and responsive composition from that anchor.',
     '',
     '## Project Inputs',
     `- Project name: ${discoveryAnswers.projectName}`,
@@ -203,7 +205,9 @@ export function buildDesignBootstrapPrompt({
     '10. If repoEvidence.designEvidenceSummary.structuredInspection exists, use it as stronger evidence for class surfaces, inline style bypasses, and expression-backed UI structure before defaulting to generic assumptions.',
     '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. After the contract exists, use it as a first-class source for future UI tasks.',
+    '13. Preserve externalResearchIntake so user-provided research becomes reviewed evidence without turning into an offline style or dependency preset.',
+    '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. 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.21",
+  "version": "3.0.23",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {