@ryuenn3123/agentic-senior-core 4.3.6 → 4.3.7

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

@@ -59,4 +59,4 @@ When the user says "redesign from zero" or equivalent: treat existing UI as beha
 
 ## Required Docs
 
-Generate or refine `docs/DESIGN.md` (human-readable design direction) and `docs/design-intent.json` (machine-readable intent with `conceptualAnchor`, creative commitments, and anti-repeat ledger) before UI implementation.
+Generate or refine `docs/DESIGN.md` before UI implementation. Keep design rationale, creative commitments, and any anti-repeat notes in the markdown contract instead of a separate machine-readable JSON file.

package/.agent-context/prompts/init-project.md

@@ -26,7 +26,7 @@ If the user describes a project or feature, the agent must:
 If the user asks to create, complete, fix, or review project docs, documentation, dokumen, `docs/*`, architecture docs, flow docs, API docs, or "lengkapkan docs", treat the request as documentation-first.
 
 The agent must:
-1. Materialize or refine required project docs before implementation: root `README.md` for every fresh or existing project; `docs/doc-index.md` whenever `docs/` exists; `docs/project-brief.md`; `docs/architecture-decision-record.md`; `docs/flow-overview.md`; `docs/api-contract.md` when APIs, firmware endpoints, CLI commands, or web application flows exist; `docs/database-schema.md` when persistent data exists; and `docs/DESIGN.md` plus `docs/design-intent.json` for UI scope.
+1. Materialize or refine required project docs before implementation: root `README.md` for every fresh or existing project; `docs/doc-index.md` whenever `docs/` exists; `docs/project-brief.md`; `docs/architecture-decision-record.md`; `docs/flow-overview.md`; `docs/api-contract.md` when APIs, firmware endpoints, CLI commands, or web application flows exist; `docs/database-schema.md` when persistent data exists; and `docs/DESIGN.md` for UI scope.
 2. Write formal project docs in English by default unless the user explicitly asks for another documentation language.
 3. Keep `docs/doc-index.md` short. Use it as the read-routing map with document path, purpose, reads-when triggers, status, and last-updated date. Do not duplicate the docs it points to.
 4. Keep `README.md` public and developer friendly even for private projects: explain what the project is, who it is for, how to set it up, how to run the core workflow, how to configure it, and where deeper docs live. Do not put internal agent notes, private reasoning, secrets, or governance policy in the README.
