@ryuenn3123/agentic-senior-core 3.0.28 → 3.0.29

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

@@ -54,6 +54,32 @@ Write the chosen anchor into `docs/design-intent.json` as `conceptualAnchor`, in
 
 Motion is not a garnish. Default to a rich motion plan: fluid transitions, spatial reveals, scroll choreography, micro-interactions, and modern motion libraries are expected when they strengthen the anchor and product experience. Keep reduced-motion fallbacks instead of suppressing motion, and solve performance deliberately instead of using safety language as a reason to stay static.
 
+## Token Derivation Audit
+
+Before implementation, `docs/design-intent.json` must include top-level `derivedTokenLogic` with `anchorReference`, `colorDerivationSource`, `spacingDerivationSource`, `typographyDerivationSource`, `motionDerivationSource`, and `validationRule`.
+
+After writing `docs/design-intent.json`, audit the token plan:
+- Why these colors instead of another palette? Answer in one sentence that references the anchorReference.
+- Why this spacing rhythm? Answer in one sentence that references the anchorReference.
+- Why this motion timing and easing? Answer in one sentence that references the anchorReference.
+
+If the answer is "looks good", "common practice", "modern default", "Tailwind default", or a generic framework habit, the token is wrong. Derive it again from the chosen anchor before writing UI code.
+
+## Library Research Protocol
+
+If web search is available:
+- Research current official docs for each library, framework API, animation package, scroll tool, 3D/canvas helper, charting tool, icon package, or UI primitive claim.
+- Record source URL, fetched date, stable compatible version, purpose, risk, and fallback in `docs/design-intent.json`.
+- Set `libraryResearchStatus` to `verified` only when each external library decision has current official evidence.
+
+If web search is unavailable or fails:
+- Do not hallucinate dependency APIs, package names, versions, or imports.
+- Write `LIBRARY_TO_VERIFY: [name] - requires live research before implementation` in the design notes.
+- Use only native CSS, browser APIs, or already-present project dependencies you can verify from local repo files.
+- Set `libraryResearchStatus` to `pending-verification` and give every `libraryDecisions[]` entry a `fallbackIfUnavailable`.
+
+Do not write imports from a new library until that library decision is verified or the user explicitly accepts a pending verification blocker.
+
 ## 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.
@@ -117,6 +143,8 @@ 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
+- `derivedTokenLogic` with exact `anchorReference` traceability for color, spacing, typography, and motion tokens
+- `libraryResearchStatus` plus `libraryDecisions[]` with verified source metadata or explicit native/project-local fallbacks
 - 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

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

@@ -60,8 +60,15 @@ Do not use this file to teach generic frontend basics the model already knows.
 - Reject anchors that can only be described with generic quality words such as "modern", "clean", "premium", "expressive", "minimal", or "bold"; the anchor must name a specific material, instrument, artifact class, architectural system, editorial genre, cinematic behavior, exhibition system, scientific apparatus, or industrial mechanism.
 - 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.
+- Token choices must trace to `docs/design-intent.json` `derivedTokenLogic.anchorReference`. A color, spacing, typography, or motion token that cannot be explained from the anchor is invalid.
 - Default to an expressive motion plan derived from the anchor. Use spatial transitions, micro-interactions, scroll choreography, and modern animation libraries when they improve the experience; include reduced-motion and performance safeguards without using them as an excuse for a static UI.
 
+## Library Research Boundary
+
+- New UI, animation, scroll, 3D, canvas, charting, icon, styling, or primitive libraries require current official-doc verification before imports are written.
+- If live research is unavailable, mark `libraryResearchStatus` as `pending-verification`, record the library as `LIBRARY_TO_VERIFY`, and use native CSS, browser APIs, or already-present project dependencies until verification is possible.
+- Each `libraryDecisions[]` entry must have either verification metadata or a concrete `fallbackIfUnavailable`.
+
 ## 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-25T11:40:57.699Z",
+  "generatedAt": "2026-04-25T11:56:18.296Z",
   "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.28
+Generated by Agentic-Senior-Core CLI v3.0.29
 Timestamp: 2026-04-24T06:02:48.303Z
 Selected policy file: .agent-context/policies/llm-judge-threshold.json
 

package/.gemini/instructions.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: f11969bd96625ecf86c6d02630aa485cd54ead44544f15daf525b72bfc38653f
+Canonical Snapshot SHA256: 5c955eab4c644e7139c0c5a5609ea9af7d47fdc8e69617f407af01ccc8c64e43
 
 Canonical policy source: [.instructions.md](../.instructions.md).
 

