@ryuenn3123/agentic-senior-core 3.0.43 → 3.0.44

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

@@ -2,9 +2,7 @@
 
 Use this prompt for UI, UX, frontend layout, screen, Tailwind, animation, 3D, canvas, or redesign work.
 
-Create or refine:
-- `docs/DESIGN.md` for human-readable design reasoning.
-- `docs/design-intent.json` for machine-readable design intent, guardrails, and review signals.
+Create or refine `docs/DESIGN.md` for human reasoning and `docs/design-intent.json` for machine-readable design intent, guardrails, and review signals.
 
 This contract is a decision scaffold, not a style preset. We guide the agent; we do not pick the final style, stack, framework, palette, typography, layout paradigm, or animation library offline.
 
@@ -43,6 +41,7 @@ Rules:
 - Output only the chosen anchor, specific reference point, and rationale.
 - Forbid final anchors named dashboard, portal, cards, admin panel, SaaS shell, web app shell, or minimalist interface.
 - Derive typography, spacing, density, color behavior, morphology, motion, and responsive composition from the chosen anchor.
+- Translate the anchor non-literally first. Anchor artifacts are evidence for behavior, hierarchy, density, typography, state language, and motion, not automatic UI chrome.
 - Use reduced-motion fallbacks instead of suppressing motion.
 
 ## Creative Ambition Floor
@@ -52,14 +51,20 @@ Before UI code, record:
 - one morphology or composition choice that avoids interchangeable card stacks when the product allows it
 - at least three at-a-glance product-specific signals for new screens or broad redesigns
 
-Do not ship AI-safe UI. Record exact drift signals in `reviewRubric`; at minimum reject decorative grid wallpaper, default line backgrounds, calibration-mark wallpaper, soft glow backgrounds, generic abstract marks, testing/demo/placeholder UI copy, terminal-only user flows, and first-output composition with only local copy swapped in when they have no product function. Treat measurement, calibration, crop, route, timeline, and inspection marks as task overlays or control affordances only; never promote them to the page background, hero backdrop, or first-output visual texture.
+Do not ship AI-safe UI. Record exact drift signals in `reviewRubric`; at minimum reject decorative grid wallpaper, default line backgrounds, calibration-mark wallpaper, soft glow backgrounds, generic abstract marks, testing/demo/placeholder UI copy, terminal-only user flows, and first-output composition with only local copy swapped in when they have no product function. Treat measurement, calibration, crop, route, timeline, and inspection marks as task overlays or control affordances only; never promote them to the page background, hero backdrop, or first-output visual texture. If a conceptual anchor suggests a forbidden motif, the forbidden motif wins; express the anchor through workflow, hierarchy, density, typography, material behavior, state design, and interaction grammar instead of literal wallpaper.
 
 ## Brave Redesign Default
 For UI design work, the agent owns the ambition decision. For broad screens, redesigns, or new visual systems, treat expressive motion, spatial hierarchy, distinctive composition, and product-specific interaction as the baseline even when the user did not say "rich". Do not reduce the request to a safer version of the existing UI, a static implementation, or a component-kit rearrangement because research or dependency selection feels inconvenient.
 
 If the expressive path needs a new motion, 3D, canvas, scroll, or interaction library and web search is available, perform the official-doc research and record the decision. If web search is unavailable, use already-present dependencies or native browser capabilities while preserving the intended ambition, then mark library verification as pending.
 
-Only downshift ambition after naming the concrete blocker: product fit, content density, performance budget, accessibility, device support, package conflict, security risk, or missing runtime capability. Pair every downshift with a replacement interaction quality that still changes composition, hierarchy, feedback, or memorability.
+Only downshift ambition after naming the concrete blocker: product fit, content density, measured performance budget, accessibility, device support, package conflict, security risk, or missing runtime capability. A new dependency, package count, or vague performance concern is not a blocker by itself. Pair every downshift with a replacement interaction quality that still changes composition, hierarchy, feedback, or memorability.
+
+## Design Flexibility Layer
+
+`docs/design-intent.json` must separate locked outcomes from flexible expression. The machine contract keeps review invariants stable; it must not freeze exact aesthetic implementation unless repo evidence, accessibility validation, implementation constraints, or explicit user approval locks it.
+
+Record `designFlexibilityPolicy`: lock user goals, runtime constraints, accessibility, production readiness, forbidden patterns, and approved continuity; keep exact palette primitives, font families, radius/shadow values, component-kit theme mapping, signature move implementation, and literal anchor artifacts flexible until validated or approved. Semantic roles are required; exact primitives are not automatically locked. Required experience outcomes are separate from candidate implementation moves. Libraries supply behavior, accessibility, primitives, and delivery speed; the project supplies final composition, theme, morphology, and visual language.
 
 ## AI Color and Template Residue Audit
 AI color drift happens when a palette uses safe defaults before product meaning.
