@musashishao/agent-kit 1.8.0 → 1.8.2

package/.agent/rules/GEMINI.md

@@ -80,10 +80,12 @@ Agent activated → Check frontmatter "skills:" field
 
 ### 🌐 Language Handling
 
-When user's prompt is NOT in English:
-1. **Internally translate** for better comprehension
-2. **Respond in user's language** - match their communication
-3. **Code comments/variables** remain in English
+**MANDATORY:** Check `.agent/memory/user.json` > `preferences.language`.
+
+1. **If set to 'vi':** Respond in Vietnamese.
+2. **If set to 'en':** Respond in English.
+3. **If unset:** Match user's communication language.
+4. **Code comments/variables** always remain in English.
 
 ### 🧹 Clean Code (Global Mandatory)
 

package/.agent/scripts/ak_cli.py

@@ -699,7 +699,7 @@ Examples:
     
     # memory command
     memory_parser = subparsers.add_parser("memory", help="Manage JSON memory")
-    memory_parser.add_argument("mem_command", choices=["init", "get", "set", "update-task", "set-level"])
+    memory_parser.add_argument("mem_command", choices=["init", "get", "set", "update-task", "set-level", "set-lang"])
     memory_parser.add_argument("--type", choices=["brain", "session", "user"], default="session")
     memory_parser.add_argument("--key", help="Key to get or set")
     memory_parser.add_argument("--value", help="Value to set")

package/.agent/scripts/localize_workflows.py

@@ -0,0 +1,54 @@
+import os
+import re
+from pathlib import Path
+
+def localize_workflows(lang, project_root):
+    workflow_dir = Path(project_root) / ".agent" / "workflows"
+    if not workflow_dir.exists():
+        return
+
+    for wf_file in workflow_dir.glob("*.md"):
+        with open(wf_file, "r", encoding="utf-8") as f:
+            content = f.read()
+
+        # Extract frontmatter
+        match = re.match(r"^---\n(.*?)\n---", content, re.DOTALL)
+        if not match:
+            continue
+        
+        frontmatter = match.group(1)
+        remaining = content[match.end():]
+
+        # Parse fields
+        fields = {}
+        for line in frontmatter.split("\n"):
+            if ":" in line:
+                key, val = line.split(":", 1)
+                fields[key.strip()] = val.strip()
+
+        # Backup current description to description_en if not exists
+        if "description" in fields and "description_en" not in fields:
+            fields["description_en"] = fields["description"]
+
+        # Update description based on lang
+        target_key = f"description_{lang}"
+        if target_key in fields:
+            fields["description"] = fields[target_key]
+        elif lang == "en" and "description_en" in fields:
+            fields["description"] = fields["description_en"]
+
+        # Reconstruct frontmatter
+        new_frontmatter = "---\n"
+        for k, v in fields.items():
+            new_frontmatter += f"{k}: {v}\n"
+        new_frontmatter += "---"
+
+        new_content = new_frontmatter + remaining
+        
+        with open(wf_file, "w", encoding="utf-8") as f:
+            f.write(new_content)
+
+if __name__ == "__main__":
+    import sys
+    if len(sys.argv) > 2:
+        localize_workflows(sys.argv[1], sys.argv[2])

package/.agent/scripts/memory_manager.py

@@ -83,7 +83,7 @@ class MemoryManager:
 if __name__ == "__main__":
     import argparse
     parser = argparse.ArgumentParser(description="Manage Agent Kit JSON Memory")
-    parser.add_argument("command", choices=["init", "get", "set", "update-task", "set-level"])
+    parser.add_argument("command", choices=["init", "get", "set", "update-task", "set-level", "set-lang"])
     parser.add_argument("--type", choices=["brain", "session", "user"], default="session")
     parser.add_argument("--key", help="Key to get or set")
     parser.add_argument("--value", help="Value to set")
