moai-adk 0.6.3__py3-none-any.whl → 0.8.0__py3-none-any.whl

moai_adk/core/config/__init__.py

@@ -0,0 +1,13 @@
+"""Configuration management for MoAI-ADK."""
+
+from moai_adk.core.config.migration import (
+    get_conversation_language,
+    get_conversation_language_name,
+    migrate_config_to_nested_structure,
+)
+
+__all__ = [
+    "migrate_config_to_nested_structure",
+    "get_conversation_language",
+    "get_conversation_language_name",
+]

moai_adk/core/config/migration.py

@@ -0,0 +1,113 @@
+# @CODE:LANG-FIX-001:MIGRATION | SPEC: .moai/specs/SPEC-LANG-FIX-001/spec.md
+"""Configuration migration utilities for legacy flat config structure.
+
+Supports migration from legacy flat config.json structure to new nested language structure.
+"""
+
+from typing import Any
+
+
+def migrate_config_to_nested_structure(config: dict[str, Any]) -> dict[str, Any]:
+    """Migrate legacy flat config to nested language structure.
+
+    This function handles the transition from legacy flat config:
+        "conversation_language": "ko"
+        "locale": "ko"
+
+    To new nested structure:
+        "language": {
+            "conversation_language": "ko",
+            "conversation_language_name": "한국어"
+        }
+
+    Args:
+        config: Configuration dictionary that may have legacy structure.
+
+    Returns:
+        Configuration dictionary with nested language structure.
+    """
+    # If config already has nested language structure, return as-is
+    if "language" in config and isinstance(config["language"], dict):
+        return config
+
+    # If config has legacy flat structure, migrate it
+    if "conversation_language" in config and "language" not in config:
+        # Extract conversation language from legacy location
+        conversation_language = config.pop("conversation_language", "en")
+        locale = config.pop("locale", None)
+
+        # Map language codes to language names
+        language_names = {
+            "en": "English",
+            "ko": "한국어",
+            "ja": "日本語",
+            "zh": "中文",
+            "es": "Español",
+        }
+
+        language_name = language_names.get(conversation_language, "English")
+
+        # Create new nested language structure
+        config["language"] = {
+            "conversation_language": conversation_language,
+            "conversation_language_name": language_name,
+        }
+
+    return config
+
+
+def get_conversation_language(config: dict[str, Any]) -> str:
+    """Get conversation language from config with fallback handling.
+
+    Handles both legacy flat and new nested config structures.
+
+    Args:
+        config: Configuration dictionary.
+
+    Returns:
+        Language code (e.g., "ko", "en", "ja").
+    """
+    # First, try to get from nested structure (new format)
+    language_config = config.get("language", {})
+    if isinstance(language_config, dict):
+        result = language_config.get("conversation_language")
+        if result:
+            return result
+
+    # Fall back to legacy flat structure
+    result = config.get("conversation_language")
+    if result:
+        return result
+
+    # Default to English
+    return "en"
+
+
+def get_conversation_language_name(config: dict[str, Any]) -> str:
+    """Get conversation language name from config with fallback handling.
+
+    Handles both legacy flat and new nested config structures.
+
+    Args:
+        config: Configuration dictionary.
+
+    Returns:
+        Language name (e.g., "한국어", "English").
+    """
+    # First, try to get from nested structure (new format)
+    language_config = config.get("language", {})
+    if isinstance(language_config, dict):
+        result = language_config.get("conversation_language_name")
+        if result:
+            return result
+
+    # If we have the language code, try to map it
+    language_code = get_conversation_language(config)
+    language_names = {
+        "en": "English",
+        "ko": "한국어",
+        "ja": "日本語",
+        "zh": "中文",
+        "es": "Español",
+    }
+    return language_names.get(language_code, "English")

moai_adk/core/project/phase_executor.py

@@ -26,6 +26,7 @@ from moai_adk.core.project.backup_utils import (
     is_protected_path,
 )
 from moai_adk.core.project.validator import ProjectValidator
