moai-adk 0.5.2__py3-none-any.whl → 0.5.6__py3-none-any.whl

moai_adk/__init__.py

@@ -9,6 +9,6 @@ from importlib.metadata import PackageNotFoundError, version
 try:
     __version__ = version("moai-adk")
 except PackageNotFoundError:
-    __version__ = "0.4.6-dev"
+    __version__ = "0.5.6-dev"
 
 __all__ = ["__version__"]

moai_adk/cli/commands/backup.py

@@ -1,4 +1,28 @@
-"""Backup command"""
+"""Backup command
+
+Create a backup of the current project including:
+- .claude/ (entire directory)
+- .moai/ (excluding specs and reports)
+- CLAUDE.md
+
+Backup location: .moai-backups/YYYYMMDD-HHMMSS/
+
+## Skill Invocation Guide (English-Only)
+
+### Related Skills
+- **moai-foundation-git**: For Git workflow and backup management
+  - Trigger: Before creating critical backups, review Git state
+  - Invocation: `Skill("moai-foundation-git")` for backup naming conventions
+
+### When to Invoke Skills in Related Workflows
+1. **Before backup creation**:
+   - Run `Skill("moai-foundation-git")` to document current Git branch state
+   - Tag backup with feature branch name for easier recovery
+
+2. **After restoration from backup**:
+   - Verify with `Skill("moai-foundation-tags")` that TAGs are intact
+   - Run `Skill("moai-foundation-trust")` to validate toolchain
+"""
 from pathlib import Path
 
 import click

moai_adk/cli/commands/doctor.py

@@ -8,6 +8,30 @@ System diagnostics command:
 - Validate project structure
 - Inspect language-specific tool chains
 - Diagnose slash command loading issues (--check-commands)
+
+## Skill Invocation Guide (English-Only)
+
+### Related Skills
+- **moai-foundation-langs**: For language toolchain verification and detection
+  - Trigger: Use `--verbose` or `--fix` flag to inspect language-specific tools
+  - Invocation: `Skill("moai-foundation-langs")` for detailed language stack analysis
+
+- **moai-foundation-trust**: For TRUST 5-principles verification after fixing tools
+  - Trigger: After running doctor with `--fix` to validate improvements
+  - Invocation: `Skill("moai-foundation-trust")` to verify code quality toolchain
+
+### When to Invoke Skills in Related Workflows
+1. **After doctor diagnosis**:
+   - Run `Skill("moai-foundation-trust")` to validate that all TRUST tools are properly configured
+   - Run `Skill("moai-foundation-langs")` to confirm language-specific toolchains
+
+2. **When tools are missing** (`--fix` flag):
+   - Use suggested fixes from doctor command
+   - Follow up with `Skill("moai-foundation-langs")` to validate corrections
+
+3. **Debugging slash command issues** (`--check-commands`):
+   - Run `Skill("moai-cc-commands")` if commands fail to load
+   - Check `.claude/commands/` directory structure and permissions
 """
 
 import json
@@ -168,11 +192,13 @@ def _suggest_fixes(tools: dict[str, bool], language: str | None) -> None:
 
 def _get_install_command(tool: str, language: str | None) -> str:
     """Return the install command for a given tool (helper)"""
-    # Common tools
+    # Common tools with preferred package managers
     install_commands = {
-        "pytest": "pip install pytest",
-        "mypy": "pip install mypy",
-        "ruff": "pip install ruff",
+        # Python tools (prefer uv)
+        "pytest": "uv pip install pytest",
+        "mypy": "uv pip install mypy",
+        "ruff": "uv pip install ruff",
+        # JavaScript tools
         "vitest": "npm install -D vitest",
         "biome": "npm install -D @biomejs/biome",
         "eslint": "npm install -D eslint",

moai_adk/cli/commands/init.py

@@ -6,6 +6,25 @@
 Project initialization command (interactive/non-interactive):
 - Interactive Mode: Ask user for project settings
 - Non-Interactive Mode: Use defaults or CLI options
+
+## Skill Invocation Guide (English-Only)
+
+### Related Skills
+- **moai-foundation-langs**: For language detection and stack configuration
+  - Trigger: When language parameter is not specified (auto-detection)
+  - Invocation: Called implicitly during project initialization for language matrix detection
+
+### When to Invoke Skills in Related Workflows
+1. **After project initialization**:
+   - Run `Skill("moai-foundation-trust")` to verify project structure and toolchain
+   - Run `Skill("moai-foundation-langs")` to validate detected language stack
+
+2. **Before first SPEC creation**:
+   - Use `Skill("moai-alfred-language-detection")` to confirm language selection
+
+3. **Project reinitialization** (`--force`):
+   - Skills automatically adapt to new project structure
+   - No manual intervention required
 """
 
 import json
