@ryuenn3123/agentic-senior-core 2.0.20 → 2.0.21

package/.cursorrules

@@ -1,6 +1,6 @@
 # AGENTIC-SENIOR-CORE DYNAMIC GOVERNANCE RULESET
 
-Generated by Agentic-Senior-Core CLI v2.0.20
+Generated by Agentic-Senior-Core CLI v2.0.21
 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.0.20
+Generated by Agentic-Senior-Core CLI v2.0.21
 Timestamp: 2026-04-15T00:14:51.184Z
 Selected profile: beginner
 Selected policy file: .agent-context/policies/llm-judge-threshold.json

package/lib/cli/commands/init.mjs

@@ -40,6 +40,7 @@ import {
   isDirectoryEffectivelyEmpty,
   hasExistingProjectDocs,
   loadProjectConfig,
+  normalizeDocsLanguage,
 } from '../project-scaffolder.mjs';
 import { performRollback } from '../rollback.mjs';
 import {
@@ -67,6 +68,7 @@ export function parseInitArguments(commandArguments) {
     includeMcpTemplate: false,
     scaffoldDocs: undefined,
     docsLang: 'en',
+    docsLangProvided: false,
     projectConfig: undefined,
   };
 
@@ -188,12 +190,14 @@ export function parseInitArguments(commandArguments) {
 
     if (currentArgument === '--docs-lang') {
       parsedInitOptions.docsLang = commandArguments[argumentIndex + 1] || 'en';
+      parsedInitOptions.docsLangProvided = true;
       argumentIndex += 1;
       continue;
     }
 
     if (currentArgument.startsWith('--docs-lang=')) {
       parsedInitOptions.docsLang = currentArgument.split('=')[1] || 'en';
+      parsedInitOptions.docsLangProvided = true;
       continue;
     }
 
@@ -215,6 +219,12 @@ export function parseInitArguments(commandArguments) {
     throw new Error('--newbie can only be combined with --profile beginner');
   }
 
+  const normalizedDocsLanguage = normalizeDocsLanguage(parsedInitOptions.docsLang || 'en');
+  if (!normalizedDocsLanguage) {
+    throw new Error('--docs-lang must be one of: en, id');
+  }
+
+  parsedInitOptions.docsLang = normalizedDocsLanguage;
   parsedInitOptions.tokenAgent = normalizeAgentName(parsedInitOptions.tokenAgent);
 
   return parsedInitOptions;
@@ -227,6 +237,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     : true;
   const shouldIncludeMcpTemplate = initOptions.includeMcpTemplate === true;
   const selectedTokenAgentName = normalizeAgentName(initOptions.tokenAgent || 'copilot');
+  const isInteractiveSession = Boolean(stdin.isTTY && stdout.isTTY);
 
   if (resolvedTargetDirectoryPath.toLowerCase() === 'c:\\windows' || resolvedTargetDirectoryPath.toLowerCase() === 'c:\\windows\\system32') {
     console.error('\n[FATAL] Target directory resolved to a Windows system folder (C:\\Windows).');
@@ -245,6 +256,9 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       throw new Error('Preflight checks failed.');
   }
 
+  const wasDirectoryEffectivelyEmpty = await isDirectoryEffectivelyEmpty(resolvedTargetDirectoryPath);
+  const hadExistingProjectDocsBeforeInit = await hasExistingProjectDocs(resolvedTargetDirectoryPath);
+
   const backup = await createBackup(resolvedTargetDirectoryPath);
 
   const userInterface = createInterface({ input: stdin, output: stdout });
@@ -428,46 +442,27 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       console.log('Installation will continue, but review these warnings before production use.');
     }
 
-    await compileDynamicContext({
-      targetDirectoryPath: resolvedTargetDirectoryPath,
-      selectedProfileName,
-      selectedProfilePack,
-      selectedStackFileName: selectedResolvedStackFileName,
-      selectedBlueprintFileName: selectedResolvedBlueprintFileName,
-      includeCiGuardrails,
-    });
-
-    await writeSelectedPolicy(resolvedTargetDirectoryPath, selectedProfileName);
-
-    const setupDurationMs = Date.now() - setupStartedAt;
-    await writeOnboardingReport({
-      targetDirectoryPath: resolvedTargetDirectoryPath,
-      selectedProfileName,
-      selectedProfilePack,
-      selectedPreset: initOptions.preset || null,
-      selectedStackFileName: selectedResolvedStackFileName,
-      selectedBlueprintFileName: selectedResolvedBlueprintFileName,
-      includeCiGuardrails,
-      setupDurationMs,
-      projectDetection,
-      selectedSkillDomains: selectedSkillDomainNames,
-      compatibilityWarnings,
-      operationMode: 'init',
-    });
-
     // --- Project Documentation Scaffolding ---
     let scaffoldingResult = null;
+    const isFreshProjectTarget = wasDirectoryEffectivelyEmpty && !hadExistingProjectDocsBeforeInit;
     const shouldOfferScaffolding = initOptions.scaffoldDocs === true
-      || (initOptions.scaffoldDocs !== false && await isDirectoryEffectivelyEmpty(resolvedTargetDirectoryPath) && !(await hasExistingProjectDocs(resolvedTargetDirectoryPath)));
+      || Boolean(initOptions.projectConfig)
+      || (initOptions.scaffoldDocs !== false && isFreshProjectTarget);
 
     if (shouldOfferScaffolding) {
+      if (initOptions.scaffoldDocs === true && !initOptions.projectConfig && !isInteractiveSession) {
+        throw new Error('Non-interactive scaffolding requires --project-config when --scaffold-docs is enabled.');
+      }
+
       const userWantsScaffolding = initOptions.scaffoldDocs === true
         || initOptions.projectConfig
-        || await askYesNo(
-          'This is a fresh project. Want me to scaffold project documentation (architecture, database, API contract, flow)?',
-          userInterface,
-          true
-        );
+        || (!isInteractiveSession
+          ? false
+          : await askYesNo(
+            'This is a fresh project. Want me to scaffold project documentation (architecture, database, API contract, flow)?',
+            userInterface,
+            true
+          ));
 
       if (userWantsScaffolding) {
         let discoveryAnswers;
@@ -479,12 +474,24 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
           discoveryAnswers = await runProjectDiscovery(userInterface);
         }
 
+        const normalizedConfigDocsLanguage = normalizeDocsLanguage(discoveryAnswers.docsLang || '');
+        if (discoveryAnswers.docsLang && !normalizedConfigDocsLanguage) {
+          throw new Error(`Unsupported docs language in project config: ${discoveryAnswers.docsLang}. Supported values: en, id`);
+        }
+
+        const selectedDocsLanguage = (!initOptions.docsLangProvided && normalizedConfigDocsLanguage)
+          ? normalizedConfigDocsLanguage
+          : initOptions.docsLang;
+
         scaffoldingResult = await generateProjectDocumentation(
           resolvedTargetDirectoryPath,
           discoveryAnswers,
           {
             stackFileName: selectedResolvedStackFileName,
             blueprintFileName: selectedResolvedBlueprintFileName,
+          },
+          {
+            docsLanguage: selectedDocsLanguage,
           }
         );
 
@@ -495,6 +502,33 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
       }
     }
 