package/.github/copilot-instructions.md

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

package/.instructions.md

@@ -185,8 +185,9 @@ Use available MCP tools when you need validation, linting, or test execution.
 2. Read `.agent-context/rules/frontend-architecture.md`.
 3. Read UI-relevant repository evidence from `.agent-context/state/onboarding-report.json`, current UI code, and `docs/*`.
 4. Before UI implementation, record a concrete creative commitment in the design contract: one specific real-world anchor reference, one signature motion behavior, and one typographic decision with meaningful role contrast.
-5. Generate or refine `docs/DESIGN.md` plus `docs/design-intent.json` before UI implementation.
-6. Keep context isolated and do not eagerly load unrelated backend-only rules unless the task explicitly touches those boundaries.
+5. Ensure `docs/design-intent.json` includes `conceptualAnchor.anchorReference`, top-level `derivedTokenLogic`, `libraryResearchStatus`, and `libraryDecisions[]` before UI code.
+6. Generate or refine `docs/DESIGN.md` plus `docs/design-intent.json` before UI implementation.
+7. Keep context isolated and do not eagerly load unrelated backend-only rules unless the task explicitly touches those boundaries.
 
 ---
 

package/.windsurfrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v3.0.28
+Generated by Agentic-Senior-Core CLI v3.0.29
 Timestamp: 2026-04-24T06:02:48.303Z
 Selected policy file: .agent-context/policies/llm-judge-threshold.json
 

package/AGENTS.md

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

package/README.md

@@ -10,15 +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.28 (2026-04-25).
-
-Highlights in 3.0.28:
-- Memory continuity now requires agents to refresh `.agent-context/state/active-memory.json` directly at completion boundaries when material project progress happened.
-- UI design governance now forces an upfront creative commitment: a specific real-world anchor reference, signature motion, and typographic decision before compliance review or implementation.
-- Token optimization now exposes an output folding strategy that preserves failures, file/line details, and actionable warnings while folding repetitive shell noise.
-- UI design guidance now treats expressive motion as a first-class default for modern interfaces instead of letting safety wording become an excuse for static screens.
-- Agents must use live/current-year research for ecosystem, framework, dependency, Docker, and modern UI/library claims instead of offline repository guesses.
-- Frontend guidance rejects safe dashboard/admin-panel defaults and requires responsive recomposition.
+Latest release: 3.0.29 (2026-04-25).
+
+Highlights in 3.0.29:
+- UI design contracts now require deterministic `anchorReference` traceability through `derivedTokenLogic` before implementation.
+- Compiled UI context can surface a top-of-file anchor commitment header from `docs/design-intent.json` so the creative direction is not buried under governance.
+- Library decisions now must be verified against current official docs or marked `pending-verification` with native/project-local fallbacks.
+- Release gate now validates the design-intent seed for token derivation and library verification completeness.
 
 </div>
 

package/lib/cli/compiler.mjs

@@ -26,6 +26,75 @@ import {
   buildMemoryContinuityGuidanceBlock,
 } from './memory-continuity.mjs';
 