@@ -163,10 +182,12 @@ def init(
                         config_data = json.load(f)
 
                     # Update version and optimization flags
+                    if "moai" not in config_data:
+                        config_data["moai"] = {}
+                    config_data["moai"]["version"] = __version__
+
                     if "project" not in config_data:
                         config_data["project"] = {}
-
-                    config_data["project"]["moai_adk_version"] = __version__
                     config_data["project"]["optimized"] = False
 
                     with open(config_path, "w", encoding="utf-8") as f:

moai_adk/cli/commands/status.py

@@ -5,6 +5,34 @@ Project status display:
 - Read project information from config.json
 - Show the number of SPEC documents
 - Summarize the Git status
+
+## Skill Invocation Guide (English-Only)
+
+### Related Skills
+- **moai-foundation-tags**: For detailed TAG inventory and orphan detection
+  - Trigger: When you need to verify TAG chain integrity beyond what status shows
+  - Invocation: `Skill("moai-foundation-tags")` to scan full project for orphan TAGs
+
+- **moai-foundation-trust**: For comprehensive TRUST 5-principles verification
+  - Trigger: After status shows SPECs exist, to validate code quality
+  - Invocation: `Skill("moai-foundation-trust")` to verify all quality gates
+
+- **moai-foundation-git**: For detailed Git workflow information
+  - Trigger: When Git status shows "Modified" and you need workflow guidance
+  - Invocation: `Skill("moai-foundation-git")` for GitFlow automation details
+
+### When to Invoke Skills in Related Workflows
+1. **Before starting new SPEC creation**:
+   - Run `Skill("moai-foundation-tags")` to verify no orphan TAGs exist from previous work
+   - Check the SPEC count from status command
+
+2. **After modifications to code/docs**:
+   - If status shows "Modified", run `Skill("moai-foundation-git")` for commit strategy
+   - Follow up with `Skill("moai-foundation-trust")` to validate code quality
+
+3. **Periodic health checks**:
+   - Run status command regularly
+   - When SPEC count grows, verify with `Skill("moai-foundation-tags")` and `Skill("moai-foundation-trust")`
 """
 
 import json
@@ -48,8 +76,10 @@ def status() -> None:
         table.add_column("Key", style="cyan")
         table.add_column("Value", style="bold")
 
-        table.add_row("Mode", config.get("mode", "unknown"))
-        table.add_row("Locale", config.get("locale", "unknown"))
+        # Read from project section (with legacy fallback)
+        project = config.get("project", {})
+        table.add_row("Mode", project.get("mode") or config.get("mode", "unknown"))
+        table.add_row("Locale", project.get("locale") or config.get("locale", "unknown"))
         table.add_row("SPECs", str(spec_count))
 
         # Optionally include Git information

moai_adk/cli/commands/update.py

@@ -1,4 +1,36 @@
-"""Update command"""
+"""Update command
+
+Update MoAI-ADK to the latest version available on PyPI.
+Includes:
+- Version checking from PyPI
+- Template and configuration updates
+- Backward compatibility validation
+
+## Skill Invocation Guide (English-Only)
+
+### Related Skills
+- **moai-foundation-trust**: For post-update validation
+  - Trigger: After updating MoAI-ADK version
+  - Invocation: `Skill("moai-foundation-trust")` to verify all toolchains still work
+
+- **moai-foundation-langs**: For language detection after update
+  - Trigger: After updating, confirm language stack is intact
+  - Invocation: `Skill("moai-foundation-langs")` to re-detect and validate language configuration
+
+### When to Invoke Skills in Related Workflows
+1. **After successful update**:
+   - Run `Skill("moai-foundation-trust")` to validate all TRUST 5 gates
+   - Run `Skill("moai-foundation-langs")` to confirm language toolchain still works
+   - Run project doctor command for full system validation
+
+2. **Before updating**:
+   - Create backup with `python -m moai_adk backup`
+   - Run `Skill("moai-foundation-tags")` to document current TAG state
+
+3. **If update fails**:
+   - Use backup to restore previous state
+   - Debug with `python -m moai_adk doctor --verbose`
+"""
 from __future__ import annotations
 
 import json
@@ -107,18 +139,18 @@ def _build_template_context(
 
     project_name = _coalesce(
         project_section.get("name"),
-        existing_config.get("projectName"),
+        existing_config.get("projectName"),  # Legacy fallback
         project_path.name,
     )
     project_mode = _coalesce(
         project_section.get("mode"),
-        existing_config.get("mode"),
+        existing_config.get("mode"),  # Legacy fallback
         default="personal",
     )
     project_description = _coalesce(
         project_section.get("description"),
-        existing_config.get("projectDescription"),
-        existing_config.get("description"),
+        existing_config.get("projectDescription"),  # Legacy fallback
+        existing_config.get("description"),  # Legacy fallback
     )
     project_version = _coalesce(
         project_section.get("version"),
@@ -164,7 +196,6 @@ def _preserve_project_metadata(
     project_data["mode"] = context["PROJECT_MODE"]
     project_data["description"] = context["PROJECT_DESCRIPTION"]
     project_data["created_at"] = context["CREATION_TIMESTAMP"]
-    project_data["moai_adk_version"] = version_for_config
 
     if "optimized" not in project_data and isinstance(existing_config, dict):
         existing_project = _extract_project_section(existing_config)
@@ -344,8 +375,16 @@ def update(path: str, force: bool, check: bool) -> None:
         console.print("\n[green]✓ Update complete![/green]")
         if latest_version and version.parse(current_version) < version.parse(latest_version):
             console.print(
-                "[yellow]⚠ Python package still on older version. "
-                "Run 'pip install --upgrade moai-adk' to upgrade the CLI package.[/yellow]"
+                "[yellow]⚠ Python package still on older version.[/yellow]"
+            )
+            console.print(
+                "[cyan]Upgrade options:[/cyan]"
+            )
+            console.print(
+                "  1. uv tool (recommended): uv tool upgrade moai-adk"
+            )
+            console.print(
+                "  2. pip (legacy):          pip install --upgrade moai-adk"
             )
         console.print("\n[cyan]ℹ️  Next step: Run /alfred:0-project update to optimize template changes[/cyan]")
 

moai_adk/core/project/initializer.py

@@ -120,17 +120,19 @@ class ProjectInitializer:
 
             # Phase 4: Configuration (generate config.json)
             config_data: dict[str, str | bool | dict] = {
-                "projectName": self.path.name,
-                "mode": mode,
-                "locale": locale,
-                "language": detected_language,
-                # Language detection metadata (will be updated by project-manager via /alfred:0-project)
-                "language_detection": {
-                    "detected_language": detected_language,
-                    "detection_method": "cli_default",  # Will be "context_aware" after /alfred:0-project
-                    "confidence": None,  # Will be calculated by project-manager
-                    "markers": [],  # Will be populated by project-manager
-                    "confirmed_by": None,  # Will be "user" after project-manager confirmation
+                "project": {
+                    "name": self.path.name,
+                    "mode": mode,
+                    "locale": locale,
+                    "language": detected_language,
+                    # Language detection metadata (will be updated by project-manager via /alfred:0-project)
+                    "language_detection": {
+                        "detected_language": detected_language,
+                        "detection_method": "cli_default",  # Will be "context_aware" after /alfred:0-project
+                        "confidence": None,  # Will be calculated by project-manager
+                        "markers": [],  # Will be populated by project-manager
+                        "confirmed_by": None,  # Will be "user" after project-manager confirmation
+                    }
                 }
             }
             config_files = self.executor.execute_configuration_phase(

moai_adk/core/project/phase_executor.py

@@ -15,6 +15,7 @@ import subprocess
 from collections.abc import Callable
 from datetime import datetime
 from pathlib import Path
+from typing import Any
 
 from rich.console import Console
 
@@ -148,7 +149,10 @@ class PhaseExecutor:
                 "PROJECT_DESCRIPTION": config.get("description", ""),
                 "PROJECT_MODE": config.get("mode", "personal"),
                 "PROJECT_VERSION": config.get("version", "0.1.0"),
+                "PROJECT_OWNER": config.get("author", "@user"),
                 "AUTHOR": config.get("author", "@user"),
+                "CONVERSATION_LANGUAGE": config.get("conversation_language", config.get("locale", "en")),
+                "CODEBASE_LANGUAGE": config.get("language", "generic"),
             }
             processor.set_context(context)
 
@@ -166,7 +170,7 @@ class PhaseExecutor:
     def execute_configuration_phase(
         self,
         project_path: Path,
-        config: dict[str, str | bool],
+        config: dict[str, str | bool | dict[Any, Any]],
         progress_callback: ProgressCallback | None = None,
     ) -> list[str]:
         """Phase 4: generate configuration.
@@ -184,9 +188,10 @@ class PhaseExecutor:
             "Phase 4: Generating configurations...", progress_callback
         )
 
