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

moai_adk/templates/.claude/skills/moai-spec-authoring/examples/validate-spec.sh

@@ -0,0 +1,161 @@
+#!/usr/bin/env bash
+# validate-spec.sh - SPEC validation helper for MoAI-ADK
+# Usage: ./validate-spec.sh .moai/specs/SPEC-AUTH-001
+
+set -e
+
+SPEC_DIR="$1"
+
+if [ -z "$SPEC_DIR" ]; then
+  echo "Usage: $0 <SPEC_DIR>"
+  echo "Example: $0 .moai/specs/SPEC-AUTH-001"
+  exit 1
+fi
+
+if [ ! -d "$SPEC_DIR" ]; then
+  echo "Error: Directory $SPEC_DIR does not exist"
+  exit 1
+fi
+
+if [ ! -f "$SPEC_DIR/spec.md" ]; then
+  echo "Error: spec.md not found in $SPEC_DIR"
+  exit 1
+fi
+
+echo "=========================================="
+echo "Validating SPEC: $SPEC_DIR"
+echo "=========================================="
+echo ""
+
+# Check required fields
+echo -n "Required fields (7)... "
+REQUIRED_COUNT=$(rg "^(id|version|status|created|updated|author|priority):" "$SPEC_DIR/spec.md" | wc -l | tr -d ' ')
+if [ "$REQUIRED_COUNT" -eq 7 ]; then
+  echo "✅ ($REQUIRED_COUNT/7)"
+else
+  echo "❌ ($REQUIRED_COUNT/7)"
+  echo "  Missing fields. Expected: id, version, status, created, updated, author, priority"
+fi
+
+# Check author format
+echo -n "Author format (@Handle)... "
+if rg "^author: @[A-Z]" "$SPEC_DIR/spec.md" > /dev/null 2>&1; then
+  echo "✅"
+else
+  echo "❌"
+  echo "  Expected format: author: @YourHandle"
+fi
+
+# Check version format
+echo -n "Version format (0.x.y)... "
+if rg "^version: 0\.\d+\.\d+" "$SPEC_DIR/spec.md" > /dev/null 2>&1; then
+  echo "✅"
+else
+  echo "❌"
+  echo "  Expected format: version: 0.x.y (e.g., 0.0.1, 0.1.0)"
+fi
+
+# Check HISTORY section
+echo -n "HISTORY section... "
+if rg "^## HISTORY" "$SPEC_DIR/spec.md" > /dev/null 2>&1; then
+  echo "✅"
+else
+  echo "❌"
+  echo "  Missing HISTORY section"
+fi
+
+# Check TAG block
+echo -n "TAG block (@SPEC:ID)... "
+if rg "^# @SPEC:" "$SPEC_DIR/spec.md" > /dev/null 2>&1; then
+  echo "✅"
+else
+  echo "❌"
+  echo "  Expected format: # @SPEC:YOUR-ID: Title"
+fi
+
+# Check Environment section
+echo -n "Environment section... "
+if rg "^## Environment" "$SPEC_DIR/spec.md" > /dev/null 2>&1; then
+  echo "✅"
+else
+  echo "⚠️  (optional but recommended)"
+fi
+
+# Check Assumptions section
+echo -n "Assumptions section... "
+if rg "^## Assumptions" "$SPEC_DIR/spec.md" > /dev/null 2>&1; then
+  echo "✅"
+else
+  echo "⚠️  (optional but recommended)"
+fi
+
+# Check Requirements section
+echo -n "Requirements section... "
+if rg "^## Requirements" "$SPEC_DIR/spec.md" > /dev/null 2>&1; then
+  echo "✅"
+else
+  echo "❌"
+  echo "  Missing Requirements section"
+fi
+
+# Check duplicate IDs
+SPEC_ID=$(basename "$SPEC_DIR" | sed 's/SPEC-//')
+echo -n "Duplicate ID check ($SPEC_ID)... "
+DUPLICATE_COUNT=$(rg "@SPEC:$SPEC_ID" -n .moai/specs/ 2>/dev/null | wc -l | tr -d ' ')
+if [ "$DUPLICATE_COUNT" -eq 1 ]; then
+  echo "✅ (1 occurrence)"
+else
+  echo "❌ (found $DUPLICATE_COUNT occurrences)"
+  if [ "$DUPLICATE_COUNT" -gt 1 ]; then
+    echo "  Duplicate SPEC IDs detected:"
+    rg "@SPEC:$SPEC_ID" -n .moai/specs/
+  fi
+fi
+
+# Check EARS patterns
+echo ""
+echo "EARS Pattern Usage:"
+echo -n "  Ubiquitous (UR-XXX)... "
+if rg "^\*\*UR-\d+" "$SPEC_DIR/spec.md" > /dev/null 2>&1; then
+  COUNT=$(rg "^\*\*UR-\d+" "$SPEC_DIR/spec.md" | wc -l | tr -d ' ')
+  echo "✅ ($COUNT found)"
+else
+  echo "⚠️  (none found)"
+fi
+
+echo -n "  Event-driven (ER-XXX)... "
+if rg "^\*\*ER-\d+" "$SPEC_DIR/spec.md" > /dev/null 2>&1; then
+  COUNT=$(rg "^\*\*ER-\d+" "$SPEC_DIR/spec.md" | wc -l | tr -d ' ')
+  echo "✅ ($COUNT found)"
+else
+  echo "⚠️  (none found)"
+fi
+
+echo -n "  State-driven (SR-XXX)... "
+if rg "^\*\*SR-\d+" "$SPEC_DIR/spec.md" > /dev/null 2>&1; then
+  COUNT=$(rg "^\*\*SR-\d+" "$SPEC_DIR/spec.md" | wc -l | tr -d ' ')
+  echo "✅ ($COUNT found)"
+else
+  echo "⚠️  (none found)"
+fi
+
+echo -n "  Optional Features (OF-XXX)... "
+if rg "^\*\*OF-\d+" "$SPEC_DIR/spec.md" > /dev/null 2>&1; then
+  COUNT=$(rg "^\*\*OF-\d+" "$SPEC_DIR/spec.md" | wc -l | tr -d ' ')
+  echo "✅ ($COUNT found)"
+else
+  echo "⚠️  (none found)"
+fi
+
+echo -n "  Constraints (C-XXX)... "
+if rg "^\*\*C-\d+" "$SPEC_DIR/spec.md" > /dev/null 2>&1; then
+  COUNT=$(rg "^\*\*C-\d+" "$SPEC_DIR/spec.md" | wc -l | tr -d ' ')
+  echo "✅ ($COUNT found)"
+else
+  echo "⚠️  (none found)"
+fi
+
+echo ""
+echo "=========================================="
+echo "Validation complete!"
+echo "=========================================="

