moai-adk 0.6.3__py3-none-any.whl → 0.7.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

@@ -142,6 +142,11 @@ class PhaseExecutor:
 
         # 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 +156,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/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 `Skill("moai-alfred-interactive-questions")` 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**.
 

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 `Skill("moai-alfred-interactive-questions")` 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.
 

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 `Skill("moai-alfred-interactive-questions")` 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.
 

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 `Skill("moai-alfred-interactive-questions")` 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.
 

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 `Skill("moai-alfred-interactive-questions")` 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.
 

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 `Skill("moai-alfred-interactive-questions")` 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.
 

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 `Skill("moai-alfred-interactive-questions")` 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.
 

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 `Skill("moai-alfred-interactive-questions")` 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.
 

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 `Skill("moai-alfred-interactive-questions")` 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.
 

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 `Skill("moai-alfred-interactive-questions")` 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.
 

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 `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 ## 🎯 Command Purpose
 
@@ -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**
@@ -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.
@@ -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

moai_adk/templates/.claude/commands/alfred/1-plan.md

@@ -21,7 +21,7 @@ allowed-tools:
 ---
 
 # 🏗️ MoAI-ADK Step 1: Establish a plan (Plan) - Always make a plan first and then proceed.
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 ## 🎯 Command Purpose
 
@@ -29,6 +29,22 @@ allowed-tools:
 
 **Plan for**: $ARGUMENTS
 
+## 🤖 CodeRabbit AI Integration (Local Only)
+
+This local environment includes CodeRabbit AI review integration for SPEC documents:
+
+**Automatic workflows:**
+- ✅ SPEC review: CodeRabbit analyzes SPEC metadata and EARS structure
+- ✅ GitHub Issue sync: SPEC files automatically create/update GitHub Issues
+- ✅ Auto-approval: Draft PRs are approved when quality meets standards (80%+)
+- ✅ SPEC quality validation: Checklist for metadata, structure, and content
+
+**Scope:**
+- 🏠 **Local environment**: Full CodeRabbit integration with auto-approval
+- 📦 **Published packages**: Users get GitHub Issue sync only (no CodeRabbit)
+
+> See `.coderabbit.yaml` for detailed review rules and SPEC validation checklist
+
 ## 💡 Planning philosophy: "Always make a plan first and then proceed."
 
 `/alfred:1-plan` is a general-purpose command that **creates a plan**, rather than simply “creating” a SPEC document.
@@ -126,14 +142,28 @@ Invoking the Task tool (Explore agent):
 Call the Task tool:
 - subagent_type: "spec-builder"
 - description: "Analyze the plan and establish a plan"
-- prompt: "Please analyze the project document and suggest SPEC candidates.
- Run in analysis mode, and must include the following:
- 1. In-depth analysis of product/structure/tech.md
- 2. Identify SPEC candidates and Determine priorities
- 3. Design EARS structure
- 4. Wait for user approval
- User input: $ARGUMENTS
- (Optional) Explore results: $EXPLORE_RESULTS"
+- prompt: """You are spec-builder agent.
+
+LANGUAGE CONFIGURATION:
+- conversation_language: {{CONVERSATION_LANGUAGE}}
+- language_name: {{CONVERSATION_LANGUAGE_NAME}}
+
+CRITICAL INSTRUCTION:
+All SPEC documents and analysis must be generated in conversation_language.
+- If conversation_language is 'ko' (Korean): Generate ALL analysis, plans, and SPEC documents in Korean
+- If conversation_language is 'ja' (Japanese): Generate ALL analysis, plans, and SPEC documents in Japanese
+- If conversation_language is other language: Follow the specified language
+
+TASK:
+Please analyze the project document and suggest SPEC candidates.
+Run in analysis mode, and must include the following:
+1. In-depth analysis of product/structure/tech.md
+2. Identify SPEC candidates and Determine priorities
+3. Design EARS structure
+4. Wait for user approval
+
+User input: $ARGUMENTS
+(Optional) Explore results: $EXPLORE_RESULTS"""
 ```
 
 ### Plan analysis progress
