@ryuenn3123/agentic-senior-core 2.5.9 → 2.5.11

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

@@ -14,12 +14,18 @@ Before making changes:
 2. Read .agent-context/rules/naming-conv.md — fix all naming violations.
 3. Read .agent-context/rules/error-handling.md — fix error handling patterns.
 4. Read .agent-context/stacks/typescript.md — fix TypeScript-specific issues.
+5. Enforce backend universal principles: no clever hacks, no premature abstraction, readability over brevity.
 
 For every change you make, provide a Reasoning Chain:
 - What was wrong (rule reference)
 - Why it was wrong (explain the risk/problem)
 - What you changed (show the improvement)
 
+Refactor guidance:
+- Prioritize maintainability over compressed one-liners.
+- Prefer explicit readable control flow when short forms hide intent.
+- Do not introduce shared abstractions before patterns are repeated and stable.
+
 Maintain ALL existing functionality. This is a refactor, not a rewrite.
 Add or update tests if the refactored code changes behavior contracts.
 ```

package/.agent-context/review-checklists/architecture-review.md

@@ -29,6 +29,12 @@ Evaluate every item against the current project structure. For each violation, e
 - [ ] **Shared code is genuinely shared** — Not domain-specific code disguised as "common"
 - [ ] **Module size is reasonable** — If a module has 20+ files, consider splitting
 
+## Backend Universal Principles
+
+- [ ] **No clever hacks in backend and shared core modules** — Prefer explicit flow over language tricks that hide intent
+- [ ] **No premature abstraction** — Introduce shared abstractions only after repeated, stable patterns emerge
+- [ ] **Readability over brevity** — Prefer clear multi-line logic over compressed one-liners
+
 ## Dependency Management
 
 - [ ] **No God classes** — No class/file with 500+ lines or 10+ dependencies

package/.agent-context/review-checklists/frontend-excellence-rubric.md

@@ -43,6 +43,15 @@ Release recommendation:
 - [ ] Error, empty, and loading states provide clear next actions.
 - [ ] User journey avoids dead ends and hidden critical actions.
 
+## 7. Template Diversity and Originality
+- [ ] Output is not a copy of a generic starter template or repeated AI layout pattern.
+- [ ] Layout composition shows intentional variation in structure and hierarchy.
+- [ ] Visual intent, interaction quality, and conversion clarity are all explicitly reviewed together.
+
+## Low-Diversity Template Output Policy
+- If output is judged as low-diversity template output, release is blocked until layout direction is revised.
+- Reviewer must record the failing dimensions and expected redesign direction before re-run.
+
 ## Benchmark Expectation
 - Treat MiniMax frontend references as baseline, not target ceiling.
 - Target visual and interaction quality aligned with top award-grade manual design workflows (Awwwards-level reference quality).

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

@@ -40,6 +40,9 @@ VERDICT: PASS / FAIL (X/Y items passed)
 - [ ] Dependencies flow inward (transport → service → repository)
 - [ ] Module boundaries respected (no reaching into another module's internals)
 - [ ] Domain layer has zero external dependencies
+- [ ] No clever hacks in backend and shared core modules (prefer explicit control flow)
+- [ ] No premature abstraction (base classes/util layers created only after repeated stable patterns)
+- [ ] Readability over brevity for maintainability (no compressed one-liners that hide intent)
 
 ### 3. Type Safety (→ stacks/typescript.md)
 - [ ] No `any` type anywhere (use `unknown` + narrowing)

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

@@ -3,6 +3,16 @@
 > If your service file imports an HTTP library, your architecture is broken.
 > If your controller contains SQL, you've already lost.
 
+## Universal Backend Principles (Mandatory)
+
+These principles are mandatory for backend and shared core modules.
+
+- No clever hacks. Prefer explicit control flow over language tricks that hide intent.
+- No premature abstraction. Extract shared utilities or base types only after repeated, stable patterns appear.
+- Readability over brevity. Reject compressed one-liners when clearer multi-line logic is easier to review.
+
+If a short and a clear implementation are functionally equivalent, choose the clear implementation.
+
 ## The Core Principle
 
 **Every layer has ONE job. Layer leaks are bugs — not "pragmatic shortcuts."**

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

@@ -2,6 +2,20 @@
 
 > A complex UI is built from simple, mathematically robust functions. State is dangerous; isolate it.
 
+## 0. Frontend Designer Mode (Auto Activation)
+When the user request is UI-facing, frontend design governance activates automatically. No manual mode toggle is required.
+
+UI scope trigger signals (any one is enough):
+- keywords such as: ui, ux, page, screen, component, layout, landing, dashboard, form, onboarding, animation, interaction
+- explicit requests to improve visual quality, conversion clarity, or interaction behavior
+- feature requests that include frontend deliverables even when backend changes are also included
+
+Mandatory behavior when triggered:
+- apply frontend excellence rubric checks from `.agent-context/review-checklists/frontend-excellence-rubric.md`
+- apply usability checks from `.agent-context/review-checklists/frontend-usability.md`
+- score and review generated UI work against visual intent, interaction quality, and conversion clarity
+- reject template-only repetitive outputs and force a distinct layout direction
+
 ## 1. File Structure (Feature-Driven Design)
 Organize your application by feature domain, not by file type.
 - **BANNED:** Monolithic directories like `/components` (with 500 files), `/hooks`, `/api`.

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

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-17T07:58:05.182Z",
+  "generatedAt": "2026-04-17T09:47:30.839Z",
   "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 v2.5.9
+Generated by Agentic-Senior-Core CLI v2.5.11
 Timestamp: 2026-04-15T00:14:51.184Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/.windsurfrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v2.5.9
+Generated by Agentic-Senior-Core CLI v2.5.11
 Timestamp: 2026-04-15T00:14:51.184Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/package.json

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

package/scripts/frontend-usability-audit.mjs

@@ -20,6 +20,7 @@ const REQUIRED_FILES = [
   'docs/roadmap.md',
   'docs/v1.7-issue-breakdown.md',
   'docs/v1.7-execution-playbook.md',
+  '.agent-context/rules/frontend-architecture.md',
   '.agent-context/review-checklists/frontend-usability.md',
   '.agent-context/review-checklists/frontend-excellence-rubric.md',
 ];
@@ -43,9 +44,19 @@ const REQUIRED_EXCELLENCE_RUBRIC_SNIPPETS = [
   'Typography Quality',
   'Color System Diversity and Contrast',
   'Interaction Choreography',
+  'UX Narrative and Conversion Clarity',
+  'Template Diversity and Originality',
+  'Low-Diversity Template Output Policy',
   'Awwwards-level reference quality',
 ];
 
+const REQUIRED_FRONTEND_RULE_SNIPPETS = [
+  'Frontend Designer Mode (Auto Activation)',
+  'UI scope trigger signals',
+  'visual intent, interaction quality, and conversion clarity',
+  'template-only repetitive outputs',
+];
+
 function assertFileExists(relativeFilePath, failures) {
   const absoluteFilePath = resolve(REPOSITORY_ROOT, relativeFilePath);
   if (!existsSync(absoluteFilePath)) {
@@ -69,6 +80,7 @@ function runAudit() {
   }
 
   const roadmapPath = 'docs/roadmap.md';
+  const frontendRulePath = '.agent-context/rules/frontend-architecture.md';
   const checklistPath = '.agent-context/review-checklists/frontend-usability.md';
   const excellenceRubricPath = '.agent-context/review-checklists/frontend-excellence-rubric.md';
 
@@ -82,6 +94,11 @@ function runAudit() {
     assertContains('Checklist', checklistPath, checklistContent, REQUIRED_CHECKLIST_SNIPPETS, failures);
   }
 
+  if (existsSync(resolve(REPOSITORY_ROOT, frontendRulePath))) {
+    const frontendRuleContent = readFileSync(resolve(REPOSITORY_ROOT, frontendRulePath), 'utf8');
+    assertContains('Frontend rule', frontendRulePath, frontendRuleContent, REQUIRED_FRONTEND_RULE_SNIPPETS, failures);
+  }
+
   if (existsSync(resolve(REPOSITORY_ROOT, excellenceRubricPath))) {
     const excellenceRubricContent = readFileSync(resolve(REPOSITORY_ROOT, excellenceRubricPath), 'utf8');
     assertContains(

package/scripts/release-gate.mjs

@@ -30,6 +30,9 @@ const REQUIRED_SKILL_DOMAINS = [
 const FRONTEND_PARITY_CHECKLIST_PATH = '.agent-context/review-checklists/frontend-skill-parity.md';
 const FRONTEND_EXCELLENCE_RUBRIC_PATH = '.agent-context/review-checklists/frontend-excellence-rubric.md';
 const FRONTEND_AUDIT_SCRIPT_PATH = 'scripts/frontend-usability-audit.mjs';
+const BACKEND_ARCHITECTURE_RULE_PATH = '.agent-context/rules/architecture.md';
+const BACKEND_REVIEW_CHECKLIST_PATH = '.agent-context/review-checklists/pr-checklist.md';
+const REFACTOR_PROMPT_PATH = '.agent-context/prompts/refactor.md';
 const REQUIRED_FRONTEND_PARITY_SNIPPETS = [
   'Architecture and Composition',
   'Interaction and Motion',
@@ -37,11 +40,29 @@ const REQUIRED_FRONTEND_PARITY_SNIPPETS = [
   'UX Narrative and Conversion Clarity',
   'Release Evidence',
 ];
+const REQUIRED_BACKEND_ARCHITECTURE_RULE_SNIPPETS = [
+  'No clever hacks.',
+  'No premature abstraction.',
+  'Readability over brevity.',
+  'backend and shared core modules',
+];
+const REQUIRED_BACKEND_REVIEW_CHECKLIST_SNIPPETS = [
+  'No clever hacks in backend and shared core modules',
+  'No premature abstraction (base classes/util layers created only after repeated stable patterns)',
+  'Readability over brevity for maintainability',
+];
+const REQUIRED_REFACTOR_PROMPT_SNIPPETS = [
+  'Enforce backend universal principles: no clever hacks, no premature abstraction, readability over brevity.',
+  'Prioritize maintainability over compressed one-liners.',
+];
 const REQUIRED_FRONTEND_EXCELLENCE_RUBRIC_SNIPPETS = [
   'Visual Direction and Identity',
   'Typography Quality',
   'Color System Diversity and Contrast',
   'Interaction Choreography',
+  'UX Narrative and Conversion Clarity',
+  'Template Diversity and Originality',
+  'Low-Diversity Template Output Policy',
   'Awwwards-level reference quality',
 ];
 const BENCHMARK_GATE_SCRIPT_PATH = 'scripts/benchmark-gate.mjs';
@@ -250,6 +271,72 @@ function runReleaseGate() {
     );
   }
 
+  const backendArchitectureRuleContent = readText(BACKEND_ARCHITECTURE_RULE_PATH);
+  if (!backendArchitectureRuleContent) {
+    pushResult(results, false, 'backend-universal-principles-rule-exists', `Missing ${BACKEND_ARCHITECTURE_RULE_PATH}`);
+  } else {
+    pushResult(results, true, 'backend-universal-principles-rule-exists', `${BACKEND_ARCHITECTURE_RULE_PATH} is present`);
+
+    const missingBackendArchitectureRuleSnippets = REQUIRED_BACKEND_ARCHITECTURE_RULE_SNIPPETS.filter(
+      (requiredSnippet) => !backendArchitectureRuleContent.includes(requiredSnippet)
+    );
+
+    if (missingBackendArchitectureRuleSnippets.length === 0) {
+      pushResult(results, true, 'backend-universal-principles-rule-coverage', 'Backend universal rule snippets are complete');
+    } else {
+      pushResult(
+        results,
+        false,
+        'backend-universal-principles-rule-coverage',
+        `Missing backend universal rule snippets: ${missingBackendArchitectureRuleSnippets.join(', ')}`
+      );
+    }
+  }
+
+  const backendReviewChecklistContent = readText(BACKEND_REVIEW_CHECKLIST_PATH);
+  if (!backendReviewChecklistContent) {
+    pushResult(results, false, 'backend-universal-principles-checklist-exists', `Missing ${BACKEND_REVIEW_CHECKLIST_PATH}`);
+  } else {
+    pushResult(results, true, 'backend-universal-principles-checklist-exists', `${BACKEND_REVIEW_CHECKLIST_PATH} is present`);
+
+    const missingBackendChecklistSnippets = REQUIRED_BACKEND_REVIEW_CHECKLIST_SNIPPETS.filter(
+      (requiredSnippet) => !backendReviewChecklistContent.includes(requiredSnippet)
+    );
+
+    if (missingBackendChecklistSnippets.length === 0) {
+      pushResult(results, true, 'backend-universal-principles-checklist-coverage', 'Backend review checklist snippets are complete');
+    } else {
+      pushResult(
+        results,
+        false,
+        'backend-universal-principles-checklist-coverage',
+        `Missing backend review checklist snippets: ${missingBackendChecklistSnippets.join(', ')}`
+      );
+    }
+  }
+
+  const refactorPromptContent = readText(REFACTOR_PROMPT_PATH);
+  if (!refactorPromptContent) {
+    pushResult(results, false, 'backend-universal-principles-refactor-guidance-exists', `Missing ${REFACTOR_PROMPT_PATH}`);
+  } else {
+    pushResult(results, true, 'backend-universal-principles-refactor-guidance-exists', `${REFACTOR_PROMPT_PATH} is present`);
+
+    const missingRefactorPromptSnippets = REQUIRED_REFACTOR_PROMPT_SNIPPETS.filter(
+      (requiredSnippet) => !refactorPromptContent.includes(requiredSnippet)
+    );
+
+    if (missingRefactorPromptSnippets.length === 0) {
+      pushResult(results, true, 'backend-universal-principles-refactor-guidance-coverage', 'Backend refactor guidance snippets are complete');
+    } else {
+      pushResult(
+        results,
+        false,
+        'backend-universal-principles-refactor-guidance-coverage',
+        `Missing backend refactor guidance snippets: ${missingRefactorPromptSnippets.join(', ')}`
+      );
+    }
+  }
+
   const frontendParityChecklistContent = readText(FRONTEND_PARITY_CHECKLIST_PATH);
   if (!frontendParityChecklistContent) {
     pushResult(results, false, 'frontend-parity-checklist-exists', `Missing ${FRONTEND_PARITY_CHECKLIST_PATH}`);