moai_adk/templates/CLAUDE.md

@@ -2,6 +2,13 @@
 
 **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`
+>
+> 💡 **Alfred와의 모든 상호작용에서 `Skill("moai-alfred-interactive-questions")`를 통해 TUI 메뉴로 응답할 수 있습니다.**
+> All interactions with Alfred can use `Skill("moai-alfred-interactive-questions")` for TUI-based responses.
+
 ---
 
 ## ▶◀ Meet Alfred: Your MoAI SuperAgent
@@ -10,49 +17,53 @@
 
 ### 4-Layer Architecture (v0.4.0)
 
-| Layer | Owner | Purpose | Examples |
-| --- | --- | --- | --- |
-| **Commands** | User ↔ Alfred | Workflow entry points that establish the Plan → Run → Sync cadence | `/alfred:0-project`, `/alfred:1-plan`, `/alfred:2-run`, `/alfred:3-sync` |
-| **Sub-agents** | Alfred | Deep reasoning and decision making for each phase | project-manager, spec-builder, code-builder pipeline, doc-syncer |
-| **Skills (44)** | Claude Skills | Reusable knowledge capsules loaded just-in-time | Foundation (TRUST/TAG/Git), Essentials (debug/refactor/review), Domain & Language packs |
-| **Hooks** | Runtime guardrails | Fast validation + JIT context hints (<100 ms) | SessionStart status card, PreToolUse destructive-command blocker |
+| Layer           | Owner              | Purpose                                                            | Examples                                                                                                 |
+| --------------- | ------------------ | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
+| **Commands**    | User ↔ Alfred      | Workflow entry points that establish the Plan → Run → Sync cadence | `/alfred:0-project`, `/alfred:1-plan`, `/alfred:2-run`, `/alfred:3-sync`                                 |
+| **Sub-agents**  | Alfred             | Deep reasoning and decision making for each phase                  | project-manager, spec-builder, code-builder pipeline, doc-syncer                                         |
+| **Skills (55)** | Claude Skills      | Reusable knowledge capsules loaded just-in-time                    | Foundation (TRUST/TAG/Git), Essentials (debug/refactor/review), Alfred workflow, Domain & Language packs |
+| **Hooks**       | Runtime guardrails | Fast validation + JIT context hints (<100 ms)                      | SessionStart status card, PreToolUse destructive-command blocker                                         |
 
 ### Core Sub-agent Roster
 
 > Alfred + 10 core sub-agents + 6 zero-project specialists + 2 built-in Claude agents = **19-member team**
-
-| Sub-agent | Model | Phase | Responsibility | Trigger |
-| --- | --- | --- | --- | --- |
-| **project-manager** 📋 | Sonnet | Init | Project bootstrap, metadata interview, mode selection | `/alfred:0-project` |
-| **spec-builder** 🏗️ | Sonnet | Plan | Plan board consolidation, EARS-based SPEC authoring | `/alfred:1-plan` |
-| **code-builder pipeline** 💎 | Sonnet | Run | Phase 1 `implementation-planner` → Phase 2 `tdd-implementer` to execute RED → GREEN → REFACTOR | `/alfred:2-run` |
-| **doc-syncer** 📖 | Haiku | Sync | Living documentation, README/CHANGELOG updates | `/alfred:3-sync` |
-| **tag-agent** 🏷️ | Haiku | Sync | TAG inventory, orphan detection, chain repair | `@agent-tag-agent` |
-| **git-manager** 🚀 | Haiku | Plan · Sync | GitFlow automation, Draft→Ready PR, auto-merge policy | `@agent-git-manager` |
-| **debug-helper** 🔍 | Sonnet | Run | Failure diagnosis, fix-forward guidance | `@agent-debug-helper` |
-| **trust-checker** ✅ | Haiku | All phases | TRUST 5 principle enforcement and risk flags | `@agent-trust-checker` |
-| **quality-gate** 🛡️ | Haiku | Sync | Coverage delta review, release gate validation | Auto during `/alfred:3-sync` |
-| **cc-manager** 🛠️ | Sonnet | Ops | Claude Code session tuning, Skill lifecycle management | `@agent-cc-manager` |
+>
+> **Note on Counting**: The "code-builder pipeline" is counted as 1 conceptual agent but implemented as 2 physical files (`implementation-planner` + `tdd-implementer`) for sequential RED → GREEN → REFACTOR execution. This maintains the 19-member team concept while acknowledging that 20 distinct agent files exist in `.claude/agents/alfred/`.
+
+| Sub-agent                   | Model  | Phase       | Responsibility                                                                                 | Trigger                      |
+| --------------------------- | ------ | ----------- | ---------------------------------------------------------------------------------------------- | ---------------------------- |
+| **project-manager** 📋       | Sonnet | Init        | Project bootstrap, metadata interview, mode selection                                          | `/alfred:0-project`          |
+| **spec-builder** 🏗️          | Sonnet | Plan        | Plan board consolidation, EARS-based SPEC authoring                                            | `/alfred:1-plan`             |
+| **code-builder pipeline** 💎 | Sonnet | Run         | Phase 1 `implementation-planner` → Phase 2 `tdd-implementer` to execute RED → GREEN → REFACTOR | `/alfred:2-run`              |
+| **doc-syncer** 📖            | Haiku  | Sync        | Living documentation, README/CHANGELOG updates                                                 | `/alfred:3-sync`             |
+| **tag-agent** 🏷️             | Haiku  | Sync        | TAG inventory, orphan detection, chain repair                                                  | `@agent-tag-agent`           |
+| **git-manager** 🚀           | Haiku  | Plan · Sync | GitFlow automation, Draft→Ready PR, auto-merge policy                                          | `@agent-git-manager`         |
+| **debug-helper** 🔍          | Sonnet | Run         | Failure diagnosis, fix-forward guidance                                                        | `@agent-debug-helper`        |
+| **trust-checker** ✅         | Haiku  | All phases  | TRUST 5 principle enforcement and risk flags                                                   | `@agent-trust-checker`       |
+| **quality-gate** 🛡️          | Haiku  | Sync        | Coverage delta review, release gate validation                                                 | Auto during `/alfred:3-sync` |
+| **cc-manager** 🛠️            | Sonnet | Ops         | Claude Code session tuning, Skill lifecycle management                                         | `@agent-cc-manager`          |
 
 The **code-builder pipeline** runs two Sonnet specialists in sequence: **implementation-planner** (strategy, libraries, TAG design) followed by **tdd-implementer** (RED → GREEN → REFACTOR execution).
 
 ### Zero-project Specialists
 
-| Sub-agent | Model | Focus | Trigger |
-| --- | --- | --- | --- |
-| **language-detector** 🔍 | Haiku | Stack detection, language matrix | Auto during `/alfred:0-project` |
-| **backup-merger** 📦 | Sonnet | Backup restore, checkpoint diff | `@agent-backup-merger` |
-| **project-interviewer** 💬 | Sonnet | Requirement interviews, persona capture | `/alfred:0-project` Q&A |
-| **document-generator** 📝 | Haiku | Project docs seed (`product.md`, `structure.md`, `tech.md`) | `/alfred:0-project` |
-| **feature-selector** 🎯 | Haiku | Skill pack recommendation | `/alfred:0-project` |
-| **template-optimizer** ⚙️ | Haiku | Template cleanup, migration helpers | `/alfred:0-project` |
+| Sub-agent                 | Model  | Focus                                                       | Trigger                         |
+| ------------------------- | ------ | ----------------------------------------------------------- | ------------------------------- |
+| **language-detector** 🔍   | Haiku  | Stack detection, language matrix                            | Auto during `/alfred:0-project` |
+| **backup-merger** 📦       | Sonnet | Backup restore, checkpoint diff                             | `@agent-backup-merger`          |
+| **project-interviewer** 💬 | Sonnet | Requirement interviews, persona capture                     | `/alfred:0-project` Q&A         |
+| **document-generator** 📝  | Haiku  | Project docs seed (`product.md`, `structure.md`, `tech.md`) | `/alfred:0-project`             |
+| **feature-selector** 🎯    | Haiku  | Skill pack recommendation                                   | `/alfred:0-project`             |
+| **template-optimizer** ⚙️  | Haiku  | Template cleanup, migration helpers                         | `/alfred:0-project`             |
+
+> **Implementation Note**: Zero-project specialists may be embedded within other agents (e.g., functionality within `project-manager`) or implemented as dedicated Skills (e.g., `moai-alfred-language-detection`). For example, `language-detector` functionality is provided by the `moai-alfred-language-detection` Skill during `/alfred:0-project` initialization.
 
 ### Built-in Claude Agents
 
-| Agent | Model | Specialty | Invocation |
-| --- | --- | --- | --- |
-| **Explore** 🔍 | Haiku | Repository-wide search & architecture mapping | `@agent-Explore` |
-| **general-purpose** | Sonnet | General assistance | Automatic |
+| Agent               | Model  | Specialty                                     | Invocation       |
+| ------------------- | ------ | --------------------------------------------- | ---------------- |
+| **Explore** 🔍       | Haiku  | Repository-wide search & architecture mapping | `@agent-Explore` |
+| **general-purpose** | Sonnet | General assistance                            | Automatic        |
 
 #### Explore Agent Guide
 
@@ -107,29 +118,57 @@ User: "Where is JWT authentication implemented in this project?"
 - `medium`: moderate sweep (multiple locations + naming rules) — **recommended**
 - `very thorough`: exhaustive scan (full codebase analysis)
 
-### Claude Skills (44 packs)
+### Claude Skills (55 packs)
+
+Alfred relies on 55 Claude Skills grouped by tier. Skills load via Progressive Disclosure: metadata is available at session start, full `SKILL.md` content loads when a sub-agent references it, and supporting templates stream only when required.
+
+**Skills Distribution by Tier**:
 
-Alfred relies on 44 Claude Skills grouped by tier. Skills load via Progressive Disclosure: metadata is available at session start, full `SKILL.md` content loads when a sub-agent references it, and supporting templates stream only when required.
+| Tier            | Count  | Purpose                                      |
+| --------------- | ------ | -------------------------------------------- |
+| Foundation      | 6      | Core TRUST/TAG/SPEC/Git/EARS/Lang principles |
+| Essentials      | 4      | Debug/Perf/Refactor/Review workflows         |
+| Alfred          | 11     | Internal workflow orchestration              |
+| Domain          | 10     | Specialized domain expertise                 |
+| Language        | 23     | Language-specific best practices             |
+| Claude Code Ops | 1      | Session management                           |
+| **Total**       | **55** | Complete knowledge capsule library           |
 
 **Foundation Tier (6)**
 
-| Skill | Purpose | Auto-load |
-| --- | --- | --- |
+| Skill                   | Purpose                                 | Auto-load                      |
+| ----------------------- | --------------------------------------- | ------------------------------ |
 | `moai-foundation-trust` | TRUST checklist, coverage gate policies | SessionStart, `/alfred:3-sync` |
-| `moai-foundation-tags` | TAG inventory & orphan detection | `/alfred:3-sync` |
-| `moai-foundation-specs` | SPEC metadata policy and versioning | `/alfred:1-plan` |
-| `moai-foundation-ears` | EARS templates and requirement phrasing | `/alfred:1-plan` |
-| `moai-foundation-git` | GitFlow automation & PR policy | Plan/Run/Sync |
-| `moai-foundation-langs` | Language detection & Skill preload | SessionStart, `/alfred:2-run` |
+| `moai-foundation-tags`  | TAG inventory & orphan detection        | `/alfred:3-sync`               |
+| `moai-foundation-specs` | SPEC metadata policy and versioning     | `/alfred:1-plan`               |
+| `moai-foundation-ears`  | EARS templates and requirement phrasing | `/alfred:1-plan`               |
+| `moai-foundation-git`   | GitFlow automation & PR policy          | Plan/Run/Sync                  |
+| `moai-foundation-langs` | Language detection & Skill preload      | SessionStart, `/alfred:2-run`  |
 
 **Essentials Tier (4)**
 
-| Skill | Purpose | Auto-load |
-| --- | --- | --- |
-| `moai-essentials-debug` | Failure diagnosis & reproduction checklist | Auto when `/alfred:2-run` detects failures |
-| `moai-essentials-perf` | Performance analysis & profiling strategies | On demand |
-| `moai-essentials-refactor` | Refactoring patterns & code-smell remediation | `/alfred:2-run` |
-| `moai-essentials-review` | Code review checklist & quality feedback | `/alfred:3-sync` |
+| Skill                      | Purpose                                       | Auto-load                                  |
+| -------------------------- | --------------------------------------------- | ------------------------------------------ |
+| `moai-essentials-debug`    | Failure diagnosis & reproduction checklist    | Auto when `/alfred:2-run` detects failures |
+| `moai-essentials-perf`     | Performance analysis & profiling strategies   | On demand                                  |
+| `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
+
+| Skill                                  | Purpose                              | Auto-load                         |
+| -------------------------------------- | ------------------------------------ | --------------------------------- |
+| `moai-alfred-code-reviewer`            | Automated code quality review        | `/alfred:3-sync`                  |
+| `moai-alfred-debugger-pro`             | Advanced debugging strategies        | `/alfred:2-run` failures          |
+| `moai-alfred-ears-authoring`           | EARS syntax validation & templates   | `/alfred:1-plan`                  |
+| `moai-alfred-git-workflow`             | GitFlow automation patterns          | Plan/Run/Sync                     |
+| `moai-alfred-language-detection`       | Stack detection & Skill preload      | SessionStart, `/alfred:0-project` |
+| `moai-alfred-performance-optimizer`    | Performance profiling & optimization | On demand                         |
+| `moai-alfred-refactoring-coach`        | Refactoring guidance & patterns      | `/alfred:2-run`                   |
+| `moai-alfred-spec-metadata-validation` | SPEC metadata policy enforcement     | `/alfred:1-plan`                  |
+| `moai-alfred-tag-scanning`             | TAG integrity & orphan detection     | `/alfred:3-sync`                  |
+| `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`.
 
