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

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,8 +137,6 @@ 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)

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
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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

@@ -20,7 +20,7 @@ allowed-tools:
 ---
 
 # 📋 MoAI-ADK Step 0: Initialize/Update Universal Language Support Project Documentation
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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)
@@ -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
@@ -543,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**:
@@ -806,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
 
@@ -847,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.
 
@@ -992,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

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.
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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
 
@@ -186,7 +186,7 @@ User input: $ARGUMENTS
 
 ### User verification steps
 
-After reviewing your implementation plan, Alfred invokes `Skill("moai-alfred-interactive-questions")` to present the following options:
+After reviewing your implementation plan, Alfred invokes `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` to present the following options:
 - **"Go"** or **"Start"**: Start writing the plan as planned
 - **"Modify [Content]"**: Request modifications to the plan
 - **"Stop"**: Stop writing the plan
@@ -195,7 +195,7 @@ After reviewing your implementation plan, Alfred invokes `Skill("moai-alfred-int
 
 ## 🚀 STEP 2: Create plan document (after user approval)
 
-After user approval (collected via `Skill("moai-alfred-interactive-questions")`), call the spec-builder and git-manager agents using the **Task tool**.
+After user approval (collected via `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`), call the spec-builder and git-manager agents using the **Task tool**.
 
 ### ⚙️ How to call an agent
 

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
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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
 
@@ -137,7 +137,7 @@ Task tool call example:
           3. TAG chain design
  4. Step-by-step execution plan
  5. Risks and response plans
-6. Create action plan and use `Skill("moai-alfred-interactive-questions")` to confirm the next action with the user
+6. Create action plan and use `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` to confirm the next action with the user
  (Optional) Explore results: $EXPLORE_RESULTS"
 ```
 
@@ -181,7 +181,7 @@ After reviewing the action plan, select one of the following:
 
 ## 🚀 STEP 2: Execute task (after user approval)
 
-After user approval (gathered through `Skill("moai-alfred-interactive-questions")`), **call the tdd-implementer agent using the Task tool**.
+After user approval (gathered through `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`), **call the tdd-implementer agent using the Task tool**.
 
 ### ⚙️ How to call an agent
 
@@ -266,7 +266,7 @@ The `implementation-planner` agent does the following:
 2. **Library selection**: Check the latest stable version and verify compatibility through WebFetch
 3. **TAG chain design**: Determine TAG order and dependency
 4. **Establishment of implementation strategy**: Step-by-step implementation plan and risk identification
-5. **Create action plan**: Create a structured plan and, via `Skill("moai-alfred-interactive-questions")`, collect user approval before proceeding
+5. **Create action plan**: Create a structured plan and, via `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`, collect user approval before proceeding
 
 ### Phase 2: Task execution phase (after approval)
 

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

@@ -22,14 +22,14 @@ allowed-tools:
 ---
 
 # 📚 MoAI-ADK Step 3: Document Synchronization (+Optional PR Ready)
-> **Note**: Interactive prompts use `Skill("moai-alfred-interactive-questions")` for TUI selection menus. The skill is loaded on-demand when user interaction is required.
+> **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.
 
 ## 🚀 START HERE
 
 **CRITICAL**: Load the TUI Survey Skill FIRST before any user interaction:
 
 ```
-Skill("moai-alfred-interactive-questions")
+AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)
 ```
 
 This Skill MUST be loaded at the very beginning to enable TUI menu rendering for AskUserQuestion calls throughout this workflow.
@@ -45,7 +45,7 @@ Synchronize code changes to Living Documents and verify @TAG system to ensure co
 ## 📋 Execution flow
 
 **Phase 0: Skill Loading** (IMMEDIATE)
-- Load `Skill("moai-alfred-interactive-questions")` at the very start
+- Load `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` at the very start
 - This enables TUI menu rendering for all user interactions
 
 **Phase 1: Analysis & Planning**
@@ -243,7 +243,7 @@ To skip pre-verification, use the `/alfred:3-sync --skip-pre-check` option.
 
 ### User verification steps
 
