moai-adk 0.4.1__py3-none-any.whl → 0.4.5__py3-none-any.whl

moai_adk/__init__.py

@@ -4,5 +4,11 @@
 SPEC-First TDD Framework with Alfred SuperAgent
 """
 
-__version__ = "0.4.0"
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("moai-adk")
+except PackageNotFoundError:
+    __version__ = "0.4.1-dev"
+
 __all__ = ["__version__"]

moai_adk/cli/commands/update.py

@@ -315,7 +315,7 @@ def update(path: str, force: bool, check: bool) -> None:
             console.print("\n[cyan]💾 Creating backup...[/cyan]")
             processor = TemplateProcessor(project_path)
             backup_path = processor.create_backup()
-            console.print(f"[green]✓ Backup completed: {backup_path.relative_to(project_path)}[/green]")
+            console.print(f"[green]✓ Backup completed: {backup_path.relative_to(project_path)}/[/green]")
         else:
             console.print("\n[yellow]⚠ Skipping backup (--force)[/yellow]")
 

moai_adk/cli/prompts/init_prompts.py

@@ -93,11 +93,11 @@ def prompt_project_setup(
         answers["locale"] = initial_locale or "en"
         if initial_locale:
             console.print(
-                f"[cyan]🌐 Preferred Language:[/cyan] {answers['locale']} (CLI 옵션으로 지정됨)"
+                f"[cyan]🌐 Preferred Language:[/cyan] {answers['locale']} (specified via CLI option)"
             )
         else:
             console.print(
-                "[cyan]🌐 Preferred Language:[/cyan] en (기본값, /alfred:0-project에서 변경 가능)"
+                "[cyan]🌐 Preferred Language:[/cyan] en (default, changeable in /alfred:0-project)"
             )
 
         # 3. Programming language (auto-detect or manual)

moai_adk/core/project/backup_utils.py

@@ -3,10 +3,9 @@
 
 Selective backup strategy:
 - Back up only the required files (OR condition)
-- Backup path: .moai-backups/{timestamp}/ (v0.3.0)
+- Backup path: .moai-backups/backup/ (v0.4.2)
 """
 
-from datetime import datetime
 from pathlib import Path
 
 # Backup targets (OR condition - back up when any exist)
@@ -59,15 +58,6 @@ def get_backup_targets(project_path: Path) -> list[str]:
     return targets
 
 
-def generate_backup_dir_name() -> str:
-    """Generate a timestamp-based backup directory name (v0.3.0).
-
-    Returns:
-        Timestamp formatted as YYYYMMDD-HHMMSS.
-        Note: callers use .moai-backups/{timestamp}/ format.
-    """
-    timestamp = datetime.now().strftime("%Y%m%d-%H%M%S")
-    return timestamp
 
 
 def is_protected_path(rel_path: Path) -> bool:

moai_adk/core/project/checker.py

@@ -298,5 +298,5 @@ def get_permission_fix_message(path: str) -> str:
         Platform-specific fix instructions.
     """
     if platform.system() == "Windows":
-        return f"관리자 권한으로 실행하거나 '{path}' 디렉토리 속성에서 권한을 확인하세요"
-    return f"chmod 755 {path} 실행 후 재시도하세요"
+        return f"Run with administrator privileges or verify permissions in the properties of the '{path}' directory"
+    return f"Run 'chmod 755 {path}' and try again"

moai_adk/core/project/phase_executor.py

@@ -1,8 +1,8 @@
 # @CODE:INIT-003:PHASE | SPEC: .moai/specs/SPEC-INIT-003/spec.md | TEST: tests/unit/test_init_reinit.py
-"""Phase-based installation executor (SPEC-INIT-003 v0.3.0)
+"""Phase-based installation executor (SPEC-INIT-003 v0.4.2)
 
 Runs the project initialization across five phases:
-- Phase 1: Preparation (create backup at .moai-backups/{timestamp}/, keep only latest)
+- Phase 1: Preparation (create single backup at .moai-backups/backup/)
 - Phase 2: Directory (build directory structure)
 - Phase 3: Resource (copy templates while preserving user content)
 - Phase 4: Configuration (generate configuration files)
@@ -20,7 +20,6 @@ from rich.console import Console
 
 from moai_adk import __version__
 from moai_adk.core.project.backup_utils import (
-    generate_backup_dir_name,
     get_backup_targets,
     has_any_moai_files,
     is_protected_path,
@@ -229,25 +228,21 @@ class PhaseExecutor:
             self._initialize_git(project_path)
 
     def _create_backup(self, project_path: Path) -> None:
-        """Create a selective backup (v0.3.0).
+        """Create a single backup (v0.4.2).
 
-        Keep only the latest backup in .moai-backups/{timestamp}/.
+        Maintains only one backup at .moai-backups/backup/.
 
         Args:
             project_path: Project path.
         """
         # Define backup directory
         backups_dir = project_path / ".moai-backups"
