moai-adk 0.4.7__py3-none-any.whl → 0.4.8__py3-none-any.whl

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

@@ -16,7 +16,7 @@ allowed-tools:
 ---
 
 # 📋 MoAI-ADK Step 0: Initialize/Update Universal Language Support Project Documentation
-> Interactive prompts rely on `Skill("moai-alfred-tui-survey")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
 
 ## 🎯 Command Purpose
 
@@ -33,10 +33,10 @@ Automatically analyzes the project environment to create/update product/structur
 
 ## 🧠 Associated Skills & Agents
 
-| Agent | Core Skill | Purpose |
-| ----- | -------- | ------- |
+| Agent           | Core Skill                       | Purpose                                       |
+| --------------- | -------------------------------- | --------------------------------------------- |
 | project-manager | `moai-alfred-language-detection` | Initialize project and interview requirements |
-| trust-checker | `moai-alfred-trust-validation` | Verify initial project structure (optional) |
+| trust-checker   | `moai-alfred-trust-validation`   | Verify initial project structure (optional)   |
 
 **Note**: TUI Survey Skill is used for user confirmations during project initialization and is shared across all interactive prompts.
 
@@ -88,20 +88,32 @@ The user executes the `/alfred:8-project` command to start analyzing the project
 
 ---
 
-## 🚀 STEP 0: Conversation Language Selection (NEW in v0.4.2)
+## 🚀 STEP 0: 초기 설정 - 언어 및 사용자 정보 선택
 
-**Purpose**: Establish the conversation language before project initialization begins. This selection applies to all Alfred prompts, interview questions, and generated documentation.
+**목적**: 프로젝트 초기화 시작 전에 대화 언어를 설정하고 사용자 닉네임을 등록합니다. 이 설정은 모든 Alfred 프롬프트, 인터뷰 질문 및 생성된 문서에 적용됩니다.
 
-### 0.1 Display Language Selection Menu
+### 0.0 Alfred 자기소개 및 환영 인사
 
-Alfred displays a language selection menu as the **very first interaction** using `Skill("moai-alfred-tui-survey")`:
+Alfred가 첫 상호작용으로 다음과 같이 인사합니다:
+
+```
+안녕하세요! 👋 저는 Alfred입니다.
+MoAI-ADK의 SuperAgent로서 당신의 프로젝트를 함께 만들어갈 준비가 되어 있습니다.
+
+앞으로의 모든 대화에서 당신을 편하게 부르기 위해,
+먼저 기본 설정을 진행하겠습니다.
+```
+
+### 0.1 언어 선택
+
+Alfred가 `Skill("moai-alfred-interactive-questions")` 를 사용하여 **첫 번째 상호작용**으로 언어 선택 메뉴를 표시합니다:
 
 **Question**:
 ```
 Which language would you like to use for the project initialization and documentation?
 ```
 
-**Options** (AskUserQuestion with moai-alfred-tui-survey):
+**Options** (AskUserQuestion with moai-alfred-interactive-questions):
 - **English** (en) — All dialogs and documentation in English
 - **한국어** (ko) — All dialogs and documentation in Korean
 - **日本語** (ja) — All dialogs and documentation in Japanese
@@ -126,22 +138,66 @@ This language preference is:
 - Used to generate all documentation in the selected language
 - Displayed in CLAUDE.md under "## Project Information"
 
-### 0.3 Transition to STEP 1
+### 0.2.5 사용자 닉네임 선택
 
-After language selection, all subsequent interactions proceed in the selected language:
-- Alfred's prompts are translated
-- project-manager sub-agent receives language parameter
-- Interview questions are in the selected language
-- Generated documents (product.md, structure.md, tech.md) are in the selected language
-- CLAUDE.md displays the selected language prominently
+언어 선택 완료 후, Alfred가 `Skill("moai-alfred-interactive-questions")` 를 사용하여 사용자 닉네임을 요청합니다:
 
-**Example output for Korean selection**:
-```markdown
-✅ 언어 선택 완료: 한국어 (ko)
+**질문**:
+```
+앞으로 대화에서 당신을 어떻게 부르면 좋을까요?
+(예: GOOS, 팀장님, 개발자님, 또는 자유롭게 입력)
+```
+
+**입력 방식**:
+- 텍스트 직접 입력 가능 (자유 형식)
+- 예시: "GOOS", "팀장", "개발자" 등
+- 최대 20자 한도
+
+### 0.2.6 사용자 정보 저장
+
+Alfred가 선택된 닉네임을 다음과 같이 저장합니다:
+
+```json
+{
+  "conversation_language": "ko",
+  "conversation_language_name": "한국어",
+  "user_nickname": "GOOS",
+  "selected_at": "2025-10-23T12:34:56Z"
+}
+```
+
+이 정보는:
+- 모든 sub-agents 에게 컨텍스트 파라미터로 전달됨
+- `.moai/config.json` 의 `user` 필드에 저장됨
+- CLAUDE.md의 `{{USER_NICKNAME}}` 변수로 치환됨
+- 모든 Alfred 대화에서 사용됨
+
+**예시**:
+```
+안녕하세요, GOOS님! 👋
 
 이제 프로젝트 환경 분석으로 진행하겠습니다...
 ```
 
