@ryuenn3123/agentic-senior-core 2.5.10 → 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/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/state/memory-continuity-benchmark.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-04-17T08:10:30.670Z",
+  "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.10
+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.10
+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.10",
+  "version": "2.5.11",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {

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,6 +40,21 @@ 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',
@@ -253,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}`);