@ryuenn3123/agentic-senior-core 3.0.27 → 3.0.29

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

@@ -19,6 +19,17 @@ 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.
 
+## Creative Commitment Gate
+
+Before broad compliance review or UI implementation, commit to one concrete creative direction and record it in `docs/DESIGN.md` plus `docs/design-intent.json`. This commitment must include:
+- one conceptual anchor from a specific physical, editorial, architectural, cinematic, industrial, scientific, or interaction domain
+- one signature motion behavior that is more specific than "smooth transitions"
+- one typographic decision that creates meaningful role contrast instead of a uniform safe type system
+
+The anchor must name at least one specific real-world reference point such as a material, instrument, artifact class, architectural system, editorial genre, cinematic interface behavior, exhibition system, scientific apparatus, or industrial mechanism. If the anchor can only be described with generic quality words such as "modern", "clean", "premium", "expressive", "minimal", or "bold", reject it and choose again.
+
+When the host supports separate agents, a lightweight creative pass may synthesize the commitment from the brief and repo evidence before a governance pass validates accessibility, tokens, maintainability, and implementation risk. When only one agent is available, perform the same separation sequentially: creative commitment first, governance validation second.
+
 ## 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.
@@ -35,14 +46,40 @@ User-supplied research means current-task evidence from the user. The scaffold s
 
 Do not use basic software UI labels as the final anchor, including "dashboard", "portal", "cards", "admin panel", "SaaS shell", "web app shell", or "minimalist interface".
 
-The agent must internally consider at least three substantially different, high-variance candidate anchors, discard the two most obvious, safest, or easiest-to-predict options, and record only the surviving anchor and concise rationale. Do not expose hidden deliberation or the rejected candidate list.
+The agent must internally consider at least three substantially different, high-variance candidate anchors, discard the two most obvious, safest, or easiest-to-predict options, then record only the surviving anchor, its concrete real-world reference point, and concise rationale. Do not expose hidden deliberation or the rejected candidate list.
 
 The final anchor must come from broad non-template domains such as complex physical engineering, high-end industrial design, cinematic spatial interfaces, experimental editorial structure, advanced architecture, scientific instrumentation, advanced data visualization, exhibition/wayfinding systems, or premium interactive web experiences. These are search domains, not style presets.
 
-Write the chosen anchor into `docs/design-intent.json` as `conceptualAnchor`, including agentResearchMode, sourceDomain, rationale, derivedTokenLogic, visualRiskBudget, motionRiskBudget, and cohesionChecks. Typography, spacing, density, color behavior, morphology, motion, and responsive composition must logically derive from that single anchor. If a later design choice does not follow from the anchor, revise the contract before coding.
+Write the chosen anchor into `docs/design-intent.json` as `conceptualAnchor`, including agentResearchMode, sourceDomain, specificReferencePoint, rationale, signatureMotion, typographicDecision, derivedTokenLogic, visualRiskBudget, motionRiskBudget, and cohesionChecks. Typography, spacing, density, color behavior, morphology, motion, and responsive composition must logically derive from that single anchor. If a later design choice does not follow from the anchor, revise the contract before coding.
 
 Motion is not a garnish. 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.
@@ -106,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/review-checklists/pr-checklist.md

@@ -81,6 +81,7 @@ Run this before declaring a task done. Apply only the sections relevant to the c
 - [ ] Official setup flows are preferred when they produce better-supported current defaults.
 - [ ] Docker, framework, package, and ecosystem claims were checked live when they could be stale.
 - [ ] Token optimization and memory continuity defaults remain enabled unless the user explicitly opts out.
+- [ ] If `.agent-context/state/active-memory.json` exists and the task made material project progress, the agent refreshed it directly before completion and preserved privacy/user-owned entries.
 
 ## 9. State And Governance
 

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

@@ -56,10 +56,19 @@ Do not use this file to teach generic frontend basics the model already knows.
 
 - If the user gives no current-task visual research or reference, the scaffold, old UI, and existing design docs do not count as research.
 - Before UI code, choose one agent-synthesized conceptual anchor from high-variance non-software domains and record only the final anchor in `docs/design-intent.json`.