+        backup_path = backups_dir / "backup"
 
-        # Remove all existing backups (keep only latest)
-        if backups_dir.exists():
-            for item in backups_dir.iterdir():
-                if item.is_dir():
-                    shutil.rmtree(item)
+        # Remove existing backup if present
+        if backup_path.exists():
+            shutil.rmtree(backup_path)
 
-        # Create new backup directory (.moai-backups/{timestamp}/)
-        timestamp = generate_backup_dir_name()
-        backup_path = backups_dir / timestamp
         backup_path.mkdir(parents=True, exist_ok=True)
 
         # Collect backup targets

moai_adk/core/quality/__init__.py

@@ -1,5 +1,5 @@
 # @CODE:TRUST-001 | SPEC: SPEC-TRUST-001/spec.md | TEST: tests/unit/core/quality/
-"""TRUST 원칙 자동 검증 시스템"""
+"""TRUST principle automated validation system"""
 
 from moai_adk.core.quality.trust_checker import TrustChecker
 

moai_adk/core/quality/trust_checker.py

@@ -1,13 +1,13 @@
 # @CODE:TRUST-001 | SPEC: SPEC-TRUST-001/spec.md | TEST: tests/unit/core/quality/test_trust_checker.py
 """
-TRUST 원칙 통합 검증 시스템
-
-TRUST 5원칙:
-- T: Test First (테스트 커버리지 ≥85%)
-- R: Readable (파일 ≤300 LOC, 함수 ≤50 LOC, 매개변수 ≤5개)
-- U: Unified (타입 안전성)
-- S: Secured (보안 취약점 스캔)
-- T: Trackable (TAG 체인 무결성)
+Integrated TRUST principle validation system
+
+TRUST 5 principles:
+- T: Test First (test coverage ≥85%)
+- R: Readable (file ≤300 LOC, function ≤50 LOC, parameters ≤5)
+- U: Unified (type safety)
+- S: Secured (vulnerability scanning)
+- T: Trackable (TAG chain integrity)
 """
 
 import ast
@@ -18,7 +18,7 @@ from typing import Any
 from moai_adk.core.quality.validators.base_validator import ValidationResult
 
 # ========================================
-# 상수 정의 (의도를 드러내는 이름)
+# Constants (descriptive names)
 # ========================================
 MIN_TEST_COVERAGE_PERCENT = 85
 MAX_FILE_LINES_OF_CODE = 300
@@ -26,20 +26,20 @@ MAX_FUNCTION_LINES_OF_CODE = 50
 MAX_FUNCTION_PARAMETERS = 5
 MAX_CYCLOMATIC_COMPLEXITY = 10
 
-# 파일 인코딩
+# File encoding
 DEFAULT_FILE_ENCODING = "utf-8"
 
-# TAG 접두사
+# TAG prefixes
 TAG_PREFIX_SPEC = "@SPEC:"
 TAG_PREFIX_CODE = "@CODE:"
 TAG_PREFIX_TEST = "@TEST:"
 
 
 class TrustChecker:
-    """TRUST 원칙 통합 검증기"""
+    """Integrated TRUST principle validator"""
 
     def __init__(self):
-        """TrustChecker 초기화"""
+        """Initialize TrustChecker"""
         self.results: dict[str, ValidationResult] = {}
 
     # ========================================
@@ -48,14 +48,14 @@ class TrustChecker:
 
     def validate_coverage(self, project_path: Path, coverage_data: dict[str, Any]) -> ValidationResult:
         """
-        테스트 커버리지 검증 (≥85%)
+        Validate test coverage (≥85%)
 
         Args:
-            project_path: 프로젝트 경로
-            coverage_data: 커버리지 데이터 (total_coverage, low_coverage_files)
+            project_path: Project path
+            coverage_data: Coverage data (total_coverage, low_coverage_files)
 
         Returns:
-            ValidationResult: 검증 결과
+            ValidationResult: Validation result
         """
         total_coverage = coverage_data.get("total_coverage", 0)
 
@@ -64,7 +64,7 @@ class TrustChecker:
                 passed=True, message=f"Test coverage: {total_coverage}% (Target: {MIN_TEST_COVERAGE_PERCENT}%)"
             )
 
-        # 실패 시 상세 정보 생성
+        # Generate detailed information on failure
         low_files = coverage_data.get("low_coverage_files", [])
         details = f"Current coverage: {total_coverage}% (Target: {MIN_TEST_COVERAGE_PERCENT}%)\n"
         details += "Low coverage files:\n"
@@ -84,15 +84,15 @@ class TrustChecker:
 
     def validate_file_size(self, src_path: Path) -> ValidationResult:
         """
-        파일 크기 검증 (≤300 LOC)
+        Validate file size (≤300 LOC)
 
         Args:
-            src_path: 소스 코드 디렉토리 경로
+            src_path: Source code directory path
 
         Returns:
-            ValidationResult: 검증 결과
+            ValidationResult: Validation result
         """
-        # 입력 검증 (보안 강화)
+        # Input validation (security)
         if not src_path.exists():
             return ValidationResult(passed=False, message=f"Source path does not exist: {src_path}", details="")
 
@@ -102,7 +102,7 @@ class TrustChecker:
         violations = []
 
         for py_file in src_path.rglob("*.py"):
-            # 가드절 적용 (가독성 향상)
+            # Apply guard clause (improves readability)
             if py_file.name.startswith("test_"):
                 continue
 
@@ -113,7 +113,7 @@ class TrustChecker:
                 if loc > MAX_FILE_LINES_OF_CODE:
                     violations.append(f"{py_file.name}: {loc} LOC (Limit: {MAX_FILE_LINES_OF_CODE})")
             except (UnicodeDecodeError, PermissionError):
-                # 보안: 파일 접근 오류 처리
+                # Security: handle file access errors
                 continue
 
         if not violations:
@@ -126,13 +126,13 @@ class TrustChecker:
 
     def validate_function_size(self, src_path: Path) -> ValidationResult:
         """
-        함수 크기 검증 (≤50 LOC)
+        Validate function size (≤50 LOC)
 
         Args:
-            src_path: 소스 코드 디렉토리 경로
+            src_path: Source code directory path
 
         Returns:
-            ValidationResult: 검증 결과
+            ValidationResult: Validation result
         """
         violations = []
 
@@ -147,11 +147,11 @@ class TrustChecker:
 
                 for node in ast.walk(tree):
                     if isinstance(node, ast.FunctionDef):
-                        # AST 라인 번호는 1-based
+                        # AST line numbers are 1-based
                         start_line = node.lineno
                         end_line = node.end_lineno if node.end_lineno else start_line  # type: ignore
 
-                        # 실제 함수 라인 수 계산 (데코레이터 제외)
+                        # Compute actual function lines of code (decorators excluded)
                         func_lines = lines[start_line - 1:end_line]
                         func_loc = len(func_lines)
 