-After reviewing your sync plan, `Skill("moai-alfred-interactive-questions")` presents the following options for user decision:
+After reviewing your sync plan, `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` presents the following options for user decision:
 - **"Proceed"** or **"Start"**: Start synchronization as planned
 - **"Modify [Contents]"**: Request modifications to your sync plan
 - **"Abort"**: Abort the sync operation
@@ -252,7 +252,7 @@ After reviewing your sync plan, `Skill("moai-alfred-interactive-questions")` pre
 
 ## 🚀 STEP 2: Execute document synchronization (after user approval)
 
-After user approval (collected via `Skill("moai-alfred-interactive-questions")`), the doc-syncer agent performs **Living Document synchronization and @TAG updates**, and optionally executes PR Ready transitions only in team mode.
+After user approval (collected via `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)`), the doc-syncer agent performs **Living Document synchronization and @TAG updates**, and optionally executes PR Ready transitions only in team mode.
 
 ### Phase 2 Details: SPEC Completion Processing (Automatic)
 

moai_adk/templates/.claude/hooks/alfred/core/project.py

@@ -5,11 +5,44 @@ Project information inquiry (language, Git, SPEC progress, etc.)
 """
 
 import json
+import signal
 import subprocess
+from contextlib import contextmanager
 from pathlib import Path
 from typing import Any
 
 
+class TimeoutError(Exception):
+    """Signal-based timeout exception"""
+    pass
+
+
+@contextmanager
+def timeout_handler(seconds: int):
+    """Hard timeout using SIGALRM (works on Unix systems including macOS)
+
+    This uses kernel-level signal to interrupt ANY blocking operation,
+    even if subprocess.run() timeout fails on macOS.
+
+    Args:
+        seconds: Timeout duration in seconds
+
+    Raises:
+        TimeoutError: If operation exceeds timeout
+    """
+    def _handle_timeout(signum, frame):
+        raise TimeoutError(f"Operation timed out after {seconds} seconds")
+
+    # Set the signal handler
+    old_handler = signal.signal(signal.SIGALRM, _handle_timeout)
+    signal.alarm(seconds)
+    try:
+        yield
+    finally:
+        signal.alarm(0)  # Disable alarm
+        signal.signal(signal.SIGALRM, old_handler)
+
+
 def detect_language(cwd: str) -> str:
     """Detect project language (supports 20 items languages)
 
@@ -89,9 +122,10 @@ def detect_language(cwd: str) -> str:
 
 
 def _run_git_command(args: list[str], cwd: str, timeout: int = 2) -> str:
-    """Git command execution helper function
+    """Git command execution with HARD timeout protection
 
     Safely execute Git commands and return output.
+    Uses SIGALRM (kernel-level interrupt) to handle macOS subprocess timeout bug.
     Eliminates code duplication and provides consistent error handling.
 
     Args:
@@ -103,29 +137,46 @@ def _run_git_command(args: list[str], cwd: str, timeout: int = 2) -> str:
         Git command output (stdout, removing leading and trailing spaces)
 
     Raises:
-        subprocess.TimeoutExpired: Timeout exceeded
+        subprocess.TimeoutExpired: Timeout exceeded (via TimeoutError)
         subprocess.CalledProcessError: Git command failed
 
     Examples:
         >>> _run_git_command(["branch", "--show-current"], ".")
         'main'
+
+    TDD History:
+        - RED: Git command hang scenario test
+        - GREEN: SIGALRM-based timeout implementation
+        - REFACTOR: Exception conversion to subprocess.TimeoutExpired
     """
-    result = subprocess.run(
-        ["git"] + args,
-        cwd=cwd,
-        capture_output=True,
-        text=True,
-        timeout=timeout,
-        check=True,
-    )
-    return result.stdout.strip()
+    try:
+        with timeout_handler(timeout):
+            result = subprocess.run(
+                ["git"] + args,
+                cwd=cwd,
+                capture_output=True,
+                text=True,
+                check=False,  # Don't raise on non-zero exit - we'll check manually
+            )
+
+            # Check exit code manually
+            if result.returncode != 0:
+                raise subprocess.CalledProcessError(
+                    result.returncode, ["git"] + args, result.stdout, result.stderr
+                )
+
+            return result.stdout.strip()
+
+    except TimeoutError:
+        # Convert to subprocess.TimeoutExpired for consistent error handling
+        raise subprocess.TimeoutExpired(["git"] + args, timeout)
 
 
 def get_git_info(cwd: str) -> dict[str, Any]:
     """Gather Git repository information
 
     View the current status of a Git repository.