+### 0.3 STEP 1로 전환
+
+언어 및 사용자 정보 설정 완료 후, 모든 후속 상호작용이 선택된 언어로 진행됩니다:
+- Alfred의 모든 프롬프트가 선택된 언어로 번역됨
+- project-manager sub-agent이 언어 및 사용자 정보 파라미터를 수신
+- 인터뷰 질문이 선택된 언어로 진행됨
+- 생성된 문서 (product.md, structure.md, tech.md)가 선택된 언어로 작성됨
+- CLAUDE.md가 선택된 언어와 사용자 닉네임을 표시함
+
+**한국어 선택 시 출력 예시**:
+```markdown
+✅ 설정 완료!
+
+언어: 한국어 (ko)
+닉네임: GOOS
+
+이제 GOOS님의 프로젝트 환경 분석으로 진행하겠습니다...
+```
+
 ---
 
 ## 🚀 STEP 1: Environmental analysis and interview plan development
@@ -168,7 +224,7 @@ grep "optimized" .moai/config.json
 - `optimized: false` in `config.json` (immediately after reinitialization)
 
 **Select user if backup exists**  
-Call `Skill("moai-alfred-tui-survey")` to display a TUI with the following options:
+Call `Skill("moai-alfred-interactive-questions")` 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)
@@ -381,9 +437,9 @@ Set optimization flags after the merge is complete:
  (Choose “Proceed,” “Modify [Content],” or “Abort”)
 ```
 
-### 1.5 Wait for user approval (moai-alfred-tui-survey) (when user selects "New")
+### 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-tui-survey")` and asks whether Phase 2 is approved.
+After Alfred receives the project-manager's interview plan report, calls `Skill("moai-alfred-interactive-questions")` 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
@@ -457,7 +513,7 @@ After the project-manager has finished creating the document, **Alfred can optio
 
 **Note**: Quality verification is optional during the project initialization phase.
 
-### 2.3 Sub-agent moai-alfred-tui-survey (Nested)
+### 2.3 Sub-agent moai-alfred-interactive-questions (Nested)
 
 **The project-manager agent can internally call the TUI survey skill** to check the details of the task.
 
@@ -466,7 +522,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-tui-survey")`,
+**Example** (inside project-manager): Ask whether to "overwrite file" with `Skill("moai-alfred-interactive-questions")`,
 - Allows you to choose between **Overwrite** / **Merge** / **Skip**.
 
 **Nested pattern**:
@@ -729,7 +785,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-tui-survey")`, and selected items are recorded in `CLAUDE.md` and `.moai/config.json`.
+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`.
 
 #### 2.6.0 Create cc-manager briefing
 
@@ -745,21 +801,21 @@ Be sure to include the source (e.g. `product.md@SPEC:SUCCESS-001`) for each item
 
 cc-manager selects the required sub-agents and skills based on the briefing.The table below is a reference guide to help you make a decision, and when making an actual call, the supporting sentences from the relevant document are also delivered.
 
-|Project requirements (document basis) |Recommended sub-agent/skill |Purpose |
-| -------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------ |
-|High quality and coverage goals (`product.md@SPEC:SUCCESS-001`) |`tdd-implementer`, `moai-essentials-debug`, `moai-essentials-review` |Establishment of RED·GREEN·REFACTOR workflow |
-|Traceability/TAG improvement request (`structure.md@DOC:TRACEABILITY-001`) |`doc-syncer`, `moai-alfred-tag-scanning`, `moai-alfred-trust-validation` |Enhanced TAG traceability and document/code synchronization |
-|Deployment automation/branch strategy required (`structure.md` Architecture/TODO) |`git-manager`, `moai-alfred-git-workflow`, `moai-foundation-git` |Branch Strategy·Commit Policy·PR Automation |
-|Refactoring legacy modules (`product.md` BACKLOG, `tech.md` TODO) |`implementation-planner`, `moai-alfred-refactoring-coach`, `moai-essentials-refactor` |Technical Debt Diagnosis and Refactoring Roadmap |
-|Strengthening regulatory/security compliance (`tech.md@DOC:SECURITY-001`) |`quality-gate`, `moai-alfred-trust-validation`, `moai-foundation-trust`, `moai-domain-security` |TRUST S (Secured) and Trackable Compliance, Security Consulting |
-|CLI Automation/Tooling Requirements (`tech.md` BUILD/CLI section) |`implementation-planner`, `moai-domain-cli-tool`, detected language skills (e.g. `moai-lang-python`) |CLI command design, input/output standardization |
-|Data analysis/reporting needs (`product.md` DATA, `tech.md` ANALYTICS) |`implementation-planner`, `moai-domain-data-science`, detected language skills |Data Pipeline·Notebook Job Definition |
-|Improved database structure (`structure.md` DB, `tech.md` STORAGE) |`doc-syncer`, `moai-domain-database`, `moai-alfred-tag-scanning` |Strengthening schema documentation and TAG-DB mapping |
-|DevOps/Infrastructure automation required (`tech.md` DEVOPS, `structure.md` CI/CD) |`implementation-planner`, `moai-domain-devops`, `moai-alfred-git-workflow` |Establishing a deployment pipeline and IaC strategy |
-|Introduction of ML/AI functions (`product.md` AI, `tech.md` MODEL) |`implementation-planner`, `moai-domain-ml`, detected language skills |Model training/inference pipeline definition |
-|Mobile app strategy (`product.md` MOBILE, `structure.md` CLIENT) |`implementation-planner`, `moai-domain-mobile-app`, detected language skills (e.g. `moai-lang-dart`, `moai-lang-swift`) |Mobile client structure design |
-|Strengthening coding standards/review process (`tech.md` REVIEW) |`quality-gate`, `moai-essentials-review`, `moai-alfred-code-reviewer` |Strengthening review checklist and quality reporting |
-|Requires onboarding/training mode (`tech.md` STACK description, etc.) |`moai-alfred-tui-survey`, `moai-adk-learning`, `agentic-coding` Output style |Enhanced interview TUI and automatically provided onboarding materials |
+| Project requirements (document basis)                                              | Recommended sub-agent/skill                                                                                             | Purpose                                                                |
+| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
+| High quality and coverage goals (`product.md@SPEC:SUCCESS-001`)                    | `tdd-implementer`, `moai-essentials-debug`, `moai-essentials-review`                                                    | Establishment of RED·GREEN·REFACTOR workflow                           |
+| Traceability/TAG improvement request (`structure.md@DOC:TRACEABILITY-001`)         | `doc-syncer`, `moai-alfred-tag-scanning`, `moai-alfred-trust-validation`                                                | Enhanced TAG traceability and document/code synchronization            |
+| Deployment automation/branch strategy required (`structure.md` Architecture/TODO)  | `git-manager`, `moai-alfred-git-workflow`, `moai-foundation-git`                                                        | Branch Strategy·Commit Policy·PR Automation                            |
+| Refactoring legacy modules (`product.md` BACKLOG, `tech.md` TODO)                  | `implementation-planner`, `moai-essentials-refactor`                                                                     | Technical Debt Diagnosis and Refactoring Roadmap                       |
+| Strengthening regulatory/security compliance (`tech.md@DOC:SECURITY-001`)          | `quality-gate`, `moai-alfred-trust-validation`, `moai-foundation-trust`, `moai-domain-security`                         | TRUST S (Secured) and Trackable Compliance, Security Consulting        |
+| CLI Automation/Tooling Requirements (`tech.md` BUILD/CLI section)                  | `implementation-planner`, `moai-domain-cli-tool`, detected language skills (e.g. `moai-lang-python`)                    | CLI command design, input/output standardization                       |
+| Data analysis/reporting needs (`product.md` DATA, `tech.md` ANALYTICS)             | `implementation-planner`, `moai-domain-data-science`, detected language skills                                          | Data Pipeline·Notebook Job Definition                                  |
+| Improved database structure (`structure.md` DB, `tech.md` STORAGE)                 | `doc-syncer`, `moai-domain-database`, `moai-alfred-tag-scanning`                                                        | Strengthening schema documentation and TAG-DB mapping                  |
+| DevOps/Infrastructure automation required (`tech.md` DEVOPS, `structure.md` CI/CD) | `implementation-planner`, `moai-domain-devops`, `moai-alfred-git-workflow`                                              | Establishing a deployment pipeline and IaC strategy                    |
+| Introduction of ML/AI functions (`product.md` AI, `tech.md` MODEL)                 | `implementation-planner`, `moai-domain-ml`, detected language skills                                                    | Model training/inference pipeline definition                           |
+| Mobile app strategy (`product.md` MOBILE, `structure.md` CLIENT)                   | `implementation-planner`, `moai-domain-mobile-app`, detected language skills (e.g. `moai-lang-dart`, `moai-lang-swift`) | Mobile client structure design                                         |
+| Strengthening coding standards/review process (`tech.md` REVIEW)                   | `quality-gate`, `moai-essentials-review`                                                                                | Strengthening review checklist and quality reporting                   |
+| Requires onboarding/training mode (`tech.md` STACK description, etc.)              | `moai-alfred-interactive-questions`, `moai-adk-learning`, `agentic-coding` Output style                                 | Enhanced interview TUI and automatically provided onboarding materials |
 
 > **Language/Domain Skill Selection Rules**
 > - Select and add one relevant language skill (`moai-lang-python`, `moai-lang-java`, …) based on the `moai-alfred-language-detection` results or the stack recorded in the Tech section of the briefing.
@@ -770,7 +826,7 @@ If multiple conditions are met, the candidates are merged without duplicates and
 
 #### 2.6.2 User confirmation flow
 
-`Skill("moai-alfred-tui-survey")` asks “whether to enable recommended items.”
+`Skill("moai-alfred-interactive-questions")` 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.
 
@@ -915,7 +971,7 @@ This subcommand is executed under the following conditions:
    ```
 
 4. **Waiting for user approval**  