@@ -172,13 +172,13 @@ class TrustChecker:
 
     def validate_param_count(self, src_path: Path) -> ValidationResult:
         """
-        매개변수 개수 검증 (≤5개)
+        Validate parameter count (≤5)
 
         Args:
-            src_path: 소스 코드 디렉토리 경로
+            src_path: Source code directory path
 
         Returns:
-            ValidationResult: 검증 결과
+            ValidationResult: Validation result
         """
         violations = []
 
@@ -211,13 +211,13 @@ class TrustChecker:
 
     def validate_complexity(self, src_path: Path) -> ValidationResult:
         """
-        순환 복잡도 검증 (≤10)
+        Validate cyclomatic complexity (≤10)
 
         Args:
-            src_path: 소스 코드 디렉토리 경로
+            src_path: Source code directory path
 
         Returns:
-            ValidationResult: 검증 결과
+            ValidationResult: Validation result
         """
         violations = []
 
@@ -250,23 +250,23 @@ class TrustChecker:
 
     def _calculate_complexity(self, node: ast.FunctionDef) -> int:
         """
-        순환 복잡도 계산 (McCabe complexity)
+        Calculate cyclomatic complexity (McCabe complexity)
 
         Args:
-            node: 함수 AST 노드
+            node: Function AST node
 
         Returns:
-            int: 순환 복잡도
+            int: Cyclomatic complexity
         """
         complexity = 1
         for child in ast.walk(node):
-            # 분기문마다 +1
+            # Add 1 for each branching statement
             if isinstance(child, (ast.If, ast.While, ast.For, ast.ExceptHandler, ast.With)):
                 complexity += 1
-            # and/or 연산자마다 +1
+            # Add 1 for each and/or operator
             elif isinstance(child, ast.BoolOp):
                 complexity += len(child.values) - 1
-            # elif는 이미 ast.If로 카운트되므로 별도 처리 불필요
+            # elif is already counted as ast.If, no extra handling needed
         return complexity
 
     # ========================================
@@ -275,22 +275,22 @@ class TrustChecker:
 
     def validate_tag_chain(self, project_path: Path) -> ValidationResult:
         """
-        TAG 체인 완전성 검증
+        Validate TAG chain completeness
 
         Args:
-            project_path: 프로젝트 경로
+            project_path: Project path
 
         Returns:
-            ValidationResult: 검증 결과
+            ValidationResult: Validation result
         """
         specs_dir = project_path / ".moai" / "specs"
         src_dir = project_path / "src"
 
-        # TAG 스캔
+        # Scan for TAGs
         spec_tags = self._scan_tags(specs_dir, "@SPEC:")
         code_tags = self._scan_tags(src_dir, "@CODE:")
 
-        # 체인 검증
+        # Validate the chain
         broken_chains = []
         for code_tag in code_tags:
             tag_id = code_tag.split(":")[-1]
@@ -307,13 +307,13 @@ class TrustChecker:
 
     def detect_orphan_tags(self, project_path: Path) -> list[str]:
         """
-        고아 TAG 탐지
+        Detect orphan TAGs
 
         Args:
-            project_path: 프로젝트 경로
+            project_path: Project path
 
         Returns:
-            list[str]: 고아 TAG 목록
+            list[str]: List of orphan TAGs
         """
         specs_dir = project_path / ".moai" / "specs"
         src_dir = project_path / "src"
@@ -331,14 +331,14 @@ class TrustChecker:
 
     def _scan_tags(self, directory: Path, tag_prefix: str) -> list[str]:
         """
-        디렉토리에서 TAG 스캔
+        Scan for TAGs in a directory
 
         Args:
-            directory: 스캔할 디렉토리
-            tag_prefix: TAG 접두사 (예: "@SPEC:", "@CODE:")
+            directory: Directory to scan
+            tag_prefix: TAG prefix (for example, "@SPEC:", "@CODE:")
 
         Returns:
-            list[str]: 발견된 TAG 목록
+            list[str]: List of discovered TAGs
         """
         if not directory.exists():
             return []
