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

moai_adk/templates/.claude/hooks/alfred/HOOK_SCHEMA_VALIDATION.md

@@ -0,0 +1,313 @@
+# Hook JSON 스키마 검증 및 해결 보고서
+
+**작성일**: 2025-10-23  
+**태그**: @CODE:HOOKS-REFACTOR-001  
+**상태**: ✅ 해결 완료
+
+---
+
+## 📋 문제 요약
+
+### 초기 오류
+```
+SessionStart:startup hook error: JSON validation failed: Hook JSON output validation failed
+Expected schema: { ... "systemMessage": ... }
+```
+
+### 근본 원인
+Claude Code Hook 스키마에서 `systemMessage`가 **최상위 필드**여야 하지만, 일부 구현에서는 이를 `hookSpecificOutput` 내부에 중첩시키고 있었습니다.
+
+---
+
+## 🔍 분석 결과
+
+### Claude Code 공식 Hook 스키마
+
+#### 1. 일반 Hook 이벤트 (SessionStart, PreToolUse, PostToolUse, SessionEnd 등)
+
+```json
+{
+  "continue": true|false,                  // ✅ 기본 필드
+  "systemMessage": "string",               // ✅ 최상위 필드 (NOT in hookSpecificOutput)
+  "decision": "approve"|"block"|undefined, // ✅ 선택적
+  "reason": "string",                      // ✅ 선택적
+  "permissionDecision": "allow"|"deny"|"ask"|undefined,  // ✅ 선택적
+  "suppressOutput": true|false             // ✅ 선택적
+}
+```
+
+#### 2. UserPromptSubmit 전용 스키마
+
+```json
+{
+  "continue": true,
+  "hookSpecificOutput": {                  // ✅ UserPromptSubmit에만 사용
+    "hookEventName": "UserPromptSubmit",
+    "additionalContext": "string"
+  }
+}
+```
+
+### 핵심 규칙
+
+| 규칙 | 설명 |
+|------|------|
+| **systemMessage 위치** | 최상위 필드 (`output["systemMessage"]`) |
+| **hookSpecificOutput** | UserPromptSubmit 전용 |
+| **내부 필드** | `context_files`, `suggestions`, `exit_code`는 Python 로직용 (JSON 출력 제외) |
+| **JSON 직렬화** | 모든 필드는 JSON 직렬화 가능해야 함 |
+
+---
+
+## ✅ 해결 방안
+
+### 1. 코드 수정
+
+**파일**: `.claude/hooks/alfred/core/__init__.py`
+
+#### `to_dict()` 메서드 (라인 63-118)
+```python
+def to_dict(self) -> dict[str, Any]:
+    """Claude Code 표준 Hook 출력 스키마로 변환"""
+    output: dict[str, Any] = {}
+
+    # 1. decision 또는 continue 추가
+    if self.decision:
+        output["decision"] = self.decision
+    else:
+        output["continue"] = self.continue_execution
+
+    # 2. reason 추가 (decision 또는 permissionDecision과 함께)
+    if self.reason:
+        output["reason"] = self.reason
+
+    # 3. suppressOutput 추가 (True인 경우만)
+    if self.suppress_output:
+        output["suppressOutput"] = True
+
+    # 4. permissionDecision 추가
+    if self.permission_decision:
+        output["permissionDecision"] = self.permission_decision
+
+    # 5. ⭐ systemMessage를 최상위 필드로 추가 (NOT in hookSpecificOutput)
+    if self.system_message:
+        output["systemMessage"] = self.system_message
+
+    # 🚫 내부 필드는 JSON 출력에서 제외
+    # - context_files: JIT 문맥 로드 (내부용)
+    # - suggestions: 제안 (내부용)
+    # - exit_code: 진단 (내부용)
+
+    return output
+```
+
+#### `to_user_prompt_submit_dict()` 메서드 (라인 120-160)
+```python
+def to_user_prompt_submit_dict(self) -> dict[str, Any]:
+    """UserPromptSubmit Hook 전용 스키마"""
+    if self.context_files:
+        context_str = "\n".join([f"📎 Context: {f}" for f in self.context_files])
+    else:
+        context_str = ""
+
+    if self.system_message:
+        if context_str:
+            context_str = f"{self.system_message}\n\n{context_str}"
+        else:
+            context_str = self.system_message
+
+    return {
+        "continue": self.continue_execution,
+        "hookSpecificOutput": {
+            "hookEventName": "UserPromptSubmit",
+            "additionalContext": context_str
+        }
+    }
+```
+
+### 2. 설정 검증
+
+**파일**: `.claude/settings.json` (라인 8-60)
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "command": "uv run \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/alfred/alfred_hooks.py SessionStart",
+            "type": "command"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "command": "uv run \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/alfred/alfred_hooks.py UserPromptSubmit",
+            "type": "command"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+---
+
+## 🧪 검증 결과
+
+### 1. 자동 테스트 (8/8 통과)
+
+**파일**: `.claude/hooks/alfred/test_hook_output.py`
+
+```bash
+$ cd .claude/hooks/alfred && python test_hook_output.py
+
+✅ Test 1: Basic output - PASSED
+✅ Test 2: systemMessage (top-level) - PASSED
+✅ Test 3: decision + reason - PASSED
+✅ Test 4: UserPromptSubmit schema - PASSED
+✅ Test 5: permissionDecision - PASSED
+✅ Test 6: SessionStart typical output - PASSED
+✅ Test 7: JSON serializable - PASSED
+✅ Test 8: UserPromptSubmit with system_message - PASSED
+
+✅ ALL 8 TESTS PASSED
+```
+
+### 2. 실제 Hook 실행 검증
+
+#### SessionStart (compact phase)
+```bash
+$ echo '{"cwd": ".", "phase": "compact"}' | uv run .claude/hooks/alfred/alfred_hooks.py SessionStart
+
+{
+  "continue": true,
+  "systemMessage": "🚀 MoAI-ADK Session Started\n   Language: python\n   Branch: develop (d905363)\n   Changes: 215\n   SPEC Progress: 30/31 (96%)\n   Checkpoints: 2 available\n      - delete-20251022-134841\n      - critical-file-20251019-230247\n   Restore: /alfred:0-project restore"
+}
+```
+
+✅ **검증**: 
+- `systemMessage`가 최상위 필드
+- JSON 유효성 확인
+- `hookSpecificOutput` 없음 (올바름)
+
+#### SessionStart (clear phase)
+```bash
+$ echo '{"cwd": ".", "phase": "clear"}' | uv run .claude/hooks/alfred/alfred_hooks.py SessionStart
+
+{"continue": true}
+```
+
+✅ **검증**: 
+- 최소 스키마 (continue만)
+- clear 단계에서 중복 출력 방지
+
+#### UserPromptSubmit
+```bash
+$ echo '{"cwd": ".", "userPrompt": "test"}' | uv run .claude/hooks/alfred/alfred_hooks.py UserPromptSubmit
+
+{
+  "continue": true,
+  "hookSpecificOutput": {
+    "hookEventName": "UserPromptSubmit",
+    "additionalContext": "📎 Loaded 1 context file(s)\n\n📎 Context: tests/"
+  }
+}
+```
+
+✅ **검증**: 
+- UserPromptSubmit 특수 스키마
+- `hookSpecificOutput` 사용 (올바름)
+
+---
+
+## 📚 각 Hook 이벤트별 스키마 가이드
+
+| 이벤트 | 최소 JSON | 예시 | 차단 가능 |
+|--------|-----------|------|----------|
+| **SessionStart** | `{"continue": true}` | 프로젝트 상태 표시 | ❌ No |
+| **SessionEnd** | `{"continue": true}` | 정리 작업 | ❌ No |
+| **PreToolUse** | `{"continue": true}` | 도구 실행 승인/차단 | ✅ Yes |
+| **PostToolUse** | `{"continue": true}` | 도구 실행 후 피드백 | ❌ No* |
+| **UserPromptSubmit** | 특수 스키마 | 프롬프트 문맥 추가 | ✅ Yes |
+| **Notification** | `{"continue": true}` | 알림 처리 | ❌ No |
+| **Stop** | `{"continue": true}` | 종료 차단 | ✅ Yes |
+| **SubagentStop** | `{"continue": true}` | 서브에이전트 종료 차단 | ✅ Yes |
+
+*: PostToolUse는 도구가 이미 실행되었으므로 차단 불가능하지만, 피드백 제공 가능
+
+---
+
+## 🔧 구현 세부사항
+
+### HookResult 클래스 필드
+
+```python
+@dataclass
+class HookResult:
+    # ✅ Claude Code 표준 필드 (JSON에 포함)
+    continue_execution: bool = True
+    suppress_output: bool = False
+    decision: Literal["approve", "block"] | None = None
+    reason: str | None = None
+    permission_decision: Literal["allow", "deny", "ask"] | None = None
+    system_message: str | None = None  # ⭐ TOP-LEVEL in JSON
+    
+    # 🚫 내부 필드 (JSON 출력 제외)
+    context_files: list[str] = field(default_factory=list)
+    suggestions: list[str] = field(default_factory=list)
+    exit_code: int = 0
+```
+
+### 메서드별 역할
+
+| 메서드 | 사용 사건 | 반환 스키마 |
+|--------|---------|----------|
+| `to_dict()` | 일반 Hook 이벤트 | 표준 Claude Code 스키마 |
+| `to_user_prompt_submit_dict()` | UserPromptSubmit 이벤트 | 특수 스키마 + hookSpecificOutput |
+
+---
+
+## 📖 참고 문서
+
+### 공식 Claude Code 문서
+- **Claude Code Hooks**: https://docs.claude.com/en/docs/claude-code/hooks
+- **Hook Output Schema**: https://docs.claude.com/en/docs/claude-code/hooks#output-schema
+
+### Context7 참고 자료
+- **Claude Code Hooks Mastery** (Trust Score: 8.3, 100+ 코드 스니펫)
+- **Claude Code Templates** (Trust Score: 10)
+
+### 프로젝트 문서
+- **CLAUDE.md**: `Error Message Standard (Shared)` 섹션
+- **Hook 구현**: `.claude/hooks/alfred/handlers/` 디렉토리
+
+---
+
+## 🎯 결론
+
+✅ **상태**: 해결 완료  
+✅ **검증**: 8/8 자동 테스트 통과  
+✅ **실제 실행**: 모든 Hook 이벤트 정상 작동  
+
+### 핵심 수정사항
+1. `systemMessage`를 최상위 필드로 이동 (NOT in hookSpecificOutput)
+2. UserPromptSubmit 특수 스키마 분리
+3. 내부 필드 JSON 출력 제외
+4. 모든 Hook 이벤트 스키마 정규화
+
+### 다음 단계
+- ✅ Hook 스키마 검증 자동화
+- ✅ 테스트 스크립트 작성
+- ⏭️ 현재 상태 유지 및 모니터링
+
+---
+
+**검증 완료**: 2025-10-23  
+**담당자**: @agent-cc-manager  
+**참고**: @CODE:HOOKS-REFACTOR-001

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