-`Skill("moai-alfred-tui-survey")` asks “Do you want to proceed with template optimization?” and provides the following options.
+`Skill("moai-alfred-interactive-questions")` 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

@@ -17,7 +17,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-tui-survey")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
 
 ## 🎯 Command Purpose
 
@@ -68,10 +68,10 @@ allowed-tools:
 
 ## 🧠 Associated Skills & Agents
 
-| Agent | Core Skill | Purpose |
-| ----- | -------- | ------- |
-| spec-builder | `moai-foundation-ears` | Write SPEC with EARS syntax |
-| git-manager | `moai-alfred-git-workflow` | Create branch and PR |
+| Agent        | Core Skill                 | Purpose                     |
+| ------------ | -------------------------- | --------------------------- |
+| spec-builder | `moai-foundation-ears`     | Write SPEC with EARS syntax |
+| git-manager  | `moai-alfred-git-workflow` | Create branch and PR        |
 
 **Note**: TUI Survey Skill is used for user confirmations during the plan phase and is shared across all interactive prompts.
 
@@ -152,7 +152,7 @@ Call the Task tool:
 
 ### User verification steps
 
-After reviewing your implementation plan, Alfred invokes `Skill("moai-alfred-tui-survey")` to present the following options:
+After reviewing your implementation plan, Alfred invokes `Skill("moai-alfred-interactive-questions")` 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
@@ -161,7 +161,7 @@ After reviewing your implementation plan, Alfred invokes `Skill("moai-alfred-tui
 
 ## 🚀 STEP 2: Create plan document (after user approval)
 
-After user approval (collected via `Skill("moai-alfred-tui-survey")`), call the spec-builder and git-manager agents using the **Task tool**.
+After user approval (collected via `Skill("moai-alfred-interactive-questions")`), 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

@@ -20,7 +20,7 @@ allowed-tools:
 ---
 
 # ⚒️ MoAI-ADK Phase 2: Run the plan - Flexible implementation strategy
-> Interactive prompts rely on `Skill("moai-alfred-tui-survey")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
 
 ## 🎯 Command Purpose
 