-    Returns the branch name, commit hash, and number of changes.
+    Returns the branch name, commit hash, number of changes, and last commit message.
     If it is not a Git repository, it returns an empty dictionary.
 
     Args:
@@ -136,12 +187,13 @@ def get_git_info(cwd: str) -> dict[str, Any]:
         - branch: Current branch name (str)
         - commit: Current commit hash (str, full hash)
         - changes: Number of changed files (int, staged + unstaged)
+        - last_commit: Last commit message (str, subject only)
 
         Empty dictionary {} if it is not a Git repository or the query fails.
 
     Examples:
         >>> get_git_info("/path/to/git/repo")
-        {'branch': 'main', 'commit': 'abc123...', 'changes': 3}
+        {'branch': 'main', 'commit': 'abc123...', 'changes': 3, 'last_commit': 'Fix bug'}
         >>> get_git_info("/path/to/non-git")
         {}
 
@@ -149,11 +201,13 @@ def get_git_info(cwd: str) -> dict[str, Any]:
         - Timeout: 2 seconds for each Git command
         - Security: Safe execution with subprocess.run(shell=False)
         - Error handling: Returns an empty dictionary in case of all exceptions
+        - Commit message limited to 50 characters for display purposes
 
     TDD History:
         - RED: 3 items scenario test (Git repo, non-Git, error)
         - GREEN: Implementation of subprocess-based Git command execution
         - REFACTOR: Add timeout (2 seconds), strengthen exception handling, remove duplicates with helper function