@@ -58,5 +58,5 @@ See [.agent-context/state/onboarding-report.json](../state/onboarding-report.jso
 
 ## UI/UX Bootstrap
 
-When a user requests frontend or UI/UX design, the agent must automatically execute the [bootstrap-design.md](./bootstrap-design.md) prompt to synthesize a dynamic design contract (`docs/DESIGN.md` + `docs/design-intent.json`).
+When a user requests frontend or UI/UX design, the agent must automatically execute the [bootstrap-design.md](./bootstrap-design.md) prompt to synthesize a dynamic markdown design contract (`docs/DESIGN.md`).
 Keep UI-only requests context-isolated: load [bootstrap-design.md](./bootstrap-design.md) and [frontend-architecture.md](../rules/frontend-architecture.md) first, and do not eagerly load backend-only rules unless the task explicitly crosses backend boundaries.

package/.agent-context/prompts/refactor.md

@@ -11,7 +11,7 @@ Before editing:
 3. If required project docs are missing, stop and bootstrap or update docs first.
 4. If the change touches UI, load .agent-context/prompts/bootstrap-design.md and .agent-context/rules/frontend-architecture.md before editing.
 5. If the change touches a dependency, framework, Docker, runtime, or ecosystem claim, verify current official docs before choosing.
-6. Enforce Universal SOP hard gate: stop implementation if root `README.md` is missing, if `docs/doc-index.md` is missing while `docs/` exists, if `docs/project-brief.md` is missing, if `docs/architecture-decision-record.md` is missing, if `docs/flow-overview.md` is missing, if `docs/database-schema.md` is missing while the project uses persistent data, if `docs/api-contract.md` is missing while the project exposes API or web application flows, or for UI scope if `docs/DESIGN.md` or `docs/design-intent.json` is missing.
+6. Enforce Universal SOP hard gate: stop implementation if root `README.md` is missing, if `docs/doc-index.md` is missing while `docs/` exists, if `docs/project-brief.md` is missing, if `docs/architecture-decision-record.md` is missing, if `docs/flow-overview.md` is missing, if `docs/database-schema.md` is missing while the project uses persistent data, if `docs/api-contract.md` is missing while the project exposes API or web application flows, or for UI scope if `docs/DESIGN.md` is missing.
 7. Enforce backend universal principles: no clever hacks, no premature abstraction, readability over brevity.
 8. For backend/API scope, enforce layered boundaries, zero-trust input validation, safe centralized error responses, bounded list reads, transaction safety for multi-write mutations, idempotency for sensitive mutations, and behavior-focused API tests.
 9. Backend/API governance is global and stack-agnostic. Do not create stack-specific adapters or framework-specific rule branches; apply the global rules through the framework already present in the target project.

package/.agent-context/prompts/review-code.md

@@ -10,8 +10,8 @@ Before reviewing:
 2. Read .agent-context/review-checklists/pr-checklist.md.
 3. Read .agent-context/review-checklists/architecture-review.md only when architecture or boundaries changed.
 4. Load only the rules relevant to the changed scope.
-5. For UI changes, load .agent-context/prompts/bootstrap-design.md, .agent-context/rules/frontend-architecture.md, docs/DESIGN.md, and docs/design-intent.json when present.
-6. Enforce Universal SOP hard gate: block coding flow when required project docs are missing (root `README.md`; `docs/doc-index.md` when `docs/` exists; `docs/project-brief.md`; `docs/architecture-decision-record.md`; `docs/flow-overview.md`; `docs/database-schema.md` when persistent data exists; `docs/api-contract.md` when API or web application flows exist; and for UI scope `docs/DESIGN.md` plus `docs/design-intent.json`).
+5. For UI changes, load .agent-context/prompts/bootstrap-design.md, .agent-context/rules/frontend-architecture.md, and docs/DESIGN.md when present.
+6. Enforce Universal SOP hard gate: block coding flow when required project docs are missing (root `README.md`; `docs/doc-index.md` when `docs/` exists; `docs/project-brief.md`; `docs/architecture-decision-record.md`; `docs/flow-overview.md`; `docs/database-schema.md` when persistent data exists; `docs/api-contract.md` when API or web application flows exist; and for UI scope `docs/DESIGN.md`).
 7. Enforce single-source and lazy-loading policy: canonical rule source must be explicitly enforced, global domain governance must load lazily based on touched scope, and conflicting duplicate rule instructions must not appear during normal flow.
 
 Prioritize findings in this order:

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

@@ -80,7 +80,7 @@ Run this before declaring a task done. Apply only the sections relevant to the c
 
 ## 7. UI And Accessibility
 
-- [ ] UI work follows `docs/DESIGN.md` and `docs/design-intent.json`.
+- [ ] UI work follows `docs/DESIGN.md`.
 - [ ] Visual direction is project-specific and not a template/default component-kit habit.
 - [ ] UI work includes a Motion/Palette Decision, and product categories were treated as heuristics rather than style presets.
 - [ ] Responsive behavior recomposes content and priority, not only shrinking desktop layout.
@@ -129,7 +129,7 @@ Run this before declaring a task done. Apply only the sections relevant to the c
 - [ ] Coding flow is blocked if `docs/flow-overview.md` is missing
 - [ ] Coding flow is blocked if `docs/database-schema.md` is missing while the project uses persistent data
 - [ ] Coding flow is blocked if `docs/api-contract.md` is missing while the project exposes API or web application flows
-- [ ] UI implementation flow is blocked if `docs/DESIGN.md` or `docs/design-intent.json` is missing
+- [ ] UI implementation flow is blocked if `docs/DESIGN.md` is missing
 
 ## Verdict
 

package/README.md

@@ -115,7 +115,7 @@ If you see `Property $schema is not allowed`, keep `.vscode/mcp.json` without `$
 
 ## Design Direction
 
-For UI, UX, layout, screen, Tailwind, frontend, or redesign work, the pack routes agents through a research dossier prompt and design bootstrap before code changes. The flow synthesizes a conceptual anchor, derives typography, spacing, morphology, motion, and responsive behavior, and carries a 90-day freshness gate with an anti-repeat ledger to avoid recycling the same visual direction. Existing projects read the real repository and docs first; fresh projects ask the agent to recommend the stack from current evidence instead of hardcoding a framework.
+For UI, UX, layout, screen, Tailwind, frontend, or redesign work, the pack routes agents through a compact design bootstrap before code changes. The flow asks the agent to reject generic defaults, choose a concrete interaction anchor, record creative commitments, and write the result into `docs/DESIGN.md`. Existing projects read the real repository and docs first; fresh projects ask the agent to recommend the stack from current evidence instead of hardcoding a framework.
 
 See [docs/doc-index.md](docs/doc-index.md) for the full doc routing map.
 

package/lib/cli/adaptive-context/catalog.mjs

@@ -415,7 +415,7 @@ export const DOCS_BY_LABEL = {
   ARCH: ['docs/architecture-decision-record.md', 'docs/flow-overview.md'],
   API: ['docs/api-contract.md'],
   DATA: ['docs/database-schema.md'],
-  FE: ['docs/DESIGN.md', 'docs/design-intent.json'],
+  FE: ['docs/DESIGN.md'],
   TEST: ['docs/flow-overview.md'],
 };
 

package/lib/cli/compiler.mjs

@@ -468,7 +468,6 @@ export async function buildCompiledRulesContent({
       'api-contract.md',
       'flow-overview.md',
       'DESIGN.md',
-      'design-intent.json',
       'runbook.md',
       'troubleshooting.md',
     ];

package/package.json

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

package/scripts/ui-design-judge/design-execution-summary.mjs

@@ -169,7 +169,7 @@ export function summarizeDesignExecutionPolicy(designIntentContent) {
 
   const notes = [];
   if (!policyPresent) {
-    notes.push('designExecutionPolicy is missing from docs/design-intent.json.');
+    notes.push('designExecutionPolicy is missing from optional structured design context.');
   }
   if (representationStrategy !== 'surface-plan-v1') {
     notes.push('Structured design execution should declare representationStrategy "surface-plan-v1".');

package/scripts/ui-design-judge/prompting.mjs

@@ -6,8 +6,8 @@ export function buildSystemPrompt() {
   return [
     'You are a Principal UI/UX Design Reviewer.',
     'Compare the changed UI code against the provided design contract.',
-    'Treat docs/design-intent.json as the machine-readable source of truth.',
-    'Treat docs/DESIGN.md as explanatory context, not a generic style guide.',
+    'Treat docs/DESIGN.md as the design contract source of truth, not a generic style guide.',
+    'Treat optional legacy structured design context as supplemental only when present.',
     'Treat designExecutionPolicy as the execution contract for how the UI must be planned, structured, and reviewed.',
     'Treat designExecutionHandoff as the explicit bridge between design intent and implementation decisions.',
     'Treat reviewRubric as the stable scoring frame for distinctiveness, contract fidelity, visual consistency, heuristic UX quality, and motion discipline.',
@@ -19,7 +19,7 @@ export function buildSystemPrompt() {
     'Treat WCAG 2.2 AA failures as hard accessibility drift.',
     'Treat APCA as advisory perceptual tuning only. Do not set blocking solely because APCA indicates a stronger readability adjustment when WCAG hard requirements still pass.',
     'Check focus visibility, focus appearance, target size, keyboard access, accessible authentication, and status or dynamic state access when the diff touches those surfaces.',
-    'Check design-intent.json for reviewRubric.genericityAutoFail. If true and forbiddenPatterns or genericitySignals are detected in the changed UI, this audit is no longer merely advisory for that finding: set blockingRecommended to true, mark the relevant rubric dimension as blocking, and require rebuilding the drifted surface instead of polishing it.',
+    'Check the optional reviewRubric.genericityAutoFail flag when structured context is present. If true and forbiddenPatterns or genericitySignals are detected in the changed UI, this audit is no longer merely advisory for that finding: set blockingRecommended to true, mark the relevant rubric dimension as blocking, and require rebuilding the drifted surface instead of polishing it.',
     'Focus on color intent, typographic hierarchy, responsive re-layout, purposeful motion, component morphology across states, interaction behavior, and genericity drift.',
     'If you call something generic, explain the specific genericity signal or anti-pattern that caused that judgment.',
     'Separate taste from failure. A bold design that follows the contract must not be penalized only because it is unusual.',
@@ -38,7 +38,7 @@ export function buildUserMessage(designIntentContent, designGuideContent, diffCo
     '## Changed UI Files',
     changedUiFiles.length > 0 ? changedUiFiles.map((filePath) => `- ${filePath}`).join('\n') : '- none',
     '',
-    '## design-intent.json',
+    '## Optional Legacy Structured Design Context',
     '```json',
     JSON.stringify(designIntentContent, null, 2),
     '```',

package/scripts/ui-design-judge.mjs

@@ -94,12 +94,12 @@ async function main() {
   const designIntentContent = loadDesignIntent();
   const designGuideContent = loadDesignGuide();
 
-  if (!designIntentContent) {
+  if (!designGuideContent.trim()) {
     emitMachineReadableReport(buildReport({
       skipped: true,
-      skipReason: 'Design contract is missing or unreadable. Skipping UI design judge.',
+      skipReason: 'Design guide is missing or unreadable. Skipping UI design judge.',
       contractPresent: false,
-      notes: ['docs/design-intent.json is required for contract-aware UI judging.'],
+      notes: ['docs/DESIGN.md is required for contract-aware UI judging.'],
     }));
     return;
   }
@@ -115,14 +115,15 @@ async function main() {
         driftCount: 0,
         blockingCandidateCount: 0,
         designExecutionSignalCount: 0,
+        genericityStatus: 'unclear',
       },
       notes: ['UI design judge only evaluates changed UI surfaces.'],
     }));
     return;
   }
 