@@ -90,7 +95,7 @@ Before implementation, `docs/design-intent.json` must include top-level `derived
 - `motionDerivationSource`
 - `validationRule`
 
-Every token must trace to `anchorReference`. If the rationale is "looks good", "common practice", "modern default", or "framework default", revise the token before code.
+Every semantic token role must trace to `anchorReference`. Exact primitive values stay flexible until repo evidence, accessibility validation, implementation constraints, or explicit user approval locks them. If the rationale is "looks good", "common practice", "modern default", or "framework default", derive the token again before UI code.
 
 ## Library Research Protocol
 If web search is available:
@@ -103,8 +108,8 @@ If web search is unavailable:
 - Use native CSS, browser APIs, or already-present dependencies.
 - Set `libraryResearchStatus` to `pending-verification`.
 
-Treat unresearched dependency choices as review findings.
-
+Treat unresearched dependency choices as review findings. Dynamic UI Foundation Selection: do not default to shadcn/ui, Tailwind-only, native-only, or any component kit because it is familiar. Choose the foundation from product type, interaction complexity, accessibility needs, design ambition, team/runtime constraints, bundle/runtime cost, and current official docs.
+Ready-made primitives are allowed when they improve behavior, accessibility, speed, or maintainability. The library supplies mechanics; the project supplies visual language. Reject default component-kit styling without product rationale, but do not reject a modern lightweight library solely because a dependency was needed.
 ## Zero-Based Redesign Protocol
 
 When the user says "redesign from zero", "redesain dari 0", "ulang dari 0", or "research ulang":
@@ -146,6 +151,7 @@ The JSON is the source of truth for machine review. It must stay project-specifi
 - confirmed project context and assumptions
 - agent-chosen visual direction
 - `motionPaletteDecision`
+- `designFlexibilityPolicy`
 - `conceptualAnchor`
 - `derivedTokenLogic`
 - `aiSafeUiAudit` and `productionContentPolicy`
@@ -165,15 +171,6 @@ WCAG 2.2 AA is the hard floor. APCA may be used only as advisory perceptual tuni
 
 Define a review rubric that names drift signals and separates taste from failure.
 
-Block or flag:
-- inaccessible contrast, focus, target size, keyboard, auth, or dynamic-status behavior
-- scale-only responsive behavior
-- default component-kit styling without product rationale
-- nonfunctional background effects, including decorative grid wallpaper
-- grid or line backgrounds used as filler instead of product function
-- testing, demo, sample, placeholder, lorem, TODO, coming soon, or scaffold labels visible in shipped UI unless they are real product states; terminal-only core user flows unless the product is explicitly a CLI, developer tool, or operational runbook
-- palette choices that use readability as an excuse for safe defaults
-- visual direction copied from unrelated memory or external references
-- genericity findings that cannot name the exact drift signal
+Block or flag inaccessible contrast/focus/target/keyboard/auth/status behavior, scale-only responsive behavior, default component-kit styling, nonfunctional background effects, grid or line filler, placeholder copy, terminal-only core flows, readability-as-safe-default palettes, copied visual direction, and genericity findings that cannot name the exact drift signal.
 
 Wait for user approval before generating Figma or code assets when the user only asked for planning or design direction.

package/.agent-context/review-checklists/pr-checklist.md

@@ -81,10 +81,13 @@ Run this before declaring a task done. Apply only the sections relevant to the c
 - [ ] Motion is treated as part of the design language for modern UI work, with reduced-motion and performance safeguards instead of defaulting to static screens.
 - [ ] Broad redesigns pass the old-design regression test: the result is not the previous composition with animation, depth, media, or interaction density removed.
 - [ ] UI work records an agent-chosen ambition level; broad screens and redesigns researched an expressive path first, and any downshift names a concrete blocker plus replacement interaction quality.
+- [ ] UI foundation choices are dynamic and product-fit; no shadcn, native-only, Tailwind-only, or component-kit default was selected by habit or avoided from dependency fear.
+- [ ] Design intent separates locked outcomes from flexible expression; candidate signature moves, exact token primitives, literal anchor artifacts, and component-kit skins were not treated as permanent requirements without evidence or user approval.
 
 ## 8. Dependencies And Runtime
 
 - [ ] New dependencies are justified by capability, maintenance health, bundle/runtime cost, and current official docs.
+- [ ] Dependency avoidance was not treated as a default virtue; lightweight maintained libraries were considered when they improve correctness, accessibility, UX, maintainability, or delivery speed.
 - [ ] 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.

package/.agent-context/rules/efficiency-vs-hype.md

@@ -4,7 +4,9 @@
 
 The LLM may choose modern libraries and tooling when they fit the project. This rule does not prefer "no library", "always add a library", or any fixed dependency set.
 
-New dependencies are allowed when they create a better practical tradeoff than custom implementation. The decision should be based on whether the dependency meaningfully improves efficiency, shortens delivery time, improves correctness, reduces maintenance burden, or avoids unnecessary in-house code.
+New dependencies are allowed when they create a better practical tradeoff than custom implementation. The decision should be based on whether the dependency meaningfully improves efficiency, shortens delivery time, improves correctness, reduces maintenance burden, unlocks a stronger user experience, or avoids unnecessary in-house code.
+
+Do not treat dependency avoidance as an engineering virtue by itself. A small, maintained, well-scoped library can be the simpler and safer choice than custom code, especially for accessibility primitives, animation, gestures, data visualization, parsing, protocol handling, security-sensitive helpers, or browser/runtime capabilities with tricky edge cases.
 
 Before adding or recommending a dependency:
 - check current official docs, release notes, and setup guidance when the ecosystem decision matters
@@ -14,5 +16,6 @@ Before adding or recommending a dependency:
 - explain why the dependency is a better tradeoff than local implementation for the current task
 - avoid packages that are stale, thinly maintained, too heavy for the job, or added only because they are popular
 - keep dependency boundaries replaceable when the library would spread through many files
+- do not reject a dependency only because it adds a package; reject it only when the project-fit, security, maintenance, compatibility, bundle/runtime, or ownership tradeoff is worse than the alternative
 
-Reject offline dependency decisions, outdated tutorial versions, trend choices, and dependency avoidance choices that are not grounded in the current repo, brief, and delivery tradeoffs.
+Reject offline dependency decisions, outdated tutorial versions, trend choices, dependency avoidance choices, and performance-fear choices that are not grounded in the current repo, brief, and delivery tradeoffs.

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

@@ -4,10 +4,7 @@ Load this rule for UI-facing work. Keep the loaded surface small.
 
 ## Activation
 
-Use this rule for:
-- UI, UX, page, screen, component, layout, landing, dashboard, form, onboarding, animation, interaction
-- redesign, reskin, visual refresh, responsive fix, hierarchy fix
-- frontend deliverables inside fullstack or backend work
+Use this rule for UI, UX, page, screen, component, layout, landing, dashboard, form, onboarding, animation, interaction, redesign, visual refresh, responsive fix, hierarchy fix, and frontend deliverables inside fullstack or backend work.
 
 ## Authority
 
@@ -16,16 +13,16 @@ Use this rule for:
 - Treat `README.md` as overview/install/user context only when design or architecture rules conflict.
 - Do not choose final style, framework, palette, typography, layout paradigm, or animation library offline.
 - Research current official docs before adding a new UI, animation, scroll, 3D, canvas, charting, icon, styling, or primitive library.
+- Dynamic UI Foundation: do not hardcode shadcn/ui, Tailwind-only, native-only, or any component library as the universal answer. Modern lightweight primitives, motion libraries, canvas/WebGL helpers, charting libraries, and styling tools are valid when product evidence, accessibility, interaction quality, maintainability, delivery speed, runtime constraints, and official docs support them.
 - Keep design continuity opt-in. Repo evidence outranks memory residue.
 
 ## Required Design Contract
 
-Before UI code, create or refine:
-- `docs/DESIGN.md`
-- `docs/design-intent.json`
+Before UI code, create or refine `docs/DESIGN.md` and `docs/design-intent.json`.
 
 The contract must record:
 - `motionPaletteDecision`
+- `designFlexibilityPolicy`
 - `conceptualAnchor`
 - `derivedTokenLogic`
 - `aiSafeUiAudit`
@@ -47,7 +44,7 @@ Use the old-design regression test for broad redesigns: if the UI reads as the p
 
 Background lines, grids, scanlines, noise, glows, blobs, abstract logos, calibration marks, and decorative geometry are invalid as wallpaper. Do not use grid or line backgrounds as first-output filler. Use them only for a named product function such as alignment, crop guidance, map/route orientation, timeline reading, measurement, status, or motion continuity.
 
-Measurement, calibration, crop, map, route, and inspection marks are task-bound overlays or control affordances. They must not become the page background, hero backdrop, or default visual texture.
+Measurement, calibration, crop, map, route, and inspection marks are task-bound overlays or control affordances. They must not become the page background, hero backdrop, or default visual texture. When a conceptual anchor and a forbidden visual motif conflict, the forbidden motif wins; translate the anchor into layout, hierarchy, density, typography, state behavior, materials, and interaction instead of literal decorative texture.
 
 Production UI must read as ship-ready: no visible testing, demo, sample, placeholder, lorem, TODO, coming soon, or scaffold labels unless they are intentional product states. User-facing workflows need an operable UI path; terminal-only core flows are valid only for CLI, developer-tool, or runbook products.
 
@@ -59,6 +56,7 @@ If the user gives no current-task visual research or reference:
 - Internally reject the safest dashboard, portal, card-grid, admin-shell, or minimalist-web-app mental model.
 - Record one real-world anchor reference, one signature motion behavior, and one typographic decision with role contrast.
 - Derive typography, spacing, morphology, motion, and responsive recomposition from that anchor.
+- Translate the anchor into workflow, hierarchy, density, typography, state behavior, and interaction before using literal artifacts. Do not turn anchor artifacts into required chrome, wallpaper, decorative props, or component-kit theme objects without a named product function.
 - Reject anchors described only by generic quality words such as modern, clean, premium, expressive, minimal, or bold.
 
 ## Motion, Palette, and 3D
@@ -70,9 +68,10 @@ If the user gives no current-task visual research or reference:
 - Do not default to dark slate, cream/beige/tan, purple-blue gradients, monochrome palettes, cyber-neon terminals, or uniform card surfaces without product evidence.
 - Treat motion, 3D, WebGL, canvas, scroll choreography, and animation libraries as first-class options.
 - Omit rich motion or spatial UI only after naming the product-fit reason and the replacement interaction quality.
-- For new screens or broad redesigns, research the expressive implementation path instead of defaulting to static native CSS. Use native or already-installed tools only when they can still deliver the chosen ambition, or when a concrete blocker is documented.
+- For new screens or broad redesigns, research the expressive implementation path instead of defaulting to static native CSS. Use native or already-installed tools only when they can still deliver the chosen ambition, or when a concrete blocker is documented. Do not downshift because adding a package feels inconvenient; downshift only for a concrete product-fit, accessibility, security, compatibility, device, maintenance, or measured performance reason.
 - Keep reduced-motion, keyboard, loading, performance, mobile, and non-3D fallbacks explicit.
-
+- Use component kits or headless primitives for behavior and accessibility when they fit. Replace library-default visual language with project-specific composition, tokens, motion, state treatment, and morphology.
+- Keep design-intent flexible: lock user goals, accessibility, production readiness, forbidden patterns, and approved continuity; keep exact palette primitives, font families, radius/shadow values, component skins, and candidate signature moves flexible until evidence or approval locks them.
 ## Zero-Based Redesign
 
 If the user asks for a redesign from zero:

package/.agent-context/rules/performance.md

@@ -2,6 +2,8 @@
 
 Do not over-optimize by habit. Do reject obvious scale and runtime failures.
 
+Performance is a decision input, not a blanket veto against modern libraries, motion, richer UI, or maintained tooling. Compare the real cost of the dependency or implementation against the cost of custom code, lost accessibility, weaker UX, duplicated maintenance, and slower delivery.
+
 Hard rejections:
 - repeated network, database, filesystem, or model calls inside loops without batching, limits, or caching rationale
 - unbounded reads, renders, exports, or searches when the data can grow
@@ -9,4 +11,4 @@ Hard rejections:
 - synchronous blocking work in request, UI, worker, or async paths where it can stall the product
 - caches without invalidation, expiry, ownership, and staleness trade-offs
 
-When performance matters, measure the real bottleneck, change the smallest useful thing, and verify the result.
+When performance matters, measure the real bottleneck, change the smallest useful thing, and verify the result. Do not downshift product quality, UI ambition, or library fit from performance fear alone; name the concrete budget, bottleneck, device limit, or runtime evidence.

package/.cursor/rules/agentic-senior-core.mdc

@@ -7,7 +7,7 @@ alwaysApply: true
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 91efb30348194cff4f7a820caabeb60cd7ca59dea3982a7d3991c7b18991d225
+Canonical Snapshot SHA256: 8a232b1dc9792849a9290898ef40dfff730c13cd0b443d217c0590ced04ed946
 
 This repository is governed by a strict instruction contract.
 Use [.instructions.md](../../.instructions.md) as the canonical policy source.

package/.cursorrules

@@ -1,6 +1,6 @@
 # .cursorrules - Legacy Thin Adapter
 
-Generated by Agentic-Senior-Core CLI v3.0.43
+Generated by Agentic-Senior-Core CLI v3.0.44
 Adapter Mode: legacy-thin
 Adapter Source: .agent-instructions.md when present; fallback .instructions.md
 Canonical baseline: .instructions.md

package/.gemini/instructions.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 91efb30348194cff4f7a820caabeb60cd7ca59dea3982a7d3991c7b18991d225
+Canonical Snapshot SHA256: 8a232b1dc9792849a9290898ef40dfff730c13cd0b443d217c0590ced04ed946
 
 This repository is governed by a strict instruction contract.
 Use [.instructions.md](../.instructions.md) as the canonical policy source.

package/.github/copilot-instructions.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 91efb30348194cff4f7a820caabeb60cd7ca59dea3982a7d3991c7b18991d225
+Canonical Snapshot SHA256: 8a232b1dc9792849a9290898ef40dfff730c13cd0b443d217c0590ced04ed946
 
 This repository is governed by a strict instruction contract.
 Use [.instructions.md](../.instructions.md) as the canonical policy source.

package/.github/instructions/agentic-senior-core.instructions.md

@@ -6,7 +6,7 @@ applyTo: "**"
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 91efb30348194cff4f7a820caabeb60cd7ca59dea3982a7d3991c7b18991d225
+Canonical Snapshot SHA256: 8a232b1dc9792849a9290898ef40dfff730c13cd0b443d217c0590ced04ed946
 
 This repository is governed by a strict instruction contract.
 Use [.instructions.md](../../.instructions.md) as the canonical policy source.

package/.instructions.md

@@ -44,7 +44,7 @@ Load only relevant rule files. Do not read the entire rule directory by default.
 
 Available rules: `naming-conv.md`, `architecture.md`, `security.md`, `performance.md`, `error-handling.md`, `testing.md`, `git-workflow.md`, `efficiency-vs-hype.md`, `api-docs.md`, `microservices.md`, `event-driven.md`, `database-design.md`, `realtime.md`, `frontend-architecture.md`, `docker-runtime.md`.
 
-For Docker or Compose work, load `docker-runtime.md` and verify the latest official Docker docs before authoring container assets. For framework or package setup work, use the latest stable compatible dependency set and official setup flow unless a documented compatibility constraint blocks it. New dependencies are allowed when they improve efficiency, delivery time, correctness, or maintainability.
+For Docker or Compose work, load `docker-runtime.md` and verify the latest official Docker docs before authoring container assets. For framework or package setup work, use the latest stable compatible dependency set and official setup flow unless a documented compatibility constraint blocks it. New dependencies are allowed when they improve efficiency, delivery time, correctness, accessibility, UX, or maintainability. Do not treat dependency avoidance or vague performance fear as a default reason to skip a modern maintained library.
 
 Backend/API routing:
 - Data/schema/persistence: `architecture.md`, `database-design.md`, `performance.md`, `testing.md`.

package/.windsurf/rules/agentic-senior-core.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 91efb30348194cff4f7a820caabeb60cd7ca59dea3982a7d3991c7b18991d225
+Canonical Snapshot SHA256: 8a232b1dc9792849a9290898ef40dfff730c13cd0b443d217c0590ced04ed946
 
 This repository is governed by a strict instruction contract.
 Use [.instructions.md](../../.instructions.md) as the canonical policy source.

package/.windsurfrules

@@ -1,6 +1,6 @@
 # .windsurfrules - Legacy Thin Adapter
 
-Generated by Agentic-Senior-Core CLI v3.0.43
+Generated by Agentic-Senior-Core CLI v3.0.44
 Adapter Mode: legacy-thin
 Adapter Source: .agent-instructions.md when present; fallback .instructions.md
 Canonical baseline: .instructions.md

package/AGENTS.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 91efb30348194cff4f7a820caabeb60cd7ca59dea3982a7d3991c7b18991d225
+Canonical Snapshot SHA256: 8a232b1dc9792849a9290898ef40dfff730c13cd0b443d217c0590ced04ed946
 
 This repository is governed by a strict instruction contract.
 Use [.instructions.md](.instructions.md) as the canonical policy source.

package/CLAUDE.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 91efb30348194cff4f7a820caabeb60cd7ca59dea3982a7d3991c7b18991d225
+Canonical Snapshot SHA256: 8a232b1dc9792849a9290898ef40dfff730c13cd0b443d217c0590ced04ed946
 
 This repository is governed by a strict instruction contract.
 Use [.instructions.md](.instructions.md) as the canonical policy source.

package/GEMINI.md

@@ -2,7 +2,7 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 91efb30348194cff4f7a820caabeb60cd7ca59dea3982a7d3991c7b18991d225
+Canonical Snapshot SHA256: 8a232b1dc9792849a9290898ef40dfff730c13cd0b443d217c0590ced04ed946
 
 This repository is governed by a strict instruction contract.
 Use [.instructions.md](.instructions.md) as the canonical policy source.

package/lib/cli/compiler.mjs

@@ -64,6 +64,8 @@ function buildAnchorCommitmentHeader(designIntent) {
   const conceptualAnchor = designIntent.conceptualAnchor || {};
   const derivedTokenLogic = designIntent.derivedTokenLogic || {};
   const creativeCommitment = designIntent.designExecutionHandoff?.creativeCommitment || {};
+  const designFlexibilityPolicy = designIntent.designFlexibilityPolicy || {};
+  const expressionFlexibility = designIntent.designExecutionHandoff?.expressionFlexibility || {};
   const anchorReference = conceptualAnchor.anchorReference || derivedTokenLogic.anchorReference;
   const conceptualAnchorName = conceptualAnchor.name || anchorReference;
   const signatureMove = conceptualAnchor.signatureMove
@@ -74,6 +76,12 @@ function buildAnchorCommitmentHeader(designIntent) {
   const typographicDecision = conceptualAnchor.typographicDecision
     || creativeCommitment.typographicDecision
     || derivedTokenLogic.typographyDerivationSource;
+  const flexibleAxes = Array.isArray(designFlexibilityPolicy.flexibleExpressionAxes)
+    ? designFlexibilityPolicy.flexibleExpressionAxes
+    : expressionFlexibility.flexibleAxes;
+  const lockedOutcomes = Array.isArray(expressionFlexibility.lockedOutcomes)
+    ? expressionFlexibility.lockedOutcomes
+    : designFlexibilityPolicy.lockedOutcomeTypes;
 
   if (!conceptualAnchorName && !anchorReference) {
     return [
@@ -92,6 +100,8 @@ function buildAnchorCommitmentHeader(designIntent) {
     `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')}`,