@@ -172,14 +202,30 @@ After user approval (collected via `Skill("moai-alfred-interactive-questions")`)
 ```
 1. Call spec-builder (create plan):
    - subagent_type: "spec-builder"
-- description: "Create SPEC document"
- - prompt: "Please fill out the SPEC document according to the plan approved in STEP 1.
- Create a specification for the EARS structure."
+   - description: "Create SPEC document"
+   - prompt: """You are spec-builder agent.
+
+LANGUAGE CONFIGURATION:
+- conversation_language: {{CONVERSATION_LANGUAGE}}
+- language_name: {{CONVERSATION_LANGUAGE_NAME}}
+
+CRITICAL INSTRUCTION:
+ALL SPEC documents MUST be generated in conversation_language:
+- spec.md: Full document in conversation_language
+- plan.md: Full document in conversation_language
+- acceptance.md: Full document in conversation_language
+
+YAML frontmatter and @TAG identifiers MUST remain in English.
+Code examples and technical keywords can be mixed (code in English, narrative in user language).
+
+TASK:
+Please fill out the SPEC document according to the plan approved in STEP 1.
+Create a specification for the EARS structure."""
 
 2. Invoke git-manager (Git task):
    - subagent_type: "git-manager"
-- description: "Create Git branch/PR"
- - prompt: "After completing the plan, please create a branch and Draft PR."
+   - description: "Create Git branch/PR"
+   - prompt: "After completing the plan, please create a branch and Draft PR."
 ```
 
 ## function
@@ -549,6 +595,48 @@ The `git-manager` agent does **all at once** after the SPEC is complete:
 3. **Initial commit**: Commit SPEC document and create tags
 4. **Remote Sync**: Apply synchronization strategy for each mode
 
+### Phase 3.5: CodeRabbit SPEC Review (Local Only)
+
+**After Draft PR is created, CodeRabbit automatically:**
+
+```bash
+echo "🤖 Waiting for CodeRabbit SPEC review..."
+
+# CodeRabbit triggers automatically on Draft PR creation
+# Review includes:
+# - SPEC metadata validation (YAML frontmatter)
+# - EARS structure completeness check
+# - Acceptance criteria quality (Given-When-Then)
+# - @TAG system traceability
+# - Documentation clarity
+
+# Expected time: 1-2 minutes
+for i in {1..12}; do
+    sleep 10
+
+    # Check PR review status
+    approval=$(gh pr view $pr_num --json reviewDecision --jq '.reviewDecision')
+
+    if [ "$approval" = "APPROVED" ]; then
+        echo "✅ CodeRabbit approved SPEC PR!"
+        echo "→ Ready for development with /alfred:2-run SPEC-$spec_id"
+        break
+    fi
+
+    echo "⏳ CodeRabbit reviewing... ($i/12)"
+done
+```
+
+**CodeRabbit review includes:**
+- ✅ YAML frontmatter validation (7 required fields)
+- ✅ HISTORY section structure and completeness
+- ✅ EARS requirements clarity (Ubiquitous/Event/State/Optional/Constraints)
+- ✅ Acceptance criteria quality (Given-When-Then scenarios)
+- ✅ @TAG system compliance (SPEC/TEST/CODE/DOC traceability)
+- ✅ Documentation and formatting
+
+See `.coderabbit.yaml` for detailed SPEC review checklist.
+
 ## Writing Tips
 
 - Information that is not in the product/structure/tech document is supplemented by asking a new question. 

moai_adk/templates/.claude/commands/alfred/2-run.md

@@ -24,7 +24,7 @@ allowed-tools:
 ---
 
 # ⚒️ MoAI-ADK Phase 2: Run the plan - Flexible implementation strategy
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 ## 🎯 Command Purpose
 
