@ryuenn3123/agentic-senior-core 3.0.20 → 3.0.22

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.
+
+## 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.
+
+In reset mode:
+- Existing UI and existing design docs are content, behavior, accessibility, and repo-evidence inputs only. They are not visual continuity sources.
+- Replace or materially rewrite `docs/DESIGN.md` and `docs/design-intent.json` before implementation so the new contract cannot inherit old palette, typography, layout, navigation shape, component morphology, motion signature, or image placement by accident.
+- Define a `visualResetStrategy` that names the old visual DNA being discarded and the new direction being selected from current brief, repo evidence, and live official documentation.
+- The implementation must change composition, hierarchy, palette/typography, motion/interaction, and responsive information architecture. A palette swap, dark-mode flip, or same hero with new colors is failure.
+- Keep product data, copy requirements, routes, accessibility needs, and required local assets intact unless the user explicitly says they may be removed.
+- If a modern UI, animation, scroll, 3D, canvas, chart, or icon library is useful, research current official docs and record the selected library, source URL, fetched date, reason, performance risk, and reduced-motion/accessibility fallback.
+
 ## Design Quality Bar
 
 The UI must feel authored by a strong UI/UX designer, not assembled from default cards and safe framework chrome.

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

@@ -29,6 +29,14 @@ Do not use this file to teach generic frontend basics the model already knows.
 - External references are tainted by default. If the user supplies one, convert only explicit constraints into the current contract and do not compare against or imitate the source surface.
 - If a new UI, animation, styling, or component library is needed, research current official docs and choose the latest stable compatible option for the project.
 
+## Zero-Based Redesign Boundary
+
+- If the user asks for a redesign "from zero" or equivalent reset language, treat existing UI as behavioral/content evidence only, not as visual direction.
+- Do not preserve prior palette, typography, hero composition, navigation placement, component morphology, motion signature, or image framing unless the user explicitly requests continuity.
+- The new UI must materially recompose at least the primary surface, content hierarchy, interaction model, and responsive information architecture.
+- A dark-mode flip, same layout with different colors, or restyled version of the previous hero is not a zero-based redesign.
+- Record the visual reset in `docs/DESIGN.md` and `docs/design-intent.json` before coding.
+
 ## Accessibility Split
 
 - Treat WCAG 2.2 AA as the hard compliance floor.

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

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-24T09:57:54.287Z",
+  "generatedAt": "2026-04-24T11:30:00.104Z",
   "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.20
+Generated by Agentic-Senior-Core CLI v3.0.22
 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.20
+Generated by Agentic-Senior-Core CLI v3.0.22
 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,22 @@ 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',
