@ryuenn3123/agentic-senior-core 2.0.25 → 2.0.26

package/lib/cli/skill-selector.mjs

@@ -43,55 +43,77 @@ export function formatSkillTierList(skillPlatformIndex) {
   return skillPlatformIndex.tiers.map((tierDefinition) => `${tierDefinition.name} (${tierDefinition.description})`).join('\n');
 }
 
-export function inferSkillDomainNamesFromSelection(selectedStackFileName, selectedBlueprintFileName) {
+export function inferSkillDomainNamesFromSelection(
+  selectedStackFileName,
+  selectedBlueprintFileName,
+  additionalStackFileNames = [],
+  additionalBlueprintFileNames = []
+) {
   const inferredDomainNames = new Set();
 
-  if (selectedBlueprintFileName === 'api-nextjs.md' || selectedBlueprintFileName === 'fastapi-service.md') {
-    inferredDomainNames.add('frontend');
-    inferredDomainNames.add('fullstack');
-    inferredDomainNames.add('cli');
-  }
+  function applyStackSignals(stackFileName) {
+    if (stackFileName === 'typescript.md') {
+      inferredDomainNames.add('frontend');
+      inferredDomainNames.add('cli');
+    }
 
-  if (selectedBlueprintFileName === 'go-service.md'
-    || selectedBlueprintFileName === 'spring-boot-api.md'
-    || selectedBlueprintFileName === 'laravel-api.md'
-    || selectedBlueprintFileName === 'aspnet-api.md') {
-    inferredDomainNames.add('backend');
-    inferredDomainNames.add('fullstack');
-    inferredDomainNames.add('cli');
-  }
+    if (stackFileName === 'go.md'
+      || stackFileName === 'java.md'
+      || stackFileName === 'php.md'
+      || stackFileName === 'csharp.md'
+      || stackFileName === 'python.md'
+      || stackFileName === 'ruby.md'
+      || stackFileName === 'rust.md') {
+      inferredDomainNames.add('backend');
+    }
 
-  if (selectedStackFileName === 'typescript.md') {
-    inferredDomainNames.add('frontend');
-    inferredDomainNames.add('cli');
+    if (stackFileName === 'react-native.md' || stackFileName === 'flutter.md') {
+      inferredDomainNames.add('frontend');
+      inferredDomainNames.add('fullstack');
+      inferredDomainNames.add('cli');
+    }
   }
 
-  if (selectedStackFileName === 'go.md'
-    || selectedStackFileName === 'java.md'
-    || selectedStackFileName === 'php.md'
-    || selectedStackFileName === 'csharp.md'
-    || selectedStackFileName === 'python.md'
-    || selectedStackFileName === 'ruby.md'
-    || selectedStackFileName === 'rust.md') {
-    inferredDomainNames.add('backend');
-  }
+  function applyBlueprintSignals(blueprintFileName) {
+    if (blueprintFileName === 'api-nextjs.md' || blueprintFileName === 'fastapi-service.md') {
+      inferredDomainNames.add('frontend');
+      inferredDomainNames.add('fullstack');
+      inferredDomainNames.add('cli');
+    }
 
-  if (selectedStackFileName === 'react-native.md' || selectedStackFileName === 'flutter.md') {
-    inferredDomainNames.add('frontend');
-    inferredDomainNames.add('fullstack');
-    inferredDomainNames.add('cli');
+    if (blueprintFileName === 'go-service.md'
+      || blueprintFileName === 'spring-boot-api.md'
+      || blueprintFileName === 'laravel-api.md'
+      || blueprintFileName === 'aspnet-api.md'
+      || blueprintFileName === 'nestjs-logic.md'
+      || blueprintFileName === 'graphql-grpc-api.md') {
+      inferredDomainNames.add('backend');
+      inferredDomainNames.add('fullstack');
+      inferredDomainNames.add('cli');
+    }
+
+    if (blueprintFileName === 'mobile-app.md') {
+      inferredDomainNames.add('frontend');
+      inferredDomainNames.add('fullstack');
+      inferredDomainNames.add('cli');
+    }
+
+    if (blueprintFileName === 'observability.md') {
+      inferredDomainNames.add('backend');
+      inferredDomainNames.add('fullstack');
+      inferredDomainNames.add('cli');
+    }
   }
 
-  if (selectedBlueprintFileName === 'mobile-app.md') {
-    inferredDomainNames.add('frontend');
-    inferredDomainNames.add('fullstack');
-    inferredDomainNames.add('cli');
+  applyBlueprintSignals(selectedBlueprintFileName);
+
+  applyStackSignals(selectedStackFileName);
+  for (const additionalStackFileName of additionalStackFileNames) {
+    applyStackSignals(additionalStackFileName);
   }
 
-  if (selectedBlueprintFileName === 'observability.md') {
-    inferredDomainNames.add('backend');
-    inferredDomainNames.add('fullstack');
-    inferredDomainNames.add('cli');
+  for (const additionalBlueprintFileName of additionalBlueprintFileNames) {
+    applyBlueprintSignals(additionalBlueprintFileName);
   }
 
   if (inferredDomainNames.size === 0) {

package/lib/cli/templates/architecture-decision-record.md.tmpl

@@ -18,9 +18,23 @@ This project requires a {{primaryDomain}} solution. The team evaluated available
 ### Decision
 
 - **Language/Runtime**: {{stackDisplayName}} (source: `.agent-context/stacks/{{stackFileName}}`)
+{{#if additionalStackDisplayNames}}
+- **Additional runtime context**:
+{{#each additionalStackDisplayNames}}
+  - {{this}}
+{{/each}}
+{{/if}}
 - **Architecture blueprint**: {{blueprintDisplayName}} (source: `.agent-context/blueprints/{{blueprintFileName}}`)
+{{#if additionalBlueprintDisplayNames}}
+- **Additional architecture blueprints**:
+{{#each additionalBlueprintDisplayNames}}
+  - {{this}}
+{{/each}}
+{{/if}}
 - **Database**: {{databaseChoice}}
 - **Auth**: {{authStrategy}}
+- **Runtime environment target**: {{runtimeEnvironmentLabel}}
+- **Containerization strategy**: {{dockerStrategy}}
 
 ### Rationale
 
@@ -36,6 +50,31 @@ The {{stackDisplayName}} stack was selected because:
 - Database access must follow `.agent-context/rules/database-design.md`.
 - API contracts must follow `.agent-context/rules/api-docs.md`.
 
+{{#if hasDocker}}
+---
+
+## ADR-004: Containerization Strategy (Dynamic)
+
+**Status**: Accepted
+**Date**: {{generatedDate}}
+
+### Context
+
+This project requires container support with separated development and production concerns.
+
+### Decision
+
+- Follow dynamic container generation based on real project dependencies and runtime profile.
+- Do not rely on static Docker templates copied from unrelated repositories.
+{{dockerDevelopmentGuidance}}
+{{dockerProductionGuidance}}
+
+### Consequences
+
+- Development and production Docker artifacts are treated as separate deliverables.
+- Changes in package/runtime dependencies must regenerate container setup instructions in the same change.
+{{/if}}
+
 ---
 
 ## ADR-002: Architecture Pattern

package/lib/cli/templates/flow-overview.md.tmpl

@@ -12,6 +12,18 @@ Template version: {{templateVersion}}
 **Domain**: {{primaryDomain}}
 **Stack**: {{stackDisplayName}}
 **Blueprint**: {{blueprintDisplayName}}
+**Runtime target**: {{runtimeEnvironmentLabel}}
+**Containerization**: {{dockerStrategy}}
+
+{{#if hasDocker}}
+## Container Flow (Dynamic Dev and Prod)
+
+- Container setup is generated dynamically by AI from current dependencies, not from static canned templates.
+{{dockerDevelopmentGuidance}}
+{{dockerProductionGuidance}}
+- Keep dev and prod container concerns explicitly separated.
+
+{{/if}}
 
 ## High-Level Architecture
 

package/lib/cli/templates/project-brief.md.id.tmpl

@@ -18,6 +18,8 @@ Versi template: {{templateVersion}}
 **Blueprint**: {{blueprintDisplayName}}
 **Database**: {{databaseChoice}}
 **Strategi autentikasi**: {{authStrategy}}
+**Target environment runtime**: {{runtimeEnvironmentLabel}}
+**Strategi containerisasi**: {{dockerStrategy}}
 
 ## Fitur Kunci
 

package/lib/cli/templates/project-brief.md.tmpl

@@ -15,9 +15,35 @@ Template version: {{templateVersion}}
 ## Technology Decisions
 
 **Stack**: {{stackDisplayName}}
+{{#if additionalStackDisplayNames}}
+**Additional stacks**:
+{{#each additionalStackDisplayNames}}
+- {{this}}
+{{/each}}
+{{/if}}
 **Blueprint**: {{blueprintDisplayName}}
+{{#if additionalBlueprintDisplayNames}}
+**Additional blueprints**:
+{{#each additionalBlueprintDisplayNames}}
+- {{this}}
+{{/each}}
+{{/if}}
 **Database**: {{databaseChoice}}
 **Auth strategy**: {{authStrategy}}
+**Runtime environment target**: {{runtimeEnvironmentLabel}}
+**Containerization strategy**: {{dockerStrategy}}
+
+{{#if hasDocker}}
+## Containerization Workflow (Dynamic)
+
+- Docker is enabled for this project: **{{dockerStrategy}}**.
+- Docker setup must be generated dynamically by AI based on current dependencies and runtime constraints.
+- Do not use fixed boilerplate templates that ignore actual project structure.
+{{dockerDevelopmentGuidance}}
+{{dockerProductionGuidance}}
+
+- Keep development and production container strategy separated to avoid environment drift.
+{{/if}}
 
 ## Key Features
 

package/lib/cli/utils.mjs

@@ -28,7 +28,7 @@ export function printUsage() {
   console.log('');
   console.log('Usage:');
   console.log('  agentic-senior-core launch');
-  console.log('  agentic-senior-core init [target-directory] [--preset <name>] [--profile <beginner|balanced|strict>] [--profile-pack <name>] [--stack <name>] [--blueprint <name>] [--ci <true|false>] [--newbie] [--token-optimize] [--no-token-optimize] [--token-agent <name>] [--scaffold-docs] [--no-scaffold-docs] [--docs-lang <en|id>] [--project-config <path>]');
+  console.log('  agentic-senior-core init [target-directory] [--preset <name>] [--profile <beginner|balanced|strict>] [--profile-pack <name>] [--stack <name>] [--blueprint <name>] [--ci <true|false>] [--newbie] [--token-optimize] [--no-token-optimize] [--token-agent <name>] [--scaffold-docs] [--no-scaffold-docs] [--docs-lang <en|id>] [--project-config <path>] [--runtime-env <auto|linux-wsl|linux|windows|macos>]');
   console.log('  agentic-senior-core upgrade [target-directory] [--dry-run] [--yes] [--mcp-template]');
   console.log('  agentic-senior-core optimize [target-directory] [--agent <copilot|claude|cursor|windsurf|gemini|codex|cline>] [--enable|--disable] [--show]');
   console.log('  agentic-senior-core mcp');
@@ -54,6 +54,7 @@ export function printUsage() {
   console.log('  --no-scaffold-docs  Skip project documentation scaffolding');
   console.log('  --docs-lang      Optional override for generated project docs language (default: en)');
   console.log('  --project-config Path to a project config file for non-interactive doc scaffolding');
+  console.log('  --runtime-env   Override runtime environment hint (auto, linux-wsl, linux, windows, macos)');
   console.log('  --dry-run    Preview upgrade without writing files');
   console.log('  --yes        Skip confirmation prompts for upgrade');
   console.log('  --agent      Target agent integration for token optimization mode');

package/package.json

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

package/scripts/frontend-usability-audit.mjs

@@ -21,6 +21,7 @@ const REQUIRED_FILES = [
   'docs/v1.7-issue-breakdown.md',
   'docs/v1.7-execution-playbook.md',
   '.agent-context/review-checklists/frontend-usability.md',
+  '.agent-context/review-checklists/frontend-excellence-rubric.md',
 ];
 
 const REQUIRED_ROADMAP_SNIPPETS = [
@@ -37,6 +38,14 @@ const REQUIRED_CHECKLIST_SNIPPETS = [
   'Documentation and Release Evidence',
 ];
 
+const REQUIRED_EXCELLENCE_RUBRIC_SNIPPETS = [
+  'Visual Direction and Identity',
+  'Typography Quality',
+  'Color System Diversity and Contrast',
+  'Interaction Choreography',
+  'Awwwards-level reference quality',
+];
+
 function assertFileExists(relativeFilePath, failures) {
   const absoluteFilePath = resolve(REPOSITORY_ROOT, relativeFilePath);
   if (!existsSync(absoluteFilePath)) {
@@ -61,6 +70,7 @@ function runAudit() {
 
   const roadmapPath = 'docs/roadmap.md';
   const checklistPath = '.agent-context/review-checklists/frontend-usability.md';
+  const excellenceRubricPath = '.agent-context/review-checklists/frontend-excellence-rubric.md';
 
   if (existsSync(resolve(REPOSITORY_ROOT, roadmapPath))) {
     const roadmapContent = readFileSync(resolve(REPOSITORY_ROOT, roadmapPath), 'utf8');
@@ -72,6 +82,17 @@ function runAudit() {
     assertContains('Checklist', checklistPath, checklistContent, REQUIRED_CHECKLIST_SNIPPETS, failures);
   }
 
+  if (existsSync(resolve(REPOSITORY_ROOT, excellenceRubricPath))) {
+    const excellenceRubricContent = readFileSync(resolve(REPOSITORY_ROOT, excellenceRubricPath), 'utf8');
+    assertContains(
+      'Frontend excellence rubric',
+      excellenceRubricPath,
+      excellenceRubricContent,
+      REQUIRED_EXCELLENCE_RUBRIC_SNIPPETS,
+      failures
+    );
+  }
+
   const reportPayload = {
     generatedAt: new Date().toISOString(),
     auditName: 'frontend-usability-audit',

package/scripts/release-gate.mjs

@@ -28,6 +28,7 @@ const REQUIRED_SKILL_DOMAINS = [
   'review-quality',
 ];
 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 REQUIRED_FRONTEND_PARITY_SNIPPETS = [
   'Architecture and Composition',
@@ -36,6 +37,13 @@ const REQUIRED_FRONTEND_PARITY_SNIPPETS = [
   'UX Narrative and Conversion Clarity',
   'Release Evidence',
 ];
+const REQUIRED_FRONTEND_EXCELLENCE_RUBRIC_SNIPPETS = [
+  'Visual Direction and Identity',
+  'Typography Quality',
+  'Color System Diversity and Contrast',
+  'Interaction Choreography',
+  'Awwwards-level reference quality',
+];
 const BENCHMARK_GATE_SCRIPT_PATH = 'scripts/benchmark-gate.mjs';
 
 function readText(relativeFilePath) {
@@ -264,6 +272,28 @@ function runReleaseGate() {
     }
   }
 
+  const frontendExcellenceRubricContent = readText(FRONTEND_EXCELLENCE_RUBRIC_PATH);
+  if (!frontendExcellenceRubricContent) {
+    pushResult(results, false, 'frontend-excellence-rubric-exists', `Missing ${FRONTEND_EXCELLENCE_RUBRIC_PATH}`);
+  } else {
+    pushResult(results, true, 'frontend-excellence-rubric-exists', `${FRONTEND_EXCELLENCE_RUBRIC_PATH} is present`);
+
+    const missingFrontendExcellenceSnippets = REQUIRED_FRONTEND_EXCELLENCE_RUBRIC_SNIPPETS.filter(
+      (requiredSnippet) => !frontendExcellenceRubricContent.includes(requiredSnippet)
+    );
+
+    if (missingFrontendExcellenceSnippets.length === 0) {
+      pushResult(results, true, 'frontend-excellence-rubric-coverage', 'Frontend excellence rubric sections are complete');
+    } else {
+      pushResult(
+        results,
+        false,
+        'frontend-excellence-rubric-coverage',
+        `Missing frontend excellence rubric sections: ${missingFrontendExcellenceSnippets.join(', ')}`
+      );
+    }
+  }
+
   try {
     const frontendAuditRawOutput = execFileSync('node', [FRONTEND_AUDIT_SCRIPT_PATH], {
       cwd: REPOSITORY_ROOT,

package/scripts/validate.mjs

@@ -258,6 +258,7 @@ async function validateRuleFiles() {
     'rules/database-design.md',
     'rules/realtime.md',
     'rules/frontend-architecture.md',
+    'rules/docker-runtime.md',
     'stacks/typescript.md',
     'stacks/python.md',
     'stacks/java.md',
@@ -285,6 +286,7 @@ async function validateRuleFiles() {
     'review-checklists/pr-checklist.md',
     'review-checklists/frontend-usability.md',
     'review-checklists/frontend-skill-parity.md',
+    'review-checklists/frontend-excellence-rubric.md',
     'review-checklists/release-operations.md',
     'review-checklists/security-audit.md',
     'review-checklists/performance-audit.md',