@@ -362,25 +362,25 @@ class TrustChecker:
 
     def generate_report(self, results: dict[str, Any], format: str = "markdown") -> str:
         """
-        검증 결과 보고서 생성
+        Generate validation report
 
         Args:
-            results: 검증 결과 딕셔너리
-            format: 보고서 형식 ("markdown" 또는 "json")
+            results: Validation result dictionary
+            format: Report format ("markdown" or "json")
 
         Returns:
-            str: 보고서 문자열
+            str: Report string
         """
         if format == "json":
             return json.dumps(results, indent=2)
 
-        # Markdown 형식
+        # Markdown format
         report = "# TRUST Validation Report\n\n"
 
         for category, result in results.items():
             status = "✅ PASS" if result.get("passed", False) else "❌ FAIL"
             value = result.get('value', 'N/A')
-            # 숫자인 경우 % 기호 추가
+            # Add % suffix when the value is numeric
             if isinstance(value, (int, float)):
                 value_str = f"{value}%"
             else:
@@ -398,13 +398,13 @@ class TrustChecker:
 
     def select_tools(self, project_path: Path) -> dict[str, str]:
         """
-        언어별 도구 자동 선택
+        Automatically select tools by language
 
         Args:
-            project_path: 프로젝트 경로
+            project_path: Project path
 
         Returns:
-            dict[str, str]: 선택된 도구 딕셔너리
+            dict[str, str]: Selected tool dictionary
         """
         config_path = project_path / ".moai" / "config.json"
         if not config_path.exists():
@@ -432,7 +432,7 @@ class TrustChecker:
                 "type_checker": "tsc",
             }
 
-        # 기본값 (Python)
+        # Default (Python)
         return {
             "test_framework": "pytest",
             "coverage_tool": "coverage.py",

moai_adk/core/quality/validators/__init__.py

@@ -1,5 +1,5 @@
 # @CODE:TRUST-001 | SPEC: SPEC-TRUST-001/spec.md
-"""TRUST 검증기 패키지"""
+"""TRUST validator package"""
 
 from moai_adk.core.quality.validators.base_validator import ValidationResult
 

moai_adk/core/quality/validators/base_validator.py

@@ -7,7 +7,7 @@ from typing import Any
 
 @dataclass
 class ValidationResult:
-    """검증 결과 데이터 클래스"""
+    """Validation result data class"""
 
     passed: bool
     message: str

moai_adk/core/template/backup.py

@@ -7,7 +7,6 @@ Creates and manages backups to protect user data during template updates.
 from __future__ import annotations
 
 import shutil
-from datetime import datetime
 from pathlib import Path
 
 
@@ -49,13 +48,19 @@ class TemplateBackup:
         )
 
     def create_backup(self) -> Path:
-        """Create a timestamped backup.
+        """Create a single backup (always at .moai-backups/backup/).
+
+        Existing backups are overwritten to maintain only one backup copy.
 
         Returns:
-            Backup path (for example, .moai-backups/20250110-143025/).
+            Backup path (always .moai-backups/backup/).
         """
-        timestamp = datetime.now().strftime("%Y%m%d-%H%M%S")
-        backup_path = self.target_path / ".moai-backups" / timestamp
+        backup_path = self.target_path / ".moai-backups" / "backup"
+
+        # Remove existing backup if present
+        if backup_path.exists():
+            shutil.rmtree(backup_path)
+
         backup_path.mkdir(parents=True, exist_ok=True)
 
         # Copy backup targets

moai_adk/core/template/merger.py

@@ -15,10 +15,7 @@ from typing import Any
 class TemplateMerger:
     """Encapsulate template merging logic."""
 
-    PROJECT_INFO_HEADERS = (
-        "## 프로젝트 정보",
-        "## Project Information",
-    )
+    PROJECT_INFO_HEADERS = ("## Project Information", "## 프로젝트 정보")
 
     def __init__(self, target_path: Path) -> None:
         """Initialize the merger.