+    `Locked Outcomes: ${toSingleLine(Array.isArray(lockedOutcomes) ? lockedOutcomes.join(', ') : '', 'user goals, accessibility, production readiness, forbidden patterns')}`,
+    `Flexible Expression: ${toSingleLine(Array.isArray(flexibleAxes) ? flexibleAxes.join(', ') : '', 'exact primitives, typeface, surface treatment, component skin, candidate moves')}`,
     'If the UI output does not reflect these lines, stop and revise the design contract before continuing.',
   ].join('\n');
 }

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

@@ -113,6 +113,36 @@ export function validateDesignIntentContract(designIntentContract) {
     }
   }
 
+  if (!designIntentContract.designFlexibilityPolicy || typeof designIntentContract.designFlexibilityPolicy !== 'object') {
+    validationErrors.push('designIntent.designFlexibilityPolicy must exist.');
+  } else {
+    const designFlexibilityPolicy = designIntentContract.designFlexibilityPolicy;
+    if (designFlexibilityPolicy.mode !== 'locked-outcomes-flexible-expression') {
+      validationErrors.push('designIntent.designFlexibilityPolicy.mode must equal "locked-outcomes-flexible-expression".');
+    }
+    if (!hasNonEmptyString(designFlexibilityPolicy.contractRole)) {
+      validationErrors.push('designIntent.designFlexibilityPolicy.contractRole must be a non-empty string.');
+    }
+    if (!Array.isArray(designFlexibilityPolicy.lockedOutcomeTypes) || designFlexibilityPolicy.lockedOutcomeTypes.length < 4) {
+      validationErrors.push('designIntent.designFlexibilityPolicy.lockedOutcomeTypes must list the locked outcome categories.');
+    }
+    if (!Array.isArray(designFlexibilityPolicy.flexibleExpressionAxes) || designFlexibilityPolicy.flexibleExpressionAxes.length < 4) {
+      validationErrors.push('designIntent.designFlexibilityPolicy.flexibleExpressionAxes must list flexible expression axes.');
+    }
+    if (!hasNonEmptyString(designFlexibilityPolicy.tokenLockingRule)) {
+      validationErrors.push('designIntent.designFlexibilityPolicy.tokenLockingRule must be a non-empty string.');
+    }
+    if (!String(designFlexibilityPolicy.signatureMovePolicy || '').includes('candidate')) {
+      validationErrors.push('designIntent.designFlexibilityPolicy.signatureMovePolicy must separate candidate moves from required outcomes.');
+    }
+    if (!String(designFlexibilityPolicy.libraryVisualLanguagePolicy || '').includes('Libraries supply')) {
+      validationErrors.push('designIntent.designFlexibilityPolicy.libraryVisualLanguagePolicy must keep libraries from dictating visual language.');
+    }
+    if (!String(designFlexibilityPolicy.literalAnchorPolicy || '').includes('Translate anchors')) {
+      validationErrors.push('designIntent.designFlexibilityPolicy.literalAnchorPolicy must require non-literal anchor translation.');
+    }
+  }
+
   if (!designIntentContract.conceptualAnchor || typeof designIntentContract.conceptualAnchor !== 'object') {
     validationErrors.push('designIntent.conceptualAnchor must exist.');
   } else {
@@ -228,6 +258,20 @@ export function validateDesignIntentContract(designIntentContract) {
         validationErrors.push('designIntent.conceptualAnchor.visualRiskBudget.requireReducedMotionFallback must equal true.');
       }
     }
