@ryuenn3123/agentic-senior-core 3.0.16 → 3.0.17

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

@@ -30,6 +30,13 @@ The agent must:
 14. Do not reuse a color palette, component skin, or motion signature from prior chats, memories, or unrelated projects unless current repo evidence or the active brand brief explicitly asks for that continuity.
 15. Treat prior website memory, old portfolio styles, and remembered screenshots as tainted context unless the user explicitly asks to continue or evolve that specific visual system.
 16. Do not default to balanced card grids, soft startup gradients, safe centered heroes, or neutral dashboard chrome unless the product context explicitly justifies them.
+17. For design work, only these count as valid style context by default: current repo evidence, the current user brief, current project docs, and explicitly approved reference systems.
+18. Design continuity is opt-in. If the user does not explicitly ask for continuity with an older system, prefer fresh synthesis from the current repo and brief.
+19. Accessibility must be split into a hard compliance floor and an advisory readability layer. Use WCAG 2.2 AA as the blocking baseline, and use APCA only as advisory perceptual tuning. APCA must never waive a WCAG failure.
+20. Accessibility planning must cover more than color contrast. It must explicitly address focus visibility, focus appearance, target size, keyboard access, accessible authentication, and dynamic state/status access.
+21. Hybrid visual QA must stay deterministic-first. Define screenshot baseline expectations, dynamic-content masking rules, stability thresholds, viewport coverage, and long-page capture strategy before escalating any visual drift to a semantic judge.
+22. Do not assume one screenshot is enough for a long page. Require above-fold capture, full-page capture when stable, and anchor-based section or tiled-scroll captures when deep content would otherwise be missed.
+23. Deterministic visual QA must distinguish rendering noise from meaningful layout or styling drift. If a semantic judge is used later, it should only review diffs that already exceeded the deterministic threshold or lost required coverage.
 
 Required `docs/DESIGN.md` sections:
 1. Design Intent and Product Personality
@@ -42,9 +49,10 @@ Required `docs/DESIGN.md` sections:
 8. Responsive Strategy and Cross-Viewport Adaptation Matrix
 9. Interaction, Motion, and Feedback Rules
 10. Component Language, Morphology, and Shared Patterns
-11. Accessibility Non-Negotiables
-12. Anti-Patterns to Avoid
-13. Implementation Notes for Future UI Tasks
+11. Context Hygiene and Approved Reference Boundaries
+12. Accessibility Non-Negotiables
+13. Anti-Patterns to Avoid
+14. Implementation Notes for Future UI Tasks
 
 Required `docs/design-intent.json` fields:
 - `mode`
@@ -60,6 +68,9 @@ Required `docs/design-intent.json` fields:
 - `crossViewportAdaptation`
 - `motionSystem`
 - `componentMorphology`
+- `accessibilityPolicy`
+- `visualQaPolicy`
+- `contextHygiene`
 - `experiencePrinciples`
 - `forbiddenPatterns`
 - `validationHints`
@@ -73,13 +84,20 @@ Output:
 - `docs/design-intent.json` must define a real token system, not just loose style notes. Include primitive, semantic, and component layers plus aliasing rules and naming constraints.
 - `docs/design-intent.json` must include deterministic fields for `colorTruth.format`, `colorTruth.allowHexDerivatives`, and `crossViewportAdaptation.mutationRules.mobile/tablet/desktop`.
 - `docs/design-intent.json` must also include `motionSystem` and `componentMorphology` so future UI work preserves state behavior and purposeful motion without collapsing into generic static output.
+- `docs/design-intent.json` must also include `accessibilityPolicy` so the hard compliance floor, advisory contrast model, and blocking-vs-advisory checks stay machine-readable.
+- `docs/design-intent.json` must also include `visualQaPolicy` so deterministic screenshot expectations, masking rules, viewport coverage, long-page capture strategy, stability thresholds, and semantic-escalation boundaries stay machine-readable.
+- `docs/design-intent.json` must include `contextHygiene` so valid design sources, tainted carryover sources, and continuity rules are machine-readable.
 - If onboarding or detector evidence exists, preserve it under `repoEvidence.designEvidenceSummary` instead of throwing away the machine-readable snapshot of the current UI system.
 - Token intent must stay structure-first: primitive tokens hold raw values, semantic tokens carry purpose, and component tokens consume semantic tokens instead of bypassing them with raw values.
 - Color intent must be defined in a perceptual or relational color model first. Hex values may appear only as implementation derivatives.
 - The contract must encode viewport mutation rules, not just breakpoint names.
 - Motion guidance must preserve creativity: allow meaningful animation, define reduced-motion behavior, and optimize choreography instead of suppressing it by default.