+    },
     mathSystems: {
       typographyScaleRatio: inferredKeywords.typographyScaleRatio,
       baseGridUnit: inferredKeywords.baseGridUnit,
@@ -237,6 +253,7 @@ function buildDesignIntentContractObject({
       handoffFormatVersion: 'ui-handoff-v1',
       requirePerSurfaceMutationOps: true,
       forbidUniformSiblingSurfaceTreatment: true,
+      zeroBasedRedesignResetsPriorVisualsWhenRequested: true,
       semanticReviewFocus: [
         'distinctiveness-vs-genericity',
         'contract-fidelity',
@@ -362,6 +379,17 @@ function buildDesignIntentContractObject({
         '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.',
       ],
+      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'],
+      },
       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.',
       implementationGuardrails: {
         requireBuildFromHandoff: true,
@@ -405,6 +433,8 @@ function buildDesignIntentContractObject({
         'default-component-kit-treatment-without-product-rationale',
         '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: [
@@ -443,6 +473,8 @@ function buildDesignIntentContractObject({
         '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: [
@@ -453,6 +485,7 @@ 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 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',
@@ -460,6 +493,8 @@ function buildDesignIntentContractObject({
       'default-component-kit-treatment-without-product-rationale',
       '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',
     ],
     validationHints: {
@@ -475,6 +510,7 @@ function buildDesignIntentContractObject({
       requireWcagHardFloor: true,
       requireStructuredDesignExecutionPolicy: true,
       requireStructuredDesignHandoff: true,
+      requireVisualResetStrategyWhenZeroBasedRedesignRequested: true,
       requireReviewRubric: true,
       requireGenericityExplanation: true,
       genericityAutoFail: true,
@@ -752,6 +788,7 @@ export function validateDesignIntentContract(designIntentContract) {
       'forbidScreenshotDependency',
       'requirePerSurfaceMutationOps',
       'forbidUniformSiblingSurfaceTreatment',
+      'zeroBasedRedesignResetsPriorVisualsWhenRequested',
     ]) {
       if (designIntentContract.designExecutionPolicy[requiredFlagName] !== true) {
         validationErrors.push(`designIntent.designExecutionPolicy.${requiredFlagName} must equal true.`);

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

@@ -172,6 +172,10 @@ export function buildDesignBootstrapPrompt({
     '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.',
     '28. Separate taste from failure. Bold direction is allowed when it still follows the contract, serves the product, and stays accessible.',
+    '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.',
     '',
     '## Project Inputs',
     `- Project name: ${discoveryAnswers.projectName}`,
@@ -199,7 +203,9 @@ export function buildDesignBootstrapPrompt({
     '9. Preserve repoEvidence.designEvidenceSummary when onboarding or detector evidence exists instead of discarding it.',
     '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. After the contract exists, use it as a first-class source for future UI tasks.',
+    '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.',
     '',
   ].join('\n');
 }

package/package.json

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

package/scripts/release-gate/audit-checks.mjs

@@ -361,13 +361,28 @@ export function runAuditReleaseChecks(results, diagnostics) {
       'ui-design-judge-advisory',
       `ui-design-judge executed (passed=${uiDesignJudgeExecution.report.passed}, skipped=${uiDesignJudgeExecution.report.skipped}, mode=${uiDesignJudgeExecution.report.mode})`
     );
+
+    pushResult(
+      results,
+      uiDesignJudgeExecution.report.passed === true,
+      'ui-design-judge-contract-hard-rule',
+      uiDesignJudgeExecution.report.passed === true
+        ? 'UI design judge contract hard-rule passed or no blocking auto-fail was triggered'
+        : `UI design judge reported blocking design drift: ${Array.isArray(uiDesignJudgeExecution.report.findings)
+          ? uiDesignJudgeExecution.report.findings
+            .filter((finding) => finding?.blockingRecommended === true)
+            .map((finding) => `${finding.area}: ${finding.problem}`)
+            .join('; ') || 'blocking drift reported without detailed findings'
+          : 'blocking drift reported without detailed findings'}`
+    );
+
     pushResult(
       results,
-      uiDesignJudgeExecution.report.advisoryOnly === true,
+      uiDesignJudgeExecution.report.advisoryOnly === true || uiDesignJudgeExecution.report.autoFailTriggered === true,
       'ui-design-judge-non-blocking-policy',
       uiDesignJudgeExecution.report.advisoryOnly === true
-        ? 'UI design judge remains advisory by default and does not hard-block release gate'
-        : 'UI design judge unexpectedly ran in blocking mode during release gate'
+        ? 'UI design judge remains advisory by default when no auto-fail drift is detected'
+        : 'UI design judge entered blocking-recommended mode because genericityAutoFail detected named drift'
     );
 
     const hasStructuredDesignDiagnostics = typeof uiDesignJudgeExecution.report?.summary?.designExecutionSignalCount === 'number'

package/scripts/ui-design-judge/prompting.mjs

@@ -19,7 +19,7 @@ export function buildSystemPrompt() {
     'Treat WCAG 2.2 AA failures as hard accessibility drift.',
     'Treat APCA as advisory perceptual tuning only. Do not set blocking solely because APCA indicates a stronger readability adjustment when WCAG hard requirements still pass.',
     'Check focus visibility, focus appearance, target size, keyboard access, accessible authentication, and status or dynamic state access when the diff touches those surfaces.',
-    'This audit always runs in advisory mode for this repository workflow.',
+    'Check design-intent.json for reviewRubric.genericityAutoFail. If true and forbiddenPatterns or genericitySignals are detected in the changed UI, this audit is no longer merely advisory for that finding: set blockingRecommended to true, mark the relevant rubric dimension as blocking, and require rebuilding the drifted surface instead of polishing it.',
     'Focus on color intent, typographic hierarchy, responsive re-layout, purposeful motion, component morphology across states, interaction behavior, and genericity drift.',
     'If you call something generic, explain the specific genericity signal or anti-pattern that caused that judgment.',
     'Separate taste from failure. A bold design that follows the contract must not be penalized only because it is unusual.',

package/scripts/ui-design-judge/reporting.mjs

@@ -107,6 +107,7 @@ export function buildReport(partialReport) {
     mode: 'advisory',
     advisoryOnly: true,
     passed: true,
+    autoFailTriggered: false,
     skipped: false,
     skipReason: null,
     provider: 'none',

package/scripts/ui-design-judge.mjs

@@ -7,9 +7,10 @@
  * Advisory-default UI design contract judge.
  *
  * Repo-internal workflow audit; no user-facing runtime modes.
- * Stays advisory by default for this repository workflow, but genericityAutoFail
- * must escalate findings into blocking required actions when named drift signals
- * or forbidden patterns are detected.
+ * Stays advisory when no provider is configured or no auto-fail signal is found.
+ * reviewRubric.genericityAutoFail escalates named drift signals and forbidden
+ * patterns into blocking findings and blocking required actions when provider
+ * evidence is available.
  *
  * Validation anchors for repo governance:
  * - Do not reward generic SaaS defaults or popular template patterns.
@@ -269,7 +270,10 @@ async function main() {
   emitMachineReadableReport(buildReport({
     provider: selectedProvider.providerName,
     contractPresent: true,
-    passed: true,
+    mode: autoFailResolution.autoFailTriggered ? 'blocking-recommended' : 'advisory',
+    advisoryOnly: !autoFailResolution.autoFailTriggered,
+    passed: !autoFailResolution.autoFailTriggered,
+    autoFailTriggered: autoFailResolution.autoFailTriggered,
     malformedVerdict: malformed,
     summary: {
       changedUiFileCount: changedUiFiles.length,