+    const literalTranslationPolicy = conceptualAnchor.literalTranslationPolicy;
+    if (!literalTranslationPolicy || typeof literalTranslationPolicy !== 'object') {
+      validationErrors.push('designIntent.conceptualAnchor.literalTranslationPolicy must exist.');
+    } else {
+      if (literalTranslationPolicy.preferNonLiteralTranslation !== true) {
+        validationErrors.push('designIntent.conceptualAnchor.literalTranslationPolicy.preferNonLiteralTranslation must equal true.');
+      }
+      if (!hasNonEmptyString(literalTranslationPolicy.allowedLiteralUse)) {
+        validationErrors.push('designIntent.conceptualAnchor.literalTranslationPolicy.allowedLiteralUse must be a non-empty string.');
+      }
+      if (!String(literalTranslationPolicy.forbiddenLiteralUse || '').includes('decorative wallpaper')) {
+        validationErrors.push('designIntent.conceptualAnchor.literalTranslationPolicy.forbiddenLiteralUse must reject decorative wallpaper.');
+      }
+    }
     if (
       !Array.isArray(conceptualAnchor.requiredDerivedAxes)
       || !conceptualAnchor.requiredDerivedAxes.includes('typography')
@@ -392,6 +436,20 @@ export function validateDesignIntentContract(designIntentContract) {
     if (designIntentContract.tokenSystem.componentTokensConsumeSemantic !== true) {
       validationErrors.push('designIntent.tokenSystem.componentTokensConsumeSemantic must equal true.');
     }
+    const tokenLockingPolicy = designIntentContract.tokenSystem.tokenLockingPolicy;
+    if (!tokenLockingPolicy || typeof tokenLockingPolicy !== 'object') {
+      validationErrors.push('designIntent.tokenSystem.tokenLockingPolicy must exist.');
+    } else {
+      if (tokenLockingPolicy.defaultLockState !== 'semantic-roles-locked-primitives-flexible') {
+        validationErrors.push('designIntent.tokenSystem.tokenLockingPolicy.defaultLockState must preserve semantic roles while keeping primitives flexible.');
+      }
+      if (!Array.isArray(tokenLockingPolicy.flexibleByDefault) || tokenLockingPolicy.flexibleByDefault.length < 4) {
+        validationErrors.push('designIntent.tokenSystem.tokenLockingPolicy.flexibleByDefault must list flexible primitive axes.');
+      }
+      if (!hasNonEmptyString(tokenLockingPolicy.promotionRule)) {
+        validationErrors.push('designIntent.tokenSystem.tokenLockingPolicy.promotionRule must be a non-empty string.');
+      }
+    }
     const fallbackPolicy = designIntentContract.tokenSystem.fallbackPolicy;
     if (!fallbackPolicy || typeof fallbackPolicy !== 'object') {
       validationErrors.push('designIntent.tokenSystem.fallbackPolicy must exist.');
@@ -589,6 +647,10 @@ export function validateDesignIntentContract(designIntentContract) {
       'requireStructuredHandoff',
       'requireRepoEvidenceAlignment',
       'forbidScreenshotDependency',
+      'separateRequiredOutcomesFromCandidateMoves',
+      'forbidCandidateMovesAsLockedRequirements',
+      'forbidLibraryThemeAsVisualAuthority',
+      'forbidLiteralAnchorChromeWithoutProductFunction',
       'requirePerSurfaceMutationOps',
       'forbidUniformSiblingSurfaceTreatment',
       'zeroBasedRedesignResetsPriorVisualsWhenRequested',
@@ -674,6 +736,23 @@ export function validateDesignIntentContract(designIntentContract) {
     if (!Array.isArray(designIntentContract.designExecutionHandoff.interactionStateMatrix) || designIntentContract.designExecutionHandoff.interactionStateMatrix.length < 1) {
       validationErrors.push('designIntent.designExecutionHandoff.interactionStateMatrix must list key component state expectations.');
     }
+    const expressionFlexibility = designIntentContract.designExecutionHandoff.expressionFlexibility;
+    if (!expressionFlexibility || typeof expressionFlexibility !== 'object') {
+      validationErrors.push('designIntent.designExecutionHandoff.expressionFlexibility must exist.');
+    } else {
+      if (!Array.isArray(expressionFlexibility.lockedOutcomes) || expressionFlexibility.lockedOutcomes.length < 3) {
+        validationErrors.push('designIntent.designExecutionHandoff.expressionFlexibility.lockedOutcomes must list locked outcomes.');
+      }
+      if (!Array.isArray(expressionFlexibility.candidateSignatureMoves) || expressionFlexibility.candidateSignatureMoves.length < 1) {
+        validationErrors.push('designIntent.designExecutionHandoff.expressionFlexibility.candidateSignatureMoves must include at least one candidate move placeholder.');
+      }
+      if (!Array.isArray(expressionFlexibility.flexibleAxes) || expressionFlexibility.flexibleAxes.length < 4) {
+        validationErrors.push('designIntent.designExecutionHandoff.expressionFlexibility.flexibleAxes must list flexible implementation axes.');
+      }
+      if (!String(expressionFlexibility.lockingRule || '').includes('candidate')) {
+        validationErrors.push('designIntent.designExecutionHandoff.expressionFlexibility.lockingRule must explain when candidate moves become required.');
+      }
+    }
     if (!Array.isArray(designIntentContract.designExecutionHandoff.taskFlowNarrative) || designIntentContract.designExecutionHandoff.taskFlowNarrative.length < 2) {
       validationErrors.push('designIntent.designExecutionHandoff.taskFlowNarrative must describe the key UI task flow in sequence.');
     }
@@ -707,6 +786,8 @@ export function validateDesignIntentContract(designIntentContract) {
         'requireBuildFromHandoff',
         'requireGapNotesBeforeFallback',
         'forbidGenericLayoutFallbackWithoutReason',
+        'requireLockedVsFlexibleDecisionReview',
+        'forbidCandidateMoveHardcoding',
         'forbidTestingDemoCopyInUi',
         'forbidTerminalOnlyUserFlows',
       ]) {

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

@@ -21,9 +21,14 @@ const GENERICITY_DRIFT_SIGNALS = [
   'timid-anchor-that-renames-dashboard-or-admin-shell',
   'motion-suppressed-without-accessibility-or-performance-reason',
   'motion-or-3d-omitted-from-fear-without-fit-analysis',
+  'modern-library-rejected-from-dependency-fear-without-tradeoff-analysis',
+  'component-library-selected-by-habit-without-product-fit',
   'scale-only-responsive-layout',
   'zero-based-redesign-kept-prior-visual-dna',
   'restyle-instead-of-recomposition',
+  'literal-anchor-artifacts-used-as-required-ui-chrome',
+  'candidate-signature-move-treated-as-locked-implementation',
+  'library-theme-tokens-drive-visual-language',
 ];
 
 const FORBIDDEN_PATTERN_SIGNALS = [
@@ -41,6 +46,8 @@ const VALID_BOLD_SIGNALS = [
   'background-or-geometry-serves-product-function',
   'motion-or-spatial-experience-derived-from-anchor',
   'explicit-3d-canvas-fit-or-nonfit-decision',
+  'official-docs-backed-modern-library-choice',
+  'headless-or-component-primitive-restyled-to-product-language',
   'responsive-recomposition-by-task-priority',
   'purposeful-motion-with-reduced-motion-path',
 ];
@@ -176,7 +183,30 @@ function buildDesignIntentContractObject({
         'ui-primitives-or-rich-media',
         'typography-and-interaction',
       ],
-      finalDecisionAuthority: 'project-fit-accessibility-performance-maintainability-official-docs',
+      finalDecisionAuthority: 'project-fit-accessibility-performance-maintainability-delivery-speed-official-docs',
+    },
+    designFlexibilityPolicy: {
+      mode: 'locked-outcomes-flexible-expression',
+      contractRole: 'Use docs/design-intent.json as review invariants and handoff structure, not as a frozen visual recipe unless the user explicitly locks a decision.',
+      lockedOutcomeTypes: [
+        'confirmed-user-goals',
+        'repo-evidence-and-runtime-constraints',
+        'accessibility-and-production-readiness',
+        'forbidden-patterns-and-safety-gates',
+        'user-approved-brand-or-continuity-decisions',
+      ],
+      flexibleExpressionAxes: [
+        'exact-palette-primitives',
+        'font-family-selection',
+        'radius-shadow-and-surface-treatment',
+        'component-kit-theme-mapping',
+        'signature-move-implementation',
+        'literal-anchor-artifacts',
+      ],
+      tokenLockingRule: 'Semantic roles are required, but exact primitive values stay flexible until repo evidence, accessibility validation, implementation constraints, or explicit user approval locks them.',
+      signatureMovePolicy: 'Record the required experience outcome separately from candidate implementation moves; replace a candidate move when another move better fits the product.',
+      libraryVisualLanguagePolicy: 'Libraries supply behavior, accessibility, primitives, and delivery speed; they must not dictate final composition, theme, morphology, or visual language.',
+      literalAnchorPolicy: 'Translate anchors into workflow, hierarchy, density, typography, material behavior, state language, and interaction grammar before requiring literal props, marks, or chrome.',
     },
     conceptualAnchor: {
       mode: 'required-when-no-external-research',
@@ -228,8 +258,14 @@ function buildDesignIntentContractObject({
         mode: 'high-distinctiveness-with-accessibility-and-performance-guardrails',
         allowRichMotionAndMicroInteraction: true,
         rejectTimidDefaultWhenAnchorSupportsExpressiveUi: true,
+        rejectDependencyFearAsDownshiftReason: true,
         requireReducedMotionFallback: true,
       },
+      literalTranslationPolicy: {
+        preferNonLiteralTranslation: true,
+        allowedLiteralUse: 'Only use literal anchor artifacts when they serve a named product function, control, state, or task overlay.',
+        forbiddenLiteralUse: 'Do not turn anchor artifacts into decorative wallpaper, required chrome, default texture, or unavoidable theme props.',
+      },
       requiredDerivedAxes: [
         'typography',
         'morphology',
@@ -267,7 +303,7 @@ function buildDesignIntentContractObject({
       spacingDerivationSource: 'Explain spacing rhythm, density, and exceptions from anchorReference. Spacing grids are layout math, not decorative background lines.',
       typographyDerivationSource: 'Explain display, body, metadata, and data roles from anchorReference.',
       motionDerivationSource: 'Explain duration, easing, choreography, and reduced-motion from anchorReference.',
-      validationRule: 'Every token must trace to anchorReference; revise tokens that cannot.',
+      validationRule: 'Every semantic token role must trace to anchorReference; keep exact primitive values flexible unless locked by repo evidence, accessibility validation, implementation constraints, or explicit user approval.',
     },
     motionPaletteDecision: {
       productCategorySignal: 'agent-inferred-starting-heuristic',
@@ -306,7 +342,7 @@ function buildDesignIntentContractObject({
           'spatial-or-3d-fit',
           'performance-and-reduced-motion-fallback',
         ],
-        rejectionRule: 'State a product reason and replacement interaction quality before omitting 3D/canvas.',
+        rejectionRule: 'State a product reason and replacement interaction quality before omitting 3D/canvas. Package count or vague performance fear is not enough.',
         reviewQuestion: 'Is the interaction as expressive as the product can responsibly support?',
       },
       reviewQuestion: 'What visible evidence proves this is product-specific?',
@@ -329,11 +365,12 @@ function buildDesignIntentContractObject({
     libraryDecisions: [
       {
         library: 'agent-defined-or-none',
-        purpose: 'Verify UI-related libraries against current official docs before imports.',
+        purpose: 'Select UI-related libraries dynamically from product fit, accessibility, interaction quality, maintenance, and current official docs before imports.',
         verifiedAt: null,
         sourceUrl: null,
         stableVersion: null,
         fallbackIfUnavailable: 'Use native CSS, browser APIs, or existing dependencies.',
+        selectionPolicy: 'Do not default to shadcn, native-only, Tailwind-only, or dependency avoidance by habit.',
       },
     ],
     mathSystems: {
@@ -357,6 +394,12 @@ function buildDesignIntentContractObject({
         forbidRawSpacingOutsidePrimitives: true,
         requireDocumentedExceptionForLegacyBypass: true,
       },
+      tokenLockingPolicy: {
+        defaultLockState: 'semantic-roles-locked-primitives-flexible',
+        lockedByDefault: ['semantic-role-purpose', 'accessibility-floor', 'state-role-meaning'],
+        flexibleByDefault: ['exact-color-values', 'font-family', 'radius-values', 'shadow-values', 'component-skin'],
+        promotionRule: 'Promote flexible tokens to locked only when user approval, repo evidence, accessibility validation, or implementation constraints require it.',
+      },
       namingConstraints: {
         forbidCurlyBracesInNames: true,
         forbidDotsInNames: true,
@@ -430,6 +473,10 @@ function buildDesignIntentContractObject({
       requireStructuredHandoff: true,
       requireRepoEvidenceAlignment: true,
       forbidScreenshotDependency: true,
+      separateRequiredOutcomesFromCandidateMoves: true,
+      forbidCandidateMovesAsLockedRequirements: true,
+      forbidLibraryThemeAsVisualAuthority: true,
+      forbidLiteralAnchorChromeWithoutProductFunction: true,
       handoffFormatVersion: 'ui-handoff-v1',
       requirePerSurfaceMutationOps: true,
       forbidUniformSiblingSurfaceTreatment: true,
@@ -531,6 +578,26 @@ function buildDesignIntentContractObject({
           notes: 'Refine states from project language and anchor; reject anonymous panels.',
         },
       ],
+      expressionFlexibility: {
+        lockedOutcomes: [
+          'preserve-primary-user-goal',
+          'preserve-accessibility-floor',
+          'preserve-production-content-policy',
+          'preserve-forbidden-patterns',
+        ],
+        candidateSignatureMoves: [
+          'agent-defined-candidate-move-not-locked-until-refined',
+        ],
+        flexibleAxes: [
+          'palette-primitives',
+          'typeface-choice',
+          'surface-treatment',
+          'component-library-skin',
+          'motion-implementation',
+          'anchor-artifact-literalness',
+        ],
+        lockingRule: 'A candidate move becomes required only after repo evidence, product function, accessibility need, or explicit user approval makes it necessary.',
+      },
       taskFlowNarrative: [
         `Entry: start ${projectName} from real evidence, not a generic opener.`,
         'Resolution: define proof, feedback, recovery, and next action.',
@@ -558,6 +625,8 @@ function buildDesignIntentContractObject({
         requireBuildFromHandoff: true,
         requireGapNotesBeforeFallback: true,
         forbidGenericLayoutFallbackWithoutReason: true,
+        requireLockedVsFlexibleDecisionReview: true,
+        forbidCandidateMoveHardcoding: true,
         forbidTestingDemoCopyInUi: true,
         forbidTerminalOnlyUserFlows: true,
       },

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

@@ -155,28 +155,29 @@ export function buildDesignBootstrapPrompt({
     '4. designPhilosophy',
     '5. visualDirection',
     '6. externalResearchIntake',
-    '7. conceptualAnchor',
-    '8. derivedTokenLogic',
-    '9. motionPaletteDecision',
-    '10. aiSafeUiAudit',
-    '11. productionContentPolicy',
-    '12. libraryResearchStatus',
-    '13. libraryDecisions',
-    '14. mathSystems',
-    '15. tokenSystem',
-    '16. colorTruth',
-    '17. crossViewportAdaptation',
-    '18. motionSystem',
-    '19. componentMorphology',
-    '20. accessibilityPolicy',
-    '21. designExecutionPolicy',
-    '22. designExecutionHandoff',
-    '23. reviewRubric',
-    '24. contextHygiene',
-    '25. forbiddenPatterns',
-    '26. requiredDesignSections',
-    '27. implementation',
-    '28. repoEvidence when onboarding or detector evidence exists',
+    '7. designFlexibilityPolicy',
+    '8. conceptualAnchor',
+    '9. derivedTokenLogic',
+    '10. motionPaletteDecision',
+    '11. aiSafeUiAudit',
+    '12. productionContentPolicy',
+    '13. libraryResearchStatus',
+    '14. libraryDecisions',
+    '15. mathSystems',
+    '16. tokenSystem',
+    '17. colorTruth',
+    '18. crossViewportAdaptation',
+    '19. motionSystem',
+    '20. componentMorphology',
+    '21. accessibilityPolicy',
+    '22. designExecutionPolicy',
+    '23. designExecutionHandoff',
+    '24. reviewRubric',
+    '25. contextHygiene',
+    '26. forbiddenPatterns',
+    '27. requiredDesignSections',
+    '28. implementation',
+    '29. repoEvidence when onboarding or detector evidence exists',
     '',
     '## Mechanical Gates',
     '1. Do not copy external style guides.',
@@ -191,6 +192,7 @@ export function buildDesignBootstrapPrompt({
     '10. Define viewport mutation rules for mobile, tablet, and desktop. Shrinking desktop is failure.',
     '11. Keep structured execution representation-first: surface plan, component graph, content-priority map, viewport mutation plan, and interaction-state matrix.',
     '12. Make design-intent.json carry designExecutionPolicy and designExecutionHandoff, not prose-only policy.',
+    '12a. Make design-intent.json carry designFlexibilityPolicy so locked outcomes, candidate moves, and flexible expression axes stay separate.',
     '13. Keep semantic review focused on contract fidelity, distinctiveness, hierarchy, state behavior, and viewport mutation.',
     '14. Treat WCAG 2.2 AA as the hard floor. Use APCA only as advisory tuning.',
     '15. Cover focus visibility, focus appearance, target size, accessible authentication, keyboard access, and dynamic status/state access.',
@@ -208,13 +210,18 @@ export function buildDesignBootstrapPrompt({
     '27. Reject anchors described only as modern, clean, premium, expressive, minimal, or bold.',
     '28. Set conceptualAnchor.anchorReference and make derivedTokenLogic.anchorReference match exactly.',
     '29. Fill derivedTokenLogic before code. If a token cannot trace to anchorReference, revise it.',
+    '29a. Lock semantic roles before exact values. Do not freeze fonts, color primitives, radius, shadows, or component-kit theme treatment unless repo evidence, accessibility validation, implementation constraints, or explicit user approval requires it.',
     '30. Research current official docs before importing any new UI-related library.',
-    '31. If research is unavailable, set libraryResearchStatus to pending-verification and use native CSS, browser APIs, or existing dependencies.',
-    '32. Define reviewRubric and require genericity findings to name the actual drift signal.',
-    '33. Separate taste from failure. Bold accessible work is valid.',
-    '34. For zero-based redesign, create visualResetStrategy and reset composition, hierarchy, palette/typography, motion or interaction, and responsive information architecture.',
-    '35. Treat productionContentPolicy as blocking: remove visible testing, demo, sample, placeholder, lorem, TODO, coming soon, and scaffold copy unless it is a real product state.',
-    '36. Do not make core user workflows terminal-only unless the product is explicitly a CLI, developer tool, or operational runbook.',
+    '31. Do not default to shadcn/ui, Tailwind-only, native-only, or any component kit by habit; choose the UI foundation from product fit, accessibility, interaction quality, runtime constraints, and official docs.',
+    '32. If research is unavailable, set libraryResearchStatus to pending-verification and use native CSS, browser APIs, or existing dependencies only when they can preserve the intended ambition.',
+    '33. Do not reject modern lightweight libraries solely because they add a dependency; package count or vague performance fear is not a blocker by itself.',
+    '34. Define reviewRubric and require genericity findings to name the actual drift signal.',
+    '35. Separate taste from failure. Bold accessible work is valid.',
+    '36. For zero-based redesign, create visualResetStrategy and reset composition, hierarchy, palette/typography, motion or interaction, and responsive information architecture.',
+    '37. Treat productionContentPolicy as blocking: remove visible testing, demo, sample, placeholder, lorem, TODO, coming soon, and scaffold copy unless it is a real product state.',
+    '38. Do not make core user workflows terminal-only unless the product is explicitly a CLI, developer tool, or operational runbook.',
+    '39. Separate required experience outcomes from candidate implementation moves. Candidate signature moves are proposals until product evidence, accessibility, or user approval makes them required.',
+    '40. Translate conceptual anchors non-literally first. Do not turn anchor artifacts into required chrome, decorative props, wallpaper, or theme objects unless they serve a named product function.',
     '',
     '## Creative Ambition Floor',
     'Before implementation, the design contract must name one authored visual bet, one product-derived palette move, one signature motion/spatial/interaction behavior, and one morphology or composition choice that would not appear in a generic AI template.',
@@ -224,11 +231,13 @@ export function buildDesignBootstrapPrompt({
     '',
     '## 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.',
+    'Every semantic token role 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.',
+    'Keep exact primitive values flexible until repo evidence, accessibility validation, implementation constraints, or explicit user approval locks them.',
     '',
     '## 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.',
+    '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 only when they can preserve the intended ambition until verification is possible.',
+    'Select UI foundations dynamically. Use ready-made primitives or component kits for mechanics when they fit, but replace library-default visual language with project-specific composition, tokens, motion, state treatment, and morphology.',
     '',
     '## Project Inputs',
     `- Project name: ${discoveryAnswers.projectName}`,
@@ -252,6 +261,7 @@ export function buildDesignBootstrapPrompt({
     '5. Encode structured design execution as policy: representation strategy, surface plan, component graph, content-priority map, viewport mutation plan, interaction-state matrix, semantic review focus, and structured handoff requirements.',
     '6. Encode an explicit structured handoff inside docs/design-intent.json: surface plan, component graph, content-priority map, viewport mutation plan, interaction-state matrix, task-flow narrative, and signature move rationale.',
     '7. Encode a stable review rubric: required dimensions, genericity signals, valid bold signals, and reporting rules that separate taste from real failure.',
+    '7a. Encode designFlexibilityPolicy and designExecutionHandoff.expressionFlexibility so future agents know what is locked and what can change.',
     '8. Make the handoff executable without screenshot dependency. The contract must still guide high-precision UI generation from repo evidence and changed code alone.',
     '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.',
@@ -261,6 +271,7 @@ export function buildDesignBootstrapPrompt({
     '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. Preserve derivedTokenLogic, libraryResearchStatus, and libraryDecisions so token choices and dependency uncertainty stay visible before implementation.',
+    '16a. Preserve designFlexibilityPolicy so the machine contract guides consistency without freezing literal anchor artifacts, exact token primitives, or component-kit visual language.',
     '17. Preserve productionContentPolicy so UI output is ship-ready and not a testing-looking scaffold.',
     '18. After the contract exists, use it as a first-class source for future UI tasks.',
     '',

package/package.json

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

package/scripts/frontend-usability-audit.mjs

@@ -94,6 +94,8 @@ const REQUIRED_BOOTSTRAP_DESIGN_SNIPPETS = [
   'WCAG 2.2 AA is the hard floor',
   'APCA may be used only as advisory perceptual tuning',
   'unresearched dependency choices',
+  'Dynamic UI Foundation Selection',
+  'A new dependency, package count, or vague performance concern is not a blocker by itself.',
   'default component-kit styling without product rationale',
   'genericity findings that cannot name the exact drift signal',
 ];

package/scripts/validate/config.mjs

@@ -334,6 +334,7 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'Creative Ambition Floor',
       'AI Color and Template Residue Audit',
       'Motion and 3D Courage Rule',
+      'Design Flexibility Layer',
       'visually exploratory, product-derived palettes',
       'decorative grid wallpaper',
       '`aiSafeUiAudit`',
@@ -346,6 +347,9 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'WCAG 2.2 AA is the hard floor',
       'APCA may be used only as advisory perceptual tuning',
       'unresearched dependency choices',
+      'Dynamic UI Foundation Selection',
+      'locked outcomes from flexible expression',
+      'A new dependency, package count, or vague performance concern is not a blocker by itself.',
       'default component-kit styling without product rationale',
       'genericity findings that cannot name the exact drift signal',
     ],
@@ -398,6 +402,7 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'structure-first-scaffold',
       'colorTruth',
       'motionPaletteDecision',
+      'designFlexibilityPolicy',
       'aiSafeUiAudit',
       'aiColorAudit',
       'motionSpatialCourageAudit',
@@ -419,6 +424,8 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'seedBehaviorsRequireRefinement',
       'accessibilityPolicy',
       'designExecutionPolicy',
+      'separateRequiredOutcomesFromCandidateMoves',
+      'forbidCandidateMovesAsLockedRequirements',
       'seedRefinementRequiredBeforeUiImplementation',
       'requirePerSurfaceMutationOps',
       'forbidUniformSiblingSurfaceTreatment',
@@ -443,6 +450,7 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'taskFlowNarrative',
       'signatureMoveRationale',
       'implementationGuardrails',
+      'expressionFlexibility',
       'reviewRubric',
       'genericityAutoFail',
       'genericitySignals',
@@ -452,6 +460,9 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'offline-prescribed-style-used-as-final-direction',
       'unresearched-library-or-framework-choice',
       'single-safe-typographic-family-without-role-contrast-or-rationale',
+      'modern-library-rejected-from-dependency-fear-without-tradeoff-analysis',
+      'component-library-selected-by-habit-without-product-fit',
+      'official-docs-backed-modern-library-choice',
       'hardComplianceFloor',
       'advisoryContrastModel',
       'contextHygiene',
@@ -540,6 +551,8 @@ export const REQUIRED_DEPENDENCY_FRESHNESS_AUTOMATION_SNIPPETS = [
       'latest stable compatible dependency version',
       'official scaffolder or setup command',
       'Only step down to an older dependency version after documenting',
+      'Do not treat dependency avoidance as an engineering virtue by itself.',
+      'performance-fear choices',
     ],
   },
   {