-  const designExecutionSummary = summarizeDesignExecutionPolicy(designIntentContent);
-  const reviewRubricSummary = summarizeReviewRubric(designIntentContent);
+  const designExecutionSummary = summarizeDesignExecutionPolicy(designIntentContent || {});
+  const reviewRubricSummary = summarizeReviewRubric(designIntentContent || {});
 
   const systemPrompt = buildSystemPrompt();
   const userMessage = buildUserMessage(

package/scripts/validate/config.mjs

@@ -193,7 +193,7 @@ export const REQUIRED_UNIVERSAL_SOP_SNIPPETS = [
       'Coding flow is blocked if `docs/flow-overview.md` is missing',
       'Coding flow is blocked if `docs/database-schema.md` is missing while the project uses persistent data',
       'Coding flow is blocked if `docs/api-contract.md` is missing while the project exposes API or web application flows',
-      'UI implementation flow is blocked if `docs/DESIGN.md` or `docs/design-intent.json` is missing',
+      'UI implementation flow is blocked if `docs/DESIGN.md` is missing',
     ],
   },
   {
@@ -308,7 +308,7 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'Name Your Defaults',
       'Choose an Anchor',
       'Creative Commitments',
-      'anti-repeat ledger',
+      'Previous Directions',
       'Named Defaults to Avoid',
       'Post-Implementation Check',
       'Redesign Protocol',