+from moai_adk.core.template.processor import TemplateProcessor
 
 console = Console()
 
@@ -136,12 +137,15 @@ class PhaseExecutor:
         )
 
         # Copy resources via TemplateProcessor in silent mode
-        from moai_adk.core.template import TemplateProcessor
-
         processor = TemplateProcessor(project_path)
 
         # Set template variable context (if provided)
         if config:
+            # @TAG:LANG-FIX-001:PY-CONFIG | Read language from nested config structure
+            language_config = config.get("language", {})
+            if not isinstance(language_config, dict):
+                language_config = {}
+
             context = {
                 "MOAI_VERSION": __version__,
                 "CREATION_TIMESTAMP": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
@@ -151,7 +155,8 @@ class PhaseExecutor:
                 "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")),
+                "CONVERSATION_LANGUAGE": language_config.get("conversation_language", "en"),
+                "CONVERSATION_LANGUAGE_NAME": language_config.get("conversation_language_name", "English"),
                 "CODEBASE_LANGUAGE": config.get("language", "generic"),
             }
             processor.set_context(context)

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

@@ -54,7 +54,7 @@ Alfred translates Claude Code configuration requirements to English before invok
 - `Skill("moai-alfred-git-workflow")` - Git strategy impact
 - Domain skills (CLI/Data Science/Database/etc) - When relevant
 - Language skills (23 available) - Based on detected language