-        # Attach version metadata (v0.3.1+)
-        config["moai_adk_version"] = __version__
-        config["optimized"] = False  # Default value
+        # Ensure project section exists and set defaults
+        if "project" not in config:
+            config["project"] = {}
+        config["project"]["optimized"] = False  # Default value
 
         # Write config.json
         config_path = project_path / ".moai" / "config.json"

moai_adk/core/template/processor.py

@@ -110,8 +110,59 @@ class TemplateProcessor:
         }
         return file_path.suffix.lower() in text_extensions
 
+    def _localize_yaml_description(self, content: str, language: str = "en") -> str:
+        """Localize multilingual YAML description field.
+
+        Converts multilingual description maps to single-language strings:
+        description:
+          en: "English text"
+          ko: "Korean text"
+        →
+        description: "Korean text"  (if language="ko")
+
+        Args:
+            content: File content.
+            language: Target language code (en, ko, ja, zh).
+
+        Returns:
+            Content with localized descriptions.
+        """
+        import yaml
+
+        # Pattern to match YAML frontmatter
+        frontmatter_pattern = r'^---\n(.*?)\n---'
+        match = re.match(frontmatter_pattern, content, re.DOTALL)
+
+        if not match:
+            return content
+
+        try:
+            yaml_content = match.group(1)
+            yaml_data = yaml.safe_load(yaml_content)
+
+            # Check if description is a dict (multilingual)
+            if isinstance(yaml_data.get('description'), dict):
+                # Select language (fallback to English)
+                descriptions = yaml_data['description']
+                selected_desc = descriptions.get(language, descriptions.get('en', ''))
+
+                # Replace description with selected language
+                yaml_data['description'] = selected_desc
+
+                # Reconstruct frontmatter
+                new_yaml = yaml.dump(yaml_data, allow_unicode=True, sort_keys=False)
+                # Preserve the rest of the content
+                rest_content = content[match.end():]
+                return f"---\n{new_yaml}---{rest_content}"
+
+        except Exception:
+            # If YAML parsing fails, return original content
+            pass
+
+        return content
+
     def _copy_file_with_substitution(self, src: Path, dst: Path) -> list[str]:
-        """Copy file with variable substitution for text files.
+        """Copy file with variable substitution and description localization for text files.
 
         Args:
             src: Source file path.
@@ -127,6 +178,14 @@ class TemplateProcessor:
             try:
                 content = src.read_text(encoding='utf-8')
                 content, file_warnings = self._substitute_variables(content)
+
+                # Apply description localization for command/output-style files
+                if src.suffix == '.md' and (
+                    'commands/alfred' in str(src) or 'output-styles/alfred' in str(src)
+                ):
+                    lang = self.context.get('CONVERSATION_LANGUAGE', 'en')
+                    content = self._localize_yaml_description(content, lang)
+
                 dst.write_text(content, encoding='utf-8')
                 warnings.extend(file_warnings)
             except UnicodeDecodeError:

moai_adk/templates/.claude/agents/alfred/cc-manager.md

@@ -32,6 +32,14 @@ model: sonnet
 
 ---
 
+## 🌍 Language Handling
+
+**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+
+Alfred translates Claude Code configuration requirements to English before invoking you. All configuration documentation and validations use English.
+
+---
+
 ## 🧰 Skill Activation
 
 **Automatic** (always load):

moai_adk/templates/.claude/agents/alfred/debug-helper.md

@@ -18,6 +18,24 @@ You are the integrated debugging expert responsible for **all errors**.
 **Role**: Troubleshooting expert who systematically analyzes code/Git/configuration errors and suggests solutions
 **Goal**: Runtime Providing accurate diagnosis and resolution of errors
 