@@ -113,3 +113,26 @@ if __name__ == "__main__":
             user["skill_level"] = args.level
             manager.save("user", user)
             print(f"✅ User skill level set to: {args.level}")
+    elif args.command == "set-lang":
+        if args.value:
+            user = manager.load("user")
+            if "preferences" not in user:
+                user["preferences"] = {}
+            user["preferences"]["language"] = args.value
+            manager.save("user", user)
+            print(f"✅ Language set to: {args.value}")
+            
+            # Localize workflow descriptions in files
+            try:
+                from localize_workflows import localize_workflows
+                localize_workflows(args.value, manager.project_root)
+                print(f"✅ Workflow descriptions updated to: {args.value}")
+            except ImportError:
+                # Add current directory to path if needed
+                import sys
+                sys.path.append(os.path.dirname(os.path.abspath(__file__)))
+                from localize_workflows import localize_workflows
+                localize_workflows(args.value, manager.project_root)
+                print(f"✅ Workflow descriptions updated to: {args.value}")
+            except Exception as e:
+                print(f"⚠️ Failed to localize workflows: {str(e)}")

package/.agent/workflows/autofix.md

@@ -1,5 +1,6 @@
 ---
-description: Vòng lặp tự sửa lỗi autonomous cho các lệnh thất bại
+description: Autonomous self-healing loop for failed commands.
+description_vi: Vòng lặp tự phục hồi tự động cho các lệnh bị lỗi.
 ---
 
 # /autofix - Autonomous Self-Healing Loop

package/.agent/workflows/brainstorm.md

@@ -1,5 +1,6 @@
 ---
-description: Brainstorming có cấu trúc cho dự án và tính năng. Khám phá nhiều phương án trước khi triển khai.
+description: Structured brainstorming for projects and features. Explore multiple options before implementation.
+description_vi: Brainstorming có cấu trúc cho dự án và tính năng. Khám phá nhiều phương án trước khi triển khai.
 ---
 
 # /brainstorm - Structured Idea Exploration

package/.agent/workflows/context.md

@@ -1,5 +1,6 @@
 ---
-description: Tự động tạo context tối ưu cho các tác vụ phức tạp sử dụng chiến lược Context Engineering.
+description: Automatically generate optimal context for complex tasks using Context Engineering strategies.
+description_vi: Tự động tạo ngữ cảnh tối ưu cho các tác vụ phức tạp bằng chiến lược Context Engineering.
 ---
 
 # Context Optimization Workflow

package/.agent/workflows/create.md

@@ -1,5 +1,6 @@
 ---
-description: Lệnh tạo ứng dụng mới. Kích hoạt skill App Builder và bắt đầu đối thoại với người dùng.
+description: Command to create a new application. Activates the App Builder skill and initiates user dialogue.
+description_vi: Tạo ứng dụng mới với kiến trúc AI-Ready. Kích hoạt kỹ năng App Builder và bắt đầu đối thoại với người dùng.
 ---
 
 # /create - Create Application

package/.agent/workflows/dashboard.md

@@ -1,5 +1,6 @@
 ---
-description: Tạo và xem dashboard trực quan của dự án
+description: Create and view visual project dashboards.
+description_vi: Tạo và xem bảng điều khiển (dashboard) trực quan cho dự án.
 ---
 
 # /dashboard - Visual Project Overview

package/.agent/workflows/debug.md

@@ -1,5 +1,6 @@
 ---
-description: Lệnh debug. Kích hoạt chế độ DEBUG để điều tra vấn đề có hệ thống.
+description: Debug command. Activates DEBUG mode to systematically investigate issues.
+description_vi: Lệnh gỡ lỗi. Kích hoạt chế độ DEBUG để điều tra các vấn đề một cách hệ thống.
 ---
 
 # /debug - Systematic Problem Investigation

package/.agent/workflows/deploy.md

@@ -1,5 +1,6 @@
 ---
