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

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

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+# @CODE:HOOK-TOOL-001 | SPEC: TBD | TEST: tests/hooks/test_handlers.py
 """Tool usage handlers
 
 PreToolUse, PostToolUse event handling
@@ -6,6 +7,7 @@ PreToolUse, PostToolUse event handling
 
 from core import HookPayload, HookResult
 from core.checkpoint import create_checkpoint, detect_risky_operation
+from core.tags import scan_recent_changes_for_missing_tags
 
 
 def handle_pre_tool_use(payload: HookPayload) -> HookResult:
@@ -44,20 +46,38 @@ def handle_pre_tool_use(payload: HookPayload) -> HookResult:
     tool_args = payload.get("arguments", {})
     cwd = payload.get("cwd", ".")
 
-    # Dangerous operation detection
-    is_risky, operation_type = detect_risky_operation(tool_name, tool_args, cwd)
-
-    # Create checkpoint when danger is detected
-    if is_risky:
-        checkpoint_branch = create_checkpoint(cwd, operation_type)
-
-        if checkpoint_branch != "checkpoint-failed":
-            system_message = (
-                f"🛡️ Checkpoint created: {checkpoint_branch}\n"
-                f"   Operation: {operation_type}"
-            )
-
-            return HookResult(system_message=system_message, continue_execution=True)
+    # Dangerous operation detection (best-effort)
+    try:
+        is_risky, operation_type = detect_risky_operation(tool_name, tool_args, cwd)
+        # Create checkpoint when danger is detected
+        if is_risky:
+            checkpoint_branch = create_checkpoint(cwd, operation_type)
+            if checkpoint_branch != "checkpoint-failed":
+                system_message = (
+                    f"🛡️ Checkpoint created: {checkpoint_branch}\n"
+                    f"   Operation: {operation_type}"
+                )
+                return HookResult(system_message=system_message, continue_execution=True)
+    except Exception:
+        # Do not fail the hook if risk detection errors out
+        pass
+
+    # TAG Guard (gentle): warn when recent changes miss @TAG
+    issues = scan_recent_changes_for_missing_tags(cwd)
+    if issues:
+        # Summarize first few issues for display
+        preview = "\n".join(
+            f" - {i.path} → 기대 태그: {i.expected}" for i in issues[:5]
+        )
+        more = "" if len(issues) <= 5 else f"\n (외 {len(issues)-5}건 더 존재)"
+        msg = (
+            "⚠️ TAG 누락 감지: 생성/수정한 파일 중 @TAG가 없는 항목이 있습니다.\n"
+            f"{preview}{more}\n"
+            "권장 조치:\n"
+            "  1) SPEC/TEST/CODE/DOC 유형에 맞는 @TAG를 파일 상단 주석이나 헤더에 추가\n"
+            "  2) rg로 확인: rg '@(SPEC|TEST|CODE|DOC):' -n <경로>\n"
+        )
+        return HookResult(system_message=msg, continue_execution=True)
 
     return HookResult(continue_execution=True)
 

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  # noqa: E402
+
+
+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/skills/moai-cc-hooks/scripts/validate-bash-command.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+# @CODE:HOOK-BASH-001 | SPEC: TBD | TEST: tests/hooks/test_bash_validation.py
 # Bash command validator (from Context7 official docs)
 import json
 import re
@@ -14,11 +15,10 @@ BLOCKED = [
 try:
     data = json.load(sys.stdin)
     cmd = data.get("tool_input", {}).get("command", "")
-    
     for pattern, msg in BLOCKED:
         if re.search(pattern, cmd):
             print(f"🔴 {msg}", file=sys.stderr)
             sys.exit(2)
     sys.exit(0)
-except:
+except Exception:
     sys.exit(0)

moai_adk/templates/CLAUDE.md

@@ -1,16 +1,28 @@
-# {{PROJECT_NAME}} - MoAI-Agentic Development Kit
+<!-- @DOC:CLAUDE-001 | SPEC: TBD -->
+# MoAI-ADK - MoAI-Agentic Development Kit
 
-**SPEC-First TDD Development with Alfred SuperAgent**
+## 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`
 >
-> 💡 **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.
@@ -70,6 +82,7 @@ The **code-builder pipeline** runs two Sonnet specialists in sequence: **impleme
 The **Explore** agent excels at navigating large codebases.
 
 **Use cases**:
+
 - ✅ **Code analysis** (understand complex implementations, trace dependencies, study architecture)
 - ✅ Search for specific keywords or patterns (e.g., "API endpoints", "authentication logic")
 - ✅ Locate files (e.g., `src/components/**/*.tsx`)
@@ -77,6 +90,7 @@ The **Explore** agent excels at navigating large codebases.
 - ✅ Search across many files (Glob + Grep patterns)
 
 **Recommend Explore when**:
+
 - 🔍 You need to understand a complex structure
 - 🔍 The implementation spans multiple files
 - 🔍 You want the end-to-end flow of a feature
@@ -84,6 +98,7 @@ The **Explore** agent excels at navigating large codebases.
 - 🔍 You're planning a refactor and need impact analysis
 
 **Usage examples**:
+
 ```python
 # 1. Deep code analysis
 Task(
@@ -114,6 +129,9 @@ User: "Where is JWT authentication implemented in this project?"
 ```
 
 **thoroughness levels** (declare explicitly inside the prompt text):
+
+**thoroughness levels** (declare explicitly inside the prompt text):
+
 - `quick`: fast scan (basic patterns)
 - `medium`: moderate sweep (multiple locations + naming rules) — **recommended**
 - `very thorough`: exhaustive scan (full codebase analysis)
@@ -134,7 +152,7 @@ Alfred relies on 55 Claude Skills grouped by tier. Skills load via Progressive D
 | Claude Code Ops | 1      | Session management                           |
 | **Total**       | **55** | Complete knowledge capsule library           |
 
-**Foundation Tier (6)**
+### Foundation Tier (6)
 
 | Skill                   | Purpose                                 | Auto-load                      |
 | ----------------------- | --------------------------------------- | ------------------------------ |
@@ -145,7 +163,7 @@ Alfred relies on 55 Claude Skills grouped by tier. Skills load via Progressive D
 | `moai-foundation-git`   | GitFlow automation & PR policy          | Plan/Run/Sync                  |
 | `moai-foundation-langs` | Language detection & Skill preload      | SessionStart, `/alfred:2-run`  |
 
-**Essentials Tier (4)**
+### Essentials Tier (4)
 
 | Skill                      | Purpose                                       | Auto-load                                  |
 | -------------------------- | --------------------------------------------- | ------------------------------------------ |
@@ -154,7 +172,7 @@ Alfred relies on 55 Claude Skills grouped by tier. Skills load via Progressive D
 | `moai-essentials-refactor` | Refactoring patterns & code-smell remediation | `/alfred:2-run`                            |
 | `moai-essentials-review`   | Code review checklist & quality feedback      | `/alfred:3-sync`                           |
 
-**Alfred Tier (11)** — Internal workflow orchestration
+### Alfred Tier (11) — Internal workflow orchestration
 
 | Skill                                  | Purpose                              | Auto-load                         |
 | -------------------------------------- | ------------------------------------ | --------------------------------- |
@@ -170,11 +188,11 @@ Alfred relies on 55 Claude Skills grouped by tier. Skills load via Progressive D
 | `moai-alfred-trust-validation`         | TRUST 5 principle verification       | All phases                        |
 | `moai-alfred-interactive-questions`    | Interactive user surveys & menus     | On demand                         |
 
-**Domain Tier (10)** — `moai-domain-backend`, `web-api`, `frontend`, `mobile-app`, `security`, `devops`, `database`, `data-science`, `ml`, `cli-tool`.
+### Domain Tier (10) — `moai-domain-backend`, `web-api`, `frontend`, `mobile-app`, `security`, `devops`, `database`, `data-science`, `ml`, `cli-tool`
 
-**Language Tier (23)** — Python, TypeScript, Go, Rust, Java, Kotlin, Swift, Dart, C/C++, C#, Scala, Haskell, Elixir, Clojure, Lua, Ruby, PHP, JavaScript, SQL, Shell, Julia, R, plus supporting stacks.
+### Language Tier (23) — Python, TypeScript, Go, Rust, Java, Kotlin, Swift, Dart, C/C++, C#, Scala, Haskell, Elixir, Clojure, Lua, Ruby, PHP, JavaScript, SQL, Shell, Julia, R, plus supporting stacks
 
-**Claude Code Ops (1)** — `moai-claude-code` manages session settings, output styles, and Skill deployment.
+### Claude Code Ops (1) — `moai-claude-code` manages session settings, output styles, and Skill deployment
 
 Skills keep the core knowledge lightweight while allowing Alfred to assemble the right expertise for each request.
 
@@ -194,6 +212,7 @@ Skills keep the core knowledge lightweight while allowing Alfred to assemble the
 | **Claude 4.5 Sonnet** | Planning, implementation, troubleshooting, session ops               | Alfred, project-manager, spec-builder, code-builder pipeline, debug-helper, cc-manager | Deep reasoning, multi-step synthesis, creative problem solving |
 
 **Guidelines**:
+
 - Default to **Haiku** when the task is pattern-driven or requires rapid iteration; escalate to **Sonnet** for novel design, architecture, or ambiguous problem solving.
 - Record any manual model switch in the task notes (who, why, expected benefit).
 - Combine both models when needed: e.g., Sonnet plans a refactor, Haiku formats and validates the resulting docs.
@@ -219,13 +238,14 @@ Alfred commands follow a three-phase loop, with an optional bootstrap stage for
 #### Pre-suggestion Checklist
 
 Before suggesting the next step, always verify:
+
 - You have the latest status from agents.
 - All blockers are documented with context.
 - Required approvals or user confirmations are noted.
 - Suggested tasks include clear owners and outcomes.
 - There is at most one "must-do" suggestion per step.
 
-**cc-manager validation sequence**
+### cc-manager validation sequence
 
 1. **SPEC** – Confirm the SPEC file exists and note its status (`draft`, `active`, `completed`, `archived`). If missing, queue `/alfred:1-plan`.
 2. **TEST & CODE** – Check whether tests and implementation files exist and whether the latest test run passed. Address failing tests before proposing new work.
@@ -279,7 +299,7 @@ Before suggesting the next step, always verify:
 
 #### Message Format
 
-```
+```text
 🔴 <Title>
 - Cause: <root cause>
 - Scope: <affected components>
@@ -299,7 +319,7 @@ Before suggesting the next step, always verify:
 
 #### Commit Structure
 
-```
+```text
 <type>(scope): <subject>
 
 - Context of the change
@@ -363,7 +383,7 @@ Claude Code now features an **Interactive Question Tool** powered by the `moai-a
 
 When you provide a high-level request, Alfred may invoke the `moai-alfred-interactive-questions` Skill to clarify implementation details through structured TUI menus:
 
-```
+```text
 User: "Add a completion page for the competition."
          ↓
 Alfred analyzes codebase & context
@@ -399,6 +419,7 @@ Execution with confirmed specifications
 ```
 
 **Where it's used**:
+
 - Sub-agents (spec-builder, code-builder pipeline) invoke this skill when ambiguity is detected
 - Alfred commands may trigger interactive surveys during Plan/Run/Sync phases
 - User approvals and architectural decisions benefit most from TUI-based selection
@@ -416,6 +437,7 @@ Execution with confirmed specifications
 ### When to Use Interactive Questions
 
 **Ideal for**:
+
 - 🎯 Complex features with multiple valid approaches
 - 🎯 Architectural decisions with trade-offs
 - 🎯 Ambiguous or high-level requirements
@@ -423,6 +445,7 @@ Execution with confirmed specifications
 - 🎯 Decisions involving user experience or data flow
 
 **Example triggers**:
+
 - "Add a dashboard" → needs clarification on layout, data sources, authentication
 - "Refactor the auth system" → needs clarification on scope, backwards compatibility, migration strategy
 - "Optimize performance" → needs clarification on which bottleneck, acceptable trade-offs
@@ -458,14 +481,16 @@ Execution with confirmed specifications
 
 **User Request**: "Competition is over. Add a completion page."
 
-**Step 1: Code Analysis**
+#### Step 1: Code Analysis
+
 Alfred scans the codebase and detects:
+
 - Existing `/end` page (auth required, shows results)
 - Need for clarification on scope and user behavior
 
-**Step 2: Interactive Survey (moai-alfred-interactive-questions activated)**
+#### Step 2: Interactive Survey (moai-alfred-interactive-questions activated)
 
-```
+```text
 ────────────────────────────────────────────────────────────────
 ALFRED: How should the completion page be implemented?
 ────────────────────────────────────────────────────────────────
@@ -490,7 +515,7 @@ ALFRED: How should the completion page be implemented?
 → Selection: Create a new public page (/competition-closed)
 ```
 
-```
+```text
 ────────────────────────────────────────────────────────────────
 ALFRED: For logged-in participants accessing the new page?
 ────────────────────────────────────────────────────────────────
@@ -514,9 +539,9 @@ ALFRED: For logged-in participants accessing the new page?
 → Selection: Show simple completion message only
 ```
 
-**Step 3: Review & Confirmation**
+#### Step 3: Review & Confirmation
 
-```
+```text
 ────────────────────────────────────────────────────────────────
 ALFRED: Review your answers
 ────────────────────────────────────────────────────────────────
@@ -538,9 +563,10 @@ ALFRED: Review your answers
 → Action: Submit answers (enter)
 ```
 
-**Step 4: Execution**
+#### Step 4: Execution
 
 Alfred now executes with **confirmed specifications**:
+
 - ✅ Creates `/app/competition-closed/page.tsx` (public route)
 - ✅ Implements simple "Competition concluded" message
 - ✅ Handles authenticated users appropriately
@@ -644,7 +670,7 @@ Combine layers when necessary: a command triggers sub-agents, sub-agents activat
 
 ### TAG Block Template
 
-```
+```text
 // @CODE:AUTH-001 | SPEC: SPEC-AUTH-001.md | TEST: tests/auth/service.test.ts
 ```
 
@@ -675,6 +701,7 @@ Combine layers when necessary: a command triggers sub-agents, sub-agents activat
 ### TAG Validation & Integrity
 
 **Avoid duplicates**:
+
 ```bash
 rg "@SPEC:AUTH" -n          # Search AUTH specs
 rg "@CODE:AUTH-001" -n      # Targeted ID search
@@ -682,6 +709,7 @@ rg "AUTH-001" -n            # Global ID search
 ```
 
 **TAG chain verification** (`/alfred:3-sync` runs automatically):
+
 ```bash
 rg '@(SPEC|TEST|CODE|DOC):' -n .moai/specs/ tests/ src/ docs/
 
@@ -711,18 +739,21 @@ Alfred enforces these quality gates on every change:
 ## Language-specific Code Rules
 
 **Global constraints**:
+
 - Files ≤ 300 LOC
 - Functions ≤ 50 LOC
 - Parameters ≤ 5
 - Cyclomatic complexity ≤ 10
 
 **Quality targets**:
+
 - Test coverage ≥ 85%
 - Intent-revealing names
 - Early guard clauses
 - Use language-standard tooling
 
 **Testing strategy**:
+
 - Prefer the standard framework per language
 - Keep tests isolated and deterministic
 - Derive cases directly from the SPEC
@@ -732,6 +763,7 @@ Alfred enforces these quality gates on every change:
 ## TDD Workflow Checklist
 
 **Step 1: SPEC authoring** (`/alfred:1-plan`)
+
 - [ ] Create `.moai/specs/SPEC-<ID>/spec.md` (with directory structure)
 - [ ] Add YAML front matter (id, version: 0.0.1, status: draft, created)
 - [ ] Include the `@SPEC:ID` TAG
@@ -740,12 +772,14 @@ Alfred enforces these quality gates on every change:
 - [ ] Check for duplicate IDs: `rg "@SPEC:<ID>" -n`
 
 **Step 2: TDD implementation** (`/alfred:2-run`)
+
 - [ ] **RED**: Write `@TEST:ID` under `tests/` and watch it fail
 - [ ] **GREEN**: Add `@CODE:ID` under `src/` and make the test pass
 - [ ] **REFACTOR**: Improve code quality; document TDD history in comments
 - [ ] List SPEC/TEST file paths in the TAG block
 
 **Step 3: Documentation sync** (`/alfred:3-sync`)
+
 - [ ] Scan TAGs: `rg '@(SPEC|TEST|CODE):' -n`
 - [ ] Ensure no orphan TAGs remain
 - [ ] Regenerate the Living Document
@@ -753,23 +787,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}}.