+        - UPDATE: Added last_commit message field for SessionStart display
     """
     try:
         # Check if it's a git repository
@@ -165,10 +219,16 @@ def get_git_info(cwd: str) -> dict[str, Any]:
         status_output = _run_git_command(["status", "--short"], cwd)
         changes = len([line for line in status_output.splitlines() if line])
 
+        # Get last commit message (subject only, limited to 50 chars)
+        last_commit = _run_git_command(["log", "-1", "--format=%s"], cwd)
+        if len(last_commit) > 50:
+            last_commit = last_commit[:47] + "..."
+
         return {
             "branch": branch,
             "commit": commit,
             "changes": changes,
+            "last_commit": last_commit,
         }
 
     except (subprocess.TimeoutExpired, subprocess.CalledProcessError, FileNotFoundError):
@@ -276,9 +336,81 @@ def get_project_language(cwd: str) -> str:
     return detect_language(cwd)
 
 
+def get_package_version_info() -> dict[str, Any]:
+    """Check MoAI-ADK current and latest version from PyPI
+
+    Compares the installed version with the latest version available on PyPI.
+    Returns version information for SessionStart hook to display update recommendations.
+
+    Returns:
+        dict with keys:
+            - "current": Current installed version
+            - "latest": Latest version available on PyPI
+            - "update_available": Boolean indicating if update is available
+            - "upgrade_command": Recommended upgrade command (if update available)
+
+    Note:
+        - Has 1-second timeout to avoid blocking SessionStart
+        - Returns graceful fallback if PyPI check fails
+        - Handles version parsing gracefully
+    """
+    from importlib.metadata import version, PackageNotFoundError
+    import urllib.request
+    import urllib.error
+
+    result = {
+        "current": "unknown",
+        "latest": "unknown",
+        "update_available": False,
+        "upgrade_command": ""
+    }
+
+    # Get current version
+    try:
+        result["current"] = version("moai-adk")
+    except PackageNotFoundError:
+        result["current"] = "dev"
+        return result
+
+    # Get latest version from PyPI (with 1-second timeout)
+    try:
+        with timeout_handler(1):
+            url = "https://pypi.org/pypi/moai-adk/json"
+            headers = {"Accept": "application/json"}
+            req = urllib.request.Request(url, headers=headers)
+            with urllib.request.urlopen(req, timeout=0.8) as response:
+                data = json.load(response)
+                result["latest"] = data.get("info", {}).get("version", "unknown")
+    except (urllib.error.URLError, TimeoutError, Exception):
+        # Network error or timeout - return with unknown latest version
+        return result
+
+    # Compare versions (simple comparison)
+    if result["current"] != "unknown" and result["latest"] != "unknown":
+        try:
+            # Parse versions for comparison
+            current_parts = [int(x) for x in result["current"].split(".")]
+            latest_parts = [int(x) for x in result["latest"].split(".")]
+
+            # Pad shorter version with zeros
+            max_len = max(len(current_parts), len(latest_parts))
+            current_parts.extend([0] * (max_len - len(current_parts)))
+            latest_parts.extend([0] * (max_len - len(latest_parts)))
+
+            if latest_parts > current_parts:
+                result["update_available"] = True
+                result["upgrade_command"] = f"uv pip install --upgrade moai-adk>={result['latest']}"
+        except (ValueError, AttributeError):
+            # Version parsing failed - skip comparison
+            pass
+
+    return result
+
+
 __all__ = [
     "detect_language",
     "get_git_info",
     "count_specs",
     "get_project_language",
+    "get_package_version_info",
 ]

moai_adk/templates/.claude/hooks/alfred/handlers/session.py

@@ -6,14 +6,16 @@ SessionStart, SessionEnd event handling
 
 from core import HookPayload, HookResult
 from core.checkpoint import list_checkpoints
-from core.project import count_specs, detect_language, get_git_info
+from core.project import count_specs, detect_language, get_git_info, get_package_version_info
 
 
 def handle_session_start(payload: HookPayload) -> HookResult:
-    """SessionStart event handler (with Checkpoint list)
+    """SessionStart event handler with GRACEFUL DEGRADATION
 
     When Claude Code Session starts, it displays a summary of project status.
     You can check the language, Git status, SPEC progress, and checkpoint list at a glance.
+    All optional operations are wrapped in try-except to ensure hook completes quickly even if
+    Git commands, file I/O, or other operations timeout or fail.
 
     Args:
         payload: Claude Code event payload (cwd key required)
@@ -24,15 +26,23 @@ def handle_session_start(payload: HookPayload) -> HookResult:
     Message Format:
         🚀 MoAI-ADK Session Started
            Language: {language}
-           Branch: {branch} ({commit hash})
-           Changes: {Number of Changed Files}
-           SPEC Progress: {Complete}/{Total} ({percent}%)
-           Checkpoints: {number} available (showing the latest 3 items)
+           [Branch: {branch} ({commit hash})] - optional if git fails
+           [Changes: {Number of Changed Files}] - optional if git fails
+           [SPEC Progress: {Complete}/{Total} ({percent}%)] - optional if specs fail
+           [Checkpoints: {number} available] - optional if checkpoint list fails
+
+    Graceful Degradation Strategy:
+        - CRITICAL: Language detection (must succeed - no try-except)
+        - OPTIONAL: Git info (skip if timeout/failure)
+        - OPTIONAL: SPEC progress (skip if timeout/failure)
+        - OPTIONAL: Checkpoint list (skip if timeout/failure)
+        - Always display SOMETHING to user, never return empty message
 
     Note:
         - Claude Code processes SessionStart in several stages (clear → compact)
         - Display message only at "compact" stage to prevent duplicate output
         - "clear" step returns minimal result (empty hookSpecificOutput)
+        - CRITICAL: All optional operations must complete within 2-3 seconds total
 
     TDD History:
         - RED: Session startup message format test
@@ -40,8 +50,10 @@ def handle_session_start(payload: HookPayload) -> HookResult:
         - REFACTOR: Improved message format, improved readability, added checkpoint list
         - FIX: Prevent duplicate output of clear step (only compact step is displayed)
         - UPDATE: Migrated to Claude Code standard Hook schema
+        - HOTFIX: Add graceful degradation for timeout scenarios (Issue #66)
 
     @TAG:CHECKPOINT-EVENT-001
+    @TAG:HOOKS-TIMEOUT-001
     """
     # Claude Code SessionStart runs in several stages (clear, compact, etc.)
     # Ignore the "clear" stage and output messages only at the "compact" stage
@@ -51,32 +63,90 @@ def handle_session_start(payload: HookPayload) -> HookResult:
         return HookResult(continue_execution=True)
 
     cwd = payload.get("cwd", ".")