-- `Skill("moai-alfred-interactive-questions")` - User clarification
+- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` - User clarification
 
 ---
 

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

@@ -6,7 +6,7 @@ model: sonnet
 ---
 
 # Debug Helper - Integrated debugging expert
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 You are the integrated debugging expert responsible for **all errors**.
 
@@ -45,7 +45,7 @@ Alfred translates error reports and debugging requirements to English before inv
 - `Skill("moai-essentials-review")`: Loaded when structural problems or solutions to prevent recurrence need to be presented.
 - Language-specific skills: Based on the result of `Skill("moai-alfred-language-detection")`, select only the one relevant language skill (e.g., `Skill("moai-lang-python")`, `Skill("moai-lang-typescript")`, etc.).  
 - `Skill("moai-alfred-tag-scanning")`: Called when missing/mismatching TAG is suspected.
-- `Skill("moai-alfred-interactive-questions")`: Executed when user selection among multiple solutions is required.
+- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Executed when user selection among multiple solutions is required.
 
 ### Expert Traits
 

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

@@ -6,7 +6,7 @@ model: haiku
 ---
 
 # Doc Syncer - Document Management/Synchronization Expert
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 All Git tasks are handled by the git-manager agent, including managing PRs, committing, and assigning reviewers. doc-syncer is only responsible for document synchronization.
 
@@ -47,7 +47,7 @@ Alfred translates document synchronization requirements to English before invoki
 - `Skill("moai-foundation-specs")`: Use only when SPEC metadata has changed or document consistency verification is required.
 - `Skill("moai-alfred-git-workflow")`: Called when performing a PR Ready transition or Git cleanup in team mode.
 - `Skill("moai-alfred-code-reviewer")`: Load when you need to review the quality of a code snippet to be included in a document.
-- `Skill("moai-alfred-interactive-questions")`: Executed when checking with the user whether to approve/skip the synchronization range.
+- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Executed when checking with the user whether to approve/skip the synchronization range.
 
 ### Expert Traits
 

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

@@ -6,7 +6,7 @@ model: haiku
 ---
 
 # Git Manager - Agent dedicated to Git tasks
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 This is a dedicated agent that optimizes and processes all Git operations in MoAI-ADK for each mode.
 
@@ -45,7 +45,7 @@ This ensures git history is always in English for global team compatibility.
 - `Skill("moai-foundation-git")`: Called when this is a new repository or the Git standard needs to be redefined.
 - `Skill("moai-alfred-trust-validation")`: Load when TRUST gate needs to be passed before commit/PR.
 - `Skill("moai-alfred-tag-scanning")`: Use only when TAG connection is required in the commit message.
-- `Skill("moai-alfred-interactive-questions")`: Called when user approval is obtained before performing risky operations such as rebase/force push.
+- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Called when user approval is obtained before performing risky operations such as rebase/force push.
 
 ### Expert Traits
 

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

@@ -6,7 +6,7 @@ model: sonnet
 ---
 
 # Implementation Planner - Implementation Strategist
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 You are an expert in analyzing SPECs to determine the optimal implementation strategy and library version.
 
@@ -47,7 +47,7 @@ Alfred translates SPEC requirements to English before invoking you via `Task()`.
 - `Skill("moai-alfred-tag-scanning")`: Use only when an existing TAG chain needs to be recycled or augmented.
 - Domain skills (`moai-domain-backend`/`frontend`/`web-api`/`mobile-app`, etc.): Select only one whose SPEC domain tag matches the language detection result.
 - `Skill("moai-alfred-trust-validation")`: Called when TRUST compliance measures need to be defined in the planning stage.
-- `Skill("moai-alfred-interactive-questions")`: Provides interactive options when user approval/comparison of alternatives is required.
+- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Provides interactive options when user approval/comparison of alternatives is required.
 
 ### Expert Traits
 

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

@@ -6,7 +6,7 @@ model: sonnet
 ---
 
 # Project Manager - Project Manager Agent
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 You are a Senior Project Manager Agent managing successful projects.
 
@@ -35,7 +35,7 @@ Alfred translates project setup requirements to English before invoking you.
 - Domain skills: When `moai-alfred-language-detection` determines the project is server/frontend/web API, select only one corresponding skill (`Skill("moai-domain-backend")`, `Skill("moai-domain-frontend")`, `Skill("moai-domain-web-api")`).  
 - `Skill("moai-alfred-tag-scanning")`: Executed when switching to legacy mode or when reinforcing the existing TAG is deemed necessary.
 - `Skill("moai-alfred-trust-validation")`: Only called when the user requests a “quality check” or when TRUST gate guidance is needed on the initial document draft.
-- `Skill("moai-alfred-interactive-questions")`: Called when the user's approval/modification decision must be received during the interview stage.
+- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Called when the user's approval/modification decision must be received during the interview stage.
 
 ### Expert Traits
 
@@ -147,11 +147,11 @@ Alfred translates project setup requirements to English before invoking you.
 
 ### Interview Question Guide
 
-> At all interview stages, you must call `Skill("moai-alfred-interactive-questions")` to display the AskUserQuestion TUI menu.Option descriptions include a one-line summary + specific examples, provide an “Other/Enter Yourself” option, and ask for free comments.
+> At all interview stages, you must use `AskUserQuestion` tool (documented in moai-alfred-interactive-questions skill) to display the AskUserQuestion TUI menu.Option descriptions include a one-line summary + specific examples, provide an “Other/Enter Yourself” option, and ask for free comments.
 
 #### 0. Common dictionary questions (common for new/legacy)
 1. **Check language & framework**
-- Check whether the automatic detection result is correct with `Skill("moai-alfred-interactive-questions")`.
+- Check whether the automatic detection result is correct with `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`.
 Options: **Confirmed / Requires modification / Multi-stack**.
 - **Follow-up**: When selecting “Modification Required” or “Multiple Stacks”, an additional open-ended question (`Please list the languages/frameworks used in the project with a comma.`) is asked.
 2. **Team size & collaboration style**
@@ -164,7 +164,7 @@ Options: **Confirmed / Requires modification / Multi-stack**.
 #### 1. Product Discovery Question Set
 ##### (1) For new projects
 - **Mission/Vision**
-- `Skill("moai-alfred-interactive-questions")` allows you to select one of **Platform/Operations Efficiency · New Business · Customer Experience · Regulations/Compliance · Direct Input**.
+- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` allows you to select one of **Platform/Operations Efficiency · New Business · Customer Experience · Regulations/Compliance · Direct Input**.
 - When selecting “Direct Entry”, a one-line summary of the mission and why the mission is important are collected as additional questions.
 - **Core Users/Personas**
 - Multiple selection options: End Customer, Internal Operations, Development Team, Data Team, Management, Partner/Reseller.