+## 🌍 Language Handling
+
+**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+
+Alfred translates error reports and debugging requirements to English before invoking you. This ensures:
+- ✅ Perfect skill trigger matching (English Skill descriptions match English error analysis 100%)
+- ✅ Consistent error diagnosis across languages
+- ✅ Global multilingual support
+
+**Example**:
+- User says (any language): Translated to "Analyze test failure in authentication module"
+- You receive (English): "Diagnose test failure: 'AssertionError: token_expiry must be 30 minutes' in test_auth.py:127"
+- You analyze the error entirely in English
+- Your diagnostic report uses English technical terminology and stack traces
+- Alfred translates your findings back to user's language for response
+
+**Do not try to infer user's original language.** Always work in English, use English in diagnostic reports and technical analysis.
+
 ## 🧰 Required Skills
 
 **Automatic Core Skills**

moai_adk/templates/.claude/agents/alfred/doc-syncer.md

@@ -18,6 +18,24 @@ All Git tasks are handled by the git-manager agent, including managing PRs, comm
 **Role**: Documentation Expert who ensures perfect consistency between code and documentation according to the Living Document philosophy
 **Goals**: Real-time document-to-code synchronization and @TAG-based fully traceable document management
 
+## 🌍 Language Handling
+
+**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+
+Alfred translates document synchronization requirements to English before invoking you. This ensures:
+- ✅ Perfect skill trigger matching (English Skill descriptions match English sync requirements 100%)
+- ✅ Consistent document handling across languages
+- ✅ Global multilingual support
+
+**Example**:
+- User says (any language): Translated to "Synchronize documents based on recent code changes"
+- You receive (English): "Update documentation for SPEC-AUTH-001 changes: JWT token implementation, 30-minute expiry"
+- You analyze TAG chains and create documentation entirely in English
+- Generated documentation uses English descriptions and API references
+- Alfred translates your sync reports back to user's language for response
+
+**Do not try to infer user's original language.** Always work in English, use English in all documentation and report generation.
+
 ## 🧰 Required Skills
 
 **Automatic Core Skills**