+
+    # CRITICAL: Language detection - MUST succeed (no try-except)
     language = detect_language(cwd)
-    git_info = get_git_info(cwd)
-    specs = count_specs(cwd)
-    checkpoints = list_checkpoints(cwd, max_count=10)
 
-    branch = git_info.get("branch", "N/A")
-    commit = git_info.get("commit", "N/A")[:7]
-    changes = git_info.get("changes", 0)
-    spec_progress = f"{specs['completed']}/{specs['total']}"
+    # OPTIONAL: Git info - skip if timeout/failure
+    git_info = {}
+    try:
+        git_info = get_git_info(cwd)
+    except Exception:
+        # Graceful degradation - continue without git info
+        pass
+
+    # OPTIONAL: SPEC progress - skip if timeout/failure
+    specs = {"completed": 0, "total": 0, "percentage": 0}
+    try:
+        specs = count_specs(cwd)
+    except Exception:
+        # Graceful degradation - continue without spec info
+        pass
+
+    # OPTIONAL: Checkpoint list - skip if timeout/failure
+    checkpoints = []
+    try:
+        checkpoints = list_checkpoints(cwd, max_count=10)
+    except Exception:
+        # Graceful degradation - continue without checkpoints
+        pass
+
+    # OPTIONAL: Package version info - skip if timeout/failure
+    version_info = {}
+    try:
+        version_info = get_package_version_info()
+    except Exception:
+        # Graceful degradation - continue without version info
+        pass
+
+    # Build message with available information
+    branch = git_info.get("branch", "N/A") if git_info else "N/A"
+    commit = git_info.get("commit", "N/A")[:7] if git_info else "N/A"
+    changes = git_info.get("changes", 0) if git_info else 0
+    spec_progress = f"{specs['completed']}/{specs['total']}" if specs["total"] > 0 else "0/0"
 
     # system_message: displayed directly to the user
     lines = [
         "🚀 MoAI-ADK Session Started",
-        f"   Language: {language}",
-        f"   Branch: {branch} ({commit})",
-        f"   Changes: {changes}",
-        f"   SPEC Progress: {spec_progress} ({specs['percentage']}%)",
+        "",  # Blank line after title
     ]
 
+    # Add version info first (at the top, right after title)
+    if version_info and version_info.get("current") != "unknown":
+        version_line = f"   🗿 MoAI-ADK Ver: {version_info['current']}"
+        if version_info.get("update_available"):
+            version_line += f" → {version_info['latest']} available ✨"
+        lines.append(version_line)
+
+        # Add upgrade recommendation if update is available
+        if version_info.get("update_available") and version_info.get("upgrade_command"):
+            lines.append(f"   ⬆️ Upgrade: {version_info['upgrade_command']}")
+
+    # Add language info
+    lines.append(f"   🐍 Language: {language}")
+
+    # Add Git info only if available (not degraded)
+    if git_info:
+        lines.append(f"   🌿 Branch: {branch} ({commit})")
+        lines.append(f"   📝 Changes: {changes}")
+
+        # Add last commit message if available
+        last_commit = git_info.get("last_commit", "")
+        if last_commit:
+            lines.append(f"   🔨 Last: {last_commit}")
+
     # Add Checkpoint list (show only the latest 3 items)
     if checkpoints:
-        lines.append(f"   Checkpoints: {len(checkpoints)} available")
+        lines.append(f"   🗂️  Checkpoints: {len(checkpoints)} available")
         for cp in reversed(checkpoints[-3:]):  # Latest 3 items
             branch_short = cp["branch"].replace("before-", "")
-            lines.append(f"      - {branch_short}")
-        lines.append("   Restore: /alfred:0-project restore")
+            lines.append(f"      📌 {branch_short}")
+        lines.append("")  # Blank line before restore command
+        lines.append("   ↩️  Restore: /alfred:0-project restore")
+
+    # Add SPEC progress only if available (not degraded) - at the bottom
+    if specs["total"] > 0:
+        lines.append(f"   📋 SPEC Progress: {spec_progress} ({specs['percentage']}%)")
 
     system_message = "\n".join(lines)
 

moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md