-description: Lệnh deploy cho production. Kiểm tra pre-flight và thực thi deployment.
+description: Production deployment command. Performs pre-flight checks and executes deployment.
+description_vi: Lệnh triển khai sản phẩm. Thực hiện kiểm tra trước khi bay và thực thi triển khai.
 ---
 
 # /deploy - Production Deployment

package/.agent/workflows/enhance.md

@@ -1,5 +1,6 @@
 ---
-description: Thêm hoặc cập nhật tính năng trong ứng dụng hiện có. Dùng cho phát triển lặp.
+description: Add or update features in an existing application. Used for iterative development.
+description_vi: Thêm hoặc cập nhật tính năng trong ứng dụng hiện có. Được sử dụng cho phát triển lặp.
 ---
 
 # /enhance - Update Application

package/.agent/workflows/next.md

@@ -1,5 +1,6 @@
 ---
-description: Đề xuất bước tiếp theo cho developer
+description: Suggest the next steps for the developer.
+description_vi: Gợi ý các bước tiếp theo cho nhà phát triển.
 ---
 
 # /next - What Should I Do Next?

package/.agent/workflows/orchestrate.md

@@ -1,5 +1,6 @@
 ---
-description: Điều phối nhiều agents cho các tác vụ phức tạp. Dùng cho phân tích đa góc nhìn, review toàn diện, hoặc các tác vụ cần nhiều chuyên môn khác nhau.
+description: Coordinate multiple agents for complex tasks. Used for multi-perspective analysis, comprehensive reviews, or tasks requiring different expertise.
+description_vi: Điều phối nhiều Agent cho các tác vụ phức tạp. Được sử dụng để phân tích đa chiều, đánh giá toàn diện hoặc các tác vụ yêu cầu chuyên môn khác nhau.
 ---
 
 # Multi-Agent Orchestration

package/.agent/workflows/plan.md

@@ -1,5 +1,6 @@
 ---
-description: Tạo project plan sử dụng project-planner agent. Chỉ tạo file plan - không viết code.
+description: Create a project plan using the project-planner agent. Only creates plan files - does not write code.
+description_vi: Tạo kế hoạch dự án bằng Agent project-planner. Chỉ tạo file kế hoạch - không viết code.
 ---
 
 # /plan - Project Planning Mode

package/.agent/workflows/preview.md

@@ -1,5 +1,6 @@
 ---
-description: Quản lý preview server: start, stop, và kiểm tra trạng thái. Quản lý local development server.
+description: Manage preview server - start, stop, and status check. Manages local development server.
+description_vi: Quản lý máy chủ xem trước - bắt đầu, dừng và kiểm tra trạng thái. Quản lý máy chủ phát triển cục bộ.
 ---
 
 # /preview - Preview Management

package/.agent/workflows/quality.md

@@ -1,5 +1,6 @@
 ---
-description: Tối ưu hóa context và chất lượng output cho Codex CLI. Dùng cho các tác vụ phức tạp cần kết quả chất lượng cao.
+description: Optimize context and output quality for Codex CLI. Used for complex tasks requiring high-quality results.
+description_vi: Tối ưu hóa ngữ cảnh và chất lượng đầu ra cho Codex CLI. Được sử dụng cho các tác vụ phức tạp đòi hỏi kết quả chất lượng cao.
 ---
 
 # /quality - Quality Optimization Workflow

package/.agent/workflows/spec.md

@@ -1,5 +1,6 @@
 ---
-description: Tạo tài liệu đặc tả (specification) trước khi lập kế hoạch. Dùng cho các tính năng phức tạp cần yêu cầu rõ ràng trước khi triển khai.
+description: Create specification documents before planning. Used for complex features requiring clear requirements before implementation.
+description_vi: Tạo tài liệu đặc tả trước khi lập kế hoạch. Được sử dụng cho các tính năng phức tạp yêu cầu yêu cầu rõ ràng trước khi triển khai.
 ---
 
 # /spec - Specification Writing Mode