+function toSingleLine(value, fallbackValue) {
+  const normalizedValue = String(value || '').replace(/\s+/g, ' ').trim();
+  return normalizedValue || fallbackValue;
+}
+
+async function readDesignIntentIfExists(targetDirectoryPath) {
+  const designIntentPath = path.join(targetDirectoryPath, 'docs', 'design-intent.json');
+  if (!(await pathExists(designIntentPath))) {
+    return null;
+  }
+
+  try {
+    return JSON.parse(await fs.readFile(designIntentPath, 'utf8'));
+  } catch {
+    return {
+      parseError: true,
+    };
+  }
+}
+
+function buildAnchorCommitmentHeader(designIntent) {
+  if (!designIntent || typeof designIntent !== 'object') {
+    return null;
+  }
+
+  if (designIntent.parseError) {
+    return [
+      '## [UI TASK ANCHOR - READ FIRST]',
+      'Source: docs/design-intent.json',
+      'Status: design-intent.json could not be parsed.',
+      'Required action: fix docs/design-intent.json before UI implementation so the creative commitment can be loaded.',
+    ].join('\n');
+  }
+
+  const conceptualAnchor = designIntent.conceptualAnchor || {};
+  const derivedTokenLogic = designIntent.derivedTokenLogic || {};
+  const creativeCommitment = designIntent.designExecutionHandoff?.creativeCommitment || {};
+  const anchorReference = conceptualAnchor.anchorReference || derivedTokenLogic.anchorReference;
+  const conceptualAnchorName = conceptualAnchor.name || anchorReference;
+  const signatureMove = conceptualAnchor.signatureMove
+    || designIntent.designExecutionHandoff?.signatureMoveRationale;
+  const signatureMotion = conceptualAnchor.signatureMotion
+    || creativeCommitment.signatureMotion
+    || derivedTokenLogic.motionDerivationSource;
+  const typographicDecision = conceptualAnchor.typographicDecision
+    || creativeCommitment.typographicDecision
+    || derivedTokenLogic.typographyDerivationSource;
+
+  if (!conceptualAnchorName && !anchorReference) {
+    return [
+      '## [UI TASK ANCHOR - READ FIRST]',
+      'Source: docs/design-intent.json',
+      'Status: Creative commitment is missing.',
+      'Required action: define conceptualAnchor.anchorReference, a concrete real-world anchor, signature motion, typographic decision, derivedTokenLogic, and libraryDecisions before UI implementation.',
+    ].join('\n');
+  }
+
+  return [
+    '## [UI TASK ANCHOR - READ FIRST]',
+    'Source: docs/design-intent.json',
+    `Conceptual Anchor: ${toSingleLine(conceptualAnchorName, 'MISSING - complete Creative Commitment Gate before UI implementation')}`,
+    `Anchor Reference: ${toSingleLine(anchorReference, 'MISSING - required for deterministic token validation')}`,
+    `Signature Move: ${toSingleLine(signatureMove, 'MISSING - define one concrete authored move before UI implementation')}`,
+    `Motion Signature: ${toSingleLine(signatureMotion, 'MISSING - define timing/easing/choreography before UI implementation')}`,
+    `Typographic Decision: ${toSingleLine(typographicDecision, 'MISSING - define role contrast before UI implementation')}`,
+    'If the UI output does not reflect these lines, stop and revise the design contract before continuing.',
+  ].join('\n');
+}
+
 export async function writeSelectedPolicy(targetDirectoryPath, selectedProfileName) {
   const policyFilePath = path.join(targetDirectoryPath, '.agent-context', 'policies', POLICY_FILE_NAME);
   const parsedPolicy = JSON.parse(await fs.readFile(policyFilePath, 'utf8'));
@@ -480,6 +549,12 @@ export async function buildCompiledRulesContent({
     );
   }
 
+  const designIntent = await readDesignIntentIfExists(resolvedTargetDirectoryPath);
+  const anchorCommitmentHeader = buildAnchorCommitmentHeader(designIntent);
+  if (anchorCommitmentHeader) {
+    contextBlocks.unshift(anchorCommitmentHeader);
+  }
+
   return [
     '# AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET',
     '',

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

@@ -136,6 +136,7 @@ function buildDesignIntentContractObject({
     conceptualAnchor: {
       mode: 'required-when-no-external-research',
       seedMode: 'selection-policy-only',
+      anchorReference: 'agent-defined-anchor-reference',
       requiresAgentSelectionBeforeUiImplementation: true,
       userResearchAbsencePolicy: {
         userSuppliedResearchOnly: true,
@@ -193,6 +194,7 @@ function buildDesignIntentContractObject({
       finalAnchorContract: {
         requiredFields: [
           'name',
+          'anchorReference',
           'agentResearchMode',
           'sourceDomain',
           'specificReferencePoint',
@@ -214,6 +216,25 @@ function buildDesignIntentContractObject({
         ],
       },
     },
+    derivedTokenLogic: {
+      anchorReference: 'agent-defined-anchor-reference',
+      colorDerivationSource: 'Agent must explain how semantic color roles derive from the chosen anchorReference; default blue or generic SaaS palettes are invalid without anchor evidence.',
+      spacingDerivationSource: 'Agent must explain how base grid, rhythm, density, and spacing exceptions derive from the chosen anchorReference.',
+      typographyDerivationSource: 'Agent must explain how display, body, metadata, and data typography roles derive from the chosen anchorReference.',
+      motionDerivationSource: 'Agent must explain how duration, easing, choreography, and reduced-motion alternatives derive from the chosen anchorReference.',
+      validationRule: 'Every primitive, semantic, component, typography, spacing, and motion token must trace back to anchorReference; if a token cannot be explained from the anchor, revise the token.',
+    },
+    libraryResearchStatus: 'pending-verification',
+    libraryDecisions: [
+      {
+        library: 'agent-defined-or-none',
+        purpose: 'Agent must verify any UI, animation, scroll, 3D, canvas, chart, icon, or styling library against current official docs before implementation.',
+        verifiedAt: null,
+        sourceUrl: null,
+        stableVersion: null,
+        fallbackIfUnavailable: 'Use native CSS, browser APIs, or existing project dependencies until live verification is available.',
+      },
+    ],
     mathSystems: {
       typographyScaleRatio: inferredKeywords.typographyScaleRatio,
       baseGridUnit: inferredKeywords.baseGridUnit,
@@ -581,6 +602,81 @@ function buildDesignIntentContractObject({
   };
 }
 
+function hasNonEmptyString(value) {
+  return typeof value === 'string' && value.trim().length > 0;
+}
+
+export function validateDesignContractCompleteness(designIntentContract) {
+  const validationIssues = [];
+  const conceptualAnchor = designIntentContract?.conceptualAnchor;
+  const derivedTokenLogic = designIntentContract?.derivedTokenLogic;
+  const libraryDecisions = designIntentContract?.libraryDecisions;
+
+  const anchorReference = conceptualAnchor?.anchorReference || derivedTokenLogic?.anchorReference;
+  if (!hasNonEmptyString(anchorReference)) {
+    validationIssues.push('designIntent.conceptualAnchor.anchorReference must be a stable non-empty ID for deterministic validation.');
+  }
+
+  if (!derivedTokenLogic || typeof derivedTokenLogic !== 'object') {
+    validationIssues.push('designIntent.derivedTokenLogic must exist.');
+  } else {
+    if (derivedTokenLogic.anchorReference !== anchorReference) {
+      validationIssues.push('designIntent.derivedTokenLogic.anchorReference must exactly match designIntent.conceptualAnchor.anchorReference.');
+    }
+
+    for (const requiredFieldName of [
+      'colorDerivationSource',
+      'spacingDerivationSource',
+      'typographyDerivationSource',
+      'motionDerivationSource',
+      'validationRule',
+    ]) {
+      if (!hasNonEmptyString(derivedTokenLogic[requiredFieldName])) {
+        validationIssues.push(`designIntent.derivedTokenLogic.${requiredFieldName} must be a non-empty string.`);
+      }
+    }
+
+    if (
+      hasNonEmptyString(derivedTokenLogic.validationRule)
+      && !derivedTokenLogic.validationRule.includes('anchorReference')
+    ) {
+      validationIssues.push('designIntent.derivedTokenLogic.validationRule must require traceability to anchorReference.');
+    }
+  }
+
+  if (!['verified', 'pending-verification', 'no-external-library-needed'].includes(designIntentContract?.libraryResearchStatus)) {
+    validationIssues.push('designIntent.libraryResearchStatus must be verified, pending-verification, or no-external-library-needed.');
+  }
+
+  if (!Array.isArray(libraryDecisions)) {
+    validationIssues.push('designIntent.libraryDecisions must be an array.');
+  } else {
+    for (const [libraryIndex, libraryDecision] of libraryDecisions.entries()) {
+      if (!libraryDecision || typeof libraryDecision !== 'object') {
+        validationIssues.push(`designIntent.libraryDecisions[${libraryIndex}] must be an object.`);
+        continue;
+      }
+
+      if (!hasNonEmptyString(libraryDecision.library)) {
+        validationIssues.push(`designIntent.libraryDecisions[${libraryIndex}].library must be a non-empty string.`);
+      }
+      if (!hasNonEmptyString(libraryDecision.purpose)) {
+        validationIssues.push(`designIntent.libraryDecisions[${libraryIndex}].purpose must be a non-empty string.`);
+      }
+
+      const hasVerification = hasNonEmptyString(libraryDecision.verifiedAt)
+        && hasNonEmptyString(libraryDecision.sourceUrl);
+      const hasFallback = hasNonEmptyString(libraryDecision.fallbackIfUnavailable);
+
+      if (!hasVerification && !hasFallback) {
+        validationIssues.push(`designIntent.libraryDecisions[${libraryIndex}] must either record verification source or provide fallbackIfUnavailable.`);
+      }
+    }
+  }
+
+  return validationIssues;
+}
+
 export function validateDesignIntentContract(designIntentContract) {
   const validationErrors = [];
 
@@ -588,6 +684,8 @@ export function validateDesignIntentContract(designIntentContract) {
     return ['Design intent contract must be an object.'];
   }
 
+  validationErrors.push(...validateDesignContractCompleteness(designIntentContract));
+
   if (designIntentContract.mode !== 'dynamic') {
     validationErrors.push('designIntent.mode must equal "dynamic".');
   }
@@ -630,6 +728,9 @@ export function validateDesignIntentContract(designIntentContract) {
     if (conceptualAnchor.requiresAgentSelectionBeforeUiImplementation !== true) {
       validationErrors.push('designIntent.conceptualAnchor.requiresAgentSelectionBeforeUiImplementation must equal true.');
     }
+    if (!hasNonEmptyString(conceptualAnchor.anchorReference)) {
+      validationErrors.push('designIntent.conceptualAnchor.anchorReference must be a stable non-empty ID.');
+    }
     const userResearchAbsencePolicy = conceptualAnchor.userResearchAbsencePolicy;
     if (!userResearchAbsencePolicy || typeof userResearchAbsencePolicy !== 'object') {
       validationErrors.push('designIntent.conceptualAnchor.userResearchAbsencePolicy must exist.');
@@ -673,6 +774,28 @@ export function validateDesignIntentContract(designIntentContract) {
         validationErrors.push('designIntent.conceptualAnchor.candidateSelectionPolicy.outputOnlyChosenAnchor must equal true.');
       }
     }
+    const creativeCommitmentPolicy = conceptualAnchor.creativeCommitmentPolicy;
+    if (!creativeCommitmentPolicy || typeof creativeCommitmentPolicy !== 'object') {
+      validationErrors.push('designIntent.conceptualAnchor.creativeCommitmentPolicy must exist.');
+    } else {
+      if (creativeCommitmentPolicy.requiredBeforeComplianceReview !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.creativeCommitmentPolicy.requiredBeforeComplianceReview must equal true.');
+      }
+      if (creativeCommitmentPolicy.recordInDesignDocs !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.creativeCommitmentPolicy.recordInDesignDocs must equal true.');
+      }
+      if (
+        !Array.isArray(creativeCommitmentPolicy.requiredCommitmentFields)
+        || !creativeCommitmentPolicy.requiredCommitmentFields.includes('specificReferencePoint')
+        || !creativeCommitmentPolicy.requiredCommitmentFields.includes('signatureMotion')
+        || !creativeCommitmentPolicy.requiredCommitmentFields.includes('typographicDecision')
+      ) {
+        validationErrors.push('designIntent.conceptualAnchor.creativeCommitmentPolicy.requiredCommitmentFields must include specificReferencePoint, signatureMotion, and typographicDecision.');
+      }
+      if (creativeCommitmentPolicy.rejectGenericQualityWordsOnly !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.creativeCommitmentPolicy.rejectGenericQualityWordsOnly must equal true.');
+      }
+    }
     if (
       !Array.isArray(conceptualAnchor.forbiddenFinalAnchorTerms)
       || !conceptualAnchor.forbiddenFinalAnchorTerms.includes('dashboard')
@@ -720,13 +843,17 @@ export function validateDesignIntentContract(designIntentContract) {
     } else {
       if (
         !Array.isArray(finalAnchorContract.requiredFields)
+        || !finalAnchorContract.requiredFields.includes('anchorReference')
         || !finalAnchorContract.requiredFields.includes('agentResearchMode')
+        || !finalAnchorContract.requiredFields.includes('specificReferencePoint')
+        || !finalAnchorContract.requiredFields.includes('signatureMotion')
+        || !finalAnchorContract.requiredFields.includes('typographicDecision')
         || !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.');
+        validationErrors.push('designIntent.conceptualAnchor.finalAnchorContract.requiredFields must require anchorReference, agentResearchMode, specificReferencePoint, signatureMotion, typographicDecision, derivedTokenLogic, visualRiskBudget, motionRiskBudget, and cohesionChecks.');
       }
       if (
         !Array.isArray(finalAnchorContract.derivedTokenLogicAxes)
@@ -968,6 +1095,7 @@ export function validateDesignIntentContract(designIntentContract) {
       'requireContentPriorityMap',
       'requireTaskFlowNarrative',
       'requireSignatureMoveRationale',
+      'requireCreativeCommitmentGate',
       'requireStructuredHandoff',
       'requireRepoEvidenceAlignment',
       'forbidScreenshotDependency',
@@ -1062,6 +1190,25 @@ export function validateDesignIntentContract(designIntentContract) {
     if (!String(designIntentContract.designExecutionHandoff.signatureMoveRationale || '').trim()) {
       validationErrors.push('designIntent.designExecutionHandoff.signatureMoveRationale must explain the chosen authored move.');
     }
+    const creativeCommitment = designIntentContract.designExecutionHandoff.creativeCommitment;
+    if (!creativeCommitment || typeof creativeCommitment !== 'object') {
+      validationErrors.push('designIntent.designExecutionHandoff.creativeCommitment must exist.');
+    } else {
+      if (creativeCommitment.status !== 'agent-must-complete-before-ui-implementation') {
+        validationErrors.push('designIntent.designExecutionHandoff.creativeCommitment.status must equal "agent-must-complete-before-ui-implementation".');
+      }
+      if (
+        !Array.isArray(creativeCommitment.requiredFields)
+        || !creativeCommitment.requiredFields.includes('specificReferencePoint')
+        || !creativeCommitment.requiredFields.includes('signatureMotion')
+        || !creativeCommitment.requiredFields.includes('typographicDecision')
+      ) {
+        validationErrors.push('designIntent.designExecutionHandoff.creativeCommitment.requiredFields must include specificReferencePoint, signatureMotion, and typographicDecision.');
+      }
+      if (!hasNonEmptyString(creativeCommitment.failureMode)) {
+        validationErrors.push('designIntent.designExecutionHandoff.creativeCommitment.failureMode must be a non-empty string.');
+      }
+    }
     const implementationGuardrails = designIntentContract.designExecutionHandoff.implementationGuardrails;
     if (!implementationGuardrails || typeof implementationGuardrails !== 'object') {
       validationErrors.push('designIntent.designExecutionHandoff.implementationGuardrails must exist.');

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

@@ -125,23 +125,26 @@ export function buildDesignBootstrapPrompt({
     '5. brandAdjectives',
     '6. antiAdjectives',
     '7. visualDirection',
-    '8. mathSystems',
-    '9. tokenSystem',
-    '10. colorTruth',
-    '11. crossViewportAdaptation',
-    '12. motionSystem',
-    '13. componentMorphology',
-    '14. accessibilityPolicy',
-    '15. designExecutionPolicy',
-    '16. designExecutionHandoff',
-    '17. reviewRubric',
-    '18. contextHygiene',
-    '19. experiencePrinciples',
-    '20. forbiddenPatterns',
-    '21. validationHints',
-    '22. requiredDesignSections',
-    '23. implementation',
-    '24. repoEvidence when onboarding or detector evidence exists',
+    '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',
     '',
     '## Hard Rules',
     '1. No copy-paste from external style guides.',
@@ -180,7 +183,19 @@ export function buildDesignBootstrapPrompt({
     '34. Before broad compliance review, make a creative commitment and record it in the design contract: one specific real-world anchor reference, one signature motion behavior more specific than smooth transitions, and one typographic decision with meaningful role contrast.',
     '35. 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, its specific reference point, and rationale, and forbid final anchors named dashboard, portal, cards, admin panel, SaaS shell, web app shell, or minimalist interface.',
     '36. Reject anchors that can only be described with generic quality words such as modern, clean, premium, expressive, minimal, or bold. The anchor must name a material, instrument, artifact class, architecture, editorial genre, cinematic behavior, exhibition system, scientific apparatus, or industrial mechanism.',
-    '37. The chosen anchor must drive typography, spacing, density, color behavior, morphology, motion, and responsive composition. Treat expressive motion, spatial transitions, micro-interactions, and modern animation libraries as first-class options; include performance notes and reduced-motion fallbacks instead of suppressing motion to look safe.',
+    '37. The chosen anchor must define a stable conceptualAnchor.anchorReference. derivedTokenLogic.anchorReference must match it exactly so validation does not depend on paraphrased prose.',
+    '38. Fill derivedTokenLogic with color, spacing, typography, and motion derivation sources before UI implementation. If a token cannot be explained from anchorReference, revise the token.',
+    '39. If live web research is unavailable or fails, do not hallucinate dependency APIs, package names, versions, or imports. Set libraryResearchStatus to pending-verification, record LIBRARY_TO_VERIFY notes, and use native CSS, browser APIs, or already-present project dependencies until verification is possible.',
+    '40. Every libraryDecisions entry must either include current official-doc verification metadata or a fallbackIfUnavailable. Do not import a new library without verification or an accepted blocker.',
+    '41. The chosen anchor must drive typography, spacing, density, color behavior, morphology, motion, and responsive composition. Treat expressive motion, spatial transitions, micro-interactions, and modern animation libraries as first-class options; include performance notes and reduced-motion fallbacks instead of suppressing motion to look safe.',
+    '',
+    '## Token Derivation Audit',
+    'Before implementation, docs/design-intent.json must include derivedTokenLogic.anchorReference plus colorDerivationSource, spacingDerivationSource, typographyDerivationSource, motionDerivationSource, and validationRule.',
+    'Every token must be explainable from anchorReference. If the rationale is only looks good, common practice, modern default, or framework default, derive the token again before UI code.',
+    '',
+    '## Library Research Protocol',
+    'If web search is available, verify every new UI, animation, scroll, 3D, canvas, chart, icon, styling, or primitive library against current official docs and record source URL, fetched date, stable compatible version, purpose, risk, and fallback.',
+    'If web search is unavailable or fails, set libraryResearchStatus to pending-verification, record LIBRARY_TO_VERIFY notes, and use native CSS, browser APIs, or already-present project dependencies until verification is possible.',
     '',
     '## Project Inputs',
     `- Project name: ${discoveryAnswers.projectName}`,
@@ -212,7 +227,8 @@ export function buildDesignBootstrapPrompt({
     '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. Record conceptualAnchor.agentResearchMode, specificReferencePoint, signatureMotion, typographicDecision, 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.',
+    '16. Preserve derivedTokenLogic, libraryResearchStatus, and libraryDecisions so token choices and dependency uncertainty stay visible before implementation.',
+    '17. After the contract exists, use it as a first-class source for future UI tasks.',
     '',
   ].join('\n');
 }

package/lib/cli/project-scaffolder.mjs

@@ -22,6 +22,7 @@ export {
 export {
   shouldBootstrapDesignDocument,
   validateDesignIntentContract,
+  validateDesignContractCompleteness,
   buildDesignIntentSeedFromSignals,
 } from './project-scaffolder/design-contract.mjs';
 

package/package.json

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

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

@@ -15,6 +15,10 @@ import {
   VERSION_PATTERN,
 } from './constants.mjs';
 import { pushResult, readText } from './runtime.mjs';
+import {
+  buildDesignIntentSeedFromSignals,
+  validateDesignContractCompleteness,
+} from '../../lib/cli/project-scaffolder.mjs';
 
 export function runStaticReleaseChecks(results, diagnostics) {
   const packageJsonPath = 'package.json';
@@ -66,6 +70,34 @@ export function runStaticReleaseChecks(results, diagnostics) {
     pushResult(results, true, 'roadmap-v18', 'Roadmap includes V1.8 release track');
   }
 
+  try {
+    const designIntentSeed = JSON.parse(buildDesignIntentSeedFromSignals({
+      projectName: 'Release Gate UI Contract',
+      projectDescription: 'Validates deterministic UI design contract completeness before release',
+      primaryDomain: 'Web application',
+      initContext: {
+        stackFileName: 'agent-decision-runtime.md',
+        blueprintFileName: 'agent-decision-architecture.md',
+      },
+      status: 'release-gate-seed-validation',
+    }));
+    const designContractIssues = validateDesignContractCompleteness(designIntentSeed);
+
+    if (designContractIssues.length === 0) {
+      pushResult(results, true, 'ui-design-contract-completeness', 'Design intent seed includes deterministic token derivation and library verification gates');
+    } else {
+      pushResult(
+        results,
+        false,
+        'ui-design-contract-completeness',
+        `Design intent seed completeness issues: ${designContractIssues.join('; ')}`
+      );
+    }
+  } catch (designContractError) {
+    const designContractMessage = designContractError instanceof Error ? designContractError.message : 'Unknown design contract error';
+    pushResult(results, false, 'ui-design-contract-completeness', `Cannot validate design intent seed: ${designContractMessage}`);
+  }
+
   const requiredOperationsFiles = [
     '.agent-context/review-checklists/architecture-review.md',
     'docs/v1.8-operations-playbook.md',