@@ -28,18 +28,23 @@ class HookResult:
     Attributes conform to Claude Code Hook output specification:
     https://docs.claude.com/en/docs/claude-code/hooks
 
-    Standard Fields (Claude Code schema):
+    Standard Fields (Claude Code schema - included in JSON output):
         continue_execution: Allow execution to continue (default True)
         suppress_output: Suppress hook output display (default False)
         decision: "approve" or "block" operation (optional)
         reason: Explanation for decision (optional)
         permission_decision: "allow", "deny", or "ask" (optional)
+        system_message: Message displayed to user (top-level field)
 
-    MoAI-ADK Fields (wrapped in hookSpecificOutput):
-        system_message: Message displayed to user
-        context_files: List of context files to load
-        suggestions: Suggestions for user
-        exit_code: Exit code (for diagnostics)
+    Internal Fields (MoAI-ADK only - NOT in JSON output):
+        context_files: List of context files to load (internal use only)
+        suggestions: Suggestions for user (internal use only)
+        exit_code: Exit code for diagnostics (internal use only)
+
+    Note:
+        - systemMessage appears at TOP LEVEL in JSON output
+        - hookSpecificOutput is ONLY used for UserPromptSubmit events
+        - Internal fields are used for Python logic but not serialized to JSON
     """
 
     # Claude Code standard fields
@@ -60,8 +65,10 @@ class HookResult:
 
         Returns:
             Dictionary conforming to Claude Code Hook specification with:
-            - Top-level fields: continue, suppressOutput, decision, reason, permissionDecision
-            - Nested field: hookSpecificOutput containing MoAI-ADK-specific data
+            - Top-level fields: continue, suppressOutput, decision, reason,
+              permissionDecision, systemMessage
+            - MoAI-ADK internal fields (context_files, suggestions, exit_code)
+              are NOT included in JSON output (used for internal logic only)
 
         Examples:
             >>> result = HookResult(continue_execution=True)
@@ -72,20 +79,27 @@ class HookResult:
             >>> result.to_dict()
             {'decision': 'block', 'reason': 'Dangerous'}
 
-            >>> result = HookResult(system_message="Test", context_files=["a.txt"])
+            >>> result = HookResult(system_message="Test")
             >>> result.to_dict()
-            {'continue': True, 'hookSpecificOutput': {'systemMessage': 'Test', 'contextFiles': ['a.txt']}}
+            {'continue': True, 'systemMessage': 'Test'}
+
+        Note:
+            - systemMessage is a TOP-LEVEL field (not nested in hookSpecificOutput)
+            - hookSpecificOutput is ONLY used for UserPromptSubmit events
+            - context_files, suggestions, exit_code are internal-only fields
         """
         output: dict[str, Any] = {}
 
         # Add decision or continue flag
         if self.decision:
             output["decision"] = self.decision