+    await compileDynamicContext({
+      targetDirectoryPath: resolvedTargetDirectoryPath,
+      selectedProfileName,
+      selectedProfilePack,
+      selectedStackFileName: selectedResolvedStackFileName,
+      selectedBlueprintFileName: selectedResolvedBlueprintFileName,
+      includeCiGuardrails,
+    });
+
+    await writeSelectedPolicy(resolvedTargetDirectoryPath, selectedProfileName);
+
+    const setupDurationMs = Date.now() - setupStartedAt;
+    await writeOnboardingReport({
+      targetDirectoryPath: resolvedTargetDirectoryPath,
+      selectedProfileName,
+      selectedProfilePack,
+      selectedPreset: initOptions.preset || null,
+      selectedStackFileName: selectedResolvedStackFileName,
+      selectedBlueprintFileName: selectedResolvedBlueprintFileName,
+      includeCiGuardrails,
+      setupDurationMs,
+      projectDetection,
+      selectedSkillDomains: selectedSkillDomainNames,
+      compatibilityWarnings,
+      operationMode: 'init',
+    });
+
     console.log('\nInitialization complete.');
     console.log(`- Target directory: ${resolvedTargetDirectoryPath}`);
     console.log(`- Profile: ${selectedProfile.displayName}`);
@@ -512,6 +546,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     console.log('- Generated files: .cursorrules, .windsurfrules, and .agent-context/state/onboarding-report.json');
     if (scaffoldingResult) {
       console.log(`- Project docs: ${scaffoldingResult.generatedFileNames.length} files generated in docs/`);
+      console.log(`- Project docs language: ${scaffoldingResult.docsLanguage}`);
     }
     console.log(`- Repository workflows copied: no (workflows remain source-repo assets)`);
     console.log(`- MCP template file: ${shouldIncludeMcpTemplate ? 'created (.vscode/mcp.json)' : 'not created by default (use --mcp-template)'}`);