@@ -233,7 +233,7 @@ Options: SPEC overhaul, TDD driven development, document/code synchronization, t
 - Operations/Monitoring → OPERATIONS, INCIDENT RESPONSE section
 
 #### 5. End of interview reminder
-- After completing all questions, use `Skill("moai-alfred-interactive-questions")` to check “Are there any additional notes you would like to leave?” (Options: “None”, “Add a note to the product document”, “Add a note to the structural document”, “Add a note to the technical document”).
+- After completing all questions, use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` to check “Are there any additional notes you would like to leave?” (Options: “None”, “Add a note to the product document”, “Add a note to the structural document”, “Add a note to the technical document”).
 - When a user selects a specific document, a “User Note” item is recorded in the **HISTORY** section of the document.
 - Organize the summary of the interview results and the written document path (`.moai/project/{product,structure,tech}.md`) in a table format at the top of the final response.
 

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

@@ -6,7 +6,7 @@ model: haiku
 ---
 
 # Quality Gate - Quality Verification Gate
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 You are a quality gate that automatically verifies TRUST principles and project standards.
 
@@ -34,7 +34,7 @@ Alfred translates quality gate requirements to English before invoking you. Your
 - `Skill("moai-essentials-review")`: Called when qualitative analysis of Readable/Unified items is required or when a code review checklist is required.
 - `Skill("moai-essentials-perf")`: Used when a suspected performance regression occurs or when performance indicators are below target.
 - `Skill("moai-foundation-trust")`: Loaded for reference when you need to check the latest update based on TRUST.
-- `Skill("moai-alfred-interactive-questions")`: Executes only when user decision is required after PASS/Warning/Block results.
+- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Executes only when user decision is required after PASS/Warning/Block results.
 
 ### Expert Traits
 

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

@@ -86,7 +86,7 @@ Instead of assuming user intent, invoke the TUI survey Skill:
 
 ```python
 # Delegate to moai-alfred-interactive-questions
-Skill("moai-alfred-interactive-questions")
+AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
 
 # Present structured survey
 Survey: "What problem does this Skill solve?"
@@ -104,7 +104,7 @@ Continue using the TUI survey Skill to clarify:
 
 ```python
 # Delegate to moai-alfred-interactive-questions for scope questions
-Skill("moai-alfred-interactive-questions")
+AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
 
 Questions:
 1. Primary domain: "Which technology/framework?"
@@ -358,7 +358,7 @@ Always delegate to `moai-alfred-interactive-questions`:
 
 ```python
 # Invoke TUI survey Skill
-Skill("moai-alfred-interactive-questions")
+AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
 
 Survey: "Which technology domain?"
 Options:
@@ -379,7 +379,7 @@ Options:
 
 ```python
 # Invoke TUI survey Skill
-Skill("moai-alfred-interactive-questions")
+AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
 
 Survey: "Which features are most important?" (Multiple selection)
 Options:
@@ -397,7 +397,7 @@ Options:
 
 ```python
 # Invoke TUI survey Skill
-Skill("moai-alfred-interactive-questions")
+AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
 
 Survey: "Target experience level?"
 Options:
@@ -462,7 +462,7 @@ Tier 3 (Supporting, ~10% weight):
 **Recovery**:
 ```python
 # 1. Activate TUI Survey
-Skill("moai-alfred-interactive-questions")
+AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
 
 # 2. Ask structured questions: domain, problem, audience
 # 3. Document clarified requirements
@@ -498,7 +498,7 @@ Skill("moai-alfred-interactive-questions")
 **Recovery**:
 ```python
 # 1. Use TUI Survey to identify priorities