+- Accessibility guidance must split hard compliance from advisory tuning: treat WCAG 2.2 AA as the minimum blocking floor and APCA as advisory perceptual guidance for readability nuance, especially in typography and dark mode.
+- Accessibility scope must include focus visibility, focus appearance, target size, accessible authentication, keyboard access, use-of-color-only failures, and dynamic status/state access.
+- Visual QA guidance must define deterministic-first screenshot review, noise thresholds, dynamic masking categories, mobile/tablet/desktop coverage, long-page capture strategy, and when semantic review is allowed to intervene.
 - Color direction must come from the current project context. Similarity to prior unrelated projects is drift unless the brief or repo evidence explicitly supports it.
 - If no approved reference system exists, synthesize the design from zero using current product context, constraints, and content only.
+- Explicitly record which sources are allowed to shape the visual language and which sources are tainted unless the user opts into continuity.
 - The resulting system should feel authored and recognizable in screenshots, not politely interchangeable with common template kits.
 - Use practical, modern, accessible language grounded in the project, not generic SaaS defaults or copycat brand systems.
 - Wait for user approval before generating Figma or code assets.

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

@@ -17,6 +17,32 @@ Mandatory behavior when triggered:
 - reject template-only repetitive outputs and force a distinct layout direction
 - treat prior website memory or old-project visual carryover as invalid evidence unless the user explicitly requests continuity with that exact system
 - do not flatten ambitious visual or motion ideas by default; keep them when they are optimized, intentional, and accessible
+- let current repo evidence, the active brief, current project docs, and explicitly approved reference systems outrank remembered style residue every time
+
+## Context Hygiene and Reference Boundaries (Mandatory)
+
+- Valid visual-context sources are limited to the current repo evidence, the current user brief, current project docs, and explicitly approved reference systems.
+- Design continuity is opt-in. If the user does not request continuity with a prior visual system, synthesize from the current project context instead.
+- Old project screenshots, remembered website styles, and cross-chat visual residue are tainted context unless the user explicitly authorizes them.
+- When repo evidence and memory residue conflict, repo evidence wins.
+- If a reference system is approved, adapt its reasoning and constraints. Do not copy its surface 1:1.
+
+## Accessibility Split (Mandatory)
+
+- Treat WCAG 2.2 AA as the hard compliance floor for release-blocking accessibility issues.
+- Treat APCA as an advisory readability model for perceptual tuning, especially for typography, dark mode, and nuanced contrast review.
+- Advisory APCA findings must never waive a WCAG hard failure.
+- Hard accessibility checks must cover more than contrast alone. They must include focus visibility, focus appearance, target size, keyboard access, use-of-color-only failures, accessible authentication, and status or dynamic state access.
+- Keep accessibility compatible with expressive design. Fix the violation without flattening the interface into generic low-risk layouts unless that is the only safe option.
+
+## Hybrid Visual QA Boundaries (Mandatory)
+
+- Visual QA must be deterministic-first. Run screenshot or pixel-diff style checks before escalating to any semantic judge.
+- Treat dynamic masking as explicit policy, not ad hoc cleanup. Time, randomized content, live counters, streaming media, and other unstable regions must be masked deliberately and documented.
+- Define stability thresholds so the system can separate tiny rendering noise from meaningful layout or styling drift.
+- Required visual coverage must include mobile, tablet, and desktop unless the product scope explicitly excludes one of those surfaces.
+- Escalate to semantic review only when deterministic evidence shows meaningful drift, missing required viewport coverage, or another contract-critical visual failure.
+- Do not use semantic review to invent aesthetic problems when deterministic evidence says the surface is stable.
 
 ## UI Consistency Guardrails (Mandatory)
 

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

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-22T12:33:03.350Z",
+  "generatedAt": "2026-04-22T23:58:57.575Z",
   "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.16
+Generated by Agentic-Senior-Core CLI v3.0.17
 Timestamp: 2026-04-22T12:30:18.799Z
 Selected policy file: .agent-context/policies/llm-judge-threshold.json
 

package/.gemini/instructions.md

@@ -2,10 +2,16 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 060b739f87a77375f261a13c3b2b295993ba67b4172420c4223ba1332d47b0a3
+Canonical Snapshot SHA256: ee64f53171dcf88e10c6f6aae98d75cc541e13880255f0e519fc82736a4af5f4
 
 Canonical policy source: [.instructions.md](../.instructions.md).
 
+If your host stops at this file, follow this minimum floor:
+- Read `.agent-instructions.md` next when it exists.
+- For UI or redesign requests, load [.agent-context/prompts/bootstrap-design.md](../.agent-context/prompts/bootstrap-design.md) and [.agent-context/rules/frontend-architecture.md](../.agent-context/rules/frontend-architecture.md) before coding.
+- If UI scope and `docs/DESIGN.md` or `docs/design-intent.json` is missing, materialize them before UI implementation.
+- Memory continuity is host-dependent project memory and does not replace bootstrap loading.
+
 ## Bootstrap Sequence
 
 1. Load [.instructions.md](../.instructions.md) first as the canonical baseline.

package/.github/copilot-instructions.md