@@ -149,10 +188,10 @@ Skills keep the core knowledge lightweight while allowing Alfred to assemble the
 
 ### Model Selection Guide
 
-| Model | Primary use cases | Representative sub-agents | Why it fits |
-| --- | --- | --- | --- |
-| **Claude 4.5 Haiku** | Documentation sync, TAG inventory, Git automation, rule-based checks | doc-syncer, tag-agent, git-manager, trust-checker, quality-gate, Explore | Fast, deterministic output for patterned or string-heavy work |
-| **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 |
+| Model                 | Primary use cases                                                    | Representative sub-agents                                                              | Why it fits                                                    |
+| --------------------- | -------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------------------- |
+| **Claude 4.5 Haiku**  | Documentation sync, TAG inventory, Git automation, rule-based checks | doc-syncer, tag-agent, git-manager, trust-checker, quality-gate, Explore               | Fast, deterministic output for patterned or string-heavy work  |
+| **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.
@@ -163,16 +202,16 @@ Skills keep the core knowledge lightweight while allowing Alfred to assemble the
 
 Alfred commands follow a three-phase loop, with an optional bootstrap stage for `/alfred:0-project`.
 
-- **Phase 0 — Bootstrap (optional)**  
+- **Phase 0 — Bootstrap (optional)**
   Capture project metadata, create `.moai/config.json` and project docs, detect languages, and stage the recommended Skill packs.
 