@@ -523,7 +558,7 @@ export async function runInitCommand(targetDirectoryArgument, initOptions = {})
     console.log('\nPlain-language summary:');
     console.log(`I prepared a ${selectedProfile.displayName.toLowerCase()} governance pack for a ${toTitleCase(selectedResolvedStackFileName)} project using the ${toTitleCase(selectedResolvedBlueprintFileName)} blueprint.`);
     if (scaffoldingResult) {
-      console.log(`I also generated project documentation based on your project description. AI agents will use docs/ as project context.`);
+      console.log(`I also generated project documentation (${scaffoldingResult.docsLanguage}) based on your project description. AI agents will use docs/ as project context.`);
     }
     console.log('Your AI tools will now receive one compiled rulebook plus the original source rules, and your review threshold is stored in .agent-context/policies/llm-judge-threshold.json.');
     console.log('MCP server registration is manual inside your IDE settings, even when mcp.json exists.');

package/lib/cli/commands/upgrade.mjs

@@ -37,6 +37,7 @@ import { createBackup } from '../backup.mjs';
 import { performRollback } from '../rollback.mjs';
 import { inferSkillDomainNamesFromSelection } from '../skill-selector.mjs';
 import { evaluateSkillDomainCompatibility } from '../compatibility.mjs';
+import { detectProjectDocTemplateStaleness } from '../project-scaffolder.mjs';
 
 export function parseUpgradeArguments(commandArguments) {
   const parsedUpgradeOptions = {
@@ -134,6 +135,7 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
       resolvedTargetDirectoryPath,
       selectedSkillDomainNames
     );
+    const projectDocStalenessReport = await detectProjectDocTemplateStaleness(resolvedTargetDirectoryPath);
 
     if (compatibilityWarnings.length > 0) {
       console.log('\n[WARN] Compatibility checks reported potential issues for this environment:');
@@ -169,6 +171,20 @@ export async function runUpgradeCommand(targetDirectoryArgument, upgradeOptions
     console.log(`- Existing rules lines: ${currentRuleLineCount}`);
     console.log(`- Planned rules lines: ${plannedRuleLineCount}`);
     console.log(`- Rules changed: ${isRulesContentChanged ? 'yes' : 'no'}`);
+    if (projectDocStalenessReport.hasProjectDocs) {
+      console.log(`- Project docs detected: ${projectDocStalenessReport.checkedFileNames.length}`);
+      console.log(`- Project docs expected template version: ${projectDocStalenessReport.expectedTemplateVersion}`);
+      console.log(`- Project docs stale files: ${projectDocStalenessReport.staleFiles.length}`);
+    }
+
+    if (projectDocStalenessReport.staleFiles.length > 0) {
+      console.log('\n[WARN] Some project docs were generated from older template versions:');
+      for (const staleDoc of projectDocStalenessReport.staleFiles) {
+        const detectedVersionLabel = staleDoc.detectedTemplateVersion || 'missing';
+        console.log(`- docs/${staleDoc.fileName} (detected: ${detectedVersionLabel}, expected: ${projectDocStalenessReport.expectedTemplateVersion})`);
+      }
+      console.log('Recommendation: regenerate docs with init --scaffold-docs or update the files manually to match the latest template version.');
+    }
 
     if (upgradeOptions.dryRun) {
       console.log('\nDry run enabled. No files were modified.');

package/lib/cli/project-scaffolder.mjs

@@ -8,11 +8,21 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 import { CLI_VERSION } from './constants.mjs';
-import { ensureDirectory, askChoice, askYesNo, toTitleCase, pathExists } from './utils.mjs';
+import { ensureDirectory, askChoice, toTitleCase, pathExists } from './utils.mjs';
 
 const CURRENT_FILE_PATH = fileURLToPath(import.meta.url);
 const CURRENT_DIRECTORY_PATH = path.dirname(CURRENT_FILE_PATH);
 const TEMPLATES_DIRECTORY_PATH = path.join(CURRENT_DIRECTORY_PATH, 'templates');
+const SUPPORTED_DOC_LANGUAGES = new Set(['en', 'id']);
+const PROJECT_DOC_FILE_NAMES = [
+  'project-brief.md',
+  'architecture-decision-record.md',
+  'database-schema.md',
+  'api-contract.md',
+  'flow-overview.md',
+];
+
+export const PROJECT_DOC_TEMPLATE_VERSION = '1.1.0';
 
 const DOMAIN_CHOICES = [
   'API service',
@@ -40,6 +50,35 @@ const AUTH_CHOICES = [
   'Other',
 ];
 
+export function normalizeDocsLanguage(rawDocsLanguage = 'en') {
+  const normalizedDocsLanguage = String(rawDocsLanguage || 'en').trim().toLowerCase();
+  return SUPPORTED_DOC_LANGUAGES.has(normalizedDocsLanguage) ? normalizedDocsLanguage : null;
+}
+
+function resolveLocalizedTemplateFileName(templateFileName, docsLanguage) {
+  if (docsLanguage === 'en') {
+    return templateFileName;
+  }
+
+  return templateFileName.replace(/\.md\.tmpl$/i, `.md.${docsLanguage}.tmpl`);
+}
+
+async function resolveTemplateFilePath(templateFileName, docsLanguage) {
+  const localizedTemplateFileName = resolveLocalizedTemplateFileName(templateFileName, docsLanguage);
+  const localizedTemplateFilePath = path.join(TEMPLATES_DIRECTORY_PATH, localizedTemplateFileName);
+
+  if (await pathExists(localizedTemplateFilePath)) {
+    return localizedTemplateFilePath;
+  }
+
+  const defaultTemplateFilePath = path.join(TEMPLATES_DIRECTORY_PATH, templateFileName);
+  if (await pathExists(defaultTemplateFilePath)) {
+    return defaultTemplateFilePath;
+  }
+
+  return null;
+}
+
 /**
  * Run the project discovery interview.
  * Returns a structured object with all user responses.
@@ -189,6 +228,7 @@ export function buildTemplateContext(discoveryAnswers, initContext) {
     blueprintFileName: initContext.blueprintFileName,
     blueprintDisplayName: toTitleCase(initContext.blueprintFileName),
     cliVersion: CLI_VERSION,
+    templateVersion: PROJECT_DOC_TEMPLATE_VERSION,
     generatedAt: new Date().toISOString(),
     generatedDate: new Date().toISOString().split('T')[0],
     hasDatabase,
@@ -259,8 +299,14 @@ export function renderTemplate(templateContent, templateContext) {
 export async function generateProjectDocumentation(
   targetDirectoryPath,
   discoveryAnswers,
-  initContext
+  initContext,
+  options = {}
 ) {
+  const normalizedDocsLanguage = normalizeDocsLanguage(options.docsLanguage || 'en');
+  if (!normalizedDocsLanguage) {
+    throw new Error(`Unsupported docs language: ${options.docsLanguage}. Supported values: en, id`);
+  }
+
   const docsDirectoryPath = path.join(targetDirectoryPath, 'docs');
   await ensureDirectory(docsDirectoryPath);
 
@@ -269,9 +315,12 @@ export async function generateProjectDocumentation(
   const generatedFileNames = [];
 
   for (const documentEntry of documentManifest) {
-    const templateFilePath = path.join(TEMPLATES_DIRECTORY_PATH, documentEntry.templateFileName);
+    const templateFilePath = await resolveTemplateFilePath(
+      documentEntry.templateFileName,
+      normalizedDocsLanguage
+    );
 
-    if (!(await pathExists(templateFilePath))) {
+    if (!templateFilePath) {
       console.log(`[WARN] Template not found: ${documentEntry.templateFileName}, skipping.`);
       continue;
     }
@@ -287,7 +336,8 @@ export async function generateProjectDocumentation(
   return {
     docsDirectoryPath,
     generatedFileNames,
-    templateVersion: '1.0.0',
+    templateVersion: PROJECT_DOC_TEMPLATE_VERSION,
+    docsLanguage: normalizedDocsLanguage,
     discoveryAnswers,
   };
 }
@@ -316,6 +366,42 @@ export async function hasExistingProjectDocs(targetDirectoryPath) {
   return pathExists(projectBriefPath);
 }
 
+function extractTemplateVersion(documentContent) {
+  const templateVersionMatch = documentContent.match(/^(?:Template version|Versi template):\s*(.+)$/im);
+  return templateVersionMatch ? templateVersionMatch[1].trim() : null;
+}
+
+export async function detectProjectDocTemplateStaleness(targetDirectoryPath) {
+  const docsDirectoryPath = path.join(targetDirectoryPath, 'docs');
+  const checkedFileNames = [];
+  const staleFiles = [];
+
+  for (const projectDocFileName of PROJECT_DOC_FILE_NAMES) {
+    const projectDocFilePath = path.join(docsDirectoryPath, projectDocFileName);
+    if (!(await pathExists(projectDocFilePath))) {
+      continue;
+    }
+
+    checkedFileNames.push(projectDocFileName);
+    const projectDocContent = await fs.readFile(projectDocFilePath, 'utf8');
+    const detectedTemplateVersion = extractTemplateVersion(projectDocContent);
+
+    if (!detectedTemplateVersion || detectedTemplateVersion !== PROJECT_DOC_TEMPLATE_VERSION) {
+      staleFiles.push({
+        fileName: projectDocFileName,
+        detectedTemplateVersion,
+      });
+    }
+  }
+
+  return {
+    hasProjectDocs: checkedFileNames.length > 0,
+    expectedTemplateVersion: PROJECT_DOC_TEMPLATE_VERSION,
+    checkedFileNames,
+    staleFiles,
+  };
+}
+
 /**
  * Load project config from a YAML-like file for non-interactive mode.
  * Uses a simple key: value format (one per line) for zero-dependency parsing.
@@ -374,5 +460,6 @@ export async function loadProjectConfig(configFilePath) {
     authStrategy: configEntries.authStrategy || configEntries.auth || 'None (public service)',
     features: Array.isArray(configEntries.features) ? configEntries.features : [],
     additionalContext: configEntries.additionalContext || configEntries.context || 'No additional context provided.',
+    docsLang: configEntries.docsLang || configEntries.docsLanguage || 'en',
   };
 }

package/lib/cli/templates/api-contract.md.id.tmpl

@@ -0,0 +1,143 @@
+# Kontrak API: {{projectName}}
+
+Dibuat oleh Agentic-Senior-Core CLI v{{cliVersion}}
+Dibuat pada: {{generatedAt}}
+Versi template: {{templateVersion}}
+
+---
+
+## Prinsip Desain API
+
+Mengacu ke `.agent-context/rules/api-docs.md`:
+- OpenAPI 3.1 wajib untuk semua HTTP API.
+- Setiap endpoint harus mendokumentasikan skema request/response.
+- Error response harus pakai error code terstruktur, bukan string mentah.
+- Validasi input wajib di semua endpoint.
+
+## Base URL
+
+```
+{{baseUrl}}
+```
+
+---
+
+## Endpoint
+
+### Health Check
+
+```
+GET /health
+```
+
+Response `200`:
+```json
+{
+  "status": "ok",
+  "version": "1.0.0",
+  "timestamp": "2026-01-01T00:00:00Z"
+}
+```
+
+{{#if hasAuth}}
+### Autentikasi
+
+```
+POST /auth/register
+```
+Request:
+```json
+{
+  "email": "user@example.com",
+  "password": "secure-password",
+  "displayName": "User Name"
+}
+```
+
+```
+POST /auth/login
+```
+Request:
+```json
+{
+  "email": "user@example.com",
+  "password": "secure-password"
+}
+```
+Response `200`:
+```json
+{
+  "token": "jwt-token-here",
+  "expiresIn": 3600
+}
+```
+
+{{/if}}
+### Endpoint Fitur
+
+Berdasarkan fitur proyek, rencanakan grup endpoint berikut:
+
+{{#each features}}
+#### {{this}}
+
+```
+GET    /api/[resource]         - List
+GET    /api/[resource]/:id     - Detail
+POST   /api/[resource]         - Create
+PUT    /api/[resource]/:id     - Update
+DELETE /api/[resource]/:id     - Delete
+```
+
+{{/each}}
+
+---
+
+## Format Error Response
+
+Semua error response mengikuti struktur ini:
+
+```json
+{
+  "error": {
+    "code": "VALIDATION_ERROR",
+    "message": "Deskripsi yang bisa dibaca manusia",
+    "details": []
+  }
+}
+```
+
+Kode error standar:
+- `VALIDATION_ERROR` (400)
+- `UNAUTHORIZED` (401)
+- `FORBIDDEN` (403)
+- `NOT_FOUND` (404)
+- `CONFLICT` (409)
+- `INTERNAL_ERROR` (500)
+
+---
+
+## Pagination
+
+Endpoint list menggunakan cursor-based atau offset-based pagination:
+
+```
+GET /api/[resource]?page=1&limit=20
+```
+
+Response mencakup:
+```json
+{
+  "data": [],
+  "pagination": {
+    "page": 1,
+    "limit": 20,
+    "total": 100,
+    "totalPages": 5
+  }
+}
+```
+
+---
+
+Dokumen ini adalah referensi hidup. Perbarui saat endpoint API diimplementasikan.
+Jaga file OpenAPI 3.1 tetap sinkron dengan dokumen ini.

package/lib/cli/templates/api-contract.md.tmpl

@@ -2,7 +2,7 @@
 
 Generated by Agentic-Senior-Core CLI v{{cliVersion}}
 Generated at: {{generatedAt}}
-Template version: 1.0.0
+Template version: {{templateVersion}}
 
 ---
 

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

@@ -0,0 +1,106 @@
+# Catatan Keputusan Arsitektur: {{projectName}}
+
+Dibuat oleh Agentic-Senior-Core CLI v{{cliVersion}}
+Dibuat pada: {{generatedAt}}
+Versi template: {{templateVersion}}
+
+---
+
+## ADR-001: Pemilihan Stack Teknologi
+
+**Status**: Disetujui
+**Tanggal**: {{generatedDate}}
+
+### Konteks
+
+Proyek ini membutuhkan solusi {{primaryDomain}}. Tim mengevaluasi profil stack dan blueprint dari repository governance Agentic-Senior-Core.
+
+### Keputusan
+
+- **Bahasa/Runtime**: {{stackDisplayName}} (sumber: `.agent-context/stacks/{{stackFileName}}`)
+- **Blueprint arsitektur**: {{blueprintDisplayName}} (sumber: `.agent-context/blueprints/{{blueprintFileName}}`)
+- **Database**: {{databaseChoice}}
+- **Autentikasi**: {{authStrategy}}
+
+### Alasan
+
+Stack {{stackDisplayName}} dipilih karena:
+- Selaras dengan domain proyek ({{primaryDomain}}).
+- Repository governance menyediakan blueprint tervalidasi untuk stack ini.
+- Tim memiliki skill pack yang relevan untuk teknologi ini.
+
+### Konsekuensi
+
+- Semua kode harus mengikuti konvensi di `.agent-context/stacks/{{stackFileName}}`.
+- Batas modul harus mengikuti `.agent-context/blueprints/{{blueprintFileName}}`.
+- Akses database harus mengikuti `.agent-context/rules/database-design.md`.
+- Kontrak API harus mengikuti `.agent-context/rules/api-docs.md`.
+
+---
+
+## ADR-002: Pola Arsitektur
+
+**Status**: Disetujui
+**Tanggal**: {{generatedDate}}
+
+### Konteks
+
+Proyek membutuhkan pemisahan concern yang jelas agar tetap mudah dirawat saat skala bertambah.
+
+### Keputusan
+
+Gunakan arsitektur berlapis **Transport - Service - Repository** seperti di `.agent-context/rules/architecture.md`.
+
+{{#if hasDatabase}}
+### Lapisan Database
+
+- Database utama: {{databaseChoice}}
+- Strategi ORM/query: ikuti konvensi stack yang dipilih.
+- Strategi migrasi: migrasi aman dan reversible sesuai `.agent-context/rules/database-design.md`.
+{{/if}}
+
+{{#if hasAuth}}
+### Lapisan Autentikasi
+
+- Strategi: {{authStrategy}}
+- Manajemen secret: tidak boleh hardcoded sesuai `.agent-context/rules/security.md`.
+- Validasi input: wajib di semua endpoint auth sesuai `.agent-context/rules/security.md`.
+{{/if}}
+
+### Konsekuensi
+
+- Setiap modul harus menjaga pemisahan tiga lapis.
+- Import lintas lapis dilarang (transport tidak boleh akses repository langsung).
+- Logic bersama dipindah ke modul shared, bukan di handler transport.
+
+---
+
+## ADR-003: Struktur Proyek
+
+**Status**: Disetujui
+**Tanggal**: {{generatedDate}}
+
+### Keputusan
+
+Struktur direktori proyek mengikuti blueprint terpilih (`{{blueprintDisplayName}}`). Direktori utama:
+
+```
+{{projectName}}/
+  src/
+    modules/          - modul fitur (masing-masing berisi transport, service, repository)
+    shared/           - utilitas, tipe, konstanta bersama
+    config/           - konfigurasi environment dan aplikasi
+  docs/               - dokumentasi proyek (direktori ini)
+  tests/              - test suites
+  .agent-context/     - aturan dan kebijakan governance
+```
+
+### Konsekuensi
+
+- Fitur baru ditambahkan sebagai modul mandiri.
+- Kode shared diekstrak jika dipakai oleh dua modul atau lebih.
+- Konfigurasi dipusatkan dan divalidasi saat startup.
+
+---
+
+Tambahkan ADR baru di bawah ini saat ada keputusan arsitektur baru.

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

@@ -2,7 +2,7 @@
 
 Generated by Agentic-Senior-Core CLI v{{cliVersion}}
 Generated at: {{generatedAt}}
-Template version: 1.0.0
+Template version: {{templateVersion}}
 
 ---
 

package/lib/cli/templates/database-schema.md.id.tmpl

@@ -0,0 +1,74 @@
+# Skema Database: {{projectName}}
+
+Dibuat oleh Agentic-Senior-Core CLI v{{cliVersion}}
+Dibuat pada: {{generatedAt}}
+Versi template: {{templateVersion}}
+
+---
+
+## Teknologi Database
+
+**Tipe**: {{databaseChoice}}
+**Strategi autentikasi**: {{authStrategy}}
+
+## Prinsip Desain Skema
+
+Mengacu ke `.agent-context/rules/database-design.md`:
+- Gunakan Third Normal Form (3NF) sebagai default kecuali ada bukti performa untuk denormalisasi.
+- Gunakan migrasi aman dan reversible untuk setiap perubahan skema.
+- Jangan gunakan raw SQL tanpa parameterized query.
+- Tambahkan index berdasarkan pola query terukur, bukan asumsi.
+
+---
+
+## Tabel Inti
+
+{{#if hasAuth}}
+### users
+
+| Kolom | Tipe | Constraint | Catatan |
+|------|------|------------|---------|
+| id | UUID / BIGINT | PK, NOT NULL | Identifier utama |
+| email | VARCHAR(255) | UNIQUE, NOT NULL | Kredensial login |
+| password_hash | VARCHAR(255) | NOT NULL | Hash bcrypt/argon2 |
+| display_name | VARCHAR(100) | NOT NULL | Nama tampilan |
+| role | VARCHAR(50) | NOT NULL, DEFAULT 'user' | Role akses |
+| created_at | TIMESTAMP | NOT NULL, DEFAULT NOW() | Waktu buat |
+| updated_at | TIMESTAMP | NOT NULL, DEFAULT NOW() | Waktu ubah |
+
+{{/if}}
+### [Definisikan tabel domain Anda di sini]
+
+Berdasarkan fitur proyek:
+{{#each features}}
+- **{{this}}** - tentukan data apa yang perlu disimpan, dibaca, dan di-query.
+{{/each}}
+
+| Kolom | Tipe | Constraint | Catatan |
+|------|------|------------|---------|
+| id | UUID / BIGINT | PK, NOT NULL | Identifier utama |
+| ... | ... | ... | Definisikan sesuai kebutuhan fitur |
+| created_at | TIMESTAMP | NOT NULL, DEFAULT NOW() | Waktu buat |
+| updated_at | TIMESTAMP | NOT NULL, DEFAULT NOW() | Waktu ubah |
+
+---
+
+## Strategi Migrasi
+
+1. **Create**: buat file migrasi baru untuk setiap perubahan skema.
+2. **Test**: uji migrasi di lokal/staging sebelum produksi.
+3. **Rollback**: setiap migrasi wajib punya script down/rollback.
+4. **Review**: perubahan skema wajib review sesuai `.agent-context/review-checklists/pr-checklist.md`.
+
+## Index
+
+Tambahkan index berdasarkan pola query yang benar-benar muncul selama development:
+
+| Tabel | Kolom | Tipe | Alasan |
+|-------|-------|------|--------|
+| users | email | UNIQUE | Lookup login |
+| ... | ... | ... | Tambahkan saat pola query muncul |
+
+---
+
+Dokumen ini adalah referensi hidup. Perbarui saat model data berkembang.

package/lib/cli/templates/database-schema.md.tmpl

@@ -2,7 +2,7 @@
 
 Generated by Agentic-Senior-Core CLI v{{cliVersion}}
 Generated at: {{generatedAt}}
-Template version: 1.0.0
+Template version: {{templateVersion}}
 
 ---
 

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

@@ -0,0 +1,118 @@
+# Ikhtisar Flow: {{projectName}}
+
+Dibuat oleh Agentic-Senior-Core CLI v{{cliVersion}}
+Dibuat pada: {{generatedAt}}
+Versi template: {{templateVersion}}
+
+---
+
+## Ikhtisar Sistem
+
+**Proyek**: {{projectName}}
+**Domain**: {{primaryDomain}}
+**Stack**: {{stackDisplayName}}
+**Blueprint**: {{blueprintDisplayName}}
+
+## Arsitektur Tingkat Tinggi
+
+```
++-------------+     +--------------+     +--------------+
+|   Client    |---->|  Transport   |---->|   Service    |
+| (Browser/   |<----|   Layer      |<----|    Layer     |
+| Mobile/CLI) |     | (Routes/     |     | (Business    |
+|             |     |  Handlers)   |     |  Logic)      |
++-------------+     +--------------+     +------+-------+
+                                                |
+                                         +------+-------+
+                                         |  Repository  |
+                                         |    Layer     |
+                                         | (Data Access)|
+                                         +------+-------+
+                                                |
+                                         +------+-------+
+                                         |   Database   |
+                                         | {{databaseChoice}} |
+                                         +--------------+
+```
+
+## Flow Request
+
+### Siklus Request Standar
+
+1. **Client** mengirim HTTP request (atau input CLI, atau event trigger).
+2. **Transport layer** menerima request, memvalidasi format input, lalu routing ke handler yang tepat.
+3. **Service layer** menerapkan business logic, orkestrasi operasi domain, dan enforcement aturan.
+4. **Repository layer** melakukan akses data (read/write ke database atau layanan eksternal).
+5. **Response** kembali dari Service ke Transport lalu ke Client.
+
+### Tanggung Jawab Layer
+
+| Layer | Melakukan | Tidak melakukan |
+|-------|-----------|-----------------|
+| Transport | Parse input, validasi shape, routing, format response | Business logic, akses database |
+| Service | Business rules, orkestrasi, validasi domain | Parse HTTP, format response, menjalankan SQL |
+| Repository | Akses data, query, caching | Business logic, validasi input |
+
+{{#if hasAuth}}
+## Flow Autentikasi
+
+```
++--------+     +-----------+     +-----------+     +-----------+
+| Client |---->|  Auth     |---->|  Token    |---->| Protected |
+|        |     | Endpoint  |     |  Verify   |     | Resource  |
+|        |<----|           |<----| ({{authStrategy}}) |<----|       |
++--------+     +-----------+     +-----------+     +-----------+
+```
+
+1. Client mengirim kredensial ke endpoint auth.
+2. Service memvalidasi kredensial terhadap data tersimpan.
+3. Jika sukses, service mengeluarkan token {{authStrategy}}.
+4. Client menyertakan token di request berikutnya.
+5. Middleware memverifikasi token sebelum request diteruskan ke handler terproteksi.
+
+{{/if}}
+## Flow Fitur
+
+Untuk setiap fitur kunci, definisikan flow data dan kontrol:
+
+{{#each features}}
+### {{this}}
+
+**Aktor**: [siapa yang memulai flow ini]
+**Trigger**: [apa yang memulai flow ini]
+**Langkah**:
+1. [Langkah 1]
+2. [Langkah 2]
+3. [Langkah 3]
+
+**Hasil sukses**: [apa yang terjadi saat flow selesai]
+**Penanganan error**: [apa yang terjadi jika gagal]
+
+---
+
+{{/each}}
+
+## Diagram Aliran Data
+
+```
+  Input Data                Proses                 Output
+  ----------              -----------             ----------
+                   +--------------------+
+  User Input ----->|   Validation       |
+                   |   (Transport)      |
+                   +---------+----------+
+                             |
+                   +---------v----------+
+                   |   Business Logic   |
+                   |   (Service)        |
+                   +---------+----------+
+                             |
+                   +---------v----------+
+                   |   Data Persist     |-------> Stored Data
+                   |   (Repository)     |
+                   +--------------------+
+```
+
+---
+
+Dokumen ini adalah referensi hidup. Perbarui flow saat fitur diimplementasikan dan disempurnakan.

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

@@ -2,7 +2,7 @@
 
 Generated by Agentic-Senior-Core CLI v{{cliVersion}}
 Generated at: {{generatedAt}}
-Template version: 1.0.0
+Template version: {{templateVersion}}
 
 ---
 

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

@@ -0,0 +1,53 @@
+# Ringkasan Proyek: {{projectName}}
+
+Dibuat oleh Agentic-Senior-Core CLI v{{cliVersion}}
+Dibuat pada: {{generatedAt}}
+Versi template: {{templateVersion}}
+
+---
+
+## Ikhtisar
+
+**Nama proyek**: {{projectName}}
+**Deskripsi**: {{projectDescription}}
+**Domain utama**: {{primaryDomain}}
+
+## Keputusan Teknologi
+
+**Stack**: {{stackDisplayName}}
+**Blueprint**: {{blueprintDisplayName}}
+**Database**: {{databaseChoice}}
+**Strategi autentikasi**: {{authStrategy}}
+
+## Fitur Kunci
+
+{{#each features}}
+- {{this}}
+{{/each}}
+
+## Konteks Tambahan
+
+{{additionalContext}}
+
+## Batasan dan Asumsi
+
+- Proyek ini mengikuti aturan governance di `.agent-context/rules/`.
+- Konvensi stack mengacu ke `.agent-context/stacks/{{stackFileName}}`.
+- Pola arsitektur mengacu ke `.agent-context/blueprints/{{blueprintFileName}}`.
+- Semua kode harus lolos checklist di `.agent-context/review-checklists/pr-checklist.md`.
+
+## Tujuan
+
+1. Mengirimkan {{primaryDomain}} yang berjalan dengan stack {{stackDisplayName}}.
+2. Menjaga standar engineering production-grade sejak awal.
+3. Menjaga keputusan arsitektur tetap terdokumentasi dan bisa ditelusuri.
+
+## Non-Tujuan (Ruang Lingkup Awal)
+
+- Optimasi performa di luar baseline yang wajar.
+- Deployment multi-region.
+- Analitik atau pelaporan tingkat lanjut.
+
+---
+
+Dokumen ini adalah referensi hidup. Perbarui saat ruang lingkup proyek berkembang.

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

@@ -2,7 +2,7 @@
 
 Generated by Agentic-Senior-Core CLI v{{cliVersion}}
 Generated at: {{generatedAt}}
-Template version: 1.0.0
+Template version: {{templateVersion}}
 
 ---
 

package/package.json

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