@@ -2,10 +2,16 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 060b739f87a77375f261a13c3b2b295993ba67b4172420c4223ba1332d47b0a3
+Canonical Snapshot SHA256: ee64f53171dcf88e10c6f6aae98d75cc541e13880255f0e519fc82736a4af5f4
 
 The canonical policy source for this repository is [.instructions.md](../.instructions.md).
 
+If your host stops at this file, follow this minimum floor:
+- Read `.agent-instructions.md` next when it exists.
+- For UI or redesign requests, load [.agent-context/prompts/bootstrap-design.md](../.agent-context/prompts/bootstrap-design.md) and [.agent-context/rules/frontend-architecture.md](../.agent-context/rules/frontend-architecture.md) before coding.
+- If UI scope and `docs/DESIGN.md` or `docs/design-intent.json` is missing, materialize them before UI implementation.
+- Memory continuity is host-dependent project memory and does not replace bootstrap loading.
+
 ## Required Load Order
 
 1. Read [.instructions.md](../.instructions.md) first as the canonical baseline.

package/.instructions.md

@@ -134,6 +134,9 @@ Meta-prompts that provide complete workflows for common scenarios:
 
 **What to do**: When user request matches a trigger, load the full prompt to understand the workflow.
 For UI-only requests, keep context isolated: load `bootstrap-design.md` and `frontend-architecture.md` first, and do not eagerly load unrelated backend-only rules such as `database-design.md`, `docker-runtime.md`, or `microservices.md` unless the request explicitly crosses those boundaries.
+For design work, treat only the current repo evidence, the current brief, current project docs, and explicitly approved reference systems as valid style context. Do not let prior-chat or unrelated-project visual memory steer the result unless the user explicitly asks for continuity.
+For accessibility in UI work, treat WCAG 2.2 AA as the hard compliance floor and APCA as advisory perceptual tuning only.
+For visual QA in UI work, treat deterministic screenshot or diff evidence as the first layer, then escalate only meaningful visual drift to a semantic judge.
 
 ---
 

package/.windsurfrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v3.0.16
+Generated by Agentic-Senior-Core CLI v3.0.17
 Timestamp: 2026-04-22T12:30:18.799Z
 Selected policy file: .agent-context/policies/llm-judge-threshold.json
 

package/AGENTS.md

@@ -2,11 +2,23 @@
 
 Adapter Mode: thin
 Adapter Source: .instructions.md
-Canonical Snapshot SHA256: 060b739f87a77375f261a13c3b2b295993ba67b4172420c4223ba1332d47b0a3
+Canonical Snapshot SHA256: ee64f53171dcf88e10c6f6aae98d75cc541e13880255f0e519fc82736a4af5f4
 
 This file is an adapter entrypoint for agent discovery.
 The canonical policy source is [.instructions.md](.instructions.md).
 
+If your host stops at this file instead of following the full chain, obey the Critical Bootstrap Floor below before coding.
+
+## Critical Bootstrap Floor
+
+- If `.agent-instructions.md` exists, prefer it immediately after this file because it is the compiled project-specific snapshot.
+- Memory continuity does not replace bootstrap loading. It is host-dependent project memory, not a guarantee that instructions were reloaded for this session.
+- For UI, UX, layout, screen, tailwind, frontend, or redesign requests: load [.agent-context/prompts/bootstrap-design.md](.agent-context/prompts/bootstrap-design.md) and [.agent-context/rules/frontend-architecture.md](.agent-context/rules/frontend-architecture.md) before editing code.
+- For UI scope: if `docs/DESIGN.md` or `docs/design-intent.json` is missing, materialize or refine them before implementing UI changes.
+- For refactor, improve, clean up, or fix requests: inspect the active rules and propose a plan before editing.
+- For new project or module requests: propose architecture before generating code.
+- For ecosystem, framework, dependency, or Docker claims: perform live web research instead of relying on stale local heuristics.
+
 ## Mandatory Bootstrap Chain
 
 1. Load [.instructions.md](.instructions.md) first as the canonical baseline.

package/lib/cli/commands/init.mjs

@@ -651,7 +651,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       });
 
       await writeMemoryContinuityState(resolvedTargetDirectoryPath, memoryContinuityState);
-      console.log(`Memory continuity policy enabled (${memoryContinuityState.hydrationMode}).`);
+      console.log(`Project memory continuity metadata enabled (${memoryContinuityState.hydrationMode}, host-supported).`);
     }
 
     let tokenOptimizationState = null;
@@ -844,7 +844,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     console.log(`- Repository workflows copied: no (workflows remain source-repo assets)`);
     console.log(`- MCP configuration: ${shouldIncludeMcpTemplate ? 'auto-configured for your IDEs (VS Code, Cursor, Zed, Gemini)' : 'disabled (--no-mcp-template)'}`);
     if (isMemoryContinuityEnabled) {
-      console.log('- Memory continuity policy: enabled (index + selective hydration)');
+      console.log('- Memory continuity policy: enabled (index + selective hydration; host support required)');
     } else {
       console.log('- Memory continuity policy: disabled (--no-memory-continuity)');
     }