@@ -67,12 +67,12 @@ Analyze SPEC documents to execute planned tasks. It supports not only TDD implem
 
 ## 🧠 Associated Skills & Agents
 
-| Agent | Core Skill | Purpose |
-| ----- | -------- | ------- |
+| Agent                  | Core Skill                       | Purpose                                 |
+| ---------------------- | -------------------------------- | --------------------------------------- |
 | implementation-planner | `moai-alfred-language-detection` | Detect language and design architecture |
-| tdd-implementer | `moai-essentials-debug` | Implement TDD (RED → GREEN → REFACTOR) |
-| quality-gate | `moai-alfred-trust-validation` | Verify TRUST 5 principles |
-| git-manager | `moai-alfred-git-workflow` | Commit and manage Git workflows |
+| tdd-implementer        | `moai-essentials-debug`          | Implement TDD (RED → GREEN → REFACTOR)  |
+| quality-gate           | `moai-alfred-trust-validation`   | Verify TRUST 5 principles               |
+| git-manager            | `moai-alfred-git-workflow`       | Commit and manage Git workflows         |
 
 **Note**: TUI Survey Skill is used for user confirmations during the run phase and is shared across all interactive prompts.
 
@@ -133,7 +133,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-tui-survey")` to confirm the next action with the user
+6. Create action plan and use `Skill("moai-alfred-interactive-questions")` to confirm the next action with the user
  (Optional) Explore results: $EXPLORE_RESULTS"
 ```
 
@@ -177,7 +177,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-tui-survey")`), **call the tdd-implementer agent using the Task tool**.
+After user approval (gathered through `Skill("moai-alfred-interactive-questions")`), **call the tdd-implementer agent using the Task tool**.
 
 ### ⚙️ How to call an agent
 
@@ -214,22 +214,22 @@ Execute on: $ARGUMENTS"
 
 #### Backend/System
 
-| SPEC Type | Implementation language | Test Framework | Performance Goals | Coverage Goals |
-|-----------|-----------|-------------------|-----------|---------------|
-| **CLI/System** | TypeScript | jest + ts-node | < 18ms | 95%+ |
-| **API/Backend** | TypeScript | Jest + SuperTest | < 50ms | 90%+ |
-| **Frontend** | TypeScript | Jest + Testing Library | < 100ms | 85%+ |
-| **Data Processing** | TypeScript | Jest + Mock | < 200ms | 85%+ |
-| **Python Project** | Python | pytest + mypy | Custom | 85%+ |
+| SPEC Type           | Implementation language | Test Framework         | Performance Goals | Coverage Goals |
+| ------------------- | ----------------------- | ---------------------- | ----------------- | -------------- |
+| **CLI/System**      | TypeScript              | jest + ts-node         | < 18ms            | 95%+           |
+| **API/Backend**     | TypeScript              | Jest + SuperTest       | < 50ms            | 90%+           |
+| **Frontend**        | TypeScript              | Jest + Testing Library | < 100ms           | 85%+           |
+| **Data Processing** | TypeScript              | Jest + Mock            | < 200ms           | 85%+           |
+| **Python Project**  | Python                  | pytest + mypy          | Custom            | 85%+           |
 
 #### Mobile Framework
 