@@ -188,19 +188,31 @@ After user approval (gathered through `Skill("moai-alfred-interactive-questions"
 **STEP 2 calls tdd-implementer using the Task tool**:
 
 ```
-Task tool call example:
+Call the Task tool:
 - subagent_type: "tdd-implementer"
-- description: "Execute task"
-- prompt: "Please execute the task according to the plan approved in STEP 1.
- For TDD scenario:
- - Perform RED → GREEN → REFACTOR cycle,
- Perform the following for each TAG:
- 1. RED Phase: Write a test that fails with the @TEST:ID tag
- 2. GREEN Phase: Minimal implementation with the @CODE:ID tag
- 3. REFACTOR Phase: Improve code quality
- 4. Verify TAG completion conditions and proceed to the next TAG
-
-Execute on: $ARGUMENTS"
+- description: "Execute task with TDD implementation"
+- prompt: """You are tdd-implementer agent.
+
+LANGUAGE CONFIGURATION:
+- conversation_language: {{CONVERSATION_LANGUAGE}}
+- language_name: {{CONVERSATION_LANGUAGE_NAME}}
+
+CRITICAL INSTRUCTION:
+Code and technical output MUST be in English.
+Code comments MAY be in {{CONVERSATION_LANGUAGE}} if appropriate.
+Test descriptions and documentation can use {{CONVERSATION_LANGUAGE}}.
+
+TASK: Execute the task according to the plan approved in STEP 1.
+
+For TDD scenario:
+- Perform RED → GREEN → REFACTOR cycle
+- Perform the following for each TAG:
+  1. RED Phase: Write a test that fails with the @TEST:ID tag
+  2. GREEN Phase: Minimal implementation with the @CODE:ID tag
+  3. REFACTOR Phase: Improve code quality
+  4. Verify TAG completion conditions and proceed to the next TAG
+
+Execute on: $ARGUMENTS"""
 ```
 
 ## 🔗 TDD optimization for each language

moai_adk/templates/.claude/commands/alfred/3-sync.md

@@ -5,23 +5,24 @@ description: "Document synchronization + PR Ready conversion"
 # - ko: "문서 동기화 + PR Ready 전환"
 # - ja: "ドキュメント同期 + PR Ready変換"
 # - zh: "文档同步 + PR Ready转换"
-argument-hint: "Mode target path - Mode: auto (default)|force|status|project, target path: Synchronization target path"
+argument-hint: 'Mode target path - Mode: auto (default)|force|status|project, target
+  path: Synchronization target path'
 allowed-tools:
-  - Read
-  - Write
-  - Edit
-  - MultiEdit
-  - Bash(git:*)
-  - Bash(gh:*)
-  - Bash(python3:*)
-  - Task
-  - Grep
-  - Glob
-  - TodoWrite
+- Read
+- Write
+- Edit
+- MultiEdit
+- Bash(git:*)
+- Bash(gh:*)
+- Bash(python3:*)
+- Task
+- Grep
+- Glob
+- TodoWrite
 ---
 
 # 📚 MoAI-ADK Step 3: Document Synchronization (+Optional PR Ready)
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
 
 ## 🚀 START HERE
 
@@ -160,10 +161,26 @@ Invoking the Task tool (Explore agent):
 
 2. doc-syncer call (synchronization plan):
    - subagent_type: "doc-syncer"
-- description: "Establish a document synchronization plan"
- - prompt: "Please analyze Git changes and establish a document synchronization plan.
-             $ARGUMENTS
-(Optional) TAG validation results: $TAG_VALIDATION_RESULTS"
+   - description: "Establish a document synchronization plan"
+   - prompt: """You are doc-syncer agent.
+
+LANGUAGE CONFIGURATION:
+- conversation_language: {{CONVERSATION_LANGUAGE}}
+- language_name: {{CONVERSATION_LANGUAGE_NAME}}
+
+CRITICAL INSTRUCTION:
+Documentation updates MUST respect conversation_language:
+- User-facing documentation (README, guides): {{CONVERSATION_LANGUAGE}}
+- SPEC documents (spec.md, plan.md, acceptance.md): {{CONVERSATION_LANGUAGE}}
+- Code comments: {{CONVERSATION_LANGUAGE}} (when not technical keywords)
+- Technical documentation and YAML frontmatter: English
+
+TASK:
+Please analyze Git changes and establish a document synchronization plan.
+Ensure all documentation updates align with the conversation_language setting.
+
+$ARGUMENTS
+(Optional) TAG validation results: $TAG_VALIDATION_RESULTS"""
 ```
 
 ### Synchronization analysis in progress

moai_adk/templates/.moai/config.json

@@ -55,6 +55,10 @@
     ],
     "current_stage": "initialized"
   },