-- **Phase 1 — Analyze & Plan**  
+- **Phase 1 — Analyze & Plan**
   Understand scope, constraints, and desired outputs; review existing context (files, specs, tests); outline the execution plan and surface risks.
 
-- **Phase 2 — Execute**  
+- **Phase 2 — Execute**
   Run the approved steps in order, log progress in the task thread, escalate blockers immediately with mitigation options, and record decisions.
 
-- **Phase 3 — Sync & Handoff**  
+- **Phase 3 — Sync & Handoff**
   Update docs, TAG inventory, and reports; verify quality gates; summarize outcomes; and suggest the next command or manual follow-up.
 
 ### Alfred's Next-Step Suggestion Principles
@@ -310,7 +349,7 @@ Refs: @TAG-ID (if applicable)
 
 ### Solution: Interactive Question Tool + TUI Survey Skill
 
-Claude Code now features an **Interactive Question Tool** powered by the `moai-alfred-tui-survey` Skill that transforms vague requests into precise, contextual specifications through guided clarification. Instead of AI making assumptions, the tool actively:
+Claude Code now features an **Interactive Question Tool** powered by the `moai-alfred-interactive-questions` Skill that transforms vague requests into precise, contextual specifications through guided clarification. Instead of AI making assumptions, the tool actively:
 
 1. **Analyzes** existing code and project context
 2. **Identifies** ambiguity and competing approaches