-| SPEC Type | Implementation language | Test Framework | Performance Goals | Coverage Goals |
-|-----------|-----------|-------------------|-----------|---------------|
-| **Flutter App** | Dart | flutter test + widget test | < 100ms | 85%+ |
-| **React Native** | TypeScript | Jest + RN Testing Library | < 100ms | 85%+ |
-| **iOS App** | Swift | XCTest + XCUITest | < 150ms | 80%+ |
-| **Android App** | Kotlin | JUnit + Espresso | < 150ms | 80%+ |
+| SPEC Type        | Implementation language | Test Framework             | Performance Goals | Coverage Goals |
+| ---------------- | ----------------------- | -------------------------- | ----------------- | -------------- |
+| **Flutter App**  | Dart                    | flutter test + widget test | < 100ms           | 85%+           |
+| **React Native** | TypeScript              | Jest + RN Testing Library  | < 100ms           | 85%+           |
+| **iOS App**      | Swift                   | XCTest + XCUITest          | < 150ms           | 80%+           |
+| **Android App**  | Kotlin                  | JUnit + Espresso           | < 150ms           | 80%+           |
 
 ## 🚀 Optimized agent collaboration structure
 
@@ -250,7 +250,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-tui-survey")`, collect user approval before proceeding
+5. **Create action plan**: Create a structured plan and, via `Skill("moai-alfred-interactive-questions")`, collect user approval before proceeding
 
 ### Phase 2: Task execution phase (after approval)
 
@@ -326,13 +326,13 @@ Alfred calls the implementation-planner agent to check the SPEC document and cre
 
 #### TypeScript execution criteria
 
-| SPEC characteristics | execution language | Reason |
-|-----------|-----------|------|
-| CLI/System Tools | TypeScript | High performance (18ms), type safety, SQLite3 integration |
-| API/Backend | TypeScript | Node.js ecosystem, Express/Fastify compatibility |
-| Frontend | TypeScript | React/Vue native support |
-| data processing | TypeScript | High-performance asynchronous processing, type safety |
-| User Python Project | Python tool support | MoAI-ADK provides Python project development tools |
+| SPEC characteristics | execution language  | Reason                                                    |
+| -------------------- | ------------------- | --------------------------------------------------------- |
+| CLI/System Tools     | TypeScript          | High performance (18ms), type safety, SQLite3 integration |
+| API/Backend          | TypeScript          | Node.js ecosystem, Express/Fastify compatibility          |
+| Frontend             | TypeScript          | React/Vue native support                                  |
+| data processing      | TypeScript          | High-performance asynchronous processing, type safety     |
+| User Python Project  | Python tool support | MoAI-ADK provides Python project development tools        |
 
 #### Approach
 
@@ -359,16 +359,16 @@ Present your plan in the following format:
 
 ### 📦 Library version (required - based on web search)
 **Backend dependencies** (example):
-| package | Latest stable version | installation command |
-|--------|--------------|----------|
-| FastAPI | 0.118.3 | fastapi>=0.118.3 |
-| SQLAlchemy | 2.0.43 | sqlalchemy>=2.0.43 |
+| package    | Latest stable version | installation command |
+| ---------- | --------------------- | -------------------- |
+| FastAPI    | 0.118.3               | fastapi>=0.118.3     |
+| SQLAlchemy | 2.0.43                | sqlalchemy>=2.0.43   |
 
 **Frontend dependency** (example):
 | package | Latest stable version | installation command |
-|--------|--------------|----------|
-| React | 18.3.1 | react@^18.3.1 |
-| Vite | 7.1.9 | vite@^7.1.9 |
+| ------- | --------------------- | -------------------- |
+| React   | 18.3.1                | react@^18.3.1        |
+| Vite    | 7.1.9                 | vite@^7.1.9          |
 
 **Important Compatibility Information**:
 - [Specific Version Requirements]

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

@@ -17,14 +17,14 @@ allowed-tools:
 ---
 
 # 📚 MoAI-ADK Step 3: Document Synchronization (+Optional PR Ready)
-> Interactive prompts rely on `Skill("moai-alfred-tui-survey")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
+> Interactive prompts rely on `Skill("moai-alfred-interactive-questions")` so AskUserQuestion renders TUI selection menus for user surveys and approvals.
 
 ## 🚀 START HERE
 
 **CRITICAL**: Load the TUI Survey Skill FIRST before any user interaction:
 
 ```
-Skill("moai-alfred-tui-survey")
+Skill("moai-alfred-interactive-questions")
 ```
 
 This Skill MUST be loaded at the very beginning to enable TUI menu rendering for AskUserQuestion calls throughout this workflow.
@@ -40,7 +40,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-tui-survey")` at the very start
+- Load `Skill("moai-alfred-interactive-questions")` at the very start
 - This enables TUI menu rendering for all user interactions
 
 **Phase 1: Analysis & Planning**
@@ -56,12 +56,12 @@ Synchronize code changes to Living Documents and verify @TAG system to ensure co
 
 ## 🧠 Associated Skills & Agents
 
-| Agent | Core Skill | Purpose |
-| ----- | -------- | ------- |
-| tag-agent | `moai-alfred-tag-scanning` | Verify TAG system integrity |
+| Agent        | Core Skill                     | Purpose                        |
+| ------------ | ------------------------------ | ------------------------------ |
+| tag-agent    | `moai-alfred-tag-scanning`     | Verify TAG system integrity    |
 | quality-gate | `moai-alfred-trust-validation` | Check code quality before sync |
-| doc-syncer | `moai-alfred-tag-scanning` | Synchronize Living Documents |
-| git-manager | `moai-alfred-git-workflow` | Handle Git operations |
+| doc-syncer   | `moai-alfred-tag-scanning`     | Synchronize Living Documents   |
+| git-manager  | `moai-alfred-git-workflow`     | Handle Git operations          |
 
 **Note**: TUI Survey Skill is loaded once at Phase 0 and reused throughout all user interactions.
 
@@ -205,7 +205,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-tui-survey")` presents the following options for user decision:
+After reviewing your sync plan, `Skill("moai-alfred-interactive-questions")` 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
@@ -214,7 +214,7 @@ After reviewing your sync plan, `Skill("moai-alfred-tui-survey")` presents the f
 
 ## 🚀 STEP 2: Execute document synchronization (after user approval)
 
-After user approval (collected via `Skill("moai-alfred-tui-survey")`), 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 `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.
 
 ### Phase 2 Details: SPEC Completion Processing (Automatic)
 

moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py

@@ -136,7 +136,8 @@ def main() -> None:
         handler = handlers.get(event_name)
         result = handler({"cwd": cwd, **data}) if handler else HookResult()
 
-        # UserPromptSubmit uses a special output schema
+        # Output Hook result as JSON
+        # Note: UserPromptSubmit uses to_user_prompt_submit_dict() for special schema
         if event_name == "UserPromptSubmit":
             print(json.dumps(result.to_user_prompt_submit_dict()))
         else:
@@ -145,9 +146,21 @@ def main() -> None:
         sys.exit(0)
 
     except json.JSONDecodeError as e:
+        # Return valid Hook response even on JSON parse error
+        error_response: dict[str, Any] = {
+            "continue": True,
+            "hookSpecificOutput": {"error": f"JSON parse error: {e}"}
+        }
+        print(json.dumps(error_response))
         print(f"JSON parse error: {e}", file=sys.stderr)
         sys.exit(1)
     except Exception as e:
+        # Return valid Hook response even on unexpected error
+        error_response: dict[str, Any] = {
+            "continue": True,
+            "hookSpecificOutput": {"error": f"Hook error: {e}"}
+        }
+        print(json.dumps(error_response))
         print(f"Unexpected error: {e}", file=sys.stderr)
         sys.exit(1)