package/lib/cli/memory-continuity.mjs

@@ -379,7 +379,7 @@ export function buildMemoryContinuityGuidanceBlock(memoryContinuityState) {
     : 2;
 
   return [
-    'Memory continuity mode is enabled.',
+    'Project memory continuity mode is enabled.',
     'Hydration mode: progressive-disclosure.',
     adapterGuidanceLine,
     '',
@@ -389,6 +389,7 @@ export function buildMemoryContinuityGuidanceBlock(memoryContinuityState) {
     '- Always redact sensitive text before persistence (<private> blocks and inline secret-like fields).',
     '',
     'Host compatibility scope:',
+    '- This memory layer does not replace reading bootstrap instruction files at the start of a session.',
     '- Works for local IDE, CLI, and cloud IDE chat hosts that implement the memory adapter contract or MCP retrieval path.',
     '- Generic web chat sessions without repository tools cannot auto-hydrate runtime memory and should rely on manual summary export/import.',
   ].join('\n');

package/lib/cli/project-scaffolder/constants.mjs

@@ -61,6 +61,7 @@ export const DESIGN_REQUIRED_SECTIONS = [
   'Responsive Strategy and Cross-Viewport Adaptation Matrix',
   'Interaction, Motion, and Feedback Rules',
   'Component Language, Morphology, and Shared Patterns',
+  'Context Hygiene and Approved Reference Boundaries',
   'Accessibility Non-Negotiables',
   'Anti-Patterns to Avoid',
   'Implementation Notes for Future UI Tasks',

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

@@ -304,6 +304,100 @@ function buildDesignIntentContractObject({
       stateKeys: ['default', 'hover', 'focus', 'active', 'disabled', 'loading', 'error'],
       viewportBehavior: inferredKeywords.componentMorphology,
     },
+    accessibilityPolicy: {
+      hardComplianceFloor: 'WCAG-2.2-AA',
+      advisoryContrastModel: 'APCA',
+      failOnHardViolations: true,
+      advisoryFindingsDoNotBlockByDefault: true,
+      hardRequirements: {
+        textContrastMinimum: true,
+        nonTextContrast: true,
+        useOfColorOnlyProhibited: true,
+        focusVisible: true,
+        focusAppearance: true,
+        targetSizeMinimum: true,
+        keyboardAccess: true,
+        reflowRequired: true,
+        accessibleAuthenticationMinimum: true,
+        statusMessagesAndDynamicStateAccess: true,
+      },
+      advisoryChecks: {
+        perceptualContrastReview: true,
+        darkModeContrastTuning: true,
+        typographyReadabilityTuning: true,
+      },
+    },
+    visualQaPolicy: {
+      deterministicFirst: true,
+      baselineStrategy: 'deterministic-screenshots',
+      reportVersion: 'hybrid-visual-diff-v1',
+      requiredViewports: ['mobile', 'tablet', 'desktop'],
+      capturePlan: {
+        requireAboveFoldCapture: true,
+        requireFullPageCapture: true,
+        requireSectionCapturesForLongPages: true,
+        longPageStrategy: 'anchor-plus-tiles',
+        minimumSectionCaptureCount: 3,
+        maxViewportHeightsPerTile: 3,
+        tileOverlapRatio: 0.15,
+        requiredSectionTypes: [
+          'hero-or-primary-action',
+          'midpage-proof-or-content',
+          'footer-or-terminal-state',
+        ],
+      },
+      masking: {
+        requireDynamicContentMasks: true,
+        requireMaskReasonAnnotations: true,
+        allowedDynamicMaskCategories: [
+          'time-based-content',
+          'randomized-content',
+          'live-counters',
+          'streaming-media',
+          'user-specific-personalization',
+        ],
+      },
+      stability: {
+        maxUnmaskedDiffRatio: 0.005,
+        maxMaskedDiffRatio: 0.02,
+        requireConsistentRenderingEnvironment: true,
+      },
+      semanticEscalation: {
+        requireMeaningfulDiffForEscalation: true,
+        escalateWhenViewportCoverageIncomplete: true,
+        skipSemanticJudgeWhenDeterministicClean: true,
+        meaningfulDiffRatioThreshold: 0.01,
+      },
+      artifactContract: {
+        requireMachineReadableDiffBundle: true,
+        requireViewportResults: true,
+        mergeDeterministicAndSemanticVerdicts: true,
+      },
+    },
+    contextHygiene: {
+      continuityMode: 'opt-in-only',
+      allowedSources: [
+        'current-repo-evidence',
+        'current-user-brief',
+        'current-project-docs',
+        'explicitly-approved-reference-systems',
+      ],
+      taintedSources: [
+        'prior-chat-visual-memory',
+        'unrelated-project-aesthetics',
+        'remembered-screenshots-without-current-approval',
+        'generic-template-recall',
+      ],
+      repoEvidenceOverridesMemory: true,
+      requireExplicitContinuityApproval: true,
+      forbidCarryoverWhenUnapproved: true,
+      approvedReferenceUsage: 'Adapt reasoning and constraints from approved references without copying the surface 1:1.',
+      driftSignals: [
+        'palette-reused-without-brief-support',
+        'motion-signature-reused-without-approval',
+        'layout-shape-matches-unrelated-project-memory',
+      ],
+    },
     experiencePrinciples: [
       'Design must feel project-specific, not interchangeable with generic SaaS templates.',
       'Major interface decisions must be explainable in product and user terms.',
@@ -328,6 +422,9 @@ function buildDesignIntentContractObject({
       allowHexDerivatives: true,
       requireMotionRationale: true,
       requireStateMorphology: true,
+      requireAccessibilitySplit: true,
+      requireWcagHardFloor: true,
+      requireHybridVisualQaPolicy: true,
       requireSignatureMove: true,
       rejectTemplateNeutralLayout: true,
     },
@@ -495,6 +592,212 @@ export function validateDesignIntentContract(designIntentContract) {
     }
   }
 
+  if (!designIntentContract.accessibilityPolicy || typeof designIntentContract.accessibilityPolicy !== 'object') {
+    validationErrors.push('designIntent.accessibilityPolicy must exist.');
+  } else {
+    if (designIntentContract.accessibilityPolicy.hardComplianceFloor !== 'WCAG-2.2-AA') {
+      validationErrors.push('designIntent.accessibilityPolicy.hardComplianceFloor must equal "WCAG-2.2-AA".');
+    }
+    if (designIntentContract.accessibilityPolicy.advisoryContrastModel !== 'APCA') {
+      validationErrors.push('designIntent.accessibilityPolicy.advisoryContrastModel must equal "APCA".');
+    }
+    if (designIntentContract.accessibilityPolicy.failOnHardViolations !== true) {
+      validationErrors.push('designIntent.accessibilityPolicy.failOnHardViolations must equal true.');
+    }
+    if (designIntentContract.accessibilityPolicy.advisoryFindingsDoNotBlockByDefault !== true) {
+      validationErrors.push('designIntent.accessibilityPolicy.advisoryFindingsDoNotBlockByDefault must equal true.');
+    }
+    const hardRequirements = designIntentContract.accessibilityPolicy.hardRequirements;
+    if (!hardRequirements || typeof hardRequirements !== 'object') {
+      validationErrors.push('designIntent.accessibilityPolicy.hardRequirements must exist.');
+    } else {
+      for (const requirementKey of [
+        'textContrastMinimum',
+        'nonTextContrast',
+        'useOfColorOnlyProhibited',
+        'focusVisible',
+        'focusAppearance',
+        'targetSizeMinimum',
+        'keyboardAccess',
+        'reflowRequired',
+        'accessibleAuthenticationMinimum',
+        'statusMessagesAndDynamicStateAccess',
+      ]) {
+        if (hardRequirements[requirementKey] !== true) {
+          validationErrors.push(`designIntent.accessibilityPolicy.hardRequirements.${requirementKey} must equal true.`);
+        }
+      }
+    }
+    const advisoryChecks = designIntentContract.accessibilityPolicy.advisoryChecks;
+    if (!advisoryChecks || typeof advisoryChecks !== 'object') {
+      validationErrors.push('designIntent.accessibilityPolicy.advisoryChecks must exist.');
+    } else {
+      for (const advisoryKey of [
+        'perceptualContrastReview',
+        'darkModeContrastTuning',
+        'typographyReadabilityTuning',
+      ]) {
+        if (advisoryChecks[advisoryKey] !== true) {
+          validationErrors.push(`designIntent.accessibilityPolicy.advisoryChecks.${advisoryKey} must equal true.`);
+        }
+      }
+    }
+  }
+
+  if (!designIntentContract.contextHygiene || typeof designIntentContract.contextHygiene !== 'object') {
+    validationErrors.push('designIntent.contextHygiene must exist.');
+  } else {
+    if (designIntentContract.contextHygiene.continuityMode !== 'opt-in-only') {
+      validationErrors.push('designIntent.contextHygiene.continuityMode must equal "opt-in-only".');
+    }
+    if (designIntentContract.contextHygiene.repoEvidenceOverridesMemory !== true) {
+      validationErrors.push('designIntent.contextHygiene.repoEvidenceOverridesMemory must equal true.');
+    }
+    if (designIntentContract.contextHygiene.requireExplicitContinuityApproval !== true) {
+      validationErrors.push('designIntent.contextHygiene.requireExplicitContinuityApproval must equal true.');
+    }
+    if (designIntentContract.contextHygiene.forbidCarryoverWhenUnapproved !== true) {
+      validationErrors.push('designIntent.contextHygiene.forbidCarryoverWhenUnapproved must equal true.');
+    }
+    if (!Array.isArray(designIntentContract.contextHygiene.allowedSources) || designIntentContract.contextHygiene.allowedSources.length < 4) {
+      validationErrors.push('designIntent.contextHygiene.allowedSources must list the approved design evidence sources.');
+    }
+    if (!Array.isArray(designIntentContract.contextHygiene.taintedSources) || designIntentContract.contextHygiene.taintedSources.length < 3) {
+      validationErrors.push('designIntent.contextHygiene.taintedSources must list tainted carryover sources.');
+    }
+    if (!String(designIntentContract.contextHygiene.approvedReferenceUsage || '').trim()) {
+      validationErrors.push('designIntent.contextHygiene.approvedReferenceUsage must be a non-empty string.');
+    }
+  }
+
+  if (!designIntentContract.visualQaPolicy || typeof designIntentContract.visualQaPolicy !== 'object') {
+    validationErrors.push('designIntent.visualQaPolicy must exist.');
+  } else {
+    if (designIntentContract.visualQaPolicy.deterministicFirst !== true) {
+      validationErrors.push('designIntent.visualQaPolicy.deterministicFirst must equal true.');
+    }
+    if (designIntentContract.visualQaPolicy.baselineStrategy !== 'deterministic-screenshots') {
+      validationErrors.push('designIntent.visualQaPolicy.baselineStrategy must equal "deterministic-screenshots".');
+    }
+    if (designIntentContract.visualQaPolicy.reportVersion !== 'hybrid-visual-diff-v1') {
+      validationErrors.push('designIntent.visualQaPolicy.reportVersion must equal "hybrid-visual-diff-v1".');
+    }
+    if (!Array.isArray(designIntentContract.visualQaPolicy.requiredViewports) || designIntentContract.visualQaPolicy.requiredViewports.join('|') !== 'mobile|tablet|desktop') {
+      validationErrors.push('designIntent.visualQaPolicy.requiredViewports must equal ["mobile","tablet","desktop"].');
+    }
+
+    const capturePlan = designIntentContract.visualQaPolicy.capturePlan;
+    if (!capturePlan || typeof capturePlan !== 'object') {
+      validationErrors.push('designIntent.visualQaPolicy.capturePlan must exist.');
+    } else {
+      if (capturePlan.requireAboveFoldCapture !== true) {
+        validationErrors.push('designIntent.visualQaPolicy.capturePlan.requireAboveFoldCapture must equal true.');
+      }
+      if (capturePlan.requireFullPageCapture !== true) {
+        validationErrors.push('designIntent.visualQaPolicy.capturePlan.requireFullPageCapture must equal true.');
+      }
+      if (capturePlan.requireSectionCapturesForLongPages !== true) {
+        validationErrors.push('designIntent.visualQaPolicy.capturePlan.requireSectionCapturesForLongPages must equal true.');
+      }
+      if (capturePlan.longPageStrategy !== 'anchor-plus-tiles') {
+        validationErrors.push('designIntent.visualQaPolicy.capturePlan.longPageStrategy must equal "anchor-plus-tiles".');
+      }
+      if (
+        typeof capturePlan.minimumSectionCaptureCount !== 'number'
+        || capturePlan.minimumSectionCaptureCount < 3
+      ) {
+        validationErrors.push('designIntent.visualQaPolicy.capturePlan.minimumSectionCaptureCount must be a number greater than or equal to 3.');
+      }
+      if (
+        typeof capturePlan.maxViewportHeightsPerTile !== 'number'
+        || capturePlan.maxViewportHeightsPerTile < 2
+        || capturePlan.maxViewportHeightsPerTile > 6
+      ) {
+        validationErrors.push('designIntent.visualQaPolicy.capturePlan.maxViewportHeightsPerTile must be a number between 2 and 6.');
+      }
+      if (
+        typeof capturePlan.tileOverlapRatio !== 'number'
+        || capturePlan.tileOverlapRatio <= 0
+        || capturePlan.tileOverlapRatio >= 0.5
+      ) {
+        validationErrors.push('designIntent.visualQaPolicy.capturePlan.tileOverlapRatio must be a number between 0 and 0.5.');
+      }
+      if (!Array.isArray(capturePlan.requiredSectionTypes) || capturePlan.requiredSectionTypes.length < 3) {
+        validationErrors.push('designIntent.visualQaPolicy.capturePlan.requiredSectionTypes must list the required section capture types.');
+      }
+    }
+
+    const maskingPolicy = designIntentContract.visualQaPolicy.masking;
+    if (!maskingPolicy || typeof maskingPolicy !== 'object') {
+      validationErrors.push('designIntent.visualQaPolicy.masking must exist.');
+    } else {
+      if (maskingPolicy.requireDynamicContentMasks !== true) {
+        validationErrors.push('designIntent.visualQaPolicy.masking.requireDynamicContentMasks must equal true.');
+      }
+      if (maskingPolicy.requireMaskReasonAnnotations !== true) {
+        validationErrors.push('designIntent.visualQaPolicy.masking.requireMaskReasonAnnotations must equal true.');
+      }
+      if (!Array.isArray(maskingPolicy.allowedDynamicMaskCategories) || maskingPolicy.allowedDynamicMaskCategories.length < 4) {
+        validationErrors.push('designIntent.visualQaPolicy.masking.allowedDynamicMaskCategories must list the approved masking categories.');
+      }
+    }
+
+    const stabilityPolicy = designIntentContract.visualQaPolicy.stability;
+    if (!stabilityPolicy || typeof stabilityPolicy !== 'object') {
+      validationErrors.push('designIntent.visualQaPolicy.stability must exist.');
+    } else {
+      if (typeof stabilityPolicy.maxUnmaskedDiffRatio !== 'number' || stabilityPolicy.maxUnmaskedDiffRatio <= 0 || stabilityPolicy.maxUnmaskedDiffRatio >= 0.1) {
+        validationErrors.push('designIntent.visualQaPolicy.stability.maxUnmaskedDiffRatio must be a number between 0 and 0.1.');
+      }
+      if (typeof stabilityPolicy.maxMaskedDiffRatio !== 'number' || stabilityPolicy.maxMaskedDiffRatio <= 0 || stabilityPolicy.maxMaskedDiffRatio >= 0.1) {
+        validationErrors.push('designIntent.visualQaPolicy.stability.maxMaskedDiffRatio must be a number between 0 and 0.1.');
+      }
+      if (stabilityPolicy.maxMaskedDiffRatio < stabilityPolicy.maxUnmaskedDiffRatio) {
+        validationErrors.push('designIntent.visualQaPolicy.stability.maxMaskedDiffRatio must be greater than or equal to maxUnmaskedDiffRatio.');
+      }
+      if (stabilityPolicy.requireConsistentRenderingEnvironment !== true) {
+        validationErrors.push('designIntent.visualQaPolicy.stability.requireConsistentRenderingEnvironment must equal true.');
+      }
+    }
+
+    const semanticEscalationPolicy = designIntentContract.visualQaPolicy.semanticEscalation;
+    if (!semanticEscalationPolicy || typeof semanticEscalationPolicy !== 'object') {
+      validationErrors.push('designIntent.visualQaPolicy.semanticEscalation must exist.');
+    } else {
+      if (semanticEscalationPolicy.requireMeaningfulDiffForEscalation !== true) {
+        validationErrors.push('designIntent.visualQaPolicy.semanticEscalation.requireMeaningfulDiffForEscalation must equal true.');
+      }
+      if (semanticEscalationPolicy.escalateWhenViewportCoverageIncomplete !== true) {
+        validationErrors.push('designIntent.visualQaPolicy.semanticEscalation.escalateWhenViewportCoverageIncomplete must equal true.');
+      }
+      if (semanticEscalationPolicy.skipSemanticJudgeWhenDeterministicClean !== true) {
+        validationErrors.push('designIntent.visualQaPolicy.semanticEscalation.skipSemanticJudgeWhenDeterministicClean must equal true.');
+      }
+      if (
+        typeof semanticEscalationPolicy.meaningfulDiffRatioThreshold !== 'number'
+        || semanticEscalationPolicy.meaningfulDiffRatioThreshold <= 0
+        || semanticEscalationPolicy.meaningfulDiffRatioThreshold >= 0.2
+      ) {
+        validationErrors.push('designIntent.visualQaPolicy.semanticEscalation.meaningfulDiffRatioThreshold must be a number between 0 and 0.2.');
+      }
+    }
+
+    const artifactContract = designIntentContract.visualQaPolicy.artifactContract;
+    if (!artifactContract || typeof artifactContract !== 'object') {
+      validationErrors.push('designIntent.visualQaPolicy.artifactContract must exist.');
+    } else {
+      if (artifactContract.requireMachineReadableDiffBundle !== true) {
+        validationErrors.push('designIntent.visualQaPolicy.artifactContract.requireMachineReadableDiffBundle must equal true.');
+      }
+      if (artifactContract.requireViewportResults !== true) {
+        validationErrors.push('designIntent.visualQaPolicy.artifactContract.requireViewportResults must equal true.');
+      }
+      if (artifactContract.mergeDeterministicAndSemanticVerdicts !== true) {
+        validationErrors.push('designIntent.visualQaPolicy.artifactContract.mergeDeterministicAndSemanticVerdicts must equal true.');
+      }
+    }
+  }
+
   if (!Array.isArray(designIntentContract.requiredDesignSections) || designIntentContract.requiredDesignSections.length !== DESIGN_REQUIRED_SECTIONS.length) {
     validationErrors.push('designIntent.requiredDesignSections must match the required design contract sections.');
   } else {

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

@@ -133,9 +133,10 @@ export function buildDesignBootstrapPrompt({
     '8. Responsive Strategy and Cross-Viewport Adaptation Matrix',
     '9. Motion and Interaction Principles',
     '10. Component Language and Morphology (cards, forms, nav, states)',
-    '11. Accessibility Non-Negotiables',
-    '12. Anti-Patterns to Avoid',
-    '13. Implementation Notes for Future UI Tasks',
+    '11. Context Hygiene and Approved Reference Boundaries',
+    '12. Accessibility Non-Negotiables',
+    '13. Anti-Patterns to Avoid',
+    '14. Implementation Notes for Future UI Tasks',
     '',
     '## Required design-intent.json Fields',
     '1. mode',
@@ -151,11 +152,15 @@ export function buildDesignBootstrapPrompt({
     '11. crossViewportAdaptation',
     '12. motionSystem',
     '13. componentMorphology',
-    '14. experiencePrinciples',
-    '15. forbiddenPatterns',
-    '16. validationHints',
-    '17. requiredDesignSections',
-    '18. implementation',
+    '14. accessibilityPolicy',
+    '15. visualQaPolicy',
+    '16. contextHygiene',
+    '17. experiencePrinciples',
+    '18. forbiddenPatterns',
+    '19. validationHints',
+    '20. requiredDesignSections',
+    '21. implementation',
+    '22. repoEvidence when onboarding or detector evidence exists',
     '',
     '## Hard Rules',
     '1. No copy-paste from external style guides.',
@@ -169,8 +174,15 @@ export function buildDesignBootstrapPrompt({
     '9. Responsive guidance must include layout mutation rules for mobile, tablet, and desktop. Shrinking the desktop layout is not enough.',
     '10. Motion can be bold, cinematic, or highly expressive when it improves memorability, hierarchy, feedback, or product confidence. Optimize it instead of flattening it. Only reject motion when it harms clarity, accessibility, or runtime performance.',
     '11. Define component morphology across interaction states and viewports so cards, forms, nav, and feedback surfaces adapt coherently instead of only resizing.',
-    '11. Keep UI-only requests context-isolated. Load frontend design rules first and do not eagerly load backend-only rules unless the task explicitly crosses those boundaries.',
-    '12. Make at least one memorable visual bet so the resulting system is recognizable and not template-neutral.',
+    '12. Keep UI-only requests context-isolated. Load frontend design rules first and do not eagerly load backend-only rules unless the task explicitly crosses those boundaries.',
+    '13. Treat WCAG 2.2 AA as the hard accessibility floor. Use APCA only as advisory perceptual tuning, never as a reason to waive a WCAG failure.',
+    '14. Accessibility planning must explicitly cover focus visibility, focus appearance, target size, accessible authentication, keyboard access, and dynamic status/state access.',
+    '15. Hybrid visual QA must stay deterministic-first. Define screenshot-baseline expectations, dynamic masking rules, noise thresholds, required mobile/tablet/desktop coverage, and long-page capture strategy before relying on semantic review.',
+    '16. Do not treat one screenshot as enough for a long page. Require above-fold capture, full-page capture when stable, and anchor-based section or tiled-scroll captures for deep pages.',
+    '17. Only escalate visual diffs to a semantic judge when deterministic evidence shows meaningful drift or missing required coverage.',
+    '18. Treat prior website memory, unrelated project aesthetics, and remembered screenshots as tainted context unless the user explicitly approves continuity.',
+    '19. Design continuity is opt-in. If no approved continuity exists, synthesize from the current repo evidence, current brief, and current project docs only.',
+    '20. Make at least one memorable visual bet so the resulting system is recognizable and not template-neutral.',
     '',
     '## Project Inputs',
     `- Project name: ${discoveryAnswers.projectName}`,
@@ -189,8 +201,13 @@ export function buildDesignBootstrapPrompt({
     '## Required Execution',
     '1. Create or update docs/DESIGN.md with complete content.',
     '2. Create or update docs/design-intent.json with machine-readable design intent.',
-    '3. Ensure both files stay project-specific, dynamic, and practical for implementation and review.',
-    '4. After the contract exists, use it as a first-class source for future UI tasks.',
+    '3. Keep both files synchronized: the markdown explains the rationale and the JSON captures the machine-readable contract.',
+    '4. Encode accessibility as a split policy: WCAG 2.2 AA hard floor, APCA advisory readability tuning, and explicit hard-vs-advisory checks.',
+    '5. Encode hybrid visual QA as policy: deterministic-first screenshot review, approved masking categories, stability thresholds, required mobile/tablet/desktop coverage, long-page capture strategy, and semantic escalation boundaries.',
+    '6. Make long-page handling explicit: above-fold capture, full-page capture when stable, and anchor-based section or tiled-scroll captures when one image would miss deep content.',
+    '7. Preserve repoEvidence.designEvidenceSummary when onboarding or detector evidence exists instead of discarding it.',
+    '8. Ensure both files stay project-specific, dynamic, and practical for implementation and review.',
+    '9. After the contract exists, use it as a first-class source for future UI tasks.',
     '',
   ].join('\n');
 }