-Skill("moai-alfred-interactive-questions")
+AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
 
 # 2. Suggest splitting into multiple Skills
 # 3. Create foundational Skill first

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

@@ -8,7 +8,7 @@ model: sonnet
 **Priority:** This guideline is **subordinate to the command guideline (`/alfred:1-plan`). In case of conflict with command instructions, the command takes precedence.
 
 # SPEC Builder - SPEC Creation Expert
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 You are a SPEC expert agent responsible for SPEC document creation and intelligent verification.
 
@@ -48,7 +48,7 @@ Alfred translates user requests to English before invoking you via `Task()`. Thi
 - `Skill("moai-alfred-spec-metadata-validation")`: Called when checking ID/version/status or updating inherited SPEC.
 - `Skill("moai-alfred-tag-scanning")`: Used only when traceability must be secured by referencing the existing TAG chain.
 - `Skill("moai-foundation-trust")` + `Skill("moai-alfred-trust-validation")`: Sequentially called when preemptive verification is required before user request or quality gate.
-- `Skill("moai-alfred-interactive-questions")`: Run when user approval/modification options need to be collected.
+- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Run when user approval/modification options need to be collected.
 
 ### Expert Traits
 

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

@@ -6,7 +6,7 @@ model: haiku
 ---
 
 # TAG System Agent - sole TAG management authority
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 You are a professional agent responsible for all TAG operations in MoAI-ADK.
 
@@ -33,7 +33,7 @@ Alfred translates TAG verification requests to English before invoking you. Your
 **Conditional Skill Logic**
 - `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.
+- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Executed when TAG conflict/deletion must be confirmed with user approval.
 
 ### Expert Traits
 

moai_adk/templates/.claude/agents/alfred/tdd-implementer.md

@@ -6,7 +6,7 @@ model: sonnet
 ---
 
 # TDD Implementer - TDD implementation expert
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 You are a TDD expert who strictly adheres to the RED-GREEN-REFACTOR cycle and keeps track of the TAG chain.
 
@@ -46,7 +46,7 @@ Alfred translates SPEC references and implementation requirements to English bef
 - `Skill("moai-essentials-refactor")`: Called only when entering the REFACTOR stage.
 - `Skill("moai-alfred-git-workflow")`: Loads commits/checkpoints for each TAG at the time of preparation.
 - `Skill("moai-essentials-perf")`: Applied only when performance requirements are specified in SPEC.
-- `Skill("moai-alfred-interactive-questions")`: Collects user decisions when choosing an implementation alternative or refactoring strategy is needed.
+- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Collects user decisions when choosing an implementation alternative or refactoring strategy is needed.
 
 ### Expert Traits
 

moai_adk/templates/.claude/agents/alfred/trust-checker.md

@@ -6,7 +6,7 @@ model: haiku
 ---
 
 # Trust Checker - Integrated Quality Verification Expert
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 You are the agent responsible for the TRUST 5 principles, code standards, and security checks.
 
@@ -35,7 +35,7 @@ Alfred translates quality verification requests to English before invoking you.
 - `Skill("moai-essentials-review")`: Called when qualitative verification of Readable/Unified indicators is required.
 - `Skill("moai-essentials-perf")`: Used when performance analysis is required in Level 3 scan.
 - `Skill("moai-essentials-debug")`: Called when a critical result occurs and root cause analysis is required.
-- `Skill("moai-alfred-interactive-questions")`: Run when it is necessary to coordinate with the user whether to re-verify/suspend.
+- `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`: Run when it is necessary to coordinate with the user whether to re-verify/suspend.
 
 ### Expert Traits
 

moai_adk/templates/.claude/commands/alfred/0-project.md

@@ -6,21 +6,21 @@ description: "Initialize project document - create product/structure/tech.md and
 # - ja: "プロジェクト文書の初期化 - product/structure/tech.mdの作成と言語別最適化設定"
 # - zh: "初始化项目文档 - 创建product/structure/tech.md并设置语言优化"
 allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - MultiEdit
-  - Grep
-  - Glob
-  - TodoWrite
-  - Bash(ls:*)
-  - Bash(find:*)
-  - Bash(cat:*)
-  - Task
+- Read
+- Write
+- Edit
+- MultiEdit
+- Grep
+- Glob
+- TodoWrite
+- Bash(ls:*)
+- Bash(find:*)
+- Bash(cat:*)
+- Task
 ---
 
 # 📋 MoAI-ADK Step 0: Initialize/Update Universal Language Support Project Documentation
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 ## 🎯 Command Purpose
 
@@ -110,7 +110,7 @@ MoAI-ADK의 SuperAgent로서 당신의 프로젝트를 함께 만들어갈 준
 
 ### 0.1 언어 선택
 
-Alfred가 `Skill("moai-alfred-interactive-questions")` 를 사용하여 **첫 번째 상호작용**으로 언어 선택 메뉴를 표시합니다:
+Alfred가 `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` 를 사용하여 **첫 번째 상호작용**으로 언어 선택 메뉴를 표시합니다:
 
 **Question**:
 ```