+  "language": {
+    "conversation_language": "{{CONVERSATION_LANGUAGE}}",
+    "conversation_language_name": "{{CONVERSATION_LANGUAGE_NAME}}"
+  },
   "project": {
     "name": "{{PROJECT_NAME}}",
     "description": "{{PROJECT_DESCRIPTION}}",

moai_adk/templates/CLAUDE.md

@@ -6,7 +6,7 @@
 > **Project Owner**: {{PROJECT_OWNER}}
 > **Config**: `.moai/config.json`
 >
-> All interactions with Alfred can use `Skill("moai-alfred-interactive-questions")` for TUI-based responses.
+> **Note**: `Skill("moai-alfred-interactive-questions")` provides TUI-based responses when user interaction is needed. The skill loads on-demand.
 
 ---
 

{moai_adk-0.6.3.dist-info → moai_adk-0.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.6.3
+Version: 0.7.0
 Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent & Complete Skills v2.0
 Project-URL: Homepage, https://github.com/modu-ai/moai-adk
 Project-URL: Repository, https://github.com/modu-ai/moai-adk

{moai_adk-0.6.3.dist-info → moai_adk-0.7.0.dist-info}/RECORD

@@ -11,6 +11,8 @@ moai_adk/cli/commands/update.py,sha256=iwDDD_ozCfkGUk1ci2CPfybzRtNFPMi-680NxmKhD
 moai_adk/cli/prompts/__init__.py,sha256=a4_ctS4KEvGtmM9j7z8XIlMkpftohjVb9woUwZu38gE,136
 moai_adk/cli/prompts/init_prompts.py,sha256=OZ_T-b4XfkyXQsKXTwLcDYwmLbaf0k5oZfbi_asTH9M,5226
 moai_adk/core/__init__.py,sha256=1sJO-PHEKF1NmYjeOPPPzn_HRgYln3CKlCpUH4E2Jrs,129
+moai_adk/core/config/__init__.py,sha256=30Qx-GSN1LLI_9ngNqQ6A6d40J92xK10AQxhKw1-MzU,328
+moai_adk/core/config/migration.py,sha256=KzFGx3kPNoOaZCmAQvNpvlrQq48N3Gj6o2COVV7jciA,3541
 moai_adk/core/diagnostics/__init__.py,sha256=aF-qC2CW0wxZDpxnlh-TILYs3kqwOIj2EjXYEXY-2j8,387
 moai_adk/core/diagnostics/slash_commands.py,sha256=cEH96M5RLxa1JLyoeoRqziBMzAbnN30j04YjNjxM7Ro,4682
 moai_adk/core/git/__init__.py,sha256=Kpq2yU5X5bBBUV8ySYIB1_vMPvfdFS6hTYx2Ue-CoeQ,697
@@ -25,7 +27,7 @@ moai_adk/core/project/backup_utils.py,sha256=-zEXIhGsM-MdX1voUIpKxLlR57Y-lqLEZSi
 moai_adk/core/project/checker.py,sha256=B94mGLHDZkjQnFDgV8sknJDms5oIiHeyKcgxWI87-f8,9523
 moai_adk/core/project/detector.py,sha256=ADVg36yvyqJEPQVNc_x9iInF9dzi7YZqqXfDq2XL17Q,4230
 moai_adk/core/project/initializer.py,sha256=yqxePuCO2ednzCOpDZLczyCP079J6Io4pvtynTp4J6w,6724
-moai_adk/core/project/phase_executor.py,sha256=w3z8VRT9p9rcmMt2lWCHmH5rHSWmLMvbe1dHHMEu0KY,10666
+moai_adk/core/project/phase_executor.py,sha256=MZXqzYZA4OrZT0xViplyOUVRchiSaEWeTEmyzkSHEQY,10997
 moai_adk/core/project/validator.py,sha256=gH9ywTMQTwqtqBVrMWj5_bPYFrVzjHuFoU4QdeVa1O4,5756
 moai_adk/core/quality/__init__.py,sha256=_uNsbThBLmVLWZCPmEgfFyQqJx3tdef9jhkP9QoHuJY,222
 moai_adk/core/quality/trust_checker.py,sha256=CN067AiublAH46IBAKEV_I-8Wc0bNaR2dMnMf9n5oBg,15198
@@ -38,25 +40,25 @@ moai_adk/core/template/languages.py,sha256=V0wLcxCIOve9Q_0_NhrHGQevSIN_MB612GwrO
 moai_adk/core/template/merger.py,sha256=ZV8_U1HZJ3bfAtgyNmSxgj8KdTMt4eUnUG6kVVRT7bE,6909
 moai_adk/core/template/processor.py,sha256=_nYHiuN9PGzC3iE4X5SpRMFW-OTkI2u1dOAjD98axAk,19190
 moai_adk/templates/.gitignore,sha256=6VNKResdDpyaii3cmJA4pOLwK2PhYARIWkUODYtKyxg,310
-moai_adk/templates/CLAUDE.md,sha256=uf6n3RKG0YdtWO26ZDfkE39jIYvXuRekgRFz2YflLLQ,11281
+moai_adk/templates/CLAUDE.md,sha256=F1KjJb2HPT887aW9HBGezm2lh0wfNZcN5GLOF2aTo_k,11318
 moai_adk/templates/__init__.py,sha256=6MV1gCB7PLZMiL4gaD_dZSKxtcQyo45MMTuN8fVdchA,104
 moai_adk/templates/.claude/settings.json,sha256=SwjID_m0XWmHT12lqkhJXL1Sh30zAr9_tk4drQ9x9K8,3149
 moai_adk/templates/.claude/agents/alfred/cc-manager.md,sha256=63HRf8C7JNRApeOqGJi9Iwhcn5is9ImucsfRHhZ5zFU,8348
-moai_adk/templates/.claude/agents/alfred/debug-helper.md,sha256=X6dOEtT93h8RHwRhx-EFXtKAoXZebI0B14KYhLttDho,7204
-moai_adk/templates/.claude/agents/alfred/doc-syncer.md,sha256=fFeUB81my-bTwJmLlBZIsANn1E6C8lEeq7swHI7g7vc,8619
-moai_adk/templates/.claude/agents/alfred/git-manager.md,sha256=jZUR-XrZ4McQCjGSt64Wb9pt5uNKwcV_n9xBxbR6iV4,14057
-moai_adk/templates/.claude/agents/alfred/implementation-planner.md,sha256=wx71G8_YAqro77ecej7tkSPKHcCBU7yCClxqOhbgzXA,11528
-moai_adk/templates/.claude/agents/alfred/project-manager.md,sha256=rXTou0zOjJmBJUnkU9_5VZKNOffjxIhK3bYcAj-HuW4,14891
-moai_adk/templates/.claude/agents/alfred/quality-gate.md,sha256=x7OZmqTGgeJqtZ6vAKmVOWKwpdrEYMmcydcU7LGn5Tg,10694
+moai_adk/templates/.claude/agents/alfred/debug-helper.md,sha256=vI0RaXhmEqpIHBHc3KYhCQsbOhF1Xy2yCJOyxfOQ9wQ,7221
+moai_adk/templates/.claude/agents/alfred/doc-syncer.md,sha256=QUzfYwUnGm46ZgN067iS6yKayE3AAYM9QIcjAO8jv5A,8636
+moai_adk/templates/.claude/agents/alfred/git-manager.md,sha256=yen1XeZJXEAE7e8JkE5lxNoLAlbm-1iPTyQMbY8yH9c,14074
+moai_adk/templates/.claude/agents/alfred/implementation-planner.md,sha256=ZSR-OWii-5pH3qLjAid89OaC4JW2QnwZgN-s5vp32lA,11545
+moai_adk/templates/.claude/agents/alfred/project-manager.md,sha256=xEU4OnEKiysH08ZWvK9KqJheoFYZXlZ9UmDDs2B80O0,14908
+moai_adk/templates/.claude/agents/alfred/quality-gate.md,sha256=iAx3O2wOWP-mpYFEumJpdLDavyqQ5Yk0ILbcvZtw98k,10711
 moai_adk/templates/.claude/agents/alfred/skill-factory.md,sha256=PGnrkeT5630ELQ2vBwVGaJr3vzU6I-4LObiZrCCjGjw,26229
-moai_adk/templates/.claude/agents/alfred/spec-builder.md,sha256=yWtF_gALjHwirPvtkz9PQOfCbFZevH7WWFqjEaSiAEA,12490
-moai_adk/templates/.claude/agents/alfred/tag-agent.md,sha256=ocDVfqk1q7f8SH7As3X_hokiRfostCnLaJf37-7dw8Q,9594
-moai_adk/templates/.claude/agents/alfred/tdd-implementer.md,sha256=vCyJRZWdRXPk9qdra-QQtEf21ap28w8sx5VYPnWMHMA,10200
-moai_adk/templates/.claude/agents/alfred/trust-checker.md,sha256=oTQ6BvGYU_luJDNwqjNPIU9G5dKUWRV4wJpmgyqr4dk,13578
-moai_adk/templates/.claude/commands/alfred/0-project.md,sha256=-gyBdhT7dYIGMNYv91DF_1uepGW_B0lJMDV8nlrzuIE,45878
-moai_adk/templates/.claude/commands/alfred/1-plan.md,sha256=t_6ubTvlZsp8u1RIy5isJFlITH7tFp2UKiIg0NfJ4bU,22028
-moai_adk/templates/.claude/commands/alfred/2-run.md,sha256=m2WLbrR0Njky5SPMLTuvQPJBeSUcmlUXivr4IbvKUYA,20415
-moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=yhxi-V7NOkhRYcrNKQ4zYJGxHrtQTfRm_ejcExf-SsE,22402
+moai_adk/templates/.claude/agents/alfred/spec-builder.md,sha256=xYzdnYbmozvSfHrkQKSfIgmlXYFGJ-tpPtubIyY0AM4,12507
+moai_adk/templates/.claude/agents/alfred/tag-agent.md,sha256=6n8n93kho3XTONZ4At7VwuZR4QjF1KmNoIN5u_CdNcE,9611
+moai_adk/templates/.claude/agents/alfred/tdd-implementer.md,sha256=p9e2PLSH5uUP3fXjaGGMzdm6-QZqDoMSUsCDzUtYQYk,10217
+moai_adk/templates/.claude/agents/alfred/trust-checker.md,sha256=TK3rVt0UqgoT8p6ubm3TesbhG6nokmV9FqR4DfC_VjU,13595
+moai_adk/templates/.claude/commands/alfred/0-project.md,sha256=sXEiAJX0L220K93drjttQGWLVDtYHS1pTzQDNToVIo0,46399
+moai_adk/templates/.claude/commands/alfred/1-plan.md,sha256=xjPSZFVZ5FeLcC5nGfkLDc1xEeTzx4RwL5zHS2H1DSo,25170
+moai_adk/templates/.claude/commands/alfred/2-run.md,sha256=xEteotB1u-j7HD0id1Sw4Uopdvv8XK51nnB4qjc3bM0,20820
+moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=EZtQpqPwzVaOvW21kx9VKi7RHMpe8PIA72iTU_sLfMQ,22992
 moai_adk/templates/.claude/hooks/alfred/HOOK_SCHEMA_VALIDATION.md,sha256=5dd6KRFQXzp0L8lAWKRN7Momgg_8XNV1QZ6VGs03_pc,9064
 moai_adk/templates/.claude/hooks/alfred/README.md,sha256=8JirNg3Jn2OUFmHySYBd8QxQgPkG7kcev86Zkf80asY,6852
 moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py,sha256=PjdyJluyoQgaIpq3n9K9r-a3VeLMH1eWcXaAA6ohvrw,7723
@@ -255,7 +257,7 @@ moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md,sha256=q753rSPFZfylgwh6HkEP2
 moai_adk/templates/.github/ISSUE_TEMPLATE/spec.yml,sha256=c6WaTy7Vh6IsNsIJzSTGuGpaGhZAZ1prQXGIUM7P8PA,5212
 moai_adk/templates/.github/workflows/moai-gitflow.yml,sha256=D9ob1O7tzsUvk3WQPPaHFx1Oo6_RxnbCb5WHJ6DWyrI,8589
 moai_adk/templates/.github/workflows/spec-issue-sync.yml,sha256=VJ0IQcIEnlnZ-3jdvQNruhBxpygYRZAP2bkn35CCO-Q,6307
-moai_adk/templates/.moai/config.json,sha256=0DZ9zK3wUD2lRfeqX93tYJz5Pb_h7DV4k2wyB9RZ6HQ,2202
+moai_adk/templates/.moai/config.json,sha256=oAL0Gb4jy-dEvhnPvitkc95dckzAU5w95mekV514YX0,2348
 moai_adk/templates/.moai/memory/CLAUDE-AGENTS-GUIDE.md,sha256=37Qj5DYcyUniLM1g8IU7UWFI_16tutZrcAkJc4E5i20,15876
 moai_adk/templates/.moai/memory/CLAUDE-PRACTICES.md,sha256=Tf3q68X1DiA3MkIBYu7AMXoeparYrDRpyqVI5Nw92OY,12653
 moai_adk/templates/.moai/memory/CLAUDE-RULES.md,sha256=S9GODGRzwwleOmROVtBDa471Ok5NyQLWIkaO_4peHhU,19783
@@ -273,8 +275,8 @@ moai_adk/templates/.moai/project/tech.md,sha256=REecMv8wOvutt-pQZ5nlGk5YdReTan7A
 moai_adk/utils/__init__.py,sha256=VnVfQzzKHvKw4bNdEw5xdscnRQYFrnr-v_TOBr3naPs,225
 moai_adk/utils/banner.py,sha256=znppKd5yo-tTqgyhgPVJjstrTrfcy_v3X1_RFQxP4Fk,1878
 moai_adk/utils/logger.py,sha256=g-m07PGKjK2bKRIInfSn6m-024Bedai-pV_WjZKDeu8,5064
-moai_adk-0.6.3.dist-info/METADATA,sha256=4yC6rqxJJy_b_-4Kjffv4zhbJtUl_xrrfGBPxizHyIU,71251
-moai_adk-0.6.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-moai_adk-0.6.3.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
-moai_adk-0.6.3.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
-moai_adk-0.6.3.dist-info/RECORD,,
+moai_adk-0.7.0.dist-info/METADATA,sha256=lhC1D05uXdGGdJ8PLMERCaBkxt7mfW8IyzInxMD0KCE,71251
+moai_adk-0.7.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+moai_adk-0.7.0.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
+moai_adk-0.7.0.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
+moai_adk-0.7.0.dist-info/RECORD,,