@ryuenn3123/agentic-senior-core 4.3.1 → 4.3.4

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

@@ -136,7 +136,6 @@ export function buildDesignBootstrapPrompt({
     '',
     'You are the Lead UI/UX Art Director for this project.',
     'Create a dynamic design contract, not a fixed stylistic template.',
-    'Use imperative, compact, mechanical rules.',
     '',
     '## Mission',
     `Author docs/DESIGN.md in ${docsLanguage.toUpperCase()} language with strong art direction and engineering-ready guidance.`,
@@ -146,133 +145,21 @@ export function buildDesignBootstrapPrompt({
     '1. docs/DESIGN.md',
     '2. docs/design-intent.json',
     '',
-    '## Required DESIGN.md Sections',
-    '1. Design Intent and Product Personality',
-    '2. Audience and Use-Context Signals',
-    '3. Visual Direction and Distinctive Moves',
-    '4. Color, Typography, Spacing, and Density Decisions',
-    '5. Token Architecture and Alias Strategy',
-    '6. Responsive Strategy and Cross-Viewport Adaptation Matrix',
-    '7. Motion and Interaction Rules',
-    '8. Component Language and Morphology',
-    '9. Context Hygiene and Source Boundaries',
-    '10. Accessibility Non-Negotiables',
-    '11. Anti-Patterns to Avoid',
-    '12. Implementation Notes for Future UI Tasks',
+    '## Design Direction Process',
+    'Follow `.agent-context/prompts/bootstrap-design.md` for the three-step design direction:',
+    '1. Name your defaults (three temptations and why each flattens this product)',
+    '2. Choose a concrete anchor (googleable, specific, not a generic quality word)',
+    '3. Record creative commitments (typography, palette, motion, composition)',
     '',
-    '## Required design-intent.json Fields',
-    '1. mode',
-    '2. status',
-    '3. project',
-    '4. designPhilosophy',
-    '5. visualDirection',
-    '6. externalResearchIntake',
-    '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. researchDossier',
-    '30. repoEvidence when onboarding or detector evidence exists',
-    '',
-    '## Mechanical Gates',
-    '0. Read `.agent-context/prompts/research-design.md` first. Sections 3 (Category Code Identification), 4 (Morphological Exploration), and 5 (Anchor Candidates) are gates: each must produce an auditable artifact before UI implementation.',
-    '0a. Complete the Live Source Freshness Gate from research-design.md before claiming a pattern, library, browser feature, accessibility requirement, or interaction style is current. Use the session current date as the rolling freshness reference; modern means relative to that date, not a fixed calendar range.',
-    '0b. Keep research vocabulary internal: evidence, dossier, anchor, category-code, morphology, rename-test, and source-freshness labels guide decisions but must not leak into UI copy, public-facing docs, or final user-facing rationale unless the user asks for the research trace.',
-    '1. Do not copy external style guides.',
-    '2. Do not anchor the final design language to famous products, benchmark visuals, or external reference surfaces.',
-    '3. Do not choose final style, library, palette, typography, motion, or layout from this offline scaffold.',
-    '4. Use repo evidence, active brief, current docs, and current official docs for technology choices.',
-    '5. Keep UI-only requests context-isolated; load frontend rules first.',
-    '6. Preserve Design continuity is opt-in. Use current repo evidence unless the user approves continuity.',
-    '7. Treat prior website memory, unrelated project aesthetics, remembered screenshots, and old design docs as tainted unless approved.',
-    '8. Use primitive, semantic, and component tokens. Component tokens must consume semantic aliases.',
-    '9. Encode colorTruth in perceptual terms. Hex values are implementation derivatives.',
-    '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.',
-    '16. Do not depend on screenshot capture, browser automation, or image diffs as the default quality path.',
-    '17. Make one memorable visual bet before code.',
-    '18. Do not ship AI-safe UI, decorative grid, line, scanline, or calibration-mark wallpaper, generic SaaS gradients, or default component-kit styling without product rationale.',
-    '19. Use visually exploratory, product-derived palettes while preserving WCAG contrast and status clarity.',
-    '20. Complete the AI color audit before code.',
-    '21. Treat motion, 3D, canvas, WebGL, scroll choreography, and modern animation libraries as first-class options.',
-    '22. If motion or spatial UI is omitted, document the product-fit reason and replacement interaction quality.',
-    '23. If the user supplies research files, library lists, screenshots, articles, or benchmark notes, read them as candidate evidence and verify technology claims.',
-    '23a. User-provided concepts are first-class constraints: support, refine, or challenge them with evidence; do not override them with trend defaults unless a product, accessibility, technical, or evidence conflict is recorded.',
-    '24. If no user-supplied research or reference exists, activate the Dynamic Avant-Garde Anchor Engine before coding; old design docs do not count as research.',
-    '25. In Dynamic Avant-Garde mode, consider three high-variance anchors, discard the two safest or most predictable options, and output only the chosen anchor.',
-    '26. Reject final anchors named dashboard, portal, cards, admin panel, SaaS shell, web app shell, or minimalist interface.',
-    '27. Reject anchors described only as modern, clean, premium, expressive, minimal, or bold.',
-    '27a. Do not default anchors to room, darkroom, counting room, control room, war room, studio, lab, cockpit, or command center unless the product genuinely depends on that physical place model.',
-    '27b. Prefer artifacts, custody flows, instruments, data behaviors, material systems, editorial systems, service rituals, or interaction mechanisms over "where the interface lives".',
-    '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. Do not default to shadcn/ui, Tailwind-only, native-only, or any component kit by habit, and do not avoid them out of guardrail fear; 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.',
-    '33a. Tailwind-first is valid only when the stack, token model, and team workflow support it; pure Tailwind, vanilla CSS, shadcn/ui, or any component kit is not neutral by default and not forbidden by default.',
-    '33b. For fresh framework projects, prefer official setup commands when official docs show they create the supported project shape; manual file assembly requires a repo, prototype, learning, or architecture reason.',
-    '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.',
-    '41. Use external websites and benchmark examples as candidate evidence for constraints, mechanics, and quality bars only; do not copy layout rhythm, palette, component skin, visual metaphor, or brand posture.',
-    '',
-    '## Research-Design Brief Gates (research-design.md)',
-    '41a. Live Source Freshness Gate: record researchDossier.sourceFreshness and evidenceTable[] with claim, sourceUrl, sourceType, publishedOrUpdatedAt, fetchedAt, confidence, and decisionImpact. Use current official docs or primary release notes for implementation claims. Trend, category-code, and visual-language claims prefer sources published or materially updated within the last 24 months from the current date. Older sources must be labeled old-timeless and may support durable principles only.',
-    '42. Section 3 — Category Code Identification: list at least three category codes per product surface in `conceptualAnchor.categoryCodes.candidateEntries`. Each entry must record `description`, `specificityEvidence`, `categoryDefaultReason`, and `rejectionNote`. The specificity floor is: a reader unfamiliar with the project must be able to visualize a specific aesthetic direction from the text alone, without seeing the UI and without knowing the product name. Reject placeholder phrases like "clean typography", "modern color palette", or "smooth animations". Anti-leakage rule: listing a cliche identifies a trap, not a target; the example cliches in the brief are not aesthetic candidates for any project. If the project pattern-matches a common AI-safe default (dev-tool dark slate, AI-startup purple-pink gradient, health-app mint, SaaS admin three-card KPI, marketing-site three-tile hero), name that cliche in `candidateEntries` with an explicit rejection note.',
-    '43. Section 4 — Morphological Exploration: build a 5x5 or 6x5 matrix in `conceptualAnchor.morphologicalExploration`. Choose 5 or 6 dimensions and 5 values per dimension. Do not seed the matrix with the Section 3 category codes as values. Highlight the selected combination, and ALSO highlight at least one uncomfortable combination that feels instinctively wrong but can be argued with product logic. The uncomfortable combination must record `combinationLabel`, `discomfortReason`, and `productLogicJustification`. If you cannot produce an uncomfortable-but-arguable combination, the dimensions are too narrow; widen at least one and regenerate.',
-    '44. Section 5 — Anchor Candidates: produce exactly five entries in `conceptualAnchor.anchorCandidates.candidates`. Each candidate must record `anchorReference`, `conceptualFamily`, `jobFit`, `hierarchyImplication`, `densityImplication`, `typeImplication`, `stateLanguage`, `motionImplication`, `whatItRulesOut`, `renameTest`, and `categoryCodeOverlap`.',
-    '45. Strengthened rename test: rename the product to three genuinely different categories that are remote from each other and from the actual product. Pick fresh test categories per anchor; do not reuse the same triple across every anchor. Record the three test categories explicitly in the dossier so a human reviewer can audit them. Score the result: 0/3 coherent equals STRONG PASS, 1/3 equals PASS, 2/3 equals REVISE, 3/3 equals DISCARD. Never select an anchor with verdict DISCARD; revise REVISE candidates until they fail in at least 2 of 3 categories.',
-    '46. Make `conceptualAnchor.anchorReference` and `derivedTokenLogic.anchorReference` match the selected anchor exactly. The selected anchor must have verdict STRONG PASS or PASS.',
-    '',
-    '## 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.',
-    'The ambition floor is not a fixed aesthetic. Quiet, dense, utilitarian, or text-heavy interfaces are allowed when the product requires them, but they still need a project-specific visual decision and a real reason for omitting richer motion, 3D, canvas, WebGL, scroll choreography, or animation libraries.',
-    'Measurement, calibration, crop, route, timeline, and inspection marks may be used only as task-bound overlays or control affordances. They must not become page wallpaper, hero texture, or first-output background filler.',
-    'Use reduced-motion fallbacks instead of suppressing motion.',
-    '',
-    '## Token Derivation Audit',
-    'Before implementation, docs/design-intent.json must include derivedTokenLogic.anchorReference plus colorDerivationSource, spacingDerivationSource, typographyDerivationSource, motionDerivationSource, colorSpace, spatialBaseUnit, typeScaleMethod, motionBudget, and validationRule.',
-    '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.',
-    '',
-    '## Implementation Craft Layer',
-    'Record explicit CSS craft decisions before UI code: color space and commitment level, fluid typography method, spacing base unit, motion budget, and the default CSS reflex this project rejects.',
-    'Prefer OKLCH, tinted neutrals, clamp() type scales, transform/opacity motion, and responsive recomposition when supported by the stack; preserve existing design-system tokens and document fallbacks instead of forcing rewrites.',
-    '',
-    '## 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 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.',
-    'For fresh projects, compare the user-constrained or strongest-fit framework against at least one plausible alternative when no framework is explicitly selected. Do not let Next.js or any familiar web stack win by pattern frequency.',
+    '## Hard Rules',
+    '1. Do not copy external style guides or anchor to famous product surfaces.',
+    '2. Do not choose final style, library, palette, typography, or motion from this offline scaffold.',
+    '3. Use repo evidence, active brief, current docs, and current official docs for technology choices.',
+    '4. WCAG 2.2 AA is the hard floor. APCA is advisory perceptual tuning only.',
+    '5. Research current official docs before importing any new UI-related library.',
+    '6. Do not default to any component kit by habit, and do not avoid them when they fit.',
+    '7. Keep research vocabulary internal; evidence, anchor, and category-code labels must not appear in public-facing docs.',
+    '8. Treat production content as blocking: remove demo, placeholder, lorem, TODO, and scaffold copy.',
     '',
     '## Project Inputs',
     `- Project name: ${discoveryAnswers.projectName}`,
@@ -283,33 +170,18 @@ export function buildDesignBootstrapPrompt({
     `- Architecture constraint: ${initContext.blueprintFileName === 'agent-decision-architecture.md' ? 'agent recommendation required before coding' : toTitleCase(initContext.blueprintFileName)}`,
     '',
     '## Seed Machine Contract',
-    'Refine this scaffold seed instead of discarding it. Keep the structural fields that are already valid, but replace all placeholder expressive direction with agent-chosen decisions grounded in repo evidence, the active brief, and live official docs when technology choices matter.',
+    'Refine this scaffold seed instead of discarding it. Replace placeholder direction with agent-chosen decisions grounded in repo evidence and the active brief.',
     '```json',
     designIntentSeed.trim(),
     '```',
     '',
     '## 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. 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 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.',
-    '11. Ensure both files stay project-specific, dynamic, and practical for implementation and review. The seed may guide structure, but it must not decide style offline.',
-    '12. Keep visualResetStrategy in the machine-readable handoff so reset-language tasks cannot quietly become restyles of the previous UI.',
-    '13. Preserve externalResearchIntake so user-provided research becomes reviewed evidence without turning into an offline style or dependency preset.',
-    '14. Preserve conceptualAnchor so prompt-only UI work has one cohesive non-template concept instead of a mixed collection of bold but unrelated visual decisions.',
-    '15. Record conceptualAnchor.agentResearchMode, specificReferencePoint, signatureMotion, typographicDecision, visualRiskBudget, motionRiskBudget, and cohesionChecks so the final UI cannot quietly fall back to a timid dashboard/admin mental model.',
-    '15a. Record conceptualAnchor.categoryCodes.candidateEntries (Section 3 of research-design.md), conceptualAnchor.morphologicalExploration with selectedCombination and uncomfortableCombination (Section 4), and conceptualAnchor.anchorCandidates.candidates with full renameTest results (Section 5) before UI implementation.',
-    '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.',
+    '1. Create or update docs/DESIGN.md with complete content covering: design intent, audience signals, visual direction, color/typography/spacing decisions, responsive strategy, motion rules, component language, accessibility non-negotiables, and anti-patterns.',
+    '2. Create or update docs/design-intent.json with machine-readable design intent including conceptualAnchor, creative commitments, and anti-repeat ledger.',
+    '3. Keep both files synchronized.',
+    '4. Make the contract executable without screenshot dependency.',
+    '5. Preserve repoEvidence.designEvidenceSummary when onboarding or detector evidence exists.',
+    '6. After the contract exists, use it as a first-class source for future UI tasks.',
     '',
   ].join('\n');
 }

package/package.json

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

package/scripts/frontend-usability-audit.mjs

@@ -50,30 +50,6 @@ const REQUIRED_ARCHITECTURE_CHECKLIST_SNIPPETS = [
 ];
 
 const REQUIRED_FRONTEND_RULE_SNIPPETS = [
-  'Frontend Design and Interaction Boundaries',
-  'Load this rule for UI-facing work. Keep the loaded surface small.',
-  '## FE-001: Activation',
-  '## FE-002: Authority',
-  'Treat `.agent-context/` as design governance authority.',
-  'Treat `README.md` as public and developer overview, setup, usage, and user-facing context only',
-  'Do not choose final style, framework, palette, typography, layout paradigm, or animation library offline.',
-  'Keep design continuity opt-in.',
-  'Repo evidence outranks memory residue.',
-  'Use the current date as the freshness anchor for design research.',
-  'Treat user-provided concepts as first-class constraints.',
-  '## FE-003: Required Design Contract',
-  '## FE-004: Anti-Generic UI Gate',
-  'Do not ship interchangeable dashboard chrome',
-  'Do not let repeated surfaces share one visual treatment by habit',
-  'Use the rename test:',
-  'decorative geometry are invalid as wallpaper',
-  '## FE-005: Dynamic Anchor Gate',
-  '## FE-006: Motion, Palette, and 3D',
-  'Treat motion, 3D, WebGL, canvas, scroll choreography, and animation libraries as first-class options.',
-  'Prefer visually exploratory, product-derived palettes while preserving WCAG contrast and status clarity.',
-  '## FE-008: Responsive Mutation',
-  'Responsive quality is not scale-only.',
-  'container queries',
   '## FE-009: Accessibility',
   'WCAG 2.2 AA is the hard floor.',
   'APCA is advisory perceptual tuning only.',
@@ -84,26 +60,10 @@ const REQUIRED_FRONTEND_RULE_SNIPPETS = [
 ];
 
 const REQUIRED_BOOTSTRAP_DESIGN_SNIPPETS = [
-  'This contract is a decision scaffold, not a style preset.',
-  'We guide the agent; we do not pick the final style',
-  'Responsive Recomposition Plan',
-  'Token Architecture and Alias Strategy',
-  'repoEvidence.designEvidenceSummary',
-  'research current official docs',
-  'Responsive design means recomposition, not resizing.',
-  'Implementation Craft Layer',
-  'agent-chosen visual direction',
-  'viewport mutation rules',
-  'WCAG 2.2 AA is the hard floor',
-  'APCA may be used only as advisory perceptual tuning',
-  'unresearched dependency choices',
-  'Dynamic UI Foundation Selection',
-  'Adaptive Research Freshness',
-  'fixed calendar range',
-  'research vocabulary internal',
-  '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',
+  'WCAG 2.2 AA is the hard compliance floor',
+  'Name Your Defaults',
+  'Choose an Anchor',
+  'Creative Commitments'
 ];
 
 const REQUIRED_UI_DESIGN_JUDGE_SNIPPETS = [
@@ -135,7 +95,6 @@ const REQUIRED_INSTRUCTIONS_SNIPPETS = [
   'External references, prior-chat memory, unrelated-project visuals, and remembered screenshots are tainted',
   'WCAG 2.2 AA as the hard compliance floor',
   'APCA as advisory perceptual tuning only',
-  'Do not require screenshot capture as a baseline dependency',
 ];
 
 const REQUIRED_DESIGN_EVIDENCE_SNIPPETS = [

package/scripts/release-gate/constants.mjs

@@ -44,6 +44,7 @@ export const REQUIRED_BACKEND_REVIEW_CHECKLIST_SNIPPETS = [
   'Backend/API governance was applied through global domain rules',
 ];
 
+export const REQUIRED_RELEASE_VERSION = '4.3.4';
 export const REQUIRED_REFACTOR_PROMPT_SNIPPETS = [
   'Enforce backend universal principles: no clever hacks, no premature abstraction, readability over brevity.',
   'Prioritize maintainability over compressed one-liners.',

package/scripts/validate/config.mjs

@@ -21,16 +21,7 @@ export const FORMAL_ARTIFACT_PATHS = [
   'GEMINI.md',
 ];
 export const REQUIRED_HUMAN_WRITING_SNIPPETS = [
-  {
-    path: '.agent-context/rules/api-docs.md',
-    snippets: [
-      '## API-006: Human Writing Standard (Mandatory)',
-      'This applies to documentation, release notes, onboarding text, review summaries, and agent-facing explanations.',
-      'Style baseline findings are advisory by default and must not block endpoint-change commits that already include accurate docs/spec updates.',
-      'Write formal project docs in English by default',
-      'No emoji in formal artifacts.',
-    ],
-  },
+  
   {
     path: '.agent-context/review-checklists/pr-checklist.md',
     snippets: [
@@ -161,18 +152,8 @@ export const REQUIRED_STACK_DECISION_BOUNDARY_SNIPPETS = [
       'produce a short evidence-backed recommendation from the brief, repo evidence, and live official documentation before coding',
     ],
   },
-  {
-    path: '.agent-context/rules/architecture.md',
-    snippets: [
-      'Do not force a default architecture label before the repo, delivery model, and boundary evidence are clear.',
-    ],
-  },
-  {
-    path: '.agent-context/rules/microservices.md',
-    snippets: [
-      'Do not start with microservices by fashion, fear, or habit.',
-    ],
-  },
+  
+  
   {
     path: 'lib/cli/commands/init.mjs',
     snippets: [
@@ -192,16 +173,7 @@ export const REQUIRED_UNIVERSAL_SOP_SNIPPETS = [
       'Do not write application, firmware, or UI code',
     ],
   },
-  {
-    path: '.agent-context/rules/architecture.md',
-    snippets: [
-      '## ARCH-003: Universal SOP Baseline (Mandatory)',
-      'Root `README.md` must exist for every fresh or existing project',
-      '`docs/doc-index.md` must exist whenever `docs/` exists',
-      'Security and testing are non-negotiable baseline requirements.',
-      'If required project context docs are missing, stop implementation and bootstrap docs before writing application code.',
-    ],
-  },
+  
   {
     path: '.agent-context/prompts/init-project.md',
     snippets: [
@@ -252,20 +224,12 @@ export const REQUIRED_UNIVERSAL_SOP_SNIPPETS = [
       'Documentation-first policy:',
       'Keep README.md public and developer friendly',
       'For docs-only/docs-first requests, do not write application, firmware, or UI code until the user asks or approves an implementation plan.',
-      'For UI scope: if docs/DESIGN.md or docs/design-intent.json is missing, execute bootstrap-design prompt before implementing UI surfaces.',
+      'Follow the three-step design direction process in bootstrap-design.md',
     ],
   },
 ];
 export const REQUIRED_DIAGRAM_FORMAT_SNIPPETS = [
-  {
-    path: '.agent-context/rules/api-docs.md',
-    snippets: [
-      '## API-013: Documentation Diagram Format (Mandatory)',
-      'Mermaid.js as the default diagram format',
-      'Do not use PlantUML',
-      'convert the relevant sections to Mermaid diagrams in the same change',
-    ],
-  },
+  
   {
     path: 'lib/cli/project-scaffolder/prompt-builders.mjs',
     snippets: [
@@ -328,15 +292,9 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'Documentation-First Mode',
       'English by default',
       'do not write application, firmware, or UI code',
-      'Motion/Palette Decision',
-      'product categories are heuristics',
+      'three-step direction process',
+      'anti-repeat ledger',
       'perform live web research',
-      'research-design.md',
-      'researchDossier.metadata',
-      'researchVerifiedAt',
-      'freshnessWindowDays',
-      'Anti-repeat ledger',
-      'user-explicit redesign',
     ],
   },
   {
@@ -346,8 +304,6 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'UI Design Mode',
       'bootstrap-design.md',
       'frontend-architecture.md',
-      'Motion/Palette Decision',
-      'product categories are heuristics',
       'do not eagerly load unrelated backend-only rules',
       'valid style context',
       'External references, prior-chat memory, unrelated-project visuals, and remembered screenshots are tainted',
@@ -358,63 +314,16 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
   {
     path: '.agent-context/prompts/bootstrap-design.md',
     snippets: [
-      'This contract is a decision scaffold, not a style preset.',
-      'We guide the agent; we do not pick the final style',
-      'Token Architecture and Alias Strategy',
-      '`repoEvidence.designEvidenceSummary`',
-      'Responsive Recomposition Plan',
-      'source of truth',
+      'WCAG 2.2 AA is the hard compliance floor',
+      'Name Your Defaults',
+      'Choose an Anchor',
+      'Creative Commitments',
+      'anti-repeat ledger',
+      'Named Defaults to Avoid',
+      'Post-Implementation Check',
+      'Redesign Protocol',
       'research current official docs',
-      'motionPaletteDecision',
-      'AI-safe UI',
-      '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`',
-      'AI color drift',
-      'first-class UI options',
-      'product categories are heuristics',
-      'Responsive design means recomposition, not resizing.',
-      'agent-chosen visual direction',
-      'viewport mutation rules',
-      'WCAG 2.2 AA is the hard floor',
-      'APCA may be used only as advisory perceptual tuning',
-      'unresearched dependency choices',
-      'Dynamic UI Foundation Selection',
-      'Adaptive Research Freshness',
-      'fixed calendar range',
-      'research vocabulary internal',
-      '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',
-      'research-design.md',
-      'Section 3 gate from `research-design.md`',
-      'Pre-Emit Identity Check',
-    ],
-  },
-  {
-    path: '.agent-context/prompts/research-design.md',
-    snippets: [
-      '# Research-Design Brief',
-      '## Section 3 — Creative Direction',
-      '### 3a. Category defaults to avoid',
-      '### 3b. Anchor reference',
-      '### 3c. Four creative commitments',
-      'AI slop',
-      'Anti-Repeat Ledger Gate',
-      'Live Source Freshness Gate',
-      'rolling-current',
-      'evidenceTable[]',
-      'old-timeless',
-      'Research vocabulary is internal-only',
-      'previousAnchors',
-      'previousMotionSignatures',
-      'tokenContinuityClassification',
-      'categoryCodes',
+      'product-specific reason',
     ],
   },
   {
@@ -566,8 +475,7 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'LAYER 1: RULES (SCOPE-RESOLVED)',
       'LAYER 5: EXECUTION PROMPTS AND UI TRIGGERS',
       'bootstrap-design.md -> ui, ux, layout, screen, tailwind, frontend, redesign',
-      'Keep UI-only requests context-isolated',
-      'git-workflow.md',
+      'three-step design direction process in bootstrap-design.md',
       'designEvidenceSummary',
     ],
   },
@@ -580,18 +488,7 @@ export const REQUIRED_DOCKER_RUNTIME_AUTOMATION_SNIPPETS = [
       'For Docker or Compose work, load `docker-runtime.md` and verify the latest official Docker docs before authoring container assets.',
     ],
   },
-  {
-    path: '.agent-context/rules/docker-runtime.md',
-    snippets: [
-      'latest official Docker documentation first',
-      'Docker Compose Quickstart',
-      'Compose file reference',
-      'Dockerfile best practices',
-      'Use current `docker compose` workflows and `compose.yaml`.',
-      'Do not add the top-level Compose `version` field by default.',
-      'Use the latest stable compatible Docker base image',
-    ],
-  },
+  
   {
     path: '.agent-context/prompts/init-project.md',
     snippets: [
@@ -607,17 +504,7 @@ export const REQUIRED_DEPENDENCY_FRESHNESS_AUTOMATION_SNIPPETS = [
       'use the latest stable compatible dependency set and official setup flow',
     ],
   },
-  {
-    path: '.agent-context/rules/efficiency-vs-hype.md',
-    snippets: [
-      'Latest-Compatible-First Rule',
-      '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',
-    ],
-  },
+  
   {
     path: '.agent-context/prompts/init-project.md',
     snippets: [
@@ -649,7 +536,6 @@ export const FORBIDDEN_ACTIVE_BIAS_ANCHOR_SNIPPETS = [
     snippets: [
       'stylistic inspiration',
       'famous brand reference',
-      'If no approved reference system exists',
       'explicitly approved reference systems',
     ],
   },

package/scripts/validate/coverage-checks.mjs

@@ -360,13 +360,9 @@ export async function validateInstructionAdapters(context) {
     'unreachable_files',
     'validation_plan',
   ];
-  const requiredUiReadabilitySnippets = [
-    'Motion/Palette Decision',
-    'product categories are heuristics',
-  ];
   const instructionFootprintLimits = [
     { path: 'AGENTS.md', maxLines: 180 },
-    { path: '.agent-context/prompts/bootstrap-design.md', maxLines: 235 },
+    { path: '.agent-context/prompts/bootstrap-design.md', maxLines: 80 },
     { path: '.agent-context/rules/frontend-architecture.md', maxLines: 180 },
   ];
 
@@ -378,13 +374,7 @@ export async function validateInstructionAdapters(context) {
     }
   }
 
-  for (const requiredUiReadabilitySnippet of requiredUiReadabilitySnippets) {
-    if (canonicalInstructionContent.includes(requiredUiReadabilitySnippet)) {
-      pass(`AGENTS.md includes UI readability snippet: ${requiredUiReadabilitySnippet}`);
-    } else {
-      fail(`AGENTS.md is missing UI readability snippet: ${requiredUiReadabilitySnippet}`);
-    }
-  }
+
 
   for (const footprintLimit of instructionFootprintLimits) {
     const absoluteFootprintPath = join(ROOT_DIR, footprintLimit.path);