@@ -318,11 +357,11 @@ Claude Code now features an **Interactive Question Tool** powered by the `moai-a
 4. **Captures** explicit user choices (arrow keys, enter)
 5. **Executes** with certainty based on confirmed intent
 
-**Implementation**: The `moai-alfred-tui-survey` Skill provides interactive survey menus that render as terminal UI elements, allowing users to navigate options with arrow keys and confirm with enter.
+**Implementation**: The `moai-alfred-interactive-questions` Skill provides interactive survey menus that render as terminal UI elements, allowing users to navigate options with arrow keys and confirm with enter.
 
 ### How It Works
 
-When you provide a high-level request, Alfred may invoke the `moai-alfred-tui-survey` Skill to clarify implementation details through structured TUI menus:
+When you provide a high-level request, Alfred may invoke the `moai-alfred-interactive-questions` Skill to clarify implementation details through structured TUI menus:
 
 ```
 User: "Add a completion page for the competition."
@@ -366,13 +405,13 @@ Execution with confirmed specifications
 
 ### Key Benefits
 
-| Benefit | Impact |
-| --- | --- |
-| **Reduced ambiguity** | AI asks before acting; eliminates guess work |
-| **Faster iteration** | Choices are presented upfront, not discovered after implementation |
-| **Higher quality** | Implementation matches intent precisely |
-| **Lower communication cost** | Answering 3-5 specific questions beats endless refinement |
-| **Active collaboration** | AI becomes a partner, not just a code generator |
+| Benefit                      | Impact                                                             |
+| ---------------------------- | ------------------------------------------------------------------ |
+| **Reduced ambiguity**        | AI asks before acting; eliminates guess work                       |
+| **Faster iteration**         | Choices are presented upfront, not discovered after implementation |
+| **Higher quality**           | Implementation matches intent precisely                            |
+| **Lower communication cost** | Answering 3-5 specific questions beats endless refinement          |
+| **Active collaboration**     | AI becomes a partner, not just a code generator                    |
 
 ### When to Use Interactive Questions
 