@@ -33,7 +30,7 @@ class TemplateMerger:
 
         Rules:
         - Use the latest template structure/content.
-        - Preserve the existing "## 프로젝트 정보" section.
+        - Preserve the existing "## Project Information" section.
 
         Args:
             template_path: Template CLAUDE.md.

moai_adk/core/template/processor.py

@@ -376,7 +376,7 @@ class TemplateProcessor:
             console.print("   ✅ .github/ copy complete (variables substituted)")
 
     def _copy_claude_md(self, silent: bool = False) -> None:
-        """Copy CLAUDE.md with smart merge (preserves \"## 프로젝트 정보\" section)."""
+        """Copy CLAUDE.md with smart merge (preserves \"## Project Information\" section)."""
         src = self.template_root / "CLAUDE.md"
         dst = self.target_path / "CLAUDE.md"
 
@@ -385,11 +385,11 @@ class TemplateProcessor:
                 console.print("⚠️ CLAUDE.md template not found")
             return
 
-        # Smart merge: preserve existing "## 프로젝트 정보" section
+        # Smart merge: preserve existing "## Project Information" section
         if dst.exists():
             self._merge_claude_md(src, dst)
             if not silent:
-                console.print("   🔄 CLAUDE.md merged (프로젝트 정보 preserved)")
+                console.print("   🔄 CLAUDE.md merged (project information preserved)")
         else:
             # First time: just copy
             self._copy_file_with_substitution(src, dst)

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

@@ -24,7 +24,8 @@ model: sonnet
 - `Skill("moai-foundation-specs")` – Always checks the command/agent document structure.
 
 **Conditional Skill Logic**
-- `Skill("moai-alfred-tag-scanning")`: Called when a diff or `agent_skill_plan` contains a TAG influence.If the result is “Rules need to be updated”, we subsequently chain `Skill("moai-foundation-tags")`.
+- `Skill("moai-alfred-language-detection")`: Always called first to detect project language/framework, which gates the activation of language-specific skills.
+- `Skill("moai-alfred-tag-scanning")`: Called when a diff or `agent_skill_plan` contains a TAG influence.If the result is "Rules need to be updated", we subsequently chain `Skill("moai-foundation-tags")`.
 - `Skill("moai-foundation-tags")`: Executed only when TAG naming reordering or traceability matrix update is confirmed.
 - `Skill("moai-foundation-trust")`: Rechecks the latest guide when a TRUST policy/version update is detected or requested.
 - `Skill("moai-alfred-trust-validation")`: Called when it is necessary to actually verify whether there is a standard violation based on the quality gate.
@@ -32,7 +33,9 @@ model: sonnet
 - `Skill("moai-alfred-spec-metadata-validation")`: Only the relevant file is verified when a new command/agent document is created or the meta field is modified.
 - Domain skills: When the brief includes CLI/Data Science/Database/DevOps/ML/Mobile/Security needs, add the corresponding item among `Skill("moai-domain-cli-tool")`, `Skill("moai-domain-data-science")`, `Skill("moai-domain-database")`, `Skill("moai-domain-devops")`, `Skill("moai-domain-ml")`, `Skill("moai-domain-mobile-app")`, `Skill("moai-domain-security")`.  
 - `Skill("moai-alfred-refactoring-coach")`: Called when the brief includes refactoring/TODO cleanup and a technical debt remediation plan is needed.