+- Before broad compliance review, record a creative commitment: one concrete real-world anchor reference, one signature motion behavior, and one typographic decision with meaningful role contrast.
+- 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-25T10:16:51.159Z",
+  "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.27
+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: 11eeafb3ff6a0977785e3668a704c6bba543b515d2828c02de8276f6cf1c391c
+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: 11eeafb3ff6a0977785e3668a704c6bba543b515d2828c02de8276f6cf1c391c
+Canonical Snapshot SHA256: 5c955eab4c644e7139c0c5a5609ea9af7d47fdc8e69617f407af01ccc8c64e43
 
 The canonical policy source for this repository is [.instructions.md](../.instructions.md).
 

package/.instructions.md

@@ -184,8 +184,10 @@ Use available MCP tools when you need validation, linting, or test execution.
 1. Read `.agent-context/prompts/bootstrap-design.md`.
 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. Generate or refine `docs/DESIGN.md` plus `docs/design-intent.json` before UI implementation.
-5. Keep context isolated and do not eagerly load unrelated backend-only rules unless the task explicitly touches those boundaries.
+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. 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.
 
 ---
 
@@ -209,7 +211,8 @@ Why Required: [why the boundary protects the project]
 1. All relevant rules from `.agent-context/rules/` applied.
 2. Code reviewed against `.agent-context/review-checklists/pr-checklist.md` and `.agent-context/review-checklists/architecture-review.md`.
 3. Universal SOP hard gates satisfied (`docs/architecture-decision-record.md`, and `docs/DESIGN.md` plus `docs/design-intent.json` for UI scope).
-4. MCP validation passed (`npm run validate`).
+4. If `.agent-context/state/active-memory.json` exists and material project progress happened, refresh it directly before the final response: update current focus, durable achievements/issues/next actions/validation state, and `lastUpdatedAt` while preserving privacy rules and existing user-owned entries.
+5. MCP validation passed (`npm run validate`).
 
 ---
 

package/.windsurfrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v3.0.27
+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: 11eeafb3ff6a0977785e3668a704c6bba543b515d2828c02de8276f6cf1c391c
+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,14 +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.26 (2026-04-25).
-
-Highlights in 3.0.26:
-- Memory continuity now seeds `.agent-context/state/active-memory.json` once, so new sessions have a compact project-focus snapshot without overwriting active work during upgrade.
-- 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/memory-continuity.mjs