@@ -8,7 +8,7 @@ description: "Agent-based coding mode that integrates hands-on development and c
 ---
 
 # Agentic Coding
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> Interactive prompts rely on `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
 
 **Audience**: Professional developers, team leaders, architects
 

moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md

@@ -8,7 +8,7 @@ description: "Learning mode to easily learn MoAI-ADK concepts and workflow"
 ---
 
 # MoAI ADK Learning
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> Interactive prompts rely on `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
 
 **Audience**: Developers new to MoAI-ADK
 

moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md

@@ -8,7 +8,7 @@ description: "Learning mode to easily learn new skills with Alfred"
 ---
 
 # Study with Alfred
-> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> Interactive prompts rely on `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
 
 **Audience**: Developers looking to learn new technologies/languages/frameworks
 

moai_adk/templates/CLAUDE.md

@@ -6,7 +6,7 @@
 > **Project Owner**: {{PROJECT_OWNER}}
 > **Config**: `.moai/config.json`
 >
-> **Note**: `Skill("moai-alfred-interactive-questions")` provides TUI-based responses when user interaction is needed. The skill loads on-demand.
+> **Note**: `AskUserQuestion tool (documented in moai-alfred-interactive-questions skill)` provides TUI-based responses when user interaction is needed. The skill loads on-demand.
 
 ---
 
@@ -213,6 +213,72 @@ Combine layers when necessary: a command triggers sub-agents, sub-agents activat
 
 ---
 
+## ⚡ Alfred Command Completion Pattern
+
+**CRITICAL RULE**: When any Alfred command (`/alfred:0-project`, `/alfred:1-plan`, `/alfred:2-run`, `/alfred:3-sync`) completes, **ALWAYS use `AskUserQuestion` tool** to ask the user what to do next.
+
+### Pattern for Each Command
+
+#### `/alfred:0-project` Completion
+```
+After project initialization completes:
+├─ Use AskUserQuestion to ask:
+│  ├─ Option 1: Proceed to /alfred:1-plan (plan specifications)
+│  ├─ Option 2: Start new session with /clear
+│  └─ Option 3: Review project structure
+└─ DO NOT suggest multiple next steps in prose - use AskUserQuestion only
+```
+
+#### `/alfred:1-plan` Completion
+```
+After planning completes:
+├─ Use AskUserQuestion to ask:
+│  ├─ Option 1: Proceed to /alfred:2-run (implement SPEC)
+│  ├─ Option 2: Revise SPEC before implementation
+│  └─ Option 3: Start new session with /clear
+└─ DO NOT suggest multiple next steps in prose - use AskUserQuestion only
+```
+
+#### `/alfred:2-run` Completion
+```
+After implementation completes:
+├─ Use AskUserQuestion to ask:
+│  ├─ Option 1: Proceed to /alfred:3-sync (synchronize docs)
+│  ├─ Option 2: Run additional tests/validation
+│  └─ Option 3: Start new session with /clear
+└─ DO NOT suggest multiple next steps in prose - use AskUserQuestion only
+```
+
+#### `/alfred:3-sync` Completion
+```
+After sync completes:
+├─ Use AskUserQuestion to ask:
+│  ├─ Option 1: Return to /alfred:1-plan (next feature)
+│  ├─ Option 2: Merge PR to main
+│  └─ Option 3: Complete session
+└─ DO NOT suggest multiple next steps in prose - use AskUserQuestion only
+```
+
+### Implementation Rules
+
+1. **Always use AskUserQuestion** - Never suggest next steps in prose (e.g., "You can now run `/alfred:1-plan`...")
+2. **Provide 3-4 clear options** - Not open-ended or free-form
+3. **Language**: Present options in user's `conversation_language` (Korean, Japanese, etc.)
+4. **Question format**: Use the `moai-alfred-interactive-questions` skill documentation as reference (don't invoke Skill())
+
+### Example (Correct Pattern)
+```markdown
+# CORRECT ✅
+After project setup, use AskUserQuestion tool to ask:
+- "프로젝트 초기화가 완료되었습니다. 다음으로 뭘 하시겠습니까?"
+- Options: 1) 스펙 작성 진행 2) 프로젝트 구조 검토 3) 새 세션 시작
+
+# INCORRECT ❌
+Your project is ready. You can now run `/alfred:1-plan` to start planning specs...
+```
+
+---
+
 ## Project Information
 
 - **Name**: MoAI-ADK

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.7.0
+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.7.0.dist-info → moai_adk-0.8.0.dist-info}/RECORD

@@ -27,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=MZXqzYZA4OrZT0xViplyOUVRchiSaEWeTEmyzkSHEQY,10997
+moai_adk/core/project/phase_executor.py,sha256=xd7wREmZPjNDO-sHv5CDLjPS8NsmhvQ-qv2m9AVQ9QY,10998
 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
@@ -40,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=F1KjJb2HPT887aW9HBGezm2lh0wfNZcN5GLOF2aTo_k,11318
+moai_adk/templates/CLAUDE.md,sha256=SIuw1GLq5w6Mh1ejhnKQ8IlnJKjUs5FmSG8EkL4-N6w,13839
 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=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=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/agents/alfred/cc-manager.md,sha256=ievRB2BMAXjQ6iepWTLTCIHR9Dc4_L-Ab-dqhKQDdxE,8382
+moai_adk/templates/.claude/agents/alfred/debug-helper.md,sha256=C6jF54jsbI1y4xmb6s-MWVpuYISaFDQzY88M_HJhurw,7289
+moai_adk/templates/.claude/agents/alfred/doc-syncer.md,sha256=iFP09SKUEMfb4OdMT3gMBakwHf0UvIaBfQHhb0YzdWo,8704
+moai_adk/templates/.claude/agents/alfred/git-manager.md,sha256=t3iDdVgs0TZUQRHQS_F9GtLcAvnXWihM7t2oy_BPJBQ,14142
+moai_adk/templates/.claude/agents/alfred/implementation-planner.md,sha256=Xysj1KinbZt-PTw0Sx1bGFlTCxBuQGFfTCNLdatjb8E,11613
+moai_adk/templates/.claude/agents/alfred/project-manager.md,sha256=N-CaSiWnCdaJXWM3tZegMg4ispm-ioHKnuzmUdwQ2YE,15111
+moai_adk/templates/.claude/agents/alfred/quality-gate.md,sha256=_OebbNOxpKmUAde1zmjjYL8UrniFnIp710xFd7EtuU0,10779
+moai_adk/templates/.claude/agents/alfred/skill-factory.md,sha256=EUXtroq8qN22vAqyMxHgGLx7TVOe_in3quEB6K1HmS8,26467
+moai_adk/templates/.claude/agents/alfred/spec-builder.md,sha256=xGUYsGXB40lBcvmlONIx3tK4iUOVNRFfPatCXNDJonE,12575
+moai_adk/templates/.claude/agents/alfred/tag-agent.md,sha256=_ydlDocuxal89jGwpGIfQLfEbcCUDNoj8CDyDONRRYg,9679
+moai_adk/templates/.claude/agents/alfred/tdd-implementer.md,sha256=qTDJotSnK1KSxe2j6Kpvx0qLYwmzu0e9lKHmD6PVwgc,10285
+moai_adk/templates/.claude/agents/alfred/trust-checker.md,sha256=Vc5ReZjdl1FAifg_9qKt2MYWAdMHmq2psda-kyVhtVI,13663
+moai_adk/templates/.claude/commands/alfred/0-project.md,sha256=Acx7045n1e6-GC1g6QDePVoI2tOGC_fZFvokgrvz_T8,46704
+moai_adk/templates/.claude/commands/alfred/1-plan.md,sha256=wHROuePWaQwrbRm4SL4369vD7EpzKpVRvQBcWPcpUw0,25272
+moai_adk/templates/.claude/commands/alfred/2-run.md,sha256=KTUuQQPheLr0YY79asbK0oH9ajlp8vDsQC_2c8BvzWY,20956
+moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=WNlBzf5I_mDbdWhcITYE7oiHziHD1UQOG-HD12sqSwQ,23162
 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
@@ -66,16 +66,16 @@ moai_adk/templates/.claude/hooks/alfred/test_hook_output.py,sha256=3pk-JBUPdSQZB
 moai_adk/templates/.claude/hooks/alfred/core/__init__.py,sha256=nx_02kZDVFlKOgxBfFz3nqVrxMkmrkE0x7crJhdjl5E,6377
 moai_adk/templates/.claude/hooks/alfred/core/checkpoint.py,sha256=dsvFDSXQNSQlaQLpvhqFbytGOrOivyovi43Y18EmNeI,8483
 moai_adk/templates/.claude/hooks/alfred/core/context.py,sha256=RQd6yk8OGT-twgYtUiNmJIL-UEt_h4oktxqiRP_wXAI,2103
-moai_adk/templates/.claude/hooks/alfred/core/project.py,sha256=XVm-Y5TVjBBznW8AkFhk_uVg-EF1lZ2wx59Rxt_LOBA,9125
+moai_adk/templates/.claude/hooks/alfred/core/project.py,sha256=Jgm8BEJOtCywiO83k2rcoGtzFYPeTXHd5LcMsP2MVsI,14141
 moai_adk/templates/.claude/hooks/alfred/core/tags.py,sha256=XcYYCS1VmCejp7Ga9xZ3hDfrWWsKM-WyPD_N5gY1q1w,6359
 moai_adk/templates/.claude/hooks/alfred/handlers/__init__.py,sha256=j5L7nayKt7tnFQOZuO5sWiie815vmbmYJOn2VRiidLY,569
 moai_adk/templates/.claude/hooks/alfred/handlers/notification.py,sha256=8TcEqGlz4EpLf2lpouaIuhVbpKOVeY31KPmIq2snt9U,662
-moai_adk/templates/.claude/hooks/alfred/handlers/session.py,sha256=jGmiDPY-unTlQlTWQVisr82Rxhbt1Rkhrun4bggTxQ4,3374
+moai_adk/templates/.claude/hooks/alfred/handlers/session.py,sha256=gFrkTcBRQrDR0p5o79KvhN1LuGdmIVQyWg0fk1YD8l8,6397
 moai_adk/templates/.claude/hooks/alfred/handlers/tool.py,sha256=0bNtAf2M7nupTAkcrEiZMBCmD2f-dLjjZa5p1CWiNyM,3383
 moai_adk/templates/.claude/hooks/alfred/handlers/user.py,sha256=PyQI201oezWBzLrKo8ntWoRa9GDyVwLYktdu9vLT84s,1389
-moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md,sha256=JyhPcBT3jrdGtYpOE_qQ_B4dgzizMN53ZEqoKHw6GPU,19668
-moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md,sha256=eBuM8tGVdKVXGecXA7WlmxWatTXWPF-dmpm-rZ4IEEw,17549
-moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md,sha256=GItPQ1wndOh5kGf8g-tdhmxGcqj6wCCRDxI7urO0AAU,12598
+moai_adk/templates/.claude/output-styles/alfred/agentic-coding.md,sha256=xxqVTxNwBEQahaerqeFYDEAErPNLw_-W1orWXYLuwtU,19702
+moai_adk/templates/.claude/output-styles/alfred/moai-adk-learning.md,sha256=Et9BlQkja_jOIVp7NLBVxCGU7H0H-qoEe_9LNaVis3k,17583
+moai_adk/templates/.claude/output-styles/alfred/study-with-alfred.md,sha256=XpIj9c4jqOOlZxn57Ujj8o7VIpAx_ftddwwd0fxIsio,12632
 moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/SKILL.md,sha256=7g_jQgyK-E_ogg4Hk1ueNdn9bRappOSYSNnjd4JMIK8,2406
 moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/examples.md,sha256=r5_lripZ45AeKpOcUSzmUl_DuioI18Xe84U05f1vDMI,403
 moai_adk/templates/.claude/skills/moai-alfred-ears-authoring/reference.md,sha256=Xw_hzLdsfN3zo7BUk2A-rQGohSM5btw6mh12yz1MbPE,339
@@ -275,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.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,,
+moai_adk-0.8.0.dist-info/METADATA,sha256=rKLmKLvWkLBTzpf5UN8I0WHgWdYJF5Q-yEDmNZ6xkag,71251
+moai_adk-0.8.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+moai_adk-0.8.0.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
+moai_adk-0.8.0.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
+moai_adk-0.8.0.dist-info/RECORD,,