-            if self.reason:
-                output["reason"] = self.reason
         else:
             output["continue"] = self.continue_execution
 
+        # Add reason if provided (works with both decision and permissionDecision)
+        if self.reason:
+            output["reason"] = self.reason
+
         # Add suppressOutput if True
         if self.suppress_output:
             output["suppressOutput"] = True
@@ -94,24 +108,12 @@ class HookResult:
         if self.permission_decision:
             output["permissionDecision"] = self.permission_decision
 
-        # Wrap MoAI-ADK custom fields in hookSpecificOutput
-        hook_output: dict[str, Any] = {}
-
+        # Add systemMessage at TOP LEVEL (required by Claude Code schema)
         if self.system_message:
-            hook_output["systemMessage"] = self.system_message
-
-        if self.context_files:
-            hook_output["contextFiles"] = self.context_files
-
-        if self.suggestions:
-            hook_output["suggestions"] = self.suggestions
-
-        if self.exit_code != 0:
-            hook_output["exitCode"] = self.exit_code
+            output["systemMessage"] = self.system_message
 
-        # Only add hookSpecificOutput if there's custom data
-        if hook_output:
-            output["hookSpecificOutput"] = hook_output
+        # Note: context_files, suggestions, exit_code are internal-only fields
+        # and are NOT included in the JSON output per Claude Code schema
 
         return output
 

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