@@ -522,7 +522,10 @@ export function buildMemoryContinuityGuidanceBlock(memoryContinuityState) {
     `- Load compact index first (limit: ${sessionStartIndexLimit} entries).`,
     `- Hydrate full detail only for highest-value entries (limit: ${fullHydrationLimit}).`,
     '- Always redact sensitive text before persistence (<private> blocks and inline secret-like fields).',
-    '- Refresh `active-memory.json` at natural task boundaries, but never store secrets, raw chat logs, or stale visual taste.',
+    '- Refresh `.agent-context/state/active-memory.json` directly at natural task boundaries when material project progress happened.',
+    '- Before the final response, update `project.currentFocus`, compact `progress.lastAchievements`, `progress.pendingIssues`, `progress.nextBestActions`, `progress.validationState`, and `lastUpdatedAt` when they changed.',
+    '- Preserve existing user-owned entries, keep each array compact (12 entries or fewer), and append only durable facts proven by current repo evidence.',
+    '- If no durable project progress happened, leave the snapshot unchanged and state that no memory update was needed.',
     '- Current repo evidence, current user brief, and live research override active-memory when they conflict.',
     '',
     'Host compatibility scope:',

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,
@@ -152,6 +153,17 @@ function buildDesignIntentContractObject({
         doNotRevealHiddenCandidateList: true,
         outputOnlyChosenAnchor: true,
       },
+      creativeCommitmentPolicy: {
+        requiredBeforeComplianceReview: true,
+        recordInDesignDocs: true,
+        requiredCommitmentFields: [
+          'specificReferencePoint',
+          'signatureMotion',
+          'typographicDecision',
+        ],
+        rejectGenericQualityWordsOnly: true,
+        specificityFloor: 'name-a-real-material-instrument-artifact-architecture-editorial-genre-cinematic-behavior-exhibition-system-scientific-apparatus-or-industrial-mechanism',
+      },
       forbiddenFinalAnchorTerms: [
         'dashboard',
         'cards',
@@ -182,9 +194,13 @@ function buildDesignIntentContractObject({
       finalAnchorContract: {
         requiredFields: [
           'name',
+          'anchorReference',
           'agentResearchMode',
           'sourceDomain',
+          'specificReferencePoint',
           'rationale',
+          'signatureMotion',
+          'typographicDecision',
           'derivedTokenLogic',
           'visualRiskBudget',
           'motionRiskBudget',
@@ -200,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,
@@ -288,6 +323,7 @@ function buildDesignIntentContractObject({
       requireContentPriorityMap: true,
       requireTaskFlowNarrative: true,
       requireSignatureMoveRationale: true,
+      requireCreativeCommitmentGate: true,
       requireStructuredHandoff: true,
       requireRepoEvidenceAlignment: true,
       forbidScreenshotDependency: true,
@@ -406,6 +442,15 @@ function buildDesignIntentContractObject({
         requiredResetAxes: ['composition', 'hierarchy', 'motion-or-interaction', 'responsive-information-architecture'],
       },
       signatureMoveRationale: 'Agent must choose one project-specific visual, motion, typographic, or interaction move and explain why generic fallback weakens it.',
+      creativeCommitment: {
+        status: 'agent-must-complete-before-ui-implementation',
+        requiredFields: [
+          'specificReferencePoint',
+          'signatureMotion',
+          'typographicDecision',
+        ],
+        failureMode: 'generic quality words without a named real-world reference are not enough',
+      },
       implementationGuardrails: {
         requireBuildFromHandoff: true,
         requireGapNotesBeforeFallback: true,
@@ -557,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 = [];
 
@@ -564,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".');
   }
@@ -606,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.');
@@ -649,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')
@@ -696,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)
@@ -944,6 +1095,7 @@ export function validateDesignIntentContract(designIntentContract) {
       'requireContentPriorityMap',
       'requireTaskFlowNarrative',
       'requireSignatureMoveRationale',
+      'requireCreativeCommitmentGate',
       'requireStructuredHandoff',
       'requireRepoEvidenceAlignment',
       'forbidScreenshotDependency',
@@ -1038,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.',
@@ -177,8 +180,22 @@ export function buildDesignBootstrapPrompt({
     '31. If modern UI, animation, scroll, 3D, canvas, chart, or icon libraries are useful, choose them from current official docs and record source URL, fetched date, reason, risk, and accessibility fallback.',
     '32. If the user supplies research files, library lists, screenshots, articles, or benchmark notes, read them as candidate evidence, summarize the useful signals, filter by project fit, and verify technology claims against current official docs before implementation.',
     '33. If no user-supplied research or reference is supplied for UI work, activate the Dynamic Avant-Garde Anchor Engine before coding. User-supplied research means current-task evidence from the user; this scaffold, prior UI, and old design docs do not count as research.',
-    '34. In Dynamic Avant-Garde mode, perform agent-led research when available, then internally consider at least three high-variance conceptual anchors, discard the two safest or most predictable options, output only the chosen anchor and rationale, and forbid final anchors named dashboard, portal, cards, admin panel, SaaS shell, web app shell, or minimalist interface.',
-    '35. The chosen anchor must drive typography, spacing, density, color behavior, morphology, motion, and responsive composition. 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.',
+    '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 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}`,
@@ -209,8 +226,9 @@ export function buildDesignBootstrapPrompt({
     '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. Preserve conceptualAnchor so prompt-only UI work has one cohesive non-template concept instead of a mixed collection of bold but unrelated visual decisions.',
-    '15. Record conceptualAnchor.agentResearchMode, visualRiskBudget, motionRiskBudget, and cohesionChecks so the final UI cannot quietly fall back to a timid dashboard/admin mental model.',
-    '16. After the contract exists, use it as a first-class source for future UI tasks.',
+    '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. 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.27",
+  "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',