moai-adk 0.6.3__tar.gz → 0.8.0__tar.gz

{moai_adk-0.6.3 → moai_adk-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.6.3
+Version: 0.8.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 → moai_adk-0.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "moai-adk"
-version = "0.6.3"
+version = "0.8.0"
 description = "MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent & Complete Skills v2.0"
 readme = "README.md"
 requires-python = ">=3.13"

moai_adk-0.8.0/src/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-0.8.0/src/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-0.6.3 → moai_adk-0.8.0}/src/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-0.6.3 → moai_adk-0.8.0}/src/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-0.6.3 → moai_adk-0.8.0}/src/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-0.6.3 → moai_adk-0.8.0}/src/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-0.6.3 → moai_adk-0.8.0}/src/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-0.6.3 → moai_adk-0.8.0}/src/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-0.6.3 → moai_adk-0.8.0}/src/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-0.6.3 → moai_adk-0.8.0}/src/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-0.6.3 → moai_adk-0.8.0}/src/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-0.6.3 → moai_adk-0.8.0}/src/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-0.6.3 → moai_adk-0.8.0}/src/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-0.6.3 → moai_adk-0.8.0}/src/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-0.6.3 → moai_adk-0.8.0}/src/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