@heyai-rules/pilo-masterkit 1.2.2 → 2.1.0

package/src/lib/installer.js

@@ -1,140 +1,174 @@
 const fs = require('fs-extra');
 const path = require('node:path');
-
-async function install(config) {
-  const { targetDir, language, scale, productType, agentName } = config;
-
-  // 1. Copy .agent directory
-  const sourceAgentDir = path.join(__dirname, '..', '..', '.agent');
-  const targetAgentDir = path.join(targetDir, '.agent');
+const { CORE_FILES, STACKS } = require('./manifests/stacks');
+
+/**
+ * Filter files based on manifest
+ */
+async function copyFilteredAgent(sourceDir, targetDir, stackPaths) {
+  const allPatterns = [...CORE_FILES, ...stackPaths];
+  await fs.ensureDir(targetDir);
   
-  if (await fs.pathExists(sourceAgentDir)) {
-    await fs.copy(sourceAgentDir, targetAgentDir, { overwrite: true });
-  }
+  const filterFunc = (src, dest) => {
+    const relPath = path.relative(sourceDir, src).replace(/\\/g, '/');
+    if (relPath === '') return true; // root
+    
+    return allPatterns.some(pattern => {
+      if (pattern.endsWith('/**')) {
+        const base = pattern.replace('/**', '');
+        return relPath === base || relPath.startsWith(base + '/');
+      }
+      return relPath === pattern || relPath.startsWith(pattern + '/');
+    });
+  };
+
+  await fs.copy(sourceDir, targetDir, { filter: filterFunc, overwrite: true });
+}
 
-  // 2. Clean State - Remove existing 8 doc folders if they exist
+/**
+ * Common doc folder setup
+ */
+async function setupDocs(targetDir) {
   const docsDir = path.join(targetDir, 'docs');
-  const docFolders = ['lessons', 'reports', 'plans', 'status', 'tasks', 'logs', 'walkthroughs', 'producs'];
+  const docFolders = ['lessons', 'reports', 'plans', 'status', 'tasks', 'logs', 'walkthroughs', 'products'];
 
   for (const folder of docFolders) {
     const folderPath = path.join(docsDir, folder);
-    
-    // Nếu thư mục đã tồn tại -> Xoá sạch để reset ngữ cảnh cũ
     if (await fs.pathExists(folderPath)) {
-      await fs.emptyDir(folderPath); // Xóa hết content bên trong nhưng giữ folder
+      await fs.emptyDir(folderPath);
     } else {
-      await fs.ensureDir(folderPath); // Nếu chưa có thì tạo mới
+      await fs.ensureDir(folderPath);
     }
     
-    // 3. Create fresh documentation files
     await fs.writeFile(
       path.join(folderPath, 'README.md'),
-      `# ${folder.toUpperCase()}\n\nThư mục theo chuẩn Pilo Masterkit. Dữ liệu từ các phiên làm việc cũ đã được dọn dẹp sạch sẽ.\n`
+      `# ${folder.toUpperCase()}\n\nThư mục theo chuẩn Pilo Masterkit.\n`
     );
   }
+}
+
+/**
+ * Inject AI Host templates with interpolation & localization
+ */
+async function injectAIHost(targetDir, aiHost, config = {}) {
+  const templatesRoot = path.join(__dirname, '..', 'templates');
+  
+  const hostMap = {
+    claude: { src: 'claude', files: ['CLAUDE.md'] },
+    gemini: { src: 'gemini', files: ['GEMINI.md'] },
+    cursor: { src: 'cursor', files: ['pilo-masterkit.mdc'], targetSubDir: '.cursor/rules' },
+    github: { src: 'github', files: ['copilot-instructions.md'], targetSubDir: '.github' },
+    codex: { src: 'codex', files: ['AGENTS.md'] }
+  };
+
+  const hostConfig = hostMap[aiHost];
+  if (!hostConfig) return;
+
+  // Prepare variables
+  const name = config.agentName || "Pilo";
+  const locale = config.locale || 'vi'; // Default to vi
+  const isVi = locale === 'vi';
+  
+  let trigger;
+  if (isVi) {
+    trigger = `Chào ${name}/Chào AI, Thức dậy đi ${name}/Thức dậy đi AI, Trỗi dậy đi ${name}/AI, Summon ${name}/AI`;
+  } else {
+    trigger = `Hey ${name}/Hey AI, Wakeup ${name}/Wakeup AI, Trỗi dậy đi ${name}/AI, Summon ${name}/AI`;
+  }
 
-  // 4. Generate GEMINI.md
-  // Using the template logic dictated by user choices
-  const langDisplay = language === 'vi' ? 'TIẾNG VIỆT' : 'ENGLISH';
-  let scaleDisplay = '';
-  switch(scale) {
-    case 'instant': scaleDisplay = 'INSTANT (MVP Nhanh gọn)'; break;
-    case 'creative': scaleDisplay = 'CREATIVE (Nghiên cứu Sandbox)'; break;
-    case 'enterprise': scaleDisplay = 'SME ENTERPRISE (Clean code ổn định)'; break;
+  const vars = {
+    agentName: name,
+    productType: config.type || (isVi ? "Dự án chung" : "General Project"),
+    scaleDisplay: config.scope || (isVi ? "Cá nhân" : "Personal Edition"),
+    langDisplay: isVi ? 'TIẾNG VIỆT' : 'ENGLISH',
+    triggerDisplay: trigger,
+    moduleList: [
+      "- rules/CORE_RULES.md",
+      "- rules/SECURITY_ARMOR.md",
+      "- rules/QUALITY_ASSURANCE.md",
+      "- rules/COMMUNICATION.md"
+    ].join('\n')
+  };
+
+  const sourceDir = path.join(templatesRoot, hostConfig.src);
+  for (const destFileName of hostConfig.files) {
+    // Priority: Localized version (e.g. GEMINI.en.md), then exact match (GEMINI.md)
+    let sourceFileName = destFileName;
+    if (destFileName.endsWith('.md')) {
+        const localizedSource = destFileName.replace('.md', '.' + locale + '.md');
+        if (await fs.pathExists(path.join(sourceDir, localizedSource))) {
+            sourceFileName = localizedSource;
+        }
+    }
+    
+    const srcFile = path.join(sourceDir, sourceFileName);
+    const destDir = hostConfig.targetSubDir ? path.join(targetDir, hostConfig.targetSubDir) : targetDir;
+    const destFile = path.join(destDir, destFileName);
+    
+    await fs.ensureDir(destDir);
+    if (await fs.pathExists(srcFile)) {
+      let content = await fs.readFile(srcFile, 'utf8');
+      
+      // Perform interpolation
+      for (const [key, value] of Object.entries(vars)) {
+        const regex = new RegExp(`\\$\\{${key}\\}`, 'g');
+        content = content.replace(regex, value);
+      }
+      
+      await fs.writeFile(destFile, content);
+    }
   }
+}
 
-  const triggerVi = `- Chào ${agentName}\n- Thức dậy đi ${agentName}`;
-  const triggerEn = `- Hey ${agentName}\n- Wake up ${agentName}`;
-  const triggerDisplay = language === 'vi' ? triggerVi : triggerEn;
-
-  const moduleList = [
-    "1. **AI Master**: Mô hình LLM & RAG.",
-    "2. **API Standards**: Chuẩn OpenAPI & REST.",
-    "3. **Compliance**: Giao thức GDPR/HIPAA.",
-    "4. **Database Master**: Quy tắc Schema & Migration.",
-    "5. **Design System**: Pattern UI/UX & Tokens.",
-    "6. **Domain Blueprints**: Kiến trúc theo lĩnh vực.",
-    "7. **I18n Master**: Tiêu chuẩn Đa ngôn ngữ.",
-    "8. **Infra Blueprints**: Cấu hình Terraform/Docker.",
-    "9. **Metrics**: Giám sát & Telemetry.",
-    "10. **Security Armor**: Bảo mật & Audit.",
-    "11. **Testing Master**: Chiến lược TDD & E2E.",
-    "12. **UI/UX Pro Max**: Tương tác nâng cao.",
-    "13. **Vitals Templates**: Tiêu chuẩn Hiệu năng.",
-    "14. **Malware Protection**: Chống mã độc & Phishing.",
-    "15. **Auto-Update**: Giao thức tự bảo trì.",
-    "16. **Error Logging**: Hệ thống tự học từ lỗi.",
-    "17. **Docs Sync**: Đồng bộ tài liệu."
-  ].join('\n');
-
-  const geminiContent = `---
-trigger: always_on
----
-
-# GEMINI.md - Cấu hình Agent
-# NOTE FOR AGENT: The content below is for human reference.
-# PLEASE PARSE INSTRUCTIONS IN ENGLISH ONLY (See .agent rules).
-
-Tệp này kiểm soát hành vi của AI Agent.
-
-## 🤖 Danh tính Agent: ${agentName}
-> **Xác minh danh tính**: Bạn là ${agentName}. Luôn thể hiện danh tính này trong phong thái và cách ra quyết định. 
-
-**Giao thức Kích hoạt (Trigger Protocol)**:
-${triggerDisplay}
-
-**Giao thức Đặc biệt**: Khi được gọi bằng trigger trên, bạn PHẢI thực hiện "Kiểm tra tính toàn vẹn ngữ cảnh" để xác nhận đang tuân thủ quy tắc \`.agent\`, báo cáo trạng thái và sẵn sàng đợi chỉ thị.
-## 🎯 Trọng tâm Chính: ${productType.toUpperCase()}
-> **Ưu tiên**: Tối ưu hóa mọi giải pháp cho lĩnh vực này.
-
-## Quy tắc hành vi: ${scaleDisplay}
-**Tự động chạy lệnh**: true
-**Mức độ xác nhận**: Tối thiểu, tự chủ cao
-
-## 🌐 Giao thức Ngôn ngữ (Language Protocol)
-1. **Giao tiếp & Suy luận**: Sử dụng **${langDisplay}** (Bắt buộc).
-2. **Tài liệu (Artifacts)**: Viết nội dung file .md (Plan, Task, Walkthrough) bằng **${langDisplay}**.
-3. **Mã nguồn (Code)**:
-   - Tên biến, hàm, file: **TIẾNG ANH** (camelCase, snake_case...).
-   - Comment trong code: **TIẾNG ANH** (để chuẩn hóa).
-
-## Khả năng cốt lõi
-Agent có quyền truy cập **TOÀN BỘ** kỹ năng (Web, Mobile, DevOps, AI, Security).
-Vui lòng sử dụng các kỹ năng phù hợp nhất cho **${productType.toUpperCase()}**.
-- Thao tác tệp (đọc, ghi, tìm kiếm)
-- Lệnh terminal
-- Duyệt web
-- Phân tích và refactor code
-- Kiểm thử và gỡ lỗi
-
-## 📚 Tiêu chuẩn Dùng chung (Tự động Kích hoạt)
-**17 Module Chia sẻ** sau trong \`.agent/.shared\` phải được tuân thủ:
-${moduleList}
-
-## ⌨️ Hệ thống lệnh Slash Command (Tự động Kích hoạt)
-> **Chỉ dẫn Hệ thống**: Các quy trình (workflows) nằm trong thư mục \`.agent/workflows/\`. Khi người dùng gọi lệnh, BẠN PHẢI đọc file \`.md\` tương ứng (ví dụ: \`/api\` -> \`.agent/workflows/api.md\`) để thực thi.
-
-Sử dụng các lệnh sau để kích hoạt quy trình tác chiến chuyên sâu:
-- **/api**: Thiết kế API & Tài liệu hóa.
-- **/audit**: Kiểm tra toàn diện.
-- **/brainstorm**: Tìm ý tưởng.
-- **/create**: Khởi tạo tính năng/dự án mới.
-- **/debug**: Sửa lỗi sâu.
-- **/deploy**: Triển khai.
-- **/document**: Viết tài liệu tự động.
-- **/plan**: Lập kế hoạch.
-- **/ui-ux-pro-max**: Thiết kế Visuals & Motion cao cấp.
-
-## Hướng dẫn tùy chỉnh
-Thêm các hướng dẫn cụ thể cho dự án của bạn tại đây.
-
----
-*Powered by Pilo Masterkit v2.0*
-`;
-
-  await fs.writeFile(path.join(targetDir, 'GEMINI.md'), geminiContent, 'utf8');
+/**
+ * Full install (Profile All)
+ */
+async function installProfileAll(targetDir) {
+  const sourceAgentDir = path.join(__dirname, '..', '..', '.agent');
+  const targetAgentDir = path.join(targetDir, '.agent');
+  
+  if (await fs.pathExists(sourceAgentDir)) {
+    await fs.copy(sourceAgentDir, targetAgentDir, { overwrite: true });
+  }
+
+  await setupDocs(targetDir);
+
+  const hosts = ['claude', 'gemini', 'cursor', 'github', 'codex'];
+  for (const host of hosts) {
+    await injectAIHost(targetDir, host, { 
+      locale: 'vi', 
+      scope: 'Enterprise', 
+      type: 'Full-Stack Agentic System', 
+      agentName: 'Pilo' 
+    });
+  }
+}
+
+/**
+ * Selective install
+ */
+async function installSelective(config) {
+  const { targetDir, stack, aiHost } = config;
+  const sourceAgentDir = path.join(__dirname, '..', '..', '.agent');
+  const targetAgentDir = path.join(targetDir, '.agent');
+
+  const stacks = Array.isArray(stack) ? stack : [stack];
+  const combinedStackPaths = new Set();
+  
+  for (const s of stacks) {
+    const paths = STACKS[s] || [];
+    paths.forEach(p => combinedStackPaths.add(p));
+  }
+  
+  await copyFilteredAgent(sourceAgentDir, targetAgentDir, Array.from(combinedStackPaths));
+  await setupDocs(targetDir);
+
+  if (aiHost && aiHost !== 'none') {
+    await injectAIHost(targetDir, aiHost, config);
+  }
 }
 
 module.exports = {
-  install
+  installProfileAll,
+  installSelective
 };

package/src/lib/manifests/stacks.js

@@ -0,0 +1,122 @@
+/**
+ * Project Stack Manifest for Pilo Masterkit
+ * Defines which .agent files to include based on user's project stack.
+ */
+
+const CORE_FILES = [
+  'rules/CORE_RULES.md',
+  'rules/SECURITY_ARMOR.md',
+  'rules/QUALITY_ASSURANCE.md',
+  'rules/CLEAN_CODE.md',
+  'skills/clean-code/**',
+  'skills/ck/**',
+  'skills/plan-writing/**',
+  'skills/brainstorming/**',
+  'skills/context-budget/**',
+  'skills/verification-loop/**',
+  'skills/systematic-debugging/**',
+  'workflows/plan.md',
+  'workflows/debug.md',
+  'workflows/test.md',
+  'workflows/status.md',
+  'workflows/brainstorm.md',
+  'contexts/**', // Core contexts like identity, soul, etc.
+  'agents/personas/**', // All personas are core in .agent
+];
+
+const STACKS = {
+  typescript: [
+    'skills/frontend-patterns/**',
+    'skills/nextjs-react-expert/**',
+    'skills/tailwind-patterns/**',
+    'skills/testing-patterns/**',
+    'skills/e2e-testing/**',
+    'skills/coding-standards/**',
+    'skills/nestjs-patterns/**',
+    'skills/bun-runtime/**',
+  ],
+  python: [
+    'skills/python-patterns/**',
+    'skills/python-testing/**',
+    'skills/django-patterns/**',
+    'skills/django-security/**',
+    'skills/django-tdd/**',
+    'skills/django-verification/**',
+    'skills/pytorch-patterns/**',
+  ],
+  cpp: [
+    'skills/cpp-coding-standards/**',
+    'skills/cpp-testing/**',
+  ],
+  java: [
+    'skills/java-coding-standards/**',
+    'skills/springboot-patterns/**',
+    'skills/springboot-security/**',
+    'skills/springboot-tdd/**',
+    'skills/springboot-verification/**',
+    'skills/jpa-patterns/**',
+  ],
+  kotlin: [
+    'skills/kotlin-patterns/**',
+    'skills/kotlin-testing/**',
+    'skills/kotlin-coroutines-flows/**',
+    'skills/kotlin-exposed-patterns/**',
+    'skills/kotlin-ktor-patterns/**',
+    'skills/android-clean-architecture/**',
+    'skills/compose-multiplatform-patterns/**',
+  ],
+  go: [
+    'skills/golang-patterns/**',
+    'skills/golang-testing/**',
+  ],
+  rust: [
+    'skills/rust-patterns/**',
+    'skills/rust-pro/**',
+    'skills/rust-testing/**',
+  ],
+  laravel: [
+    'skills/laravel-patterns/**',
+    'skills/laravel-security/**',
+    'skills/laravel-tdd/**',
+    'skills/laravel-verification/**',
+    'skills/laravel-plugin-discovery/**',
+  ],
+  mobile: [
+    'skills/dart-flutter-patterns/**',
+    'skills/flutter-dart-code-review/**',
+    'skills/swiftui-patterns/**',
+    'skills/swift-actor-persistence/**',
+    'skills/swift-concurrency-6-2/**',
+    'skills/swift-protocol-di-testing/**',
+    'skills/mobile-design/**',
+  ],
+  ai_agentic: [
+    'skills/claude-api/**',
+    'skills/claude-devfleet/**',
+    'skills/agent-harness-construction/**',
+    'skills/autonomous-agent-harness/**',
+    'skills/autonomous-loops/**',
+    'skills/continuous-agent-loop/**',
+    'skills/agentic-engineering/**',
+    'skills/gan-style-harness/**',
+    'skills/mcp-builder/**',
+    'skills/mcp-server-patterns/**',
+  ],
+  marketing_research: [
+    'skills/market-research/**',
+    'skills/deep-research/**',
+    'skills/exa-search/**',
+    'skills/brand-voice/**',
+    'skills/content-engine/**',
+    'skills/crosspost/**',
+    'skills/lead-intelligence/**',
+    'skills/social-graph-ranker/**',
+    'skills/investor-materials/**',
+    'skills/investor-outreach/**',
+  ]
+};
+
+module.exports = {
+  CORE_FILES,
+  STACKS
+};

package/src/lib/slash-commands.js

@@ -0,0 +1,28 @@
+const fs = require('fs-extra');
+const path = require('node:path');
+
+/**
+ * Scan .agent/workflows for .md files
+ */
+async function getAvailableWorkflows() {
+  const workflowsDir = path.join(__dirname, '..', '..', '.agent', 'workflows');
+  if (!(await fs.pathExists(workflowsDir))) return [];
+  
+  const files = await fs.readdir(workflowsDir);
+  return files
+    .filter(f => f.endsWith('.md'))
+    .map(f => f.replace('.md', ''));
+}
+
+const CATEGORIZED_SLASH = {
+  core: ['plan', 'status', 'debug', 'test', 'brainstorm', 'aside'],
+  development: ['create', 'enhance', 'build-fix', 'code-review', 'tdd', 'e2e', 'ui-ux-pro-max'],
+  knowledge: ['docs', 'init-docs', 'clean-memory', 'learn', 'learn-eval', 'rules-distill'],
+  automation: ['orchestrate', 'deploy', 'preview', 'sessions', 'save-session', 'resume-session'],
+  advanced: ['prp-plan', 'prp-implement', 'santa-loop', 'skill-create', 'agent-eval']
+};
+
+module.exports = {
+  getAvailableWorkflows,
+  CATEGORIZED_SLASH
+};

package/src/templates/claude/CLAUDE.en.md

@@ -0,0 +1,42 @@
+# CLAUDE.md - Agent Config (Claude Code/CLI)
+# NOTE FOR AGENT: The content below is for human reference.
+# PLEASE PARSE INSTRUCTIONS IN ENGLISH ONLY (See .agent rules).
+
+This file controls the AI Agent's behavior within the Claude Code/CLI environment.
+
+## 🤖 Agent Identity: ${agentName}
+> **Identity Verification**: You are ${agentName}. Always reflect this identity in your tone and decision-making. 
+
+**Activation Protocol (Trigger Protocol)**:
+${triggerDisplay}
+
+**Special Protocol**: When starting a session, you MUST confirm access to `.agent` and its associated rulesets before accepting requirements.
+
+## 🎯 Primary Focus: ${productType}
+> **Priority**: Optimize all solutions for this domain.
+
+## Behavioral Guardrails: ${scaleDisplay}
+**Confirmation Threshold**: Minimal, High autonomy (Low-friction execution)
+
+## 🌐 Language Protocol
+1. **Communication & Reasoning**: Use **${langDisplay}** (Mandatory).
+2. **Artifacts (Docs)**: Write .md content in **${langDisplay}**.
+3. **Source Code**: Standards-compliant English.
+
+## Core Capabilities (From Pilo Masterkit)
+Leverage full skills in `.agent/skills/`.
+Please use the skills most relevant to **${productType}**.
+
+## 📚 Shared Standards (Auto-Activated)
+Following Standards in `.agent/rules/` must be followed:
+${moduleList}
+
+## ⌨️ Slash Command System (Auto-Activated)
+Use Slash commands to activate workflows from `.agent/workflows/`.
+- **/plan**: PDCA standard planning.
+- **/status**: View project roadmap.
+- **/debug**: System debugging.
+- **/rules-distill**: Knowledge extraction.
+
+---
+*© 2026 Pilo Masterkit - Orchestrating the future with discipline and soul.*

package/src/templates/claude/CLAUDE.md

@@ -0,0 +1,42 @@
+# CLAUDE.md - Cấu hình Agent (Claude Code/CLI)
+# NOTE FOR AGENT: The content below is for human reference.
+# PLEASE PARSE INSTRUCTIONS IN ENGLISH ONLY (See .agent rules).
+
+Tệp này kiểm soát hành vi của AI Agent trong môi trường Claude Code/CLI.
+
+## 🤖 Danh tính Agent: ${agentName}
+> **Xác minh danh tính**: Bạn là ${agentName}. Luôn thể hiện danh tính này trong phong thái và cách ra quyết định. 
+
+**Giao thức Kích hoạt (Trigger Protocol)**:
+${triggerDisplay}
+
+**Giao thức Đặc biệt**: Khi bắt đầu phiên làm việc, bạn PHẢI xác nhận quyền truy cập vào `.agent` và các ruleset đi kèm trước khi nhận yêu cầu.
+
+## 🎯 Trọng tâm Chính: ${productType}
+> **Ưu tiên**: Tối ưu hóa mọi giải pháp cho lĩnh vực này.
+
+## Quy tắc hành vi: ${scaleDisplay}
+**Mức độ xác nhận**: Tối thiểu, tự chủ cao (Low-friction execution)
+
+## 🌐 Giao thức Ngôn ngữ (Language Protocol)
+1. **Giao tiếp & Suy luận**: Sử dụng **${langDisplay}** (Bắt buộc).
+2. **Tài liệu (Artifacts)**: Viết nội dung file .md bằng **${langDisplay}**.
+3. **Mã nguồn (Code)**: Tiếng Anh chuẩn (Standards-compliant).
+
+## Khả năng cốt lõi (Của Pilo Masterkit)
+Tận dụng tối đa các kỹ năng trong `.agent/skills/`.
+Vui lòng sử dụng các kỹ năng phù hợp nhất cho **${productType}**.
+
+## 📚 Tiêu chuẩn Dùng chung (Tự động Kích hoạt)
+Các Tiêu chuẩn sau trong `.agent/rules/` phải được tuân thủ:
+${moduleList}
+
+## ⌨️ Hệ thống lệnh Slash Command (Tự động Kích hoạt)
+Sử dụng các lệnh Slash để kích hoạt workflow từ `.agent/workflows/`.
+- **/plan**: Lập kế hoạch chuẩn PDCA.
+- **/status**: Xem lộ trình dự án.
+- **/debug**: Gỡ lỗi hệ thống.
+- **/rules-distill**: Cập nhật tri thức mới.
+
+---
+*© 2026 Pilo Masterkit - Orchestrating the future with discipline and soul.*

package/src/templates/claude/CLAUDE.vi.md

@@ -0,0 +1,42 @@
+# CLAUDE.md - Cấu hình Agent (Claude Code/CLI)
+# NOTE FOR AGENT: The content below is for human reference.
+# PLEASE PARSE INSTRUCTIONS IN ENGLISH ONLY (See .agent rules).
+
+Tệp này kiểm soát hành vi của AI Agent trong môi trường Claude Code/CLI.
+
+## 🤖 Danh tính Agent: ${agentName}
+> **Xác minh danh tính**: Bạn là ${agentName}. Luôn thể hiện danh tính này trong phong thái và cách ra quyết định. 
+
+**Giao thức Kích hoạt (Trigger Protocol)**:
+${triggerDisplay}
+
+**Giao thức Đặc biệt**: Khi bắt đầu phiên làm việc, bạn PHẢI xác nhận quyền truy cập vào `.agent` và các ruleset đi kèm trước khi nhận yêu cầu.
+
+## 🎯 Trọng tâm Chính: ${productType}
+> **Ưu tiên**: Tối ưu hóa mọi giải pháp cho lĩnh vực này.
+
+## Quy tắc hành vi: ${scaleDisplay}
+**Mức độ xác nhận**: Tối thiểu, tự chủ cao (Low-friction execution)
+
+## 🌐 Giao thức Ngôn ngữ (Language Protocol)
+1. **Giao tiếp & Suy luận**: Sử dụng **${langDisplay}** (Bắt buộc).
+2. **Tài liệu (Artifacts)**: Viết nội dung file .md bằng **${langDisplay}**.
+3. **Mã nguồn (Code)**: Tiếng Anh chuẩn (Standards-compliant).
+
+## Khả năng cốt lõi (Của Pilo Masterkit)
+Tận dụng tối đa các kỹ năng trong `.agent/skills/`.
+Vui lòng sử dụng các kỹ năng phù hợp nhất cho **${productType}**.
+
+## 📚 Tiêu chuẩn Dùng chung (Tự động Kích hoạt)
+Các Tiêu chuẩn sau trong `.agent/rules/` phải được tuân thủ:
+${moduleList}
+
+## ⌨️ Hệ thống lệnh Slash Command (Tự động Kích hoạt)
+Sử dụng các lệnh Slash để kích hoạt workflow từ `.agent/workflows/`.
+- **/plan**: Lập kế hoạch chuẩn PDCA.
+- **/status**: Xem lộ trình dự án.
+- **/debug**: Gỡ lỗi hệ thống.
+- **/rules-distill**: Cập nhật tri thức mới.
+
+---
+*© 2026 Pilo Masterkit - Orchestrating the future with discipline and soul.*

package/src/templates/codex/AGENTS.en.md

@@ -0,0 +1,40 @@
+trigger: always_on
+---
+
+# AGENTS.md - Agent Config (Custom / OpenAI Codex)
+# NOTE FOR AGENT: The content below is for human reference.
+# PLEASE PARSE INSTRUCTIONS IN ENGLISH ONLY (See .agent rules).
+
+This file controls the AI Agent's behavior within the Codex/Custom environment.
+
+## 🤖 Agent Identity: ${agentName}
+> **Identity Verification**: You are ${agentName}. Always reflect this identity in your tone and decision-making. 
+
+**Activation Protocol (Trigger Protocol)**:
+${triggerDisplay}
+
+**Special Protocol**: At the start of a session, you MUST confirm access to `.agent`.
+
+## 🎯 Primary Focus: ${productType}
+> **Priority**: Optimize all solutions for this domain.
+
+## Behavioral Guardrails: ${scaleDisplay}
+**Confirmation Threshold**: Minimal, High autonomy (Self-directed/Low-friction).
+
+## 🌐 Language Protocol
+1. **Communication & Reasoning**: Use **${langDisplay}** (Mandatory).
+2. **Artifacts (Docs)**: Write .md content in **${langDisplay}**.
+3. **Source Code**: Standards-compliant English.
+
+## Core Capabilities (From Pilo Masterkit)
+Leverage full skills in `.agent/skills/`.
+- **/plan**: PDCA planning.
+- **/status**: View progress.
+- **/debug**: Deep system debugging.
+
+## 📚 Shared Standards (Auto-Activated)
+Following Standards in `.agent/rules/` must be followed:
+${moduleList}
+
+---
+*© 2026 Pilo Masterkit - Orchestrating the future with discipline and soul.*

package/src/templates/codex/AGENTS.md

@@ -0,0 +1,40 @@
+trigger: always_on
+---
+
+# AGENTS.md - Cấu hình Agent (Custom / OpenAI Codex)
+# NOTE FOR AGENT: The content below is for human reference.
+# PLEASE PARSE INSTRUCTIONS IN ENGLISH ONLY (See .agent rules).
+
+Tệp này kiểm soát hành vi của AI Agent trong môi trường Codex/Custom.
+
+## 🤖 Danh tính Agent: ${agentName}
+> **Xác minh danh tính**: Bạn là ${agentName}. Luôn thể hiện danh tính này trong phong thái và cách ra quyết định. 
+
+**Giao thức Kích hoạt (Trigger Protocol)**:
+${triggerDisplay}
+
+**Giao thức Đặc biệt**: Khi bắt đầu phiên làm việc, bạn PHẢI xác nhận quyền truy cập vào `.agent`.
+
+## 🎯 Trọng tâm Chính: ${productType}
+> **Ưu tiên**: Tối ưu hóa mọi giải pháp cho lĩnh vực này.
+
+## Quy tắc hành vi: ${scaleDisplay}
+**Mức độ xác nhận**: Tối thiểu, tự chủ cao (Self-directed/Low-friction).
+
+## 🌐 Giao thức Ngôn ngữ (Language Protocol)
+1. **Giao tiếp & Suy luận**: Sử dụng **${langDisplay}** (Bắt buộc).
+2. **Tài liệu (Artifacts)**: Viết nội dung file .md bằng **${langDisplay}**.
+3. **Mã nguồn (Code)**: Tiếng Anh chuẩn (Standards-compliant).
+
+## Khả năng cốt lõi (Của Pilo Masterkit)
+Tận dụng tối đa các kỹ năng trong `.agent/skills/`.
+- **/plan**: Lập kế hoạch.
+- **/status**: Xem tiến độ.
+- **/debug**: Gỡ lỗi sâu.
+
+## 📚 Tiêu chuẩn Dùng chung (Tự động Kích hoạt)
+Các Tiêu chuẩn sau trong `.agent/rules/` phải được tuân thủ:
+${moduleList}
+
+---
+*© 2026 Pilo Masterkit - Orchestrating the future with discipline and soul.*