Initial commit

2025-11-30 08:29:39 +08:00
commit d0feb2b434
18 changed files with 2296 additions and 0 deletions
--- a/commands/prompt.md
+++ b/commands/prompt.md
@@ -0,0 +1,53 @@
+---
+name: prompt
+description: Optimize a prompt using templates and execute with specialized skills
+argument-hint: [--template=<name>] [--code|--refactor|--review|--test|--docs|--documentation|--extract|--compare|--comparison|--custom] [--plan] [--return-only] <task description>
+allowed-tools: [Task, TodoWrite, Bash(~/.claude/plugins/marketplaces/claude-experiments/meta-prompt/commands/scripts/prompt-handler.sh:*)]
+---
+
+Execute tasks using optimized prompts with domain-specific skills.
+
+<task>{$TASK_DESCRIPTION}</task>
+
+## Process
+
+1. **Call handler** with the task:
+   ```bash
+   ~/.claude/plugins/marketplaces/claude-experiments/meta-prompt/commands/scripts/prompt-handler.sh "{$TASK_DESCRIPTION}"
+   ```
+
+2. **Parse XML response** from handler:
+   - Extract `<todos>` and call TodoWrite with the todo items
+   - Extract `<task_tool>` for subagent parameters
+   - Check `<next_action>` and `<final_action>` for flow control
+
+3. **Update TodoWrite** from `<todos>`:
+   Parse each `<todo status="..." content="..." activeForm="..."/>` and call TodoWrite with the array.
+
+   **Example transformation:**
+   ```xml
+   <todos>
+   <todo status="in_progress" content="Optimize prompt" activeForm="Optimizing prompt"/>
+   <todo status="pending" content="Execute task" activeForm="Executing task"/>
+   </todos>
+   ```
+   Becomes TodoWrite input:
+   ```json
+   [
+     {"status": "in_progress", "content": "Optimize prompt", "activeForm": "Optimizing prompt"},
+     {"status": "pending", "content": "Execute task", "activeForm": "Executing task"}
+   ]
+   ```
+
+4. **Execute based on `<next_action>`:**
+   - If spawning subagent: Use Task tool with `<subagent_type>`, `<description>`, `<prompt>`
+   - Pass subagent XML results back to handler via `<next_handler_call>`
+   - If `<final_action>` present: execute that action instead of looping
+
+5. **Handle `<final_action>` values:**
+   - `present_results`: Display the task execution results to the user
+   - `present_optimized_prompt`: Display the optimized prompt to the user (for --return-only mode)
+
+6. **Loop until `<next_action>done</next_action>`**
+
+7. **Present results** to user when complete.
--- a/commands/scripts/prompt-handler.sh
+++ b/commands/scripts/prompt-handler.sh
@@ -0,0 +1,542 @@
+#!/usr/bin/env bash
+# Purpose: State machine for /prompt command orchestration
+# Inputs: Structured XML via stdin OR command-line args for initial state
+# Outputs: Next instruction for /prompt command
+# Architecture: State machine that guides /prompt through:
+#   - Without --plan: optimizer → executor → done
+#   - With --plan: optimizer → Plan agent → executor → done
+
+set -euo pipefail
+
+# Source common functions
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+. "$SCRIPT_DIR/../../scripts/common.sh"
+
+# Detect current state from input
+detect_state() {
+    local input="$1"
+
+    if echo "$input" | grep -q "<template_selector_result>"; then
+        echo "post_template_selector"
+    elif echo "$input" | grep -q "<prompt_optimizer_result>"; then
+        echo "post_optimizer"
+    elif echo "$input" | grep -q "<plan_result>"; then
+        echo "post_plan"
+    elif echo "$input" | grep -q "<template_executor_result>"; then
+        echo "final"
+    else
+        # Initial state (command-line args or initial XML)
+        echo "initial"
+    fi
+}
+
+# Parse flags from initial task description
+# Sets global variables: RETURN_ONLY, PLAN, TEMPLATE, TEMPLATE_FLAG_SEEN, TASK_DESCRIPTION
+parse_initial_flags() {
+    local raw_input="$1"
+
+    # Set global variables for use by handler functions
+    RETURN_ONLY=false
+    PLAN=false
+    TEMPLATE=""
+    TEMPLATE_FLAG_SEEN=false
+
+    # Parse all flags from the beginning of the input
+    while true; do
+        case "$raw_input" in
+            --template=*)
+                if [ "$TEMPLATE_FLAG_SEEN" = true ]; then
+                    echo "Error: Multiple template flags specified." >&2
+                    exit 1
+                fi
+                TEMPLATE="${raw_input#--template=}"
+                TEMPLATE="${TEMPLATE%% *}"
+                raw_input="${raw_input#--template=$TEMPLATE}"
+                raw_input="${raw_input# }"
+                TEMPLATE_FLAG_SEEN=true
+                ;;
+            --code\ *|--code)
+                if [ "$TEMPLATE_FLAG_SEEN" = true ]; then
+                    echo "Error: Multiple template flags specified." >&2
+                    echo "Already set: $TEMPLATE" >&2
+                    echo "Cannot use multiple template flags in one command." >&2
+                    exit 1
+                fi
+                TEMPLATE="code-refactoring"
+                TEMPLATE_FLAG_SEEN=true
+                raw_input="${raw_input#--code}"
+                raw_input="${raw_input# }"
+                ;;
+            --refactor\ *|--refactor)
+                if [ "$TEMPLATE_FLAG_SEEN" = true ]; then
+                    echo "Error: Multiple template flags specified." >&2
+                    exit 1
+                fi
+                TEMPLATE="code-refactoring"
+                TEMPLATE_FLAG_SEEN=true
+                raw_input="${raw_input#--refactor}"
+                raw_input="${raw_input# }"
+                ;;
+            --review\ *|--review)
+                if [ "$TEMPLATE_FLAG_SEEN" = true ]; then
+                    echo "Error: Multiple template flags specified." >&2
+                    exit 1
+                fi
+                TEMPLATE="code-review"
+                TEMPLATE_FLAG_SEEN=true
+                raw_input="${raw_input#--review}"
+                raw_input="${raw_input# }"
+                ;;
+            --test\ *|--test)
+                if [ "$TEMPLATE_FLAG_SEEN" = true ]; then
+                    echo "Error: Multiple template flags specified." >&2
+                    exit 1
+                fi
+                TEMPLATE="test-generation"
+                TEMPLATE_FLAG_SEEN=true
+                raw_input="${raw_input#--test}"
+                raw_input="${raw_input# }"
+                ;;
+            --docs\ *|--docs)
+                if [ "$TEMPLATE_FLAG_SEEN" = true ]; then
+                    echo "Error: Multiple template flags specified." >&2
+                    exit 1
+                fi
+                TEMPLATE="documentation-generator"
+                TEMPLATE_FLAG_SEEN=true
+                raw_input="${raw_input#--docs}"
+                raw_input="${raw_input# }"
+                ;;
+            --documentation\ *|--documentation)
+                if [ "$TEMPLATE_FLAG_SEEN" = true ]; then
+                    echo "Error: Multiple template flags specified." >&2
+                    exit 1
+                fi
+                TEMPLATE="documentation-generator"
+                TEMPLATE_FLAG_SEEN=true
+                raw_input="${raw_input#--documentation}"
+                raw_input="${raw_input# }"
+                ;;
+            --extract\ *|--extract)
+                if [ "$TEMPLATE_FLAG_SEEN" = true ]; then
+                    echo "Error: Multiple template flags specified." >&2
+                    exit 1
+                fi
+                TEMPLATE="data-extraction"
+                TEMPLATE_FLAG_SEEN=true
+                raw_input="${raw_input#--extract}"
+                raw_input="${raw_input# }"
+                ;;
+            --compare\ *|--compare)
+                if [ "$TEMPLATE_FLAG_SEEN" = true ]; then
+                    echo "Error: Multiple template flags specified." >&2
+                    exit 1
+                fi
+                TEMPLATE="code-comparison"
+                TEMPLATE_FLAG_SEEN=true
+                raw_input="${raw_input#--compare}"
+                raw_input="${raw_input# }"
+                ;;
+            --comparison\ *|--comparison)
+                if [ "$TEMPLATE_FLAG_SEEN" = true ]; then
+                    echo "Error: Multiple template flags specified." >&2
+                    exit 1
+                fi
+                TEMPLATE="code-comparison"
+                TEMPLATE_FLAG_SEEN=true
+                raw_input="${raw_input#--comparison}"
+                raw_input="${raw_input# }"
+                ;;
+            --custom\ *|--custom)
+                if [ "$TEMPLATE_FLAG_SEEN" = true ]; then
+                    echo "Error: Multiple template flags specified." >&2
+                    exit 1
+                fi
+                TEMPLATE="custom"
+                TEMPLATE_FLAG_SEEN=true
+                raw_input="${raw_input#--custom}"
+                raw_input="${raw_input# }"
+                ;;
+            --return-only\ *|--return-only)
+                RETURN_ONLY=true
+                raw_input="${raw_input#--return-only}"
+                raw_input="${raw_input# }"
+                ;;
+            --plan\ *|--plan)
+                PLAN=true
+                raw_input="${raw_input#--plan}"
+                raw_input="${raw_input# }"
+                ;;
+            *)
+                # No more flags, break out of loop
+                break
+                ;;
+        esac
+    done
+
+    # Validate template name if provided
+    if [ -n "$TEMPLATE" ]; then
+        case "$TEMPLATE" in
+            code-refactoring|code-review|test-generation|documentation-generator|data-extraction|code-comparison|custom)
+                # Valid template
+                ;;
+            *)
+                echo "Error: Invalid template name: $TEMPLATE" >&2
+                exit 1
+                ;;
+        esac
+    fi
+
+    # Normalize whitespace and set global TASK_DESCRIPTION
+    raw_input=$(echo "$raw_input" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//' -e 's/[[:space:]][[:space:]]*/ /g')
+
+    TASK_DESCRIPTION="$raw_input"
+}
+
+# Handle initial state - spawn template-selector or prompt-optimizer
+handle_initial_state() {
+    parse_initial_flags "$1"
+    # Sanitize for shell safety, then escape for CDATA safety
+    local sanitized_task=$(escape_cdata "$(sanitize_input "$TASK_DESCRIPTION")")
+
+    # If no template specified, spawn template-selector first
+    if [ -z "$TEMPLATE" ]; then
+        cat <<EOF
+<handler_response>
+<state>initial</state>
+<next_action>spawn_template_selector</next_action>
+<todos>
+<todo status="in_progress" content="Determine template" activeForm="Determining template"/>
+<todo status="pending" content="Optimize prompt" activeForm="Optimizing prompt"/>
+<todo status="pending" content="Execute task" activeForm="Executing task"/>
+<todo status="pending" content="Present results" activeForm="Presenting results"/>
+</todos>
+<task_tool>
+<subagent_type>meta-prompt:template-selector</subagent_type>
+<description>Select template for task</description>
+<prompt><![CDATA[Select the best template for this task:
+
+<template_selector_request>
+<user_task>$sanitized_task</user_task>
+</template_selector_request>
+
+Follow your instructions to classify the task and return the result in XML format.]]></prompt>
+</task_tool>
+<next_handler_call><![CDATA[~/.claude/plugins/marketplaces/claude-experiments/meta-prompt/commands/scripts/prompt-handler.sh '<template_selector_result>...(full XML output)...</template_selector_result>
+<original_task>$sanitized_task</original_task>
+<plan_flag>$PLAN</plan_flag>
+<return_only_flag>$RETURN_ONLY</return_only_flag>']]></next_handler_call>
+</handler_response>
+EOF
+        return
+    fi
+
+    # Template already specified, proceed to optimizer
+    # Determine execution mode
+    local execution_mode="direct"
+    if [ "$PLAN" = true ]; then
+        execution_mode="plan"
+    fi
+
+    # Build template XML
+    local template_xml="<template>$TEMPLATE</template>"
+
+    # Check if return-only mode
+    if [ "$RETURN_ONLY" = true ]; then
+        cat <<EOF
+<handler_response>
+<state>initial</state>
+<next_action>spawn_optimizer_return_only</next_action>
+<todos>
+<todo status="in_progress" content="Optimize prompt" activeForm="Optimizing prompt"/>
+<todo status="pending" content="Present optimized prompt" activeForm="Presenting optimized prompt"/>
+</todos>
+<task_tool>
+<subagent_type>meta-prompt:prompt-optimizer</subagent_type>
+<description>Create optimized prompt</description>
+<prompt><![CDATA[Process this request and return an optimized prompt:
+
+<prompt_optimizer_request>
+<user_task>$sanitized_task</user_task>$template_xml
+<execution_mode>$execution_mode</execution_mode>
+</prompt_optimizer_request>
+
+Follow your instructions to process the template and return the result in XML format.]]></prompt>
+</task_tool>
+<final_action>present_optimized_prompt</final_action>
+</handler_response>
+EOF
+    else
+        cat <<EOF
+<handler_response>
+<state>initial</state>
+<next_action>spawn_optimizer</next_action>
+<todos>
+<todo status="in_progress" content="Optimize prompt" activeForm="Optimizing prompt"/>
+<todo status="pending" content="Execute task" activeForm="Executing task"/>
+<todo status="pending" content="Present results" activeForm="Presenting results"/>
+</todos>
+<task_tool>
+<subagent_type>meta-prompt:prompt-optimizer</subagent_type>
+<description>Create optimized prompt</description>
+<prompt><![CDATA[Process this request and return an optimized prompt:
+
+<prompt_optimizer_request>
+<user_task>$sanitized_task</user_task>$template_xml
+<execution_mode>$execution_mode</execution_mode>
+</prompt_optimizer_request>
+
+Follow your instructions to process the template and return the result in XML format.]]></prompt>
+</task_tool>
+<next_handler_call><![CDATA[~/.claude/plugins/marketplaces/claude-experiments/meta-prompt/commands/scripts/prompt-handler.sh '<prompt_optimizer_result>...(full XML output)...</prompt_optimizer_result>']]></next_handler_call>
+</handler_response>
+EOF
+    fi
+}
+
+# Handle post-template-selector state - spawn prompt-optimizer with selected template
+handle_post_template_selector_state() {
+    local selector_output="$1"
+
+    # Extract values from XML using sed (BSD-compatible)
+    local selected_template=$(echo "$selector_output" | sed -n 's/.*<selected_template>\(.*\)<\/selected_template>.*/\1/p')
+    local original_task=$(echo "$selector_output" | sed -n 's/.*<original_task>\(.*\)<\/original_task>.*/\1/p')
+    local plan_flag=$(echo "$selector_output" | sed -n 's/.*<plan_flag>\(.*\)<\/plan_flag>.*/\1/p')
+    local return_only_flag=$(echo "$selector_output" | sed -n 's/.*<return_only_flag>\(.*\)<\/return_only_flag>.*/\1/p')
+
+    # Sanitize for shell safety, then escape for CDATA safety
+    local sanitized_task=$(escape_cdata "$(sanitize_input "$original_task")")
+
+    # Determine execution mode
+    local execution_mode="direct"
+    if [ "$plan_flag" = "true" ]; then
+        execution_mode="plan"
+    fi
+
+    # Build template XML
+    local template_xml="<template>$selected_template</template>"
+
+    # Check if return-only mode
+    if [ "$return_only_flag" = "true" ]; then
+        cat <<EOF
+<handler_response>
+<state>post_template_selector</state>
+<next_action>spawn_optimizer_return_only</next_action>
+<todos>
+<todo status="completed" content="Determine template" activeForm="Determining template"/>
+<todo status="in_progress" content="Optimize prompt" activeForm="Optimizing prompt"/>
+<todo status="pending" content="Present optimized prompt" activeForm="Presenting optimized prompt"/>
+</todos>
+<task_tool>
+<subagent_type>meta-prompt:prompt-optimizer</subagent_type>
+<description>Create optimized prompt</description>
+<prompt><![CDATA[Process this request and return an optimized prompt:
+
+<prompt_optimizer_request>
+<user_task>$sanitized_task</user_task>$template_xml
+<execution_mode>$execution_mode</execution_mode>
+</prompt_optimizer_request>
+
+Follow your instructions to process the template and return the result in XML format.]]></prompt>
+</task_tool>
+<final_action>present_optimized_prompt</final_action>
+</handler_response>
+EOF
+    else
+        cat <<EOF
+<handler_response>
+<state>post_template_selector</state>
+<next_action>spawn_optimizer</next_action>
+<todos>
+<todo status="completed" content="Determine template" activeForm="Determining template"/>
+<todo status="in_progress" content="Optimize prompt" activeForm="Optimizing prompt"/>
+<todo status="pending" content="Execute task" activeForm="Executing task"/>
+<todo status="pending" content="Present results" activeForm="Presenting results"/>
+</todos>
+<task_tool>
+<subagent_type>meta-prompt:prompt-optimizer</subagent_type>
+<description>Create optimized prompt</description>
+<prompt><![CDATA[Process this request and return an optimized prompt:
+
+<prompt_optimizer_request>
+<user_task>$sanitized_task</user_task>$template_xml
+<execution_mode>$execution_mode</execution_mode>
+</prompt_optimizer_request>
+
+Follow your instructions to process the template and return the result in XML format.]]></prompt>
+</task_tool>
+<next_handler_call><![CDATA[~/.claude/plugins/marketplaces/claude-experiments/meta-prompt/commands/scripts/prompt-handler.sh '<prompt_optimizer_result>...(full XML output)...</prompt_optimizer_result>']]></next_handler_call>
+</handler_response>
+EOF
+    fi
+}
+
+# Handle post-optimizer state - spawn Plan or template-executor
+handle_post_optimizer_state() {
+    local optimizer_output="$1"
+
+    # Extract values from XML using sed (BSD-compatible)
+    local skill=$(echo "$optimizer_output" | sed -n 's/.*<skill>\(.*\)<\/skill>.*/\1/p')
+    local execution_mode=$(echo "$optimizer_output" | sed -n 's/.*<execution_mode>\(.*\)<\/execution_mode>.*/\1/p')
+    local optimized_prompt=$(echo "$optimizer_output" | sed -n 's/.*<optimized_prompt>\(.*\)<\/optimized_prompt>.*/\1/p')
+
+    # Sanitize for shell safety, then escape for CDATA safety
+    local sanitized_skill=$(escape_cdata "$(sanitize_input "$skill")")
+    local sanitized_prompt=$(escape_cdata "$optimized_prompt")
+
+    if [ "$execution_mode" = "plan" ]; then
+        cat <<EOF
+<handler_response>
+<state>post_optimizer</state>
+<next_action>spawn_plan_agent</next_action>
+<todos>
+<todo status="completed" content="Optimize prompt" activeForm="Optimizing prompt"/>
+<todo status="in_progress" content="Create plan" activeForm="Creating plan"/>
+<todo status="pending" content="Execute task" activeForm="Executing task"/>
+<todo status="pending" content="Present results" activeForm="Presenting results"/>
+</todos>
+<task_tool>
+<subagent_type>Plan</subagent_type>
+<description>Create execution plan</description>
+<prompt><![CDATA[SKILL_TO_LOAD: $sanitized_skill
+
+$sanitized_prompt]]></prompt>
+</task_tool>
+<next_handler_call><![CDATA[~/.claude/plugins/marketplaces/claude-experiments/meta-prompt/commands/scripts/prompt-handler.sh '<plan_result>
+<skill>$sanitized_skill</skill>
+<optimized_prompt>
+$sanitized_prompt
+</optimized_prompt>
+</plan_result>']]></next_handler_call>
+</handler_response>
+EOF
+    else
+        cat <<EOF
+<handler_response>
+<state>post_optimizer</state>
+<next_action>spawn_template_executor</next_action>
+<todos>
+<todo status="completed" content="Optimize prompt" activeForm="Optimizing prompt"/>
+<todo status="in_progress" content="Execute task" activeForm="Executing task"/>
+<todo status="pending" content="Present results" activeForm="Presenting results"/>
+</todos>
+<task_tool>
+<subagent_type>meta-prompt:template-executor</subagent_type>
+<description>Execute task</description>
+<prompt><![CDATA[SKILL_TO_LOAD: $sanitized_skill
+
+<template_executor_request>
+<skill>$sanitized_skill</skill>
+<optimized_prompt>
+$sanitized_prompt
+</optimized_prompt>
+</template_executor_request>
+
+Follow your instructions to load the skill (if not 'none') and execute the task.]]></prompt>
+</task_tool>
+<final_action>present_results</final_action>
+</handler_response>
+EOF
+    fi
+}
+
+# Handle post-plan state - spawn template-executor with the plan
+handle_post_plan_state() {
+    local plan_output="$1"
+
+    # Extract values from XML using sed (BSD-compatible)
+    local skill=$(echo "$plan_output" | sed -n 's/.*<skill>\(.*\)<\/skill>.*/\1/p')
+
+    # Extract optimized_prompt (multiline content)
+    local optimized_prompt=$(echo "$plan_output" | sed -n '/<optimized_prompt>/,/<\/optimized_prompt>/p' | sed '1d;$d')
+
+    # Sanitize for shell safety, then escape for CDATA safety
+    local sanitized_skill=$(escape_cdata "$(sanitize_input "$skill")")
+    local sanitized_prompt=$(escape_cdata "$optimized_prompt")
+
+    cat <<EOF
+<handler_response>
+<state>post_plan</state>
+<next_action>spawn_template_executor</next_action>
+<todos>
+<todo status="completed" content="Optimize prompt" activeForm="Optimizing prompt"/>
+<todo status="completed" content="Create plan" activeForm="Creating plan"/>
+<todo status="in_progress" content="Execute task" activeForm="Executing task"/>
+<todo status="pending" content="Present results" activeForm="Presenting results"/>
+</todos>
+<task_tool>
+<subagent_type>meta-prompt:template-executor</subagent_type>
+<description>Execute task</description>
+<prompt><![CDATA[SKILL_TO_LOAD: $sanitized_skill
+
+<template_executor_request>
+<skill>$sanitized_skill</skill>
+<optimized_prompt>
+$sanitized_prompt
+</optimized_prompt>
+</template_executor_request>
+
+Follow your instructions to load the skill (if not 'none') and execute the task.]]></prompt>
+</task_tool>
+<final_action>present_results</final_action>
+</handler_response>
+EOF
+}
+
+# Handle final state - just present results
+handle_final_state() {
+    cat <<EOF
+<handler_response>
+<state>final</state>
+<next_action>done</next_action>
+<todos>
+<todo status="completed" content="Optimize prompt" activeForm="Optimizing prompt"/>
+<todo status="completed" content="Execute task" activeForm="Executing task"/>
+<todo status="in_progress" content="Present results" activeForm="Presenting results"/>
+</todos>
+<final_action>present_results</final_action>
+</handler_response>
+EOF
+}
+
+# Main state machine logic
+main() {
+    # Check if input is provided as command-line arg
+    if [ $# -gt 0 ]; then
+        # Use command-line args
+        INPUT="$1"
+        # Detect state from input
+        STATE=$(detect_state "$INPUT")
+    else
+        # No input provided
+        echo "Error: No input provided. Usage: $0 '<task description>'" >&2
+        echo "   Or: $0 '<xml>'" >&2
+        exit 1
+    fi
+
+    # Execute state handler
+    case "$STATE" in
+        initial)
+            handle_initial_state "$INPUT"
+            ;;
+        post_template_selector)
+            handle_post_template_selector_state "$INPUT"
+            ;;
+        post_optimizer)
+            handle_post_optimizer_state "$INPUT"
+            ;;
+        post_plan)
+            handle_post_plan_state "$INPUT"
+            ;;
+        final)
+            handle_final_state
+            ;;
+        *)
+            echo "Error: Unknown state: $STATE" >&2
+            exit 1
+            ;;
+    esac
+}
+
+# Run main function
+main "$@"
--- a/commands/scripts/verify-installation.sh
+++ b/commands/scripts/verify-installation.sh
@@ -0,0 +1,141 @@
+#!/usr/bin/env bash
+# Purpose: Verify meta-prompt plugin installation
+# Usage: ./verify-installation.sh
+# Exits: 0 if installation is valid, 1 if issues found
+
+set -euo pipefail
+
+# ANSI colors (only use if terminal supports them)
+if [ -t 1 ] && command -v tput >/dev/null 2>&1 && [ "$(tput colors 2>/dev/null || echo 0)" -ge 8 ]; then
+    GREEN='\033[0;32m'
+    RED='\033[0;31m'
+    YELLOW='\033[1;33m'
+    NC='\033[0m'
+else
+    GREEN=''
+    RED=''
+    YELLOW=''
+    NC=''
+fi
+
+# Setup: Set CLAUDE_PLUGIN_ROOT if not already set
+if [ -z "${CLAUDE_PLUGIN_ROOT:-}" ]; then
+    # Try to derive from script location (commands/scripts/ -> 2 levels up)
+    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    if [ -d "$SCRIPT_DIR/../../templates" ]; then
+        CLAUDE_PLUGIN_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+    else
+        # Fallback to hardcoded path for standard installation
+        CLAUDE_PLUGIN_ROOT="$HOME/.claude/plugins/marketplaces/claude-experiments/meta-prompt"
+    fi
+fi
+
+echo -e "${YELLOW}Meta-Prompt Installation Verification${NC}"
+echo "========================================"
+echo ""
+echo "Plugin root: $CLAUDE_PLUGIN_ROOT"
+echo ""
+
+# Track issues
+ISSUES_FOUND=0
+
+# Check if plugin root exists
+if [ ! -d "$CLAUDE_PLUGIN_ROOT" ]; then
+    echo -e "${RED}✗ Error: Plugin directory not found at: $CLAUDE_PLUGIN_ROOT${NC}"
+    echo ""
+    echo "Expected installation locations:"
+    echo "  - Standard: ~/.claude/plugins/marketplaces/claude-experiments/meta-prompt"
+    echo "  - Development: <repo-clone>/meta-prompt"
+    echo ""
+    exit 1
+fi
+
+echo -e "${GREEN}✓ Plugin directory found${NC}"
+
+# Check critical directories
+DIRS=(
+    "templates"
+    "commands"
+    "commands/scripts"
+    "agents"
+    "guides"
+    "tests"
+)
+
+for dir in "${DIRS[@]}"; do
+    if [ -d "$CLAUDE_PLUGIN_ROOT/$dir" ]; then
+        echo -e "${GREEN}✓${NC} Directory exists: $dir"
+    else
+        echo -e "${RED}✗${NC} Missing directory: $dir"
+        ISSUES_FOUND=$((ISSUES_FOUND + 1))
+    fi
+done
+
+echo ""
+
+# Check critical scripts
+SCRIPTS=(
+    "commands/scripts/prompt-handler.sh"
+    "scripts/common.sh"
+    "agents/scripts/prompt-optimizer-handler.sh"
+    "agents/scripts/template-selector-handler.sh"
+    "agents/scripts/template-executor-handler.sh"
+)
+
+for script in "${SCRIPTS[@]}"; do
+    if [ -f "$CLAUDE_PLUGIN_ROOT/$script" ]; then
+        if [ -x "$CLAUDE_PLUGIN_ROOT/$script" ]; then
+            echo -e "${GREEN}✓${NC} Script exists and is executable: $script"
+        else
+            echo -e "${YELLOW}⚠${NC}  Script exists but not executable: $script"
+            echo "   Run: chmod +x $CLAUDE_PLUGIN_ROOT/$script"
+            ISSUES_FOUND=$((ISSUES_FOUND + 1))
+        fi
+    else
+        echo -e "${RED}✗${NC} Missing script: $script"
+        ISSUES_FOUND=$((ISSUES_FOUND + 1))
+    fi
+done
+
+echo ""
+
+# Check templates (should have 6 templates + custom)
+EXPECTED_TEMPLATES=(
+    "code-refactoring.md"
+    "code-review.md"
+    "test-generation.md"
+    "documentation-generator.md"
+    "data-extraction.md"
+    "code-comparison.md"
+    "custom.md"
+)
+
+for template in "${EXPECTED_TEMPLATES[@]}"; do
+    if [ -f "$CLAUDE_PLUGIN_ROOT/templates/$template" ]; then
+        echo -e "${GREEN}✓${NC} Template exists: $template"
+    else
+        echo -e "${RED}✗${NC} Missing template: $template"
+        ISSUES_FOUND=$((ISSUES_FOUND + 1))
+    fi
+done
+
+echo ""
+
+# Summary
+echo "========================================"
+if [ $ISSUES_FOUND -eq 0 ]; then
+    echo -e "${GREEN}✓ Installation verified successfully!${NC}"
+    echo ""
+    echo "You can use the meta-prompt plugin with:"
+    echo "  /prompt <task description>"
+    echo "  /create-prompt <task description>"
+    exit 0
+else
+    echo -e "${RED}✗ Found $ISSUES_FOUND issue(s) with installation${NC}"
+    echo ""
+    echo "Troubleshooting:"
+    echo "  1. Ensure the plugin is installed via: /plugin install jtsylve/claude-experiments"
+    echo "  2. For development, run: chmod +x commands/scripts/*.sh tests/*.sh"
+    echo "  3. See docs/infrastructure.md for detailed setup instructions"
+    exit 1
+fi