moai_adk/templates/.claude/agents/alfred/git-manager.md

@@ -16,8 +16,25 @@ This is a dedicated agent that optimizes and processes all Git operations in MoA
 **Job**: Release Engineer
 **Specialization**: Git workflow and version control expert
 **Role**: Release expert responsible for automating branch management, checkpoints, and deployments according to the GitFlow strategy
-**Goals**: Implement perfect version management and safe distribution with optimized Git strategy for each Personal/Team mode 
-**Multilingual support**: Commit messages are automatically generated in the corresponding language according to the `locale` setting in `.moai/config.json` (ko, en, ja, zh)
+**Goals**: Implement perfect version management and safe distribution with optimized Git strategy for each Personal/Team mode
+
+## 🌍 Language Handling
+
+**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+
+Alfred translates Git requirements to English before invoking you. Your commit messages MUST be in **English** only:
+- ✅ All commit messages must be in English
+- ✅ Branch names must follow English conventions
+- ✅ PR titles and descriptions must be in English
+- ✅ Do NOT create commit messages in user's conversation language
+
+**Example**:
+- User says (any language): Translated to "Create commit for authentication implementation"
+- You receive (English): "Create commit for JWT authentication with 30-minute token expiry - TAG: AUTH-001"
+- You create commit: `feat(auth): Implement JWT authentication with 30-minute expiry - Refs: @AUTH-001`
+- Alfred translates the commit summary back to user's language for notification
+
+This ensures git history is always in English for global team compatibility.
 
 ## 🧰 Required Skills
 
@@ -336,4 +353,23 @@ Git-manager automatically handles the following exception situations:
 
 ---
 
+## 🤖 Git Commit Message Signature
+
+**All commits created by git-manager follow this signature format**:
+
+```
+🤖 Generated with [Claude Code](https://claude.com/claude-code)
+
+Co-Authored-By: 🎩 Alfred@[MoAI](https://adk.mo.ai.kr)
+```
+
+This signature applies to all Git operations:
+- TDD phase commits (RED, GREEN, REFACTOR)
+- Release commits
+- Hotfix commits
+- Merge commits
+- Tag creation
+
+---
+
 **git-manager provides a simple and stable work environment with direct Git commands instead of complex scripts.**

moai_adk/templates/.claude/agents/alfred/implementation-planner.md

@@ -18,6 +18,24 @@ You are an expert in analyzing SPECs to determine the optimal implementation str
 **Role**: Strategist who translates SPECs into actual implementation plans
 **Goal**: Clear and Provides an actionable implementation plan
 
+## 🌍 Language Handling
+
+**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+
+Alfred translates SPEC requirements to English before invoking you via `Task()`. This ensures:
+- ✅ Perfect skill trigger matching (English Skill descriptions match English analysis 100%)
+- ✅ Consistent architecture planning across languages
+- ✅ Global multilingual support
+
+**Example**:
+- User says (any language): Translated to "Analyze user authentication SPEC and create implementation plan"
+- You receive (English): "Review SPEC-AUTH-001 (JWT authentication) and create implementation strategy with library selections"
+- You analyze entirely in English
+- Your implementation plan uses English library names, technical terms, and documentation
+- Alfred translates your plan back to user's language for response
+
+**Do not try to infer user's original language.** Always work in English, use English in all technical documentation and planning documents.
+
 ## 🧰 Required Skills
 
 **Automatic Core Skills**

moai_adk/templates/.claude/agents/alfred/project-manager.md

@@ -18,6 +18,12 @@ You are a Senior Project Manager Agent managing successful projects.
 **Role**: Project manager responsible for project initial setup, document construction, team composition, and strategic direction
 **Goal**: Through systematic interviews Build complete project documentation (product/structure/tech) and set up Personal/Team mode
 