@@ -144,7 +144,7 @@ This language preference is:
 
 ### 0.2.5 사용자 닉네임 선택
 
-언어 선택 완료 후, Alfred가 `Skill("moai-alfred-interactive-questions")` 를 사용하여 사용자 닉네임을 요청합니다:
+언어 선택 완료 후, Alfred가 `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` 를 사용하여 사용자 닉네임을 요청합니다:
 
 **질문**:
 ```
@@ -228,7 +228,7 @@ grep "optimized" .moai/config.json
 - `optimized: false` in `config.json` (immediately after reinitialization)
 
 **Select user if backup exists**  
-Call `Skill("moai-alfred-interactive-questions")` to display a TUI with the following options:
+Call `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` to display a TUI with the following options:
 - **Merge**: Merge backup contents and latest template (recommended)
 - **New**: Ignore the backup and start a new interview
 - **Skip**: Keep current file (terminate task)
@@ -267,7 +267,7 @@ The following patterns are considered "template defaults" (not merged):
 - "Define your key user base"
 - "Describe the core problem you are trying to solve"
 - "List the strengths and differences of your project"
-- "{{PROJECT_NAME}}", "{{PROJECT_DESCRIPTION}}", etc. Variable format
+- "MoAI-ADK", "MoAI-Agentic Development Kit", etc. Variable format
 - Guide phrases such as "Example:", "Sample:", "Example:", etc.
 
 **STEP 3: Extract user customization**
@@ -443,7 +443,7 @@ Set optimization flags after the merge is complete:
 
 ### 1.5 Wait for user approval (moai-alfred-interactive-questions) (when user selects "New")
 
-After Alfred receives the project-manager's interview plan report, calls `Skill("moai-alfred-interactive-questions")` and asks whether Phase 2 is approved.
+After Alfred receives the project-manager's interview plan report, uses `AskUserQuestion` tool (documented in moai-alfred-interactive-questions skill) and asks whether Phase 2 is approved.
 - **Proceed**: Interview conducted according to approved plan
 - **Modify**: Re-establish the plan (re-execute Phase 1)
 - **Stop**: Stop initialization
@@ -477,21 +477,38 @@ Alfred starts project initialization by calling the project-manager agent with t
 - Approved Interview Plan: [Plan Summary]
 
 **Execution**:
-```bash
-# Pseudo-code showing parameter flow
-Task(
-    subagent_type="project-manager",
-    description="Initialize project with conversation language support",
-    prompt=f"""You are project-manager. Initialize project with these parameters:
-    - conversation_language: "{conversation_language}"  # e.g., "ko"
-    - language_name: "{language_name}"  # e.g., "Korean"
-    - project_type: "{project_type}"  # e.g., "new"
-    - detected_languages: {detected_languages}
-
-    All interviews and documentation must be generated in the conversation_language.
-    Update .moai/config.json with these language parameters.
-    """
-)
+```
+Call the Task tool:
+- subagent_type: "project-manager"
+- description: "Initialize project with conversation language support"
+- prompt: """You are project-manager agent.
+
+LANGUAGE CONFIGURATION:
+- conversation_language: {{CONVERSATION_LANGUAGE}}
+- language_name: {{CONVERSATION_LANGUAGE_NAME}}
+
+PROJECT_TYPE: [new|existing]
+DETECTED_LANGUAGES: [detected codebase languages]
+
+CRITICAL INSTRUCTION:
+All interviews and generated documentation MUST be in conversation_language:
+- product.md: Generate in {{CONVERSATION_LANGUAGE}}
+- structure.md: Generate in {{CONVERSATION_LANGUAGE}}
+- tech.md: Generate in {{CONVERSATION_LANGUAGE}}
+
+If conversation_language is 'ko': All narrative content in Korean
+If conversation_language is 'ja': All narrative content in Japanese
+If conversation_language is other: Follow the specified language
+
+After project initialization, update .moai/config.json with nested language structure:
+{
+  "language": {
+    "conversation_language": "{{CONVERSATION_LANGUAGE}}",
+    "conversation_language_name": "{{CONVERSATION_LANGUAGE_NAME}}"
+  }
+}
+
+TASK: Conduct project interviews and create/update product/structure/tech.md documents."""
 ```
 
 **Outcome**: The project-manager agent conducts structured interviews entirely in the selected language and creates/updates product/structure/tech.md documents in that language.