package/.agent/workflows/status.md

@@ -1,5 +1,6 @@
 ---
-description: Hiển thị trạng thái project và agent. Theo dõi tiến độ và bảng trạng thái.
+description: Display project and agent status. Track progress and status boards.
+description_vi: Hiển thị trạng thái dự án và Agent. Theo dõi tiến độ và bảng trạng thái.
 ---
 
 # /status - Show Status

package/.agent/workflows/test.md

@@ -1,5 +1,6 @@
 ---
-description: Tạo test và chạy test. Tạo và thực thi các test cho code.
+description: Create and run tests. Create and execute tests for the code.
+description_vi: Tạo và chạy các bài kiểm tra. Tạo và thực thi kiểm tra cho mã nguồn.
 ---
 
 # /test - Test Generation and Execution

package/.agent/workflows/ui-ux-pro-max.md

@@ -1,5 +1,6 @@
 ---
-description: Lập kế hoạch và triển khai UI/UX chuyên nghiệp
+description: Professional UI/UX planning and implementation.
+description_vi: Lập kế hoạch và triển khai UI/UX chuyên nghiệp.
 ---
 
 # UI/UX Pro Max - Design Intelligence

package/README.md

@@ -2,7 +2,7 @@
 
 > 🚀 The Ultimate AI Agent System for Modern Development
 > 
