moai-adk 0.4.7__py3-none-any.whl → 0.4.10__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

@@ -1,7 +1,25 @@
-# {{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**: {{project_owner}}
+> **Config**: `.moai/config.json` → `project.conversation_language`
+>
+> 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
@@ -10,12 +28,12 @@
 
 ### 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 (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 |
+| 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
 
@@ -23,40 +41,40 @@
 >
 > **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` |
+| 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
 
@@ -117,51 +135,51 @@ Alfred relies on 55 Claude Skills grouped by tier. Skills load via Progressive D
 
 **Skills Distribution by Tier**:
 
-| 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 |
+| 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-tui-survey` | Interactive user surveys & menus | On demand |
+| 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`.
 
@@ -181,10 +199,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.
@@ -342,7 +360,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
@@ -350,11 +368,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."
@@ -398,13 +416,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
 
@@ -456,7 +474,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)**
 
 ```
 ────────────────────────────────────────────────────────────────
@@ -748,20 +766,21 @@ Alfred enforces these quality gates on every change:
 
 ## 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**: {{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
 
-- **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}}`): 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**: 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}}.