@@ -526,7 +543,7 @@ After the project-manager has finished creating the document, **Alfred can optio
 - When selecting language/framework
 - When changing important settings
 
-**Example** (inside project-manager): Ask whether to "overwrite file" with `Skill("moai-alfred-interactive-questions")`,
+**Example** (inside project-manager): Ask whether to "overwrite file" with `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`,
 - Allows you to choose between **Overwrite** / **Merge** / **Skip**.
 
 **Nested pattern**:
@@ -789,7 +806,7 @@ Alfred only calls the trust-checker agent to perform project initial structural
 ### 2.6: Agent & Skill Tailoring (Project Optimization)
 
 Based on the results of the interviews and initial analysis, we recommend and activate sub-agents and skills that should be immediately utilized in the project.
-Before actual application, user confirmation is received with `Skill("moai-alfred-interactive-questions")`, and selected items are recorded in `CLAUDE.md` and `.moai/config.json`.
+Before actual application, user confirmation is received with `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`, and selected items are recorded in `CLAUDE.md` and `.moai/config.json`.
 
 #### 2.6.0 Create cc-manager briefing
 
@@ -830,7 +847,7 @@ If multiple conditions are met, the candidates are merged without duplicates and
 
 #### 2.6.2 User confirmation flow
 
-`Skill("moai-alfred-interactive-questions")` asks “whether to enable recommended items.”
+`AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` asks “whether to enable recommended items.”
 - Provides three options: **Install all** / **Install selectively** / **Do not install**.
 Selecting “Selective Install” presents the list of candidates again as multiple choices, allowing the user to select only the items they need.
 
@@ -975,7 +992,7 @@ This subcommand is executed under the following conditions:
    ```
 
 4. **Waiting for user approval**  
-`Skill("moai-alfred-interactive-questions")` asks “Do you want to proceed with template optimization?” and provides the following options.
+`AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` asks “Do you want to proceed with template optimization?” and provides the following options.
 - **Proceed** → Phase 2 execution
 - **Preview** → Display change details and recheck
 - **Skip** → keep optimized=false
@@ -1110,7 +1127,7 @@ Alfred: Skill("moai-alfred-template-generator")
 ✅ Project customized optimization completed!
 
 📊 Optimization results:
-- **Project**: {{PROJECT_NAME}}
+- **Project**: MoAI-ADK
 - **Category**: web-api
 - **Main language**: python
 - **Framework**: fastapi