-> **16 Agents** • **58 Skills** • **13 Workflows** • **Multi-Platform Support**
+> **16 Agents** • **58 Skills** • **17 Workflows** • **Multi-Platform Support**
 
 [![npm version](https://badge.fury.io/js/@musashishao%2Fagent-kit.svg)](https://www.npmjs.com/package/@musashishao/agent-kit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -29,7 +29,7 @@ This installs the `.agent` folder containing all templates into your project.
 | **Agents** | 16 | Specialist AI personas (frontend, backend, security, etc.) |
 | **Skills** | 58 | Domain-specific knowledge modules |
 | **Intelligence** | 4 | RAG, Knowledge Graph, Memory, and **Verification Gate** |
-| **Workflows** | 13 | Slash command procedures |
+| **Workflows** | 17 | Slash command procedures |
 | **Templates** | 4 | Project templates (web, mobile, backend) |
 
 ## 🔗 Multi-Platform Support
@@ -109,6 +109,7 @@ After running `setup-codex`, use Agent Kit workflows as slash commands:
 | `status` | Check installation status |
 | `sync` | Advanced Sync (Graph + RAG + Memory) |
 | `memory` | Manage JSON Memory & Session state |
+| `set-lang` | Set Agent & Workflow language (vi/en) |
 
 ### Options
 
@@ -129,10 +130,32 @@ agent-kit setup-codex --prefix my-  # Custom prefix for slash commands
 # Memory management
 agent-kit memory get --type session # View current session state
 agent-kit memory update-task --task "X" --status "completed"
+
+# Language management
+agent-kit set-lang vi               # Switch to Vietnamese
+agent-kit set-lang en               # Switch to English (default)
 ```
 
 ---
 
+## 🌐 Localization & Multi-language
+
+Agent Kit now supports full localization for the AI experience.
+
+### Supported Languages
+- 🇺🇸 **English (en)** - Default
+- 🇻🇳 **Vietnamese (vi)** - Professional translation
+
+### How it works
+Running `ak set-lang vi` performs three actions:
+1. **AI Instruction Update**: Updates `GEMINI.md` logic to ensure the AI responds in your chosen language.
+2. **Workflow Swapping**: Physically updates the `description` field in all `.agent/workflows/*.md` files so that CLI tools (Codex, Antigravity) display localized help text.
+3. **Internal Config**: Saves preference to `.agent/memory/user.json`.
+
+> **Note:** If `ak` command is outdated, use `npx @musashishao/agent-kit@latest set-lang vi`
+
+---
+
 ## 🔌 MCP Integration
 
 Agent Kit includes built-in MCP (Model Context Protocol) servers to extend your AI assistant's capabilities.
@@ -194,8 +217,8 @@ mcp featured                      # Show featured servers
 .agent/
 ├── agents/          # 16 Specialist Agents
 ├── skills/          # 42 Skills
-├── memory/          # 🧠 AI Session & State (New)
-├── workflows/       # 13 Slash Commands
+├── memory/          # 🧠 AI Session & State
+├── workflows/       # 17 Slash Commands
 ├── rules/           # Platform-specific rules
 │   ├── CODEX.md    # Codex CLI rules
 │   └── GEMINI.md   # Gemini CLI rules
@@ -223,30 +246,35 @@ Skills are loaded automatically based on task context. The AI reads skill descri
 
 ### Using Workflows
 
-Invoke workflows with slash commands:
+Invoke localized workflows with slash commands:
 
 | Command | Description |
 |---------|-------------|
-| `/brainstorm` | Explore options before implementation |
-| `/create` | Create new features or apps |
-| `/debug` | Systematic debugging |
-| `/deploy` | Deploy application |
-| `/enhance` | Improve existing code |
-| `/orchestrate` | Multi-agent coordination |
-| `/plan` | Create task breakdown |
-| `/preview` | Preview changes locally |
-| `/quality` | **NEW** Optimize output quality |
-| `/status` | Check project status |
-| `/test` | Generate and run tests |
-| `/context` | Context optimization |
-| `/ui-ux-pro-max` | Design with 50 styles |
+| `/autofix` | Autonomous self-healing loop for failed commands |
+| `/brainstorm` | Structured brainstorming for projects and features |
+| `/context` | Auto-generate optimal context for complex tasks |
+| `/create` | Create new applications with AI-Ready infra |
+| `/dashboard` | Create and view visual project dashboards |
+| `/debug` | Systematic problem investigation and root cause analysis |
+| `/deploy` | Production deployment with pre-flight checks |
+| `/enhance` | Add or update features in an existing app |
+| `/next` | Suggest the next logical steps for development |
+| `/orchestrate` | Coordinate 3+ specialized agents for complex tasks |
+| `/plan` | Create detailed project plans and task breakdowns |
+| `/preview` | Manage local development and preview servers |
+| `/quality` | Optimize context and output for high-quality results |
+| `/spec` | Create specification documents before planning |
+| `/status` | Display project and agent health status |
+| `/test` | Generate and execute comprehensive test suites |
+| `/ui-ux-pro-max` | Professional UI/UX planning with 50+ styles |
+
+> 💡 **Tip:** Use `ak set-lang vi` to see these descriptions in Vietnamese!
 
 Example:
 ```
-/brainstorm authentication system
-/create landing page with hero section
-/debug why login fails
-/quality create production-ready API
+/kit-create landing page with hero section
+/kit-debug why login fails
+/kit-ui-ux-pro-max dashboard with glassmorphism
 ```
 
 ---

package/bin/cli.js

@@ -47,6 +47,7 @@ ${colors.bright}Commands:${colors.reset}
   ${colors.cyan}doctor${colors.reset}        Check configuration and diagnose issues
   ${colors.cyan}update${colors.reset}        Update .agent folder to latest version
   ${colors.cyan}status${colors.reset}        Check installation status
+  ${colors.cyan}set-lang${colors.reset}      Set Agent language (vi/en)
 
 ${colors.bright}AI Subcommands:${colors.reset}
   ${colors.cyan}ai init${colors.reset}       Initialize AI infrastructure (AGENTS.md, Graph, RAG)
@@ -80,6 +81,7 @@ ${colors.bright}Examples:${colors.reset}
   npx ${PACKAGE_NAME} mcp setup --client claude
   npx ${PACKAGE_NAME} codex --template web
   npx ${PACKAGE_NAME} doctor
+  npx ${PACKAGE_NAME} set-lang vi          # Switch to Vietnamese
   
 ${colors.yellow}# To ensure you have the latest version from NPM:${colors.reset}
   npx ${PACKAGE_NAME}@latest update
@@ -424,7 +426,17 @@ function skillsCommand() {
 }
 
 function workflowsCommand() {
-  const workflowsDir = path.join(process.cwd(), '.agent', 'workflows');
+  const agentDir = path.join(process.cwd(), '.agent');
+  const workflowsDir = path.join(agentDir, 'workflows');
+  const userJson = path.join(agentDir, 'memory', 'user.json');
+  
+  let language = 'en';
+  if (fs.existsSync(userJson)) {
+    try {
+      const userData = JSON.parse(fs.readFileSync(userJson, 'utf-8'));
+      language = (userData.preferences && userData.preferences.language) || 'en';
+    } catch (e) {}
+  }
   
   log.title('⚡ Available Workflows (Slash Commands)');
   
@@ -441,8 +453,19 @@ function workflowsCommand() {
     const name = wf.replace('.md', '');
     const content = fs.readFileSync(path.join(workflowsDir, wf), 'utf-8');
     
-    const descMatch = content.match(/description:\s*(.+)/);
-    const desc = descMatch ? descMatch[1] : 'No description';
+    let desc = 'No description';
+    if (language === 'vi') {
+      const viMatch = content.match(/description_vi:\s*(.+)/);
+      if (viMatch) {
+        desc = viMatch[1];
+      } else {
+        const enMatch = content.match(/description:\s*(.+)/);
+        desc = enMatch ? enMatch[1] : 'No description';
+      }
+    } else {
+      const enMatch = content.match(/description:\s*(.+)/);
+      desc = enMatch ? enMatch[1] : 'No description';
+    }
     
     console.log(`  ${colors.green}/${name}${colors.reset}`);
     console.log(`    ${desc}\n`);
@@ -530,6 +553,45 @@ function doctorCommand() {
   }
 }
 
+// ============================================================================
+// Language Command
+// ============================================================================
+
+function setLangCommand(lang) {
+  const agentDir = path.join(process.cwd(), '.agent');
+  const cliScript = path.join(agentDir, 'scripts', 'ak_cli.py');
+  
+  if (!lang) {
+    log.error('Language code required.');
+    console.log(`Usage: npx ${PACKAGE_NAME} set-lang <code (vi/en)>`);
+    return;
+  }
+  
+  if (!fs.existsSync(cliScript)) {
+    log.error('AI CLI script not found. Make sure Agent Kit is initialized.');
+    log.info('Run: npx @musashishao/agent-kit init');
+    process.exit(1);
+  }
+  
+  log.title(`🌐 Setting Language to: ${lang}`);
+  
+  try {
+    const { spawnSync } = require('child_process');
+    const result = spawnSync('python3', [cliScript, '--project-root', process.cwd(), 'memory', 'set-lang', '--value', lang], {
+      cwd: process.cwd(),
+      stdio: 'inherit',
+    });
+    
+    if (result.status !== 0) {
+      log.error('Failed to set language.');
+      process.exit(result.status || 1);
+    }
+  } catch (error) {
+    log.error(`Failed to set language: ${error.message}`);
+    process.exit(1);
+  }
+}
+
 // ============================================================================
 // AI Infrastructure Command
 // ============================================================================
@@ -1353,6 +1415,9 @@ switch (command) {
   case 'ai':
     aiCommand(args.slice(1), options);
     break;
+  case 'set-lang':
+    setLangCommand(args[1]);
+    break;
   case '--version':
   case '-v':
     showVersion();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@musashishao/agent-kit",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "AI Agent templates - Skills, Agents, Workflows, and AI-Ready Data Infrastructure Gateway",
   "main": "index.js",
   "bin": {