@@ -0,0 +1,175 @@
+#!/usr/bin/env -S uv run --script
+# /// script
+# requires-python = ">=3.11"
+# ///
+"""Test Hook Output Validation
+
+자동 테스트: Claude Code Hook JSON 스키마 검증
+
+- SessionStart Hook JSON 출력 검증
+- UserPromptSubmit Hook 특수 스키마 검증
+- 모든 Hook 이벤트 스키마 일관성 검증
+
+실행:
+    uv run test_hook_output.py
+"""
+
+import json
+import sys
+from pathlib import Path
+
+# Add hooks directory to sys.path
+HOOKS_DIR = Path(__file__).parent
+if str(HOOKS_DIR) not in sys.path:
+    sys.path.insert(0, str(HOOKS_DIR))
+
+from core import HookResult
+
+
+def test_basic_output():
+    """Test 1: Basic output with only continue flag"""
+    result = HookResult(continue_execution=True)
+    output = result.to_dict()
+
+    assert output == {"continue": True}, f"Expected {{'continue': True}}, got {output}"
+    print("✅ Test 1: Basic output - PASSED")
+
+
+def test_system_message_top_level():
+    """Test 2: systemMessage at TOP-LEVEL (not in hookSpecificOutput)"""
+    result = HookResult(system_message="Test message")
+    output = result.to_dict()
+
+    assert "systemMessage" in output, "systemMessage not found in output"
+    assert output["systemMessage"] == "Test message"
+    assert "hookSpecificOutput" not in output, "hookSpecificOutput should not be in to_dict() output"
+    print("✅ Test 2: systemMessage (top-level) - PASSED")
+
+
+def test_decision_with_reason():
+    """Test 3: decision + reason (block pattern)"""
+    result = HookResult(decision="block", reason="Dangerous operation")
+    output = result.to_dict()
+
+    assert output.get("decision") == "block"
+    assert output.get("reason") == "Dangerous operation"
+    assert "continue" not in output, "continue should not appear when decision is set"
+    print("✅ Test 3: decision + reason - PASSED")
+
+
+def test_user_prompt_submit_schema():
+    """Test 4: UserPromptSubmit special schema"""
+    result = HookResult(context_files=["tests/", "docs/"])
+    output = result.to_user_prompt_submit_dict()
+
+    assert "hookSpecificOutput" in output
+    assert output["hookSpecificOutput"]["hookEventName"] == "UserPromptSubmit"
+    assert "additionalContext" in output["hookSpecificOutput"]
+    assert "📎 Context: tests/" in output["hookSpecificOutput"]["additionalContext"]
+    print("✅ Test 4: UserPromptSubmit schema - PASSED")
+
+
+def test_permission_decision():
+    """Test 5: permissionDecision field"""
+    result = HookResult(permission_decision="deny")
+    output = result.to_dict()
+
+    assert output.get("permissionDecision") == "deny"
+    assert "continue" in output  # continue should still be present
+    print("✅ Test 5: permissionDecision - PASSED")
+
+
+def test_session_start_typical_output():
+    """Test 6: Typical SessionStart output"""
+    result = HookResult(
+        continue_execution=True,
+        system_message="🚀 MoAI-ADK Session Started\n   Language: python\n   Branch: develop"
+    )
+    output = result.to_dict()
+
+    # Validate schema
+    assert "continue" in output or "decision" in output, "Missing continue or decision"
+    assert output.get("systemMessage", "").startswith("🚀 MoAI-ADK")
+
+    # Ensure internal fields are NOT in output
+    assert "context_files" not in output, "Internal field context_files leaked to output"
+    assert "suggestions" not in output, "Internal field suggestions leaked to output"
+    assert "exit_code" not in output, "Internal field exit_code leaked to output"
+
+    print("✅ Test 6: SessionStart typical output - PASSED")
+
+
+def test_json_serializable():
+    """Test 7: Output is JSON serializable"""
+    result = HookResult(
+        system_message="Test",
+        decision="approve",
+        reason="Valid operation"
+    )
+    output = result.to_dict()
+
+    try:
+        json_str = json.dumps(output)
+        parsed = json.loads(json_str)
+        assert parsed == output
+        print("✅ Test 7: JSON serializable - PASSED")
+    except Exception as e:
+        print(f"❌ Test 7: JSON serialization FAILED: {e}")
+        sys.exit(1)
+
+
+def test_user_prompt_submit_with_system_message():
+    """Test 8: UserPromptSubmit with both context and system message"""
+    result = HookResult(
+        context_files=["src/"],
+        system_message="Loading context..."
+    )
+    output = result.to_user_prompt_submit_dict()
+
+    assert "hookSpecificOutput" in output
+    assert "Loading context..." in output["hookSpecificOutput"]["additionalContext"]
+    assert "📎 Context: src/" in output["hookSpecificOutput"]["additionalContext"]
+    print("✅ Test 8: UserPromptSubmit with system_message - PASSED")
+
+
+def main():
+    """Run all tests"""
+    print("\n" + "="*60)
+    print("🧪 Claude Code Hook Output Validation Tests")
+    print("="*60 + "\n")
+
+    tests = [
+        test_basic_output,
+        test_system_message_top_level,
+        test_decision_with_reason,
+        test_user_prompt_submit_schema,
+        test_permission_decision,
+        test_session_start_typical_output,
+        test_json_serializable,
+        test_user_prompt_submit_with_system_message,
+    ]
+
+    failed = 0
+    for test in tests:
+        try:
+            test()
+        except AssertionError as e:
+            print(f"❌ {test.__name__}: FAILED - {e}")
+            failed += 1
+        except Exception as e:
+            print(f"❌ {test.__name__}: ERROR - {e}")
+            failed += 1
+
+    print("\n" + "="*60)
+    if failed == 0:
+        print(f"✅ ALL {len(tests)} TESTS PASSED")
+        print("="*60 + "\n")
+        sys.exit(0)
+    else:
+        print(f"❌ {failed}/{len(tests)} TESTS FAILED")
+        print("="*60 + "\n")
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