@@ -424,7 +463,7 @@ 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-tui-survey activated)**
+**Step 2: Interactive Survey (moai-alfred-interactive-questions activated)**
 
 ```
 ────────────────────────────────────────────────────────────────
@@ -526,15 +565,15 @@ MoAI-ADK assigns every responsibility to a dedicated execution layer.
 - Examples: spec-builder, code-builder pipeline, doc-syncer, tag-agent, git-manager.
 - Communicate status, escalate blockers, and request Skills when additional knowledge is required.
 
-### Skills — Reusable knowledge capsules (44 packs)
+### Skills — Reusable knowledge capsules (55 packs)
 
 - <500-word playbooks stored under `.claude/skills/`.
 - Loaded via Progressive Disclosure only when relevant.
-- Provide standard templates, best practices, and checklists across Foundation, Essentials, Domain, Language, and Ops tiers.
+- Provide standard templates, best practices, and checklists across Foundation, Essentials, Alfred, Domain, Language, and Ops tiers.
 
 ### Hooks — Guardrails & just-in-time context
 
-- Lightweight (<100 ms) checks triggered by session events.
+- Lightweight (<100 ms) checks triggered by session events.
 - Block destructive commands, surface status cards, and seed context pointers.
 - Examples: SessionStart project summary, PreToolUse safety checks.
 
@@ -714,22 +753,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}}
-- **Conversation Language**: {{CONVERSATION_LANGUAGE}} ({{CONVERSATION_LANGUAGE_NAME}})
-- **Codebase Language**: {{CODEBASE_LANGUAGE}}
-- **Toolchain**: Automatically selects the best tools for the chosen language
+- **이름 | 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
 
-### Language Configuration
+### 언어 설정 | Language Configuration
 
-- **Conversation Language** (`{{CONVERSATION_LANGUAGE}}`): 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}}`): 모든 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}})
 
 ---
 
-**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 the selected language.
+**주의 | 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.