+## 🌍 Language Handling
+
+**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+
+Alfred translates project setup requirements to English before invoking you.
+
 ## 🧰 Required Skills
 
 **Automatic Core Skills**

moai_adk/templates/.claude/agents/alfred/quality-gate.md

@@ -18,6 +18,12 @@ You are a quality gate that automatically verifies TRUST principles and project
 **Role**: Automatically verify that all code passes quality standards
 **Goal**: Ensure that only high quality code is committed
 
+## 🌍 Language Handling
+
+**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+
+Alfred translates quality gate requirements to English before invoking you. Your verification reports use English.
+
 ## 🧰 Required Skills
 
 **Automatic Core Skills**

moai_adk/templates/.claude/agents/alfred/skill-factory.md

@@ -13,6 +13,14 @@ model: sonnet
 
 ---
 
+## 🌍 Language Handling
+
+**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+
+Alfred translates Skill creation requirements to English before invoking you. All generated Skills are in **English** with English descriptions, examples, and documentation.
+
+---
+
 ## ▶◀ Agent Overview
 
 The **skill-factory** sub-agent is an intelligent Skill creation orchestrator that combines **user interaction**, **web research**, and **best practices aggregation** to produce high-quality, always-current Skill packages.

moai_adk/templates/.claude/agents/alfred/spec-builder.md

@@ -20,6 +20,23 @@ You are a SPEC expert agent responsible for SPEC document creation and intellige
 **Role**: Chief Architect who translates business requirements into EARS specifications and architecture designs
 **Goal**: Produce complete SPEC documents. Provides clear development direction and system design blueprint through
 
+## 🌍 Language Handling
+
+**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+
+Alfred translates user requests to English before invoking you via `Task()`. This ensures:
+- ✅ Perfect skill trigger matching (English descriptions match English requests 100%)
+- ✅ Consistent internal communication
+- ✅ Global multilingual support (Korean, Japanese, Chinese, Spanish, etc.)
+
+**Example**:
+- User says (any language): Translated to "Create SPEC for user authentication with JWT token strategy"
+- You receive (English): "Create SPEC for user authentication with JWT tokens and email/password login"
+- You work entirely in English
+- Alfred translates your results back to user's language for response
+
+**Do not try to infer user's original language from your prompt.** Always work in English.
+
 ## 🧰 Required Skills
 
 **Automatic Core Skills**

moai_adk/templates/.claude/agents/alfred/tag-agent.md

@@ -18,13 +18,19 @@ You are a professional agent responsible for all TAG operations in MoAI-ADK.
 **Role**: Traceability expert who exclusively manages the TAG system based on code scans according to the CODE-FIRST principle
 **Goal**: Real-time TAG chain integrity guaranteed and 4-Core TAG system fully verified
 
+## 🌍 Language Handling
+
+**IMPORTANT**: You will ALWAYS receive prompts in **English**, regardless of user's original conversation language.
+
+Alfred translates TAG verification requests to English before invoking you. Your TAG reports and chains use English.
+
 ## 🧰 Required Skills
 
 **Automatic Core Skills**
 - `Skill("moai-alfred-tag-scanning")` – CODE-FIRST Performs a full scan to obtain the latest TAG inventory.
+- `Skill("moai-foundation-tags")` – TAG inventory management and orphan detection (CODE-FIRST principle). **CRITICAL for all TAG verification requests.**
 
 **Conditional Skill Logic**
-- `Skill("moai-foundation-tags")`: Called when reordering the TAG naming convention or updating the matrix.
 - `Skill("moai-alfred-trust-validation")`: Used only to check whether the TAG chain meets TRUST-Traceable criteria.
 - `Skill("moai-foundation-specs")`: Loaded when the SPEC document and TAG connection status need to be verified.
 - `Skill("moai-alfred-interactive-questions")`: Executed when TAG conflict/deletion must be confirmed with user approval.