moai_adk/templates/CLAUDE.md

@@ -1,16 +1,27 @@
-# {{PROJECT_NAME}} - MoAI-Agentic Development Kit
+# MoAI-ADK - MoAI-Agentic Development Kit
 
 **SPEC-First TDD Development with Alfred SuperAgent**
 
-> **문서 언어 | Document Language**: {{CONVERSATION_LANGUAGE_NAME}} ({{CONVERSATION_LANGUAGE}})
-> **프로젝트 담당자 | Project Owner**: {{USER_NICKNAME}}
-> **설정 파일 | Config**: `.moai/config.json` → `project.conversation_language`
+> **Document Language**: {{conversation_language_name}} ({{conversation_language}})
+> **Project Owner**: {{project_owner}}
+> **Config**: `.moai/config.json` → `project.conversation_language`
 >
-> 💡 **Alfred와의 모든 상호작용에서 `Skill("moai-alfred-interactive-questions")`를 통해 TUI 메뉴로 응답할 수 있습니다.**
 > All interactions with Alfred can use `Skill("moai-alfred-interactive-questions")` for TUI-based responses.
 
 ---
 
+## 🗿 🎩 Alfred's Core Directives
+
+You are the SuperAgent **🎩 Alfred** of **🗿 MoAI-ADK**. Follow these core principles:
+
+1. **Identity**: You are Alfred, the MoAI-ADK SuperAgent, responsible for orchestrating the SPEC → TDD → Sync workflow.
+2. **Address the User**: Always address {{project_owner}} 님 with respect and personalization.
+3. **Conversation Language**: Conduct ALL conversations in **{{conversation_language_name}}** ({{conversation_language}}).
+4. **Commit & Documentation**: Write all commits, documentation, and code comments in **{{locale}}** for localization consistency.
+5. **Project Context**: Every interaction is contextualized within {{project_name}}, optimized for {{codebase_language}}.
+
+---
+
 ## ▶◀ Meet Alfred: Your MoAI SuperAgent
 
 **Alfred** orchestrates the MoAI-ADK agentic workflow across a four-layer stack (Commands → Sub-agents → Skills → Hooks). The SuperAgent interprets user intent, activates the right specialists, streams Claude Skills on demand, and enforces the TRUST 5 principles so every project follows the SPEC → TDD → Sync rhythm.