-- Language skills: Based on the result of `Skill("moai-alfred-language-detection")`, activate the relevant one(s) among `Skill("moai-lang-python")`, `Skill("moai-lang-typescript")`, `Skill("moai-lang-javascript")`, `Skill("moai-lang-java")`, `Skill("moai-lang-go")`, `Skill("moai-lang-rust")`, `Skill("moai-lang-csharp")`, `Skill("moai-lang-cpp")`, `Skill("moai-lang-c")`, `Skill("moai-lang-clojure")`, `Skill("moai-lang-dart")`, `Skill("moai-lang-elixir")`, `Skill("moai-lang-haskell")`, `Skill("moai-lang-julia")`, `Skill("moai-lang-kotlin")`, `Skill("moai-lang-lua")`, `Skill("moai-lang-php")`, `Skill("moai-lang-r")`, `Skill("moai-lang-ruby")`, `Skill("moai-lang-scala")`, `Skill("moai-lang-shell")`, `Skill("moai-lang-sql")`, `Skill("moai-lang-swift")`.  
+- **Language skills** (23 available): Based on the result of `Skill("moai-alfred-language-detection")`, activate the relevant language skill(s) from the Language Tier:
+  - Supported: Python, TypeScript, JavaScript, Java, Go, Rust, C#, C++, C, Clojure, Dart, Elixir, Haskell, Julia, Kotlin, Lua, PHP, R, Ruby, Scala, Shell, SQL, Swift
+  - Called as: `Skill("moai-lang-{language-name}")` (e.g., `Skill("moai-lang-python")`)
 - `Skill("moai-claude-code")`: Used to customize the Claude Code output format or reorganize the code example template.
 - `Skill("moai-alfred-tui-survey")`: Provides an interactive survey when changes to operating policies or introduction of standards need to be confirmed with user approval.
 

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

@@ -40,30 +40,38 @@ You are a Senior Project Manager Agent managing successful projects.
 
 ## 🎯 Key Role
 
-**✅ project-manager is called from the `/alfred:8-project` command**
+**✅ project-manager is called from the `/alfred:0-project` command**
 
-- When `/alfred:8-project` is executed, it is called as `Task: project-manager` to perform project analysis
+- When `/alfred:0-project` is executed, it is called as `Task: project-manager` to perform project analysis
+- Receives **conversation_language** parameter from Alfred (e.g., "ko", "en", "ja", "zh") as first input
 - Directly responsible for project type detection (new/legacy) and document creation
-- Product/structure/tech documents interactively Writing
-- Putting into practice the method and structure of project document creation
+- Product/structure/tech documents written interactively **in the selected language**
+- Putting into practice the method and structure of project document creation with language localization
 
 ## 🔄 Workflow
 
 **What the project-manager actually does:**
 
+0. **Conversation Language Setup** (NEW):
+   - Receive `conversation_language` parameter from Alfred (e.g., "ko" for Korean, "en" for English)
+   - Confirm and announce the selected language in all subsequent interactions
+   - Store language preference in context for all generated documents and responses
+   - All prompts, questions, and outputs from this point forward are in the selected language
 1. **Project status analysis**: `.moai/project/*.md`, README, read source structure
 2. **Determination of project type**: Decision to introduce new (greenfield) vs. legacy
-3. **User Interview**: Gather information with a question tree tailored to the project type
-4. **Create Document**: Create or update product/structure/tech.md
+3. **User Interview**: Gather information with a question tree tailored to the project type (questions delivered in selected language)
+4. **Create Document**: Create or update product/structure/tech.md (all documents generated in the selected language)
 5. **Prevention of duplication**: Prohibit creation of `.claude/memory/` or `.claude/commands/alfred/*.json` files
-6. **Memory Synchronization**: Leverage CLAUDE.md's existing `@.moai/project/*` import.
+6. **Memory Synchronization**: Leverage CLAUDE.md's existing `@.moai/project/*` import and add language metadata.
 
 ## 📦 Deliverables and Delivery
 
-- Updated `.moai/project/{product,structure,tech}.md`
-- Project overview summary (team size, technology stack, constraints)
+- Updated `.moai/project/{product,structure,tech}.md` (in the selected language)
+- Updated `.moai/config.json` with language metadata (conversation_language, language_name)
+- Project overview summary (team size, technology stack, constraints) in selected language
 - Individual/team mode settings confirmation results
 - For legacy projects, organized with "Legacy Context" TODO/DEBT items
+- Language preference confirmation in final summary
 
 ## ✅ Operational checkpoints