@amsterdamdatalabs/enact-extensions 0.1.37 → 0.1.47

package/extensions/plugin-dev/skills/agent-development/scripts/test-agent-trigger.sh

@@ -1,227 +0,0 @@
-#!/bin/bash
-# Agent Trigger Test Helper
-# Extracts triggering examples and validates example block formatting
-
-set -euo pipefail
-
-# Usage
-if [ $# -eq 0 ]; then
-  echo "Usage: $0 <path/to/agent.md>"
-  echo ""
-  echo "This script helps test agent triggering by:"
-  echo "  - Extracting <example> blocks from description"
-  echo "  - Parsing user phrases that should trigger the agent"
-  echo "  - Validating example block formatting"
-  echo "  - Providing manual testing guidance"
-  exit 1
-fi
-
-AGENT_FILE="$1"
-
-echo "🔍 Analyzing agent triggers: $AGENT_FILE"
-echo ""
-
-# Check file exists
-if [ ! -f "$AGENT_FILE" ]; then
-  echo "❌ File not found: $AGENT_FILE"
-  exit 1
-fi
-
-# Check frontmatter exists
-FIRST_LINE=$(head -1 "$AGENT_FILE")
-if [ "$FIRST_LINE" != "---" ]; then
-  echo "❌ File must start with YAML frontmatter (---)"
-  exit 1
-fi
-
-# Extract agent name
-NAME=$(sed -n '/^---$/,/^---$/p' "$AGENT_FILE" | grep '^name:' | sed 's/name: *//' | sed 's/^"\(.*\)"$/\1/' | head -1)
-
-if [ -z "$NAME" ]; then
-  echo "❌ Could not extract agent name"
-  exit 1
-fi
-
-echo "📋 Agent: $NAME"
-echo ""
-
-# Extract full frontmatter section
-FRONTMATTER=$(awk '
-  /^---$/ { count++; next }
-  count == 1 { print }
-' "$AGENT_FILE")
-
-# Extract description - handles multi-line YAML
-# Description ends when we hit another top-level field (model:, color:, tools:, etc.)
-DESCRIPTION=$(echo "$FRONTMATTER" | awk '
-  /^description:/ {
-    in_desc = 1
-    sub(/^description: */, "")
-    if ($0 != "") print
-    next
-  }
-  in_desc && /^(model|color|tools|name):/ { exit }
-  in_desc { print }
-')
-
-if [ -z "$DESCRIPTION" ]; then
-  echo "❌ Could not extract description"
-  exit 1
-fi
-
-# Count example blocks
-EXAMPLE_COUNT=$(echo "$DESCRIPTION" | grep -c '<example>' 2>/dev/null || echo 0)
-
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "📊 EXAMPLE ANALYSIS"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-if [ "$EXAMPLE_COUNT" -eq 0 ]; then
-  echo "⚠️  No <example> blocks found in description"
-  echo ""
-  echo "Agent descriptions should include 2-4 example blocks showing"
-  echo "when the agent should be triggered."
-  echo ""
-  echo "Example format:"
-  echo "  <example>"
-  echo "  Context: [Scenario description]"
-  echo '  user: "[User request]"'
-  echo '  assistant: "[How Claude responds]"'
-  echo "  <commentary>"
-  echo "  [Why this triggers the agent]"
-  echo "  </commentary>"
-  echo "  </example>"
-  exit 1
-fi
-
-echo "Found $EXAMPLE_COUNT example block(s)"
-echo ""
-
-# Extract and display each example
-# Use awk to extract example blocks
-echo "$DESCRIPTION" | awk '
-  /<example>/ { in_example=1; example=""; next }
-  /<\/example>/ {
-    in_example=0
-    example_num++
-    print "───────────────────────────────────────"
-    print "Example " example_num ":"
-    print "───────────────────────────────────────"
-    print example
-    print ""
-    next
-  }
-  in_example { example = example $0 "\n" }
-' | while IFS= read -r line; do
-  echo "$line"
-done
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "🎯 TRIGGER PHRASES"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-# Initialize warning counter early (used across sections)
-warning_count=0
-
-# Extract user phrases from examples
-USER_PHRASES=$(echo "$DESCRIPTION" | grep -oE 'user: *"[^"]*"' | sed 's/user: *"//' | sed 's/"$//' || true)
-
-if [ -z "$USER_PHRASES" ]; then
-  echo "⚠️  Could not extract user phrases from examples"
-  echo ""
-  echo "Make sure examples include 'user: \"phrase\"' format"
-  ((warning_count++))
-else
-  echo "Use these phrases to test agent triggering:"
-  echo ""
-  echo "$USER_PHRASES" | while IFS= read -r phrase; do
-    echo "  → $phrase"
-  done
-fi
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "✅ VALIDATION"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-
-# Check for "Use this agent when" pattern
-if ! echo "$DESCRIPTION" | grep -qi 'use this agent when'; then
-  echo "⚠️  Description should start with 'Use this agent when...'"
-  ((warning_count++))
-else
-  echo "✅ Has 'Use this agent when' pattern"
-fi
-
-# Check example count
-if [ "$EXAMPLE_COUNT" -lt 2 ]; then
-  echo "⚠️  Only $EXAMPLE_COUNT example(s) - recommend 2-4 examples"
-  ((warning_count++))
-elif [ "$EXAMPLE_COUNT" -gt 4 ]; then
-  echo "⚠️  $EXAMPLE_COUNT examples - consider trimming to 2-4"
-  ((warning_count++))
-else
-  echo "✅ Good number of examples ($EXAMPLE_COUNT)"
-fi
-
-# Check for commentary in examples
-COMMENTARY_COUNT=$(echo "$DESCRIPTION" | grep -c '<commentary>' 2>/dev/null || echo 0)
-COMMENTARY_COUNT=$(echo "$COMMENTARY_COUNT" | tr -d '[:space:]')
-if [ "$COMMENTARY_COUNT" -lt "$EXAMPLE_COUNT" ]; then
-  echo "⚠️  Some examples missing <commentary> blocks"
-  ((warning_count++))
-else
-  echo "✅ All examples have commentary"
-fi
-
-# Check for Context in examples
-CONTEXT_COUNT=$(echo "$DESCRIPTION" | grep -ci 'context:' 2>/dev/null || echo 0)
-CONTEXT_COUNT=$(echo "$CONTEXT_COUNT" | tr -d '[:space:]')
-if [ "$CONTEXT_COUNT" -lt "$EXAMPLE_COUNT" ]; then
-  echo "⚠️  Some examples missing Context: lines"
-  ((warning_count++))
-else
-  echo "✅ All examples have context"
-fi
-
-# Check for assistant responses
-ASSISTANT_COUNT=$(echo "$DESCRIPTION" | grep -c 'assistant:' 2>/dev/null || echo 0)
-ASSISTANT_COUNT=$(echo "$ASSISTANT_COUNT" | tr -d '[:space:]')
-if [ "$ASSISTANT_COUNT" -lt "$EXAMPLE_COUNT" ]; then
-  echo "⚠️  Some examples missing assistant: responses"
-  ((warning_count++))
-else
-  echo "✅ All examples have assistant responses"
-fi
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "📖 MANUAL TESTING GUIDE"
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo ""
-echo "To test agent triggering:"
-echo ""
-echo "1. Load your plugin in Claude Code:"
-echo "   claude --plugin-dir /path/to/plugin"
-echo ""
-echo "2. Try the trigger phrases listed above"
-echo ""
-echo "3. Verify Claude loads the agent (look for agent indicator)"
-echo ""
-echo "4. Test variations of the phrases to ensure robust triggering"
-echo ""
-echo "5. Test negative cases - phrases that should NOT trigger"
-echo ""
-
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-
-if [ "$warning_count" -eq 0 ]; then
-  echo "✅ All validations passed!"
-  exit 0
-else
-  echo "⚠️  Completed with $warning_count warning(s)"
-  exit 0
-fi

package/extensions/plugin-dev/skills/agent-development/scripts/validate-agent.sh

@@ -1,227 +0,0 @@
-#!/bin/bash
-# Agent File Validator
-# Validates agent markdown files for correct structure and content
-
-set -euo pipefail
-
-# Usage
-if [ $# -eq 0 ]; then
-  echo "Usage: $0 <path/to/agent.md>"
-  echo ""
-  echo "Validates agent file for:"
-  echo "  - YAML frontmatter structure"
-  echo "  - Required fields (name, description, model, color)"
-  echo "  - Field formats and constraints"
-  echo "  - System prompt presence and length"
-  echo "  - Example blocks in description"
-  exit 1
-fi
-
-AGENT_FILE="$1"
-
-echo "🔍 Validating agent file: $AGENT_FILE"
-echo ""
-
-# Check 1: File exists
-if [ ! -f "$AGENT_FILE" ]; then
-  echo "❌ File not found: $AGENT_FILE"
-  exit 1
-fi
-echo "✅ File exists"
-
-# Check 2: Starts with ---
-FIRST_LINE=$(head -1 "$AGENT_FILE")
-if [ "$FIRST_LINE" != "---" ]; then
-  echo "❌ File must start with YAML frontmatter (---)"
-  exit 1
-fi
-echo "✅ Starts with frontmatter"
-
-# Check 3: Has closing ---
-if ! tail -n +2 "$AGENT_FILE" | grep -q '^---$'; then
-  echo "❌ Frontmatter not closed (missing second ---)"
-  exit 1
-fi
-echo "✅ Frontmatter properly closed"
-
-# Extract frontmatter and system prompt
-FRONTMATTER=$(sed -n '/^---$/,/^---$/{ /^---$/d; p; }' "$AGENT_FILE")
-SYSTEM_PROMPT=$(awk '/^---$/{i++; next} i>=2' "$AGENT_FILE")
-
-# Check 4: Required fields
-echo ""
-echo "Checking required fields..."
-
-error_count=0
-warning_count=0
-
-# Check name field
-NAME=$(echo "$FRONTMATTER" | grep '^name:' | sed 's/name: *//' | sed 's/^"\(.*\)"$/\1/')
-
-if [ -z "$NAME" ]; then
-  echo "❌ Missing required field: name"
-  ((error_count++))
-else
-  echo "✅ name: $NAME"
-
-  # Validate name format
-  if ! [[ "$NAME" =~ ^[a-z0-9][a-z0-9-]*[a-z0-9]$ ]]; then
-    echo "❌ name must start/end with lowercase alphanumeric and contain only lowercase letters, numbers, hyphens"
-    ((error_count++))
-  fi
-
-  # Validate name length
-  name_length=${#NAME}
-  if [ "$name_length" -lt 3 ]; then
-    echo "❌ name too short (minimum 3 characters)"
-    ((error_count++))
-  elif [ "$name_length" -gt 50 ]; then
-    echo "❌ name too long (maximum 50 characters)"
-    ((error_count++))
-  fi
-
-  # Check for generic names
-  if [[ "$NAME" =~ ^(helper|assistant|agent|tool)$ ]]; then
-    echo "⚠️  name is too generic: $NAME"
-    ((warning_count++))
-  fi
-fi
-
-# Check description field - handles multi-line YAML
-# Description ends when we hit another top-level field (model:, color:, tools:, name:)
-DESCRIPTION=$(echo "$FRONTMATTER" | awk '
-  /^description:/ {
-    in_desc = 1
-    sub(/^description: */, "")
-    if ($0 != "") print
-    next
-  }
-  in_desc && /^(model|color|tools|name):/ { exit }
-  in_desc { print }
-')
-
-if [ -z "$DESCRIPTION" ]; then
-  echo "❌ Missing required field: description"
-  ((error_count++))
-else
-  desc_length=${#DESCRIPTION}
-  echo "✅ description: ${desc_length} characters"
-
-  if [ "$desc_length" -lt 10 ]; then
-    echo "⚠️  description too short (minimum 10 characters recommended)"
-    ((warning_count++))
-  elif [ "$desc_length" -gt 5000 ]; then
-    echo "⚠️  description very long (over 5000 characters)"
-    ((warning_count++))
-  fi
-
-  # Check for example blocks
-  if ! echo "$DESCRIPTION" | grep -q '<example>'; then
-    echo "⚠️  description should include <example> blocks for triggering"
-    ((warning_count++))
-  fi
-
-  # Check for "Use this agent when" pattern
-  if ! echo "$DESCRIPTION" | grep -qi 'use this agent when'; then
-    echo "⚠️  description should start with 'Use this agent when...'"
-    ((warning_count++))
-  fi
-fi
-
-# Check model field
-MODEL=$(echo "$FRONTMATTER" | grep '^model:' | sed 's/model: *//')
-
-if [ -z "$MODEL" ]; then
-  echo "❌ Missing required field: model"
-  ((error_count++))
-else
-  echo "✅ model: $MODEL"
-
-  case "$MODEL" in
-    inherit|sonnet|opus|haiku)
-      # Valid model
-      ;;
-    *)
-      echo "⚠️  Unknown model: $MODEL (valid: inherit, sonnet, opus, haiku)"
-      ((warning_count++))
-      ;;
-  esac
-fi
-
-# Check color field
-COLOR=$(echo "$FRONTMATTER" | grep '^color:' | sed 's/color: *//')
-
-if [ -z "$COLOR" ]; then
-  echo "❌ Missing required field: color"
-  ((error_count++))
-else
-  echo "✅ color: $COLOR"
-
-  case "$COLOR" in
-    blue|cyan|green|yellow|magenta|red)
-      # Valid color
-      ;;
-    *)
-      echo "⚠️  Unknown color: $COLOR (valid: blue, cyan, green, yellow, magenta, red)"
-      ((warning_count++))
-      ;;
-  esac
-fi
-
-# Check tools field (optional)
-TOOLS=$(echo "$FRONTMATTER" | grep '^tools:' | sed 's/tools: *//')
-
-if [ -n "$TOOLS" ]; then
-  echo "✅ tools: $TOOLS"
-else
-  echo "💡 tools: not specified (agent has access to all tools)"
-fi
-
-# Check 5: System prompt
-echo ""
-echo "Checking system prompt..."
-
-if [ -z "$SYSTEM_PROMPT" ]; then
-  echo "❌ System prompt is empty"
-  ((error_count++))
-else
-  prompt_length=${#SYSTEM_PROMPT}
-  echo "✅ System prompt: $prompt_length characters"
-
-  if [ "$prompt_length" -lt 20 ]; then
-    echo "❌ System prompt too short (minimum 20 characters)"
-    ((error_count++))
-  elif [ "$prompt_length" -gt 10000 ]; then
-    echo "⚠️  System prompt very long (over 10,000 characters)"
-    ((warning_count++))
-  fi
-
-  # Check for second person
-  if ! echo "$SYSTEM_PROMPT" | grep -Eq "You are|You will|Your"; then
-    echo "⚠️  System prompt should use second person (You are..., You will...)"
-    ((warning_count++))
-  fi
-
-  # Check for structure
-  if ! echo "$SYSTEM_PROMPT" | grep -Eqi "responsibilities|process|steps"; then
-    echo "💡 Consider adding clear responsibilities or process steps"
-  fi
-
-  if ! echo "$SYSTEM_PROMPT" | grep -qi "output"; then
-    echo "💡 Consider defining output format expectations"
-  fi
-fi
-
-echo ""
-echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-
-if [ $error_count -eq 0 ] && [ $warning_count -eq 0 ]; then
-  echo "✅ All checks passed!"
-  exit 0
-elif [ $error_count -eq 0 ]; then
-  echo "⚠️  Validation passed with $warning_count warning(s)"
-  exit 0
-else
-  echo "❌ Validation failed with $error_count error(s) and $warning_count warning(s)"
-  exit 1
-fi