@@ -753,23 +764,23 @@ Alfred enforces these quality gates on every change:
 
 ---
 
-## 프로젝트 정보 | Project Information
+## Project Information
 
-- **이름 | Name**: {{PROJECT_NAME}}
-- **설명 | Description**: {{PROJECT_DESCRIPTION}}
-- **버전 | Version**: {{PROJECT_VERSION}}
-- **모드 | Mode**: {{PROJECT_MODE}}
-- **프로젝트 담당자 | Project Owner**: {{USER_NICKNAME}}
-- **대화 언어 | Conversation Language**: {{CONVERSATION_LANGUAGE_NAME}} ({{CONVERSATION_LANGUAGE}})
-- **코드 언어 | Codebase Language**: {{CODEBASE_LANGUAGE}}
-- **도구 | Toolchain**: 선택된 언어에 최적화된 도구 자동 선택 | Automatically selects the best tools for the chosen language
+- **Name**: {{project_name}}
+- **Description**: {{project_description}}
+- **Version**: {{moai_adk_version}}
+- **Mode**: {{project_mode}}
+- **Project Owner**: {{project_owner}}
+- **Conversation Language**: {{conversation_language_name}} ({{conversation_language}})
+- **Codebase Language**: {{codebase_language}}
+- **Toolchain**: Automatically selects the best tools for {{codebase_language}}
 
-### 언어 설정 | Language Configuration
+### Language Configuration
 
-- **대화 언어 | Conversation Language** (`{{CONVERSATION_LANGUAGE}}`): 모든 Alfred 대화, 문서, 프로젝트 인터뷰가 이 언어로 진행됨 | All Alfred dialogs, documentation, and project interviews conducted in this language
-- **코드 언어 | Codebase Language** (`{{CODEBASE_LANGUAGE}}`): 이 프로젝트에서 감지된 주요 프로그래밍 언어 | Primary programming language(s) detected in this project
-- **문서 | Documentation**: 대화 언어로 생성됨 | Generated in the conversation language ({{CONVERSATION_LANGUAGE_NAME}})
+- **Conversation Language** (`{{conversation_language}}`): All Alfred dialogs, documentation, and project interviews conducted in {{conversation_language_name}}
+- **Codebase Language** (`{{codebase_language_lower}}`): Primary programming language for this project
+- **Documentation**: Generated in {{conversation_language_name}}
 
 ---
 
-**주의 | Note**: 대화 언어는 `/alfred:0-project` 시작 시점에 선택되며, 모든 후속 프로젝트 초기화 단계에 적용됩니다. 생성되는 모든 문서(product.md, structure.md, tech.md)는 선택된 언어로 생성됩니다 | The conversation language is selected at the beginning of `/alfred:0-project` and applies to all subsequent project initialization steps. All generated documentation (product.md, structure.md, tech.md) will be created in the selected language.
+**Note**: The conversation language is selected at the beginning of `/alfred:0-project` and applies to all subsequent project initialization steps. All generated documentation (product.md, structure.md, tech.md) will be created in {{conversation_language_name}}.

{moai_adk-0.4.8.dist-info → moai_adk-0.4.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.4.8
+Version: 0.4.10
 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
@@ -190,7 +190,7 @@ uv tool install moai-adk
 
 # Verify installation
 moai-adk --version
-# Output: MoAI-ADK v0.4.6
+# Output: MoAI-ADK v0.4.10
 ```
 
 Once installed, you can use the `moai-adk` command anywhere.
@@ -1223,14 +1223,14 @@ If you need to temporarily disable hooks, edit `.claude/settings.json`:
 
 | Version    | Key Features                                                                         | Date       |
 | ---------- | ------------------------------------------------------------------------------------ | ---------- |
+| **v0.4.10** | 🔧 Hook robustness improvements + Bilingual documentation + Template language config | 2025-10-23 |
+| **v0.4.9** | 🎯 Hook JSON schema validation fixes + Comprehensive tests (468/468 passing)        | 2025-10-23 |
+| **v0.4.8** | 🚀 Release automation + PyPI deployment + Skills refinement                          | 2025-10-23 |
+| **v0.4.7** | 📖 Korean language optimization + SPEC-First principle documentation                 | 2025-10-22 |
 | **v0.4.6** | 🎉 Complete Skills v2.0 (100% Production-Ready) + 85,000 lines official docs + 300+ TDD examples | 2025-10-22 |
 | **v0.4.5** | ✅ CI/CD fixes + Multi-language README + Deployment cleanup                           | 2025-10-22 |
-| **v0.4.4** | Korean language support                                                              | 2025-10-21 |
-| **v0.4.3** | Interactive question tool (TUI menu)                                                 | 2025-10-21 |
-| **v0.4.1** | Skills localization                                                                  | 2025-10-21 |
-| **v0.4.0** | Claude Skills + AI team + 4-stage workflow                                          | 2025-10-21 |
 
-> 📦 **Install Now**: `pip install moai-adk==0.4.6` or `uv tool install moai-adk==0.4.6`
+> 📦 **Install Now**: `pip install moai-adk==0.4.10` or `uv tool install moai-adk==0.4.10`
 
 ---
 
@@ -1544,10 +1544,11 @@ Start a new experience of **trustworthy AI development** with Alfred! 🤖
 
 ---
 
-**MoAI-ADK v0.4.6** — SPEC-First TDD with AI SuperAgent & Complete Skills v2.0
+**MoAI-ADK v0.4.10** — SPEC-First TDD with AI SuperAgent & Complete Skills v2.0
 - 📦 PyPI: https://pypi.org/project/moai-adk/
 - 🏠 GitHub: https://github.com/modu-ai/moai-adk
 - 📝 License: MIT
-- ⭐ Skills: 56/56 Complete (100% Production-Ready)
+- ⭐ Skills: 55+ Production-Ready Guides
+- ✅ Tests: 468/468 Passing (86% coverage)
 
 ---

{moai_adk-0.4.8.dist-info → moai_adk-0.4.10.dist-info}/RECORD

@@ -38,7 +38,7 @@ 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=W4M3BNrlfA0dHRwvPWIkJmJwhkNDglXaNzsYBoVTSnQ,17019
 moai_adk/templates/.gitignore,sha256=6VNKResdDpyaii3cmJA4pOLwK2PhYARIWkUODYtKyxg,310
-moai_adk/templates/CLAUDE.md,sha256=Vr5z4cUZna1FB6gEi8Cwz-G9pSh7YZKHxJ6wPEZvZZo,42170
+moai_adk/templates/CLAUDE.md,sha256=9eF_fWzNJucNBKAChoaJzVXa-LLhK4Cv7j4XZ1Whl8o,42030
 moai_adk/templates/__init__.py,sha256=6MV1gCB7PLZMiL4gaD_dZSKxtcQyo45MMTuN8fVdchA,104
 moai_adk/templates/.claude/settings.json,sha256=sXQ8gV3oyZJHqPHMxYaH-ps-LXliIMpLMj-Xx2jjE7o,3269
 moai_adk/templates/.claude/agents/alfred/cc-manager.md,sha256=nyiNtcSqvLKK8Mp88hhTFBqrpsRiTqtNTpnAo1m0qQg,8048
@@ -57,9 +57,11 @@ moai_adk/templates/.claude/commands/alfred/0-project.md,sha256=c0aCthvHu57Eg4QHB
 moai_adk/templates/.claude/commands/alfred/1-plan.md,sha256=4Afx44Xx1yp4kp5FwrJg4QxMt-NBkkfgNNi05lk0glg,21792
 moai_adk/templates/.claude/commands/alfred/2-run.md,sha256=UMscmBrpqysmWoKvwyGXEnCEzDWVeS5VEvvYABFYC4g,20194
 moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=xF9XnP20cJrRuCFEG_J3RnZtwMy5Ym3nj_f6eryBFBE,21535
+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=dPlwlj7LlsJd-c-D5ONiQGkih4qULFcjzNvZQyto_kc,7547
-moai_adk/templates/.claude/hooks/alfred/core/__init__.py,sha256=0G35NawGba73POlkG--xjLnaibUCLxS6LUmdJdWBh30,5982
+moai_adk/templates/.claude/hooks/alfred/test_hook_output.py,sha256=zxA330umo4HHoYe_reOocqDeIU3OMBd31rcEfY9QR-U,5632
+moai_adk/templates/.claude/hooks/alfred/core/__init__.py,sha256=Cz1YeL6c5j2ZhJwG3y-lpxde7paJ00tEaYRduc5gDoM,6375
 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
@@ -258,8 +260,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.4.8.dist-info/METADATA,sha256=SL2pkhKPxjBJj348Ho7LdEBRLd08ulRoSYeDgZ9rTaY,61797
-moai_adk-0.4.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-moai_adk-0.4.8.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
-moai_adk-0.4.8.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
-moai_adk-0.4.8.dist-info/RECORD,,
+moai_adk-0.4.10.dist-info/METADATA,sha256=o-wzIPH9FTTUj3Ta4mbhbeepWXmxWALSCVBmySStonk,61844
+moai_adk-0.4.10.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+moai_adk-0.4.10.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
+moai_adk-0.4.10.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
+moai_adk-0.4.10.dist-info/RECORD,,