Skip to content

team-telnyx/ai / providers/claude/plugins/telnyx-platform/skills/telnyx-twilio-migration

telnyx-twilio-migration

Unverified

Migrate from Twilio to Telnyx. Orchestrates a complete 6-phase migration: discovery, planning, setup, code migration, validation, and cleanup. Covers voice (TwiML to TeXML, Call Control API), messaging, WebRTC, SIP trunking, verify, fax, video, IoT, number lookup, and porting. Includes automated scanners, validation scripts, and integration tests.

FileKindSize
SKILL.mdskill md43.3 KB
references/account-setup-guide.mdmarkdown17.8 KB
references/error-code-mapping.mdmarkdown11.0 KB
references/fax-migration.mdmarkdown14.7 KB
references/iot-migration.mdmarkdown17.9 KB
references/lookup-migration.mdmarkdown14.3 KB
references/messaging-migration.mdmarkdown36.5 KB
references/mobile-sdk-migration.mdmarkdown38.6 KB
references/number-porting.mdmarkdown17.0 KB
references/numbers-migration.mdmarkdown21.1 KB
references/product-mapping.mdmarkdown6.7 KB
references/sdk-api-details/10dlc.mdmarkdown9.8 KB
references/sdk-api-details/ai-assistants.mdmarkdown5.8 KB
references/sdk-api-details/messaging.mdmarkdown16.1 KB
references/sdk-api-details/numbers.mdmarkdown10.1 KB
references/sdk-api-details/voice.mdmarkdown9.6 KB
references/sip-trunking-migration.mdmarkdown18.1 KB
references/texml-verbs.mdmarkdown43.7 KB
references/unsupported-products.mdmarkdown3.5 KB
references/verify-migration.mdmarkdown18.4 KB
references/video-migration.mdmarkdown20.6 KB
references/voice-migration.mdmarkdown37.2 KB
references/webhook-migration.mdmarkdown20.3 KB
references/webrtc-migration.mdmarkdown50.0 KB
scripts/lint-telnyx-correctness.shexecutablescript31.4 KB
scripts/migration-state.shexecutablescript7.3 KB
scripts/post-test-diagnostic.shexecutablescript18.9 KB
scripts/preflight-check.shexecutablescript13.4 KB
scripts/run-discovery.shexecutablescript7.7 KB
scripts/run-validation.shexecutablescript13.1 KB
scripts/scan-twilio-deep.pyexecutablescript64.8 KB
scripts/scan-twilio-usage.shexecutablescript29.1 KB
scripts/test-migration/smoke-test.shexecutablescript10.0 KB
scripts/test-migration/test-fax.shexecutablescript8.7 KB
scripts/test-migration/test-lookup.shexecutablescript5.5 KB
scripts/test-migration/test-messaging.shexecutablescript18.8 KB
scripts/test-migration/test-sip.shexecutablescript29.6 KB
scripts/test-migration/test-verify.shexecutablescript13.6 KB
scripts/test-migration/test-voice.shexecutablescript22.4 KB
scripts/test-migration/test-webhooks-local.pyexecutablescript9.7 KB
scripts/test-migration/test-webrtc.shexecutablescript24.0 KB
scripts/test-migration/webhook-receiver.pyexecutablescript11.8 KB
scripts/validate-migration.shexecutablescript31.1 KB
scripts/validate-texml.shexecutablescript61.4 KB
sdk-reference/curl/10dlc.mdmarkdown25.8 KB
sdk-reference/curl/account-access.mdmarkdown15.6 KB
sdk-reference/curl/account-management.mdmarkdown9.5 KB
sdk-reference/curl/account-notifications.mdmarkdown11.0 KB
sdk-reference/curl/account-reports.mdmarkdown45.5 KB
sdk-reference/curl/account.mdmarkdown8.1 KB
sdk-reference/curl/ai-assistants.mdmarkdown34.3 KB
sdk-reference/curl/ai-inference.mdmarkdown34.5 KB
sdk-reference/curl/fax.mdmarkdown19.8 KB
sdk-reference/curl/iot.mdmarkdown49.4 KB
sdk-reference/curl/messaging-hosted.mdmarkdown23.3 KB
sdk-reference/curl/messaging-profiles.mdmarkdown14.2 KB
sdk-reference/curl/messaging.mdmarkdown29.1 KB
sdk-reference/curl/missions.mdmarkdown23.5 KB
sdk-reference/curl/networking.mdmarkdown39.8 KB
sdk-reference/curl/numbers-compliance.mdmarkdown30.2 KB
sdk-reference/curl/numbers-config.mdmarkdown29.7 KB
sdk-reference/curl/numbers-services.mdmarkdown12.6 KB
sdk-reference/curl/numbers.mdmarkdown24.0 KB
sdk-reference/curl/oauth.mdmarkdown15.6 KB
sdk-reference/curl/porting-in.mdmarkdown35.1 KB
sdk-reference/curl/porting-out.mdmarkdown9.8 KB
sdk-reference/curl/sip-integrations.mdmarkdown27.5 KB
sdk-reference/curl/sip.mdmarkdown47.6 KB
sdk-reference/curl/storage.mdmarkdown4.2 KB
sdk-reference/curl/texml.mdmarkdown31.4 KB
sdk-reference/curl/verify.mdmarkdown13.2 KB
sdk-reference/curl/video.mdmarkdown17.2 KB
sdk-reference/curl/voice-advanced.mdmarkdown32.8 KB
sdk-reference/curl/voice-conferencing.mdmarkdown41.6 KB
sdk-reference/curl/voice-gather.mdmarkdown14.7 KB
sdk-reference/curl/voice-media.mdmarkdown17.8 KB
sdk-reference/curl/voice-streaming.mdmarkdown13.3 KB
sdk-reference/curl/voice.mdmarkdown37.6 KB
sdk-reference/curl/webrtc.mdmarkdown6.5 KB
sdk-reference/go/10dlc.mdmarkdown29.0 KB
sdk-reference/go/account-access.mdmarkdown17.0 KB
sdk-reference/go/account-management.mdmarkdown9.9 KB
sdk-reference/go/account-notifications.mdmarkdown12.4 KB
sdk-reference/go/account-reports.mdmarkdown31.5 KB
sdk-reference/go/account.mdmarkdown9.1 KB
sdk-reference/go/ai-assistants.mdmarkdown37.7 KB
sdk-reference/go/ai-inference.mdmarkdown27.1 KB
sdk-reference/go/fax.mdmarkdown20.2 KB
sdk-reference/go/iot.mdmarkdown51.3 KB
sdk-reference/go/messaging-hosted.mdmarkdown24.5 KB
sdk-reference/go/messaging-profiles.mdmarkdown15.2 KB
sdk-reference/go/messaging.mdmarkdown30.1 KB
sdk-reference/go/missions.mdmarkdown26.9 KB
sdk-reference/go/networking.mdmarkdown42.5 KB
sdk-reference/go/numbers-compliance.mdmarkdown28.2 KB
sdk-reference/go/numbers-config.mdmarkdown29.5 KB
sdk-reference/go/numbers-services.mdmarkdown14.1 KB
sdk-reference/go/numbers.mdmarkdown26.7 KB
sdk-reference/go/oauth.mdmarkdown11.7 KB
sdk-reference/go/porting-in.mdmarkdown41.1 KB
sdk-reference/go/porting-out.mdmarkdown10.9 KB
sdk-reference/go/sip-integrations.mdmarkdown32.3 KB
sdk-reference/go/sip.mdmarkdown49.1 KB
sdk-reference/go/storage.mdmarkdown4.8 KB
sdk-reference/go/texml.mdmarkdown35.7 KB
sdk-reference/go/verify.mdmarkdown14.4 KB
sdk-reference/go/video.mdmarkdown18.6 KB
sdk-reference/go/voice-advanced.mdmarkdown33.2 KB
sdk-reference/go/voice-conferencing.mdmarkdown42.3 KB
sdk-reference/go/voice-gather.mdmarkdown14.5 KB
sdk-reference/go/voice-media.mdmarkdown18.1 KB
sdk-reference/go/voice-streaming.mdmarkdown13.5 KB
sdk-reference/go/voice.mdmarkdown39.2 KB
sdk-reference/go/webrtc.mdmarkdown7.5 KB
sdk-reference/java/10dlc.mdmarkdown31.3 KB
sdk-reference/java/account-access.mdmarkdown18.5 KB
sdk-reference/java/account-management.mdmarkdown11.1 KB
sdk-reference/java/account-notifications.mdmarkdown14.3 KB
sdk-reference/java/account-reports.mdmarkdown36.5 KB
sdk-reference/java/account.mdmarkdown10.3 KB
sdk-reference/java/ai-assistants.mdmarkdown39.2 KB
sdk-reference/java/ai-inference.mdmarkdown30.7 KB
sdk-reference/java/fax.mdmarkdown21.5 KB
sdk-reference/java/iot.mdmarkdown57.5 KB
sdk-reference/java/messaging-hosted.mdmarkdown28.4 KB
sdk-reference/java/messaging-profiles.mdmarkdown15.7 KB
sdk-reference/java/messaging.mdmarkdown32.2 KB
sdk-reference/java/missions.mdmarkdown31.6 KB
sdk-reference/java/networking.mdmarkdown47.1 KB
sdk-reference/java/numbers-compliance.mdmarkdown31.1 KB
sdk-reference/java/numbers-config.mdmarkdown32.2 KB
sdk-reference/java/numbers-services.mdmarkdown15.9 KB
sdk-reference/java/numbers.mdmarkdown28.4 KB
sdk-reference/java/oauth.mdmarkdown13.0 KB
sdk-reference/java/porting-in.mdmarkdown46.2 KB
sdk-reference/java/porting-out.mdmarkdown11.9 KB
sdk-reference/java/sip-integrations.mdmarkdown38.1 KB
sdk-reference/java/sip.mdmarkdown51.9 KB
sdk-reference/java/storage.mdmarkdown5.7 KB
sdk-reference/java/texml.mdmarkdown41.3 KB
sdk-reference/java/verify.mdmarkdown16.0 KB
sdk-reference/java/video.mdmarkdown20.3 KB
sdk-reference/java/voice-advanced.mdmarkdown35.0 KB
sdk-reference/java/voice-conferencing.mdmarkdown46.0 KB
sdk-reference/java/voice-gather.mdmarkdown16.1 KB
sdk-reference/java/voice-media.mdmarkdown19.5 KB
sdk-reference/java/voice-streaming.mdmarkdown14.7 KB
sdk-reference/java/voice.mdmarkdown40.8 KB
sdk-reference/java/webrtc.mdmarkdown8.5 KB
sdk-reference/javascript/10dlc.mdmarkdown28.5 KB
sdk-reference/javascript/account-access.mdmarkdown15.9 KB
sdk-reference/javascript/account-management.mdmarkdown9.6 KB
sdk-reference/javascript/account-notifications.mdmarkdown11.7 KB
sdk-reference/javascript/account-reports.mdmarkdown29.3 KB
sdk-reference/javascript/account.mdmarkdown8.7 KB
sdk-reference/javascript/ai-assistants.mdmarkdown37.5 KB
sdk-reference/javascript/ai-inference.mdmarkdown24.4 KB
sdk-reference/javascript/fax.mdmarkdown19.9 KB
sdk-reference/javascript/iot.mdmarkdown47.4 KB
sdk-reference/javascript/messaging-hosted.mdmarkdown22.4 KB
sdk-reference/javascript/messaging-profiles.mdmarkdown14.8 KB
sdk-reference/javascript/messaging.mdmarkdown29.7 KB
sdk-reference/javascript/missions.mdmarkdown23.8 KB
sdk-reference/javascript/networking.mdmarkdown39.3 KB
sdk-reference/javascript/numbers-compliance.mdmarkdown25.9 KB
sdk-reference/javascript/numbers-config.mdmarkdown28.3 KB
sdk-reference/javascript/numbers-services.mdmarkdown13.0 KB
sdk-reference/javascript/numbers.mdmarkdown26.1 KB
sdk-reference/javascript/oauth.mdmarkdown10.8 KB
sdk-reference/javascript/porting-in.mdmarkdown37.4 KB
sdk-reference/javascript/porting-out.mdmarkdown10.2 KB
sdk-reference/javascript/sip-integrations.mdmarkdown28.5 KB
sdk-reference/javascript/sip.mdmarkdown47.4 KB
sdk-reference/javascript/storage.mdmarkdown4.5 KB
sdk-reference/javascript/texml.mdmarkdown31.9 KB
sdk-reference/javascript/verify.mdmarkdown13.3 KB
sdk-reference/javascript/video.mdmarkdown17.2 KB
sdk-reference/javascript/voice-advanced.mdmarkdown32.6 KB
sdk-reference/javascript/voice-conferencing.mdmarkdown40.4 KB
sdk-reference/javascript/voice-gather.mdmarkdown14.3 KB
sdk-reference/javascript/voice-media.mdmarkdown17.8 KB
sdk-reference/javascript/voice-streaming.mdmarkdown13.4 KB
sdk-reference/javascript/voice.mdmarkdown39.4 KB
sdk-reference/javascript/webrtc.mdmarkdown7.2 KB
sdk-reference/python/10dlc.mdmarkdown28.5 KB
sdk-reference/python/account-access.mdmarkdown15.0 KB
sdk-reference/python/account-management.mdmarkdown9.1 KB
sdk-reference/python/account-notifications.mdmarkdown10.9 KB
sdk-reference/python/account-reports.mdmarkdown28.1 KB
sdk-reference/python/account.mdmarkdown8.1 KB
sdk-reference/python/ai-assistants.mdmarkdown37.3 KB
sdk-reference/python/ai-inference.mdmarkdown23.4 KB
sdk-reference/python/fax.mdmarkdown19.5 KB
sdk-reference/python/iot.mdmarkdown45.3 KB
sdk-reference/python/messaging-hosted.mdmarkdown21.7 KB
sdk-reference/python/messaging-profiles.mdmarkdown14.1 KB
sdk-reference/python/messaging.mdmarkdown29.4 KB
sdk-reference/python/missions.mdmarkdown23.2 KB
sdk-reference/python/networking.mdmarkdown37.1 KB
sdk-reference/python/numbers-compliance.mdmarkdown24.6 KB

scripts/lint-telnyx-correctness.sh

View on GitHub
#!/usr/bin/env bash
#
# lint-telnyx-correctness.sh — Check migrated code for known Telnyx anti-patterns
#
# Unlike validate-migration.sh (which checks "is Twilio code gone?"), this linter
# checks "is the Telnyx code correct?" — catching common mistakes agents make when
# translating Twilio patterns to Telnyx.
#
# Usage:
#   bash lint-telnyx-correctness.sh <project-root> [--product <name>] [--json]
#                                   [--state-file <path>] [--scan-json <path>]
#
# Options:
#   <project-root>       Path to the project to lint (required)
#   --product <name>     Only check patterns for a specific product
#   --json               Output results as machine-readable JSON
#   --state-file <path>  Path to migration-state.json for hybrid context
#   --scan-json <path>   Path to twilio-scan.json for context-aware checks
#
# Exit codes:
#   0 — No issues found
#   1 — Issues found (details in output)
#   2 — Usage error

set -euo pipefail

# --- Colors ---
if [ -t 1 ]; then
  RED='\033[0;31m'
  YELLOW='\033[0;33m'
  GREEN='\033[0;32m'
  BLUE='\033[0;34m'
  BOLD='\033[1m'
  NC='\033[0m'
else
  RED='' YELLOW='' GREEN='' BLUE='' BOLD='' NC=''
fi

ISSUE_COUNT=0
WARN_COUNT=0
PASS_COUNT=0
JSON_MODE=false
PRODUCT_FILTER="all"
PROJECT_ROOT=""
SCAN_JSON=""
STATE_FILE=""
HYBRID_PRODUCTS=""
MIGRATED_FILES=""
JSON_CHECKS="[]"

EXCLUDE_DIRS="node_modules .git vendor __pycache__ venv .venv dist build"
EXCLUDE_LOCK_FILES="--exclude=package-lock.json --exclude=yarn.lock --exclude=pnpm-lock.yaml --exclude=Gemfile.lock --exclude=Pipfile.lock --exclude=poetry.lock --exclude=go.sum"
EXCLUDE_SCAN_FILES="--exclude=twilio-scan.json --exclude=twilio-deep-scan.json --exclude=migration-state.json --exclude=MIGRATION-PLAN.md --exclude=MIGRATION-REPORT.md"

# --- Helpers ---

usage() {
  echo "Usage: $(basename "$0") <project-root> [--product <name>] [--json] [--state-file <path>] [--scan-json <path>]"
  echo ""
  echo "Checks migrated Telnyx code for known anti-patterns and common mistakes."
  echo ""
  echo "Products: voice, messaging, verify, webrtc"
  exit 2
}

build_exclude_args() {
  local args=""
  for d in $EXCLUDE_DIRS; do
    args="$args --exclude-dir=$d"
  done
  args="$args $EXCLUDE_LOCK_FILES"
  args="$args $EXCLUDE_SCAN_FILES"
  args="$args --exclude=*.md --exclude=*.min.js"
  echo "$args"
}

GREP_EXCLUDES=""

search_files() {
  local pattern="$1"
  shift
  local include_args=""
  for glob in "$@"; do
    include_args="$include_args --include=$glob"
  done
  # shellcheck disable=SC2086
  grep -rn $GREP_EXCLUDES $include_args -E "$pattern" "$PROJECT_ROOT" 2>/dev/null || true
}

count_matches() {
  local matches="$1"
  if [ -z "$matches" ]; then
    echo "0"
    return
  fi
  echo "$matches" | grep -c . 2>/dev/null
}

matches_to_json() {
  local matches="$1"
  local files_json
  files_json=$(echo "$matches" | head -20 | jq -R -s 'split("\n") | map(select(length > 0))' 2>/dev/null)
  echo "{\"files\": $files_json}"
}

lint_issue() {
  local name="$1"
  local msg="$2"
  local fix="$3"
  local details="${4:-}"
  ISSUE_COUNT=$((ISSUE_COUNT + 1))
  if [ "$JSON_MODE" = true ]; then
    if [ -n "$details" ]; then
      JSON_CHECKS=$(echo "$JSON_CHECKS" | jq --arg n "$name" --arg s "issue" --arg f "$fix" --argjson d "$details" \
        '. + [{"name": $n, "status": $s, "fix": $f, "details": $d}]')
    else
      JSON_CHECKS=$(echo "$JSON_CHECKS" | jq --arg n "$name" --arg s "issue" --arg f "$fix" \
        '. + [{"name": $n, "status": $s, "fix": $f, "details": null}]')
    fi
  else
    echo -e "  ${RED}ISSUE${NC}  $msg"
    echo -e "         ${BLUE}FIX${NC}:  $fix"
    if [ -n "$details" ]; then
      echo "$details" | jq -r '.files[]' 2>/dev/null | while read -r f; do
        echo -e "         - $f"
      done
    fi
  fi
}

lint_warn() {
  local name="$1"
  local msg="$2"
  local fix="$3"
  local details="${4:-}"
  WARN_COUNT=$((WARN_COUNT + 1))
  if [ "$JSON_MODE" = true ]; then
    if [ -n "$details" ]; then
      JSON_CHECKS=$(echo "$JSON_CHECKS" | jq --arg n "$name" --arg s "warn" --arg f "$fix" --argjson d "$details" \
        '. + [{"name": $n, "status": $s, "fix": $f, "details": $d}]')
    else
      JSON_CHECKS=$(echo "$JSON_CHECKS" | jq --arg n "$name" --arg s "warn" --arg f "$fix" \
        '. + [{"name": $n, "status": $s, "fix": $f, "details": null}]')
    fi
  else
    echo -e "  ${YELLOW}WARN${NC}   $msg"
    echo -e "         ${BLUE}FIX${NC}:  $fix"
    if [ -n "$details" ]; then
      echo "$details" | jq -r '.files[]' 2>/dev/null | while read -r f; do
        echo -e "         - $f"
      done
    fi
  fi
}

lint_pass() {
  local name="$1"
  local msg="$2"
  PASS_COUNT=$((PASS_COUNT + 1))
  if [ "$JSON_MODE" = true ]; then
    JSON_CHECKS=$(echo "$JSON_CHECKS" | jq --arg n "$name" --arg s "pass" \
      '. + [{"name": $n, "status": $s}]')
  else
    echo -e "  ${GREEN}PASS${NC}   $msg"
  fi
}

product_applies() {
  local check_products="$1"
  if [ "$check_products" != "all" ] && [ -n "$HYBRID_PRODUCTS" ]; then
    local candidate
    for candidate in $(echo "$check_products" | tr ',' ' '); do
      if echo "$HYBRID_PRODUCTS" | tr ',' '\n' | grep -qx "$candidate"; then
        return 1
      fi
    done
  fi
  if [ "$PRODUCT_FILTER" = "all" ] || [ "$check_products" = "all" ]; then
    return 0
  fi
  echo "$check_products" | tr ',' '\n' | grep -qx "$PRODUCT_FILTER"
}

hybrid_waiver_applies() {
  [ -n "$HYBRID_PRODUCTS" ] || return 1
  # The prescribed Phase-5 command is an all-products scan. In a recorded
  # hybrid migration, generic Twilio imports and directory names cannot be
  # attributed to one product by grep alone, so keep them visible as warnings
  # rather than making a legitimate retained product fail the required gate.
  if [ "$PRODUCT_FILTER" = "all" ]; then
    # A retained product never waives a residual inside a file explicitly
    # recorded as migrated. Only downgrade when every matched path is outside
    # that set; mixed or migrated-only results must keep the gate blocking.
    [ -n "$MIGRATED_FILES" ] || return 0
    while IFS= read -r match; do
      [ -n "$match" ] || continue
      path=$(printf '%s\n' "$match" | sed -E 's/:[0-9]+:.*$//')
      case "$path" in
        "$PROJECT_ROOT"/*) path=${path#"$PROJECT_ROOT"/} ;;
        ./*) path=${path#./} ;;
      esac
      while IFS= read -r migrated_file; do
        [ -n "$migrated_file" ] || continue
        # A directory finding covers every file below it. Do not waive a
        # Twilio-named directory when any explicitly migrated file lives in
        # that directory, even though the grep finding names only the parent.
        if [ "$migrated_file" = "$path" ] || [[ "$migrated_file" = "$path"/* ]]; then
          return 1
        fi
      done <<<"$MIGRATED_FILES"
    done <<<"${1:-}"
    return 0
  fi
  echo "$HYBRID_PRODUCTS" | tr ',' '\n' | grep -qx "$PRODUCT_FILTER"
}

section_header() {
  if [ "$JSON_MODE" = false ]; then
    echo ""
    echo -e "${BOLD}$1${NC}"
  fi
}

# --- Argument parsing ---
if [ $# -lt 1 ]; then
  usage
fi

while [ $# -gt 0 ]; do
  case "$1" in
    --product)
      if [ $# -lt 2 ]; then echo "Error: --product requires a value" >&2; usage; fi
      PRODUCT_FILTER="$2"
      shift 2
      ;;
    --json)
      JSON_MODE=true
      shift
      ;;
    --scan-json)
      if [ $# -lt 2 ]; then echo "Error: --scan-json requires a value" >&2; usage; fi
      SCAN_JSON="$2"
      shift 2
      ;;
    --state-file)
      if [ $# -lt 2 ]; then echo "Error: --state-file requires a value" >&2; usage; fi
      STATE_FILE="$2"
      shift 2
      ;;
    -h|--help)
      usage
      ;;
    -*)
      echo "Error: Unknown option '$1'" >&2
      usage
      ;;
    *)
      if [ -z "$PROJECT_ROOT" ]; then
        PROJECT_ROOT="$1"
      else
        echo "Error: Unexpected argument '$1'" >&2
        usage
      fi
      shift
      ;;
  esac
done

if [ -z "$PROJECT_ROOT" ]; then
  echo "Error: <project-root> is required" >&2
  usage
fi

if [ "$JSON_MODE" = true ] && ! command -v jq >/dev/null 2>&1; then
  echo "Error: --json requires jq" >&2
  exit 2
fi

if [ ! -d "$PROJECT_ROOT" ]; then
  echo "Error: '$PROJECT_ROOT' is not a directory" >&2
  exit 2
fi

if ! command -v python3 >/dev/null 2>&1; then
  echo "Error: python3 is required for correctness analysis" >&2
  exit 2
fi

PROJECT_ROOT="$(cd "$PROJECT_ROOT" && pwd)"
GREP_EXCLUDES=$(build_exclude_args)

if [ -z "$STATE_FILE" ] && [ -f "$PROJECT_ROOT/migration-state.json" ]; then
  STATE_FILE="$PROJECT_ROOT/migration-state.json"
fi

if [ -n "$STATE_FILE" ]; then
  if [ ! -f "$STATE_FILE" ]; then
    echo "Warning: --state-file '$STATE_FILE' not found, ignoring" >&2
  elif ! command -v jq >/dev/null 2>&1; then
    echo "Error: --state-file requires jq" >&2
    exit 2
  else
    HYBRID_PRODUCTS=$(jq -r '
      if type == "object" and ((.kept_on_twilio? // {}) | type == "object")
      then (.kept_on_twilio // {} | to_entries | map(select(.value) | .key | ascii_downcase) | join(","))
      else error("invalid migration state") end
    ' "$STATE_FILE" 2>/dev/null) || {
      echo "Error: --state-file '$STATE_FILE' is not valid migration state JSON" >&2
      exit 2
    }
    MIGRATED_FILES=$(jq -r --arg root "$PROJECT_ROOT/" '
      [(.migrated_files? // {}) | .. | arrays | .[]?
       | select(type == "string")
       | if startswith($root) then .[($root | length):]
         elif startswith("./") then .[2:]
         else . end]
      | unique[]
    ' "$STATE_FILE" 2>/dev/null) || {
      echo "Error: --state-file '$STATE_FILE' has invalid migrated_files" >&2
      exit 2
    }
  fi
fi

# Load scan context if provided (for context-aware checks like webhook validation)
ORIGINAL_HAD_WEBHOOK_VALIDATION="unknown"
SCAN_PRODUCTS=""
if [ -n "$SCAN_JSON" ] && [ -f "$SCAN_JSON" ] && command -v jq >/dev/null 2>&1; then
  ORIGINAL_HAD_WEBHOOK_VALIDATION=$(jq -r '.has_webhook_validation // false' "$SCAN_JSON" 2>/dev/null || echo "unknown")
  SCAN_PRODUCTS=$(jq -r '.products_used // [] | map(ascii_downcase) | join(",")' "$SCAN_JSON" 2>/dev/null || true)
fi

# Helper: returns 0 if a product was detected in the scan (or if no scan data)
scan_has_product() {
  local product="$1"
  if [ -z "$SCAN_PRODUCTS" ]; then
    return 0  # no scan data — be conservative, run the check
  fi
  echo "$SCAN_PRODUCTS" | tr ',' '\n' | grep -qx "$product"
}

# --- Header ---
if [ "$JSON_MODE" = false ]; then
  echo -e "${BOLD}Telnyx Correctness Linter${NC}"
  printf '%.0s═' {1..24}
  echo ""
  echo ""
  echo "Project: $PROJECT_ROOT"
  echo "Product: $PRODUCT_FILTER"
fi

# ============================================================
# MESSAGING ANTI-PATTERNS
# ============================================================
if product_applies "messaging"; then
  section_header "Messaging Correctness"

  # Check 1: .messages.create( — Twilio pattern, Telnyx uses .send() or messages.create differently
  matches=$(search_files '\.messages\.create\(' "*.py" "*.js" "*.ts" "*.rb" "*.go" "*.java" "*.php")
  count=$(count_matches "$matches")
  if [ "$count" -gt 0 ]; then
    lint_issue "twilio_messages_create" \
      "Twilio .messages.create() pattern found in $count file(s)" \
      "Use telnyx.messages.send() (Python) or telnyx.messages.create() with text parameter (JS/Ruby)" \
      "$(matches_to_json "$matches")"
  else
    lint_pass "twilio_messages_create" "No Twilio .messages.create() pattern found"
  fi

  # Check 2: body= or body: in message send context — Telnyx uses 'text' not 'body'
  matches=$(search_files '(\.send\(|\.create\().*body[=:]' "*.py" "*.js" "*.ts" "*.rb")
  count=$(count_matches "$matches")
  if [ "$count" -gt 0 ]; then
    # Filter to only lines that also reference telnyx or messaging context
    telnyx_context=$(echo "$matches" | grep -iE "telnyx|message|sms|mms" || true)
    tcount=$(count_matches "$telnyx_context")
    if [ "$tcount" -gt 0 ]; then
      lint_issue "body_not_text" \
        "Message send with 'body' parameter found in $tcount file(s)" \
        "Telnyx uses 'text' not 'body' for message content" \
        "$(matches_to_json "$telnyx_context")"
    else
      lint_pass "body_not_text" "No 'body' parameter in Telnyx messaging context"
    fi
  else
    lint_pass "body_not_text" "No 'body' parameter in message send calls"
  fi

  # Check 3: messaging_profile_id missing in send calls (skip if messaging not detected in scan)
  if scan_has_product "messaging"; then
    telnyx_send=$(search_files '(telnyx.*message|message.*send|messages\.create)' "*.py" "*.js" "*.ts" "*.rb" "*.go")
    send_count=$(count_matches "$telnyx_send")
    if [ "$send_count" -gt 0 ]; then
      profile_refs=$(search_files 'messaging_profile_id' "*.py" "*.js" "*.ts" "*.rb" "*.go")
      profile_count=$(count_matches "$profile_refs")
      if [ "$profile_count" -eq 0 ]; then
        lint_warn "missing_messaging_profile_id" \
          "Telnyx messaging calls found but no messaging_profile_id reference" \
          "Include messaging_profile_id in send calls or set a default on the messaging profile"
      else
        lint_pass "missing_messaging_profile_id" "messaging_profile_id referenced in code"
      fi
    fi
  fi

  # Check 4: MessagingResponse builder class (doesn't exist in Telnyx)
  matches=$(search_files 'MessagingResponse\(' "*.py" "*.js" "*.ts" "*.rb")
  count=$(count_matches "$matches")
  if [ "$count" -gt 0 ]; then
    lint_issue "messaging_response_builder" \
      "Twilio MessagingResponse() builder found in $count file(s)" \
      "Telnyx has no MessagingResponse builder — return JSON or use the SDK to send replies" \
      "$(matches_to_json "$matches")"
  else
    lint_pass "messaging_response_builder" "No Twilio MessagingResponse builder found"
  fi
fi

# ============================================================
# VOICE ANTI-PATTERNS
# ============================================================
if product_applies "voice"; then
  section_header "Voice Correctness"

  # Check 5: VoiceResponse builder (Twilio TwiML — doesn't exist in Telnyx SDK)
  matches=$(search_files 'VoiceResponse\(' "*.py" "*.js" "*.ts" "*.rb" "*.java" "*.php")
  count=$(count_matches "$matches")
  if [ "$count" -gt 0 ]; then
    lint_issue "voice_response_builder" \
      "Twilio VoiceResponse() builder found in $count file(s)" \
      "Telnyx uses TeXML (return XML directly) or Call Control API — no VoiceResponse builder class" \
      "$(matches_to_json "$matches")"
  else
    lint_pass "voice_response_builder" "No Twilio VoiceResponse builder found"
  fi

  # Check 6: speechModel must be translated on Gather/Transcription, but it is
  # a documented attribute on a Language child of ConversationRelay. Inspect
  # tag ancestry instead of rejecting every textual occurrence.
  matches=$(python3 - "$PROJECT_ROOT" <<'PYEOF'
import os
import pathlib
import re
import sys

root = pathlib.Path(sys.argv[1])
excluded = {
    ".git", ".next", ".nuxt", ".tox", ".venv", "__pycache__",
    "build", "coverage", "dist", "node_modules", "vendor", "venv",
}
suffixes = {".xml", ".py", ".js", ".ts", ".rb", ".java", ".php"}
tag_pattern = re.compile(
    r"<(?P<closing>/)?\s*(?P<tag>[A-Za-z_][\w:.-]*)"
    r"(?P<attrs>(?:\"[^\"]*\"|'[^']*'|[^>])*)>",
    re.DOTALL,
)
speech_model = re.compile(r"(?<![\w:.-])speechModel\s*(?:=|:)")

for directory, child_dirs, filenames in os.walk(root):
    child_dirs[:] = sorted(name for name in child_dirs if name not in excluded)
    for filename in sorted(filenames):
        path = pathlib.Path(directory, filename)
        if path.suffix.lower() not in suffixes:
            continue
        source = path.read_text(encoding="utf-8", errors="replace")
        source = re.sub(
            r"<!--.*?-->|<!\[CDATA\[.*?\]\]>",
            lambda match: "".join(
                char if char in "\r\n" else " " for char in match.group(0)
            ),
            source,
            flags=re.DOTALL,
        )
        stack = []
        tagged_speech_model = set()
        for match in tag_pattern.finditer(source):
            tag = match.group("tag").rsplit(":", 1)[-1]
            if match.group("closing"):
                if stack and stack[-1] == tag:
                    stack.pop()
                else:
                    stack.clear()
                continue
            attr_start = match.start("attrs")
            attr_occurrences = list(speech_model.finditer(match.group("attrs")))
            tagged_speech_model.update(
                attr_start + occurrence.start() for occurrence in attr_occurrences
            )
            if attr_occurrences:
                if not (tag == "Language" and stack[-1:] == ["ConversationRelay"]):
                    line = source.count("\n", 0, match.start()) + 1
                    print(f"{path}:{line}: <{tag}> speechModel")
            if not match.group("attrs").rstrip().endswith("/"):
                stack.append(tag)
        # Builder/object forms (for example `{speechModel: "phone_call"}`)
        # are migration-sensitive even when no literal XML tag exists. Only
        # suppress occurrences already classified inside an XML tag, including
        # the valid ConversationRelay <Language> form above.
        for occurrence in speech_model.finditer(source):
            if occurrence.start() in tagged_speech_model:
                continue
            line = source.count("\n", 0, occurrence.start()) + 1
            print(f"{path}:{line}: non-XML speechModel")
PYEOF
)
  count=$(count_matches "$matches")
  if [ "$count" -gt 0 ]; then
    lint_issue "speech_model_attr" \
      "speechModel requiring migration found in $count location(s)" \
      "Map Gather/Transcription speechModel to the documented TeXML model configuration; preserve ConversationRelay Language speechModel" \
      "$(matches_to_json "$matches")"
  else
    lint_pass "speech_model_attr" "No speechModel attribute found"
  fi

  # Check 7: Recording URL stored without download logic (10-min expiry)
  # Skip if voice/recording not detected in scan
  if scan_has_product "voice"; then
    matches=$(search_files '(recording.*url|RecordingUrl|recording_url)' "*.py" "*.js" "*.ts" "*.rb" "*.go" "*.java")
    count=$(count_matches "$matches")
    if [ "$count" -gt 0 ]; then
      lint_warn "recording_url_expiry" \
        "Recording URL references found in $count file(s)" \
        "Telnyx recording URLs expire after 10 minutes — download immediately upon receipt" \
        "$(matches_to_json "$matches")"
    else
      lint_pass "recording_url_expiry" "No recording URL references found"
    fi
  fi
fi

# ============================================================
# VERIFY ANTI-PATTERNS
# ============================================================
if product_applies "verify"; then
  section_header "Verify Correctness"

  # Check 8: status === 'approved' (Twilio) — Telnyx uses response_code === 'accepted'
  matches=$(search_files "(status.*[=!]=.*['\"]approved['\"]|['\"]approved['\"].*[=!]=.*status)" "*.py" "*.js" "*.ts" "*.rb" "*.go" "*.java" "*.php")
  count=$(count_matches "$matches")
  if [ "$count" -gt 0 ]; then
    lint_issue "verify_status_approved" \
      "Twilio Verify status === 'approved' pattern found in $count file(s)" \
      "Telnyx uses response_code === 'accepted' (not status === 'approved')" \
      "$(matches_to_json "$matches")"
  else
    lint_pass "verify_status_approved" "No Twilio Verify 'approved' status check found"
  fi

  # Check 9: verify_profile_id missing (skip if verify not detected in scan)
  if scan_has_product "verify"; then
    telnyx_verify=$(search_files '(telnyx.*verif|verif.*telnyx|verify_profile|verification)' "*.py" "*.js" "*.ts" "*.rb" "*.go")
    verify_count=$(count_matches "$telnyx_verify")
    if [ "$verify_count" -gt 0 ]; then
      profile_refs=$(search_files 'verify_profile_id' "*.py" "*.js" "*.ts" "*.rb" "*.go")
      profile_count=$(count_matches "$profile_refs")
      if [ "$profile_count" -eq 0 ]; then
        lint_warn "missing_verify_profile_id" \
          "Telnyx verify calls found but no verify_profile_id reference" \
          "Include verify_profile_id in verification requests"
      else
        lint_pass "missing_verify_profile_id" "verify_profile_id referenced in code"
      fi
    fi
  fi
fi

# ============================================================
# HALLUCINATED TELNYX METHOD NAMES (all products)
# ============================================================
# Catches common agent hallucinations — methods that don't exist in the Telnyx
# SDKs but look plausible by analogy to Twilio, Stripe, or older Telnyx APIs.
# Keep entries high-confidence (zero false-positive risk).
if product_applies "all"; then
  section_header "Hallucinated Method Names"

  # Entries must be high-confidence: the pattern should be something a user is
  # extremely unlikely to write for a legitimate non-Telnyx reason. Plain
  # `messages.create(` is intentionally NOT here — it's already covered by the
  # Twilio-pattern check in the Messaging section above, and matching it at
  # file-scope here produces false positives against internal app code that
  # happens to have a `messages` service/model.
  HALLUCINATED_METHODS=(
    'verifications\.submitVerification'   # correct: verifications.byPhoneNumber.actions.verify
    'verifications\.checkVerification'    # correct: verifications.byPhoneNumber.actions.verify
    'new TelnyxWebhook\('                 # not a real class — use client.webhooks.unwrap()
    'telnyx\.Webhook\.construct'          # Stripe-style, not Telnyx — use client.webhooks.unwrap()
  )

  hallucinated_hits=0
  for pattern in "${HALLUCINATED_METHODS[@]}"; do
    matches=$(search_files "$pattern" "*.py" "*.js" "*.ts" "*.rb" "*.go")
    count=$(count_matches "$matches")
    if [ "$count" -gt 0 ]; then
      hallucinated_hits=$((hallucinated_hits + count))
      lint_issue "hallucinated_method" \
        "Non-existent Telnyx method pattern '$pattern' found in $count location(s)" \
        "Consult {baseDir}/sdk-reference/{language}/{product}.md for the correct method signature" \
        "$(matches_to_json "$matches")"
    fi
  done
  if [ "$hallucinated_hits" -eq 0 ]; then
    lint_pass "hallucinated_method" "No hallucinated Telnyx method names found"
  fi
fi

# ============================================================
# WEBHOOK SIGNATURE VALIDATION
# ============================================================
if product_applies "all"; then
  section_header "Webhook Signature Validation"

  # Check 12: Webhook handlers without Ed25519 signature verification
  webhook_handlers=$(search_files "(app\.(post|put)|router\.(post|put)|@app\.route|@csrf_exempt|http\.HandleFunc|post.*do)" "*.py" "*.js" "*.ts" "*.rb" "*.go" "*.java" "*.php")
  webhook_count=$(count_matches "$webhook_handlers")
  if [ "$webhook_count" -gt 0 ]; then
    ed25519_refs=$(search_files "(telnyx-signature-ed25519|ed25519|verify_signature|verifySignature|construct_event|webhooks\.unwrap|TELNYX_PUBLIC_KEY)" "*.py" "*.js" "*.ts" "*.rb" "*.go" "*.java" "*.php")
    ed25519_count=$(count_matches "$ed25519_refs")
    telnyx_webhook_parse=$(search_files "(data\.payload|data\[.payload.\]|data\.event_type|data\[.event_type.\])" "*.py" "*.js" "*.ts" "*.rb" "*.go" "*.java" "*.php")
    telnyx_parse_count=$(count_matches "$telnyx_webhook_parse")
    if [ "$telnyx_parse_count" -gt 0 ] && [ "$ed25519_count" -eq 0 ]; then
      lint_issue "webhook_ed25519_missing" \
        "Webhook handlers parse Telnyx payloads but no Ed25519 signature verification found" \
        "Add Ed25519 verification using telnyx-signature-ed25519 + telnyx-timestamp headers. See webhook-migration.md" \
        "$(matches_to_json "$telnyx_webhook_parse")"
    elif [ "$ed25519_count" -gt 0 ]; then
      lint_pass "webhook_ed25519_missing" "Ed25519 webhook signature verification found"
    fi
  fi

  # Check 13: twilio.webhook() middleware still present (must be replaced, not just removed)
  # Use specific Twilio patterns to avoid false positives from generic validateRequest functions
  twilio_webhook_mw=$(search_files "(twilio\.webhook\(|@validate_twilio_request|RequestValidator\(|twilio.*validateRequest|validateExpressRequest)" "*.py" "*.js" "*.ts" "*.rb")
  twilio_mw_count=$(count_matches "$twilio_webhook_mw")
  if [ "$twilio_mw_count" -gt 0 ]; then
    if hybrid_waiver_applies "$twilio_webhook_mw"; then
      lint_warn "twilio_webhook_middleware" \
        "Twilio webhook middleware/validator remains while selected products are intentionally hybrid" \
        "Confirm each validator belongs only to kept products: $HYBRID_PRODUCTS" \
        "$(matches_to_json "$twilio_webhook_mw")"
    else
      lint_issue "twilio_webhook_middleware" \
        "Twilio webhook middleware/validator still present in $twilio_mw_count file(s)" \
        "Remove if original had validate:false (it was a no-op). Replace with Ed25519 if original actually validated." \
        "$(matches_to_json "$twilio_webhook_mw")"
    fi
  else
    lint_pass "twilio_webhook_middleware" "No Twilio webhook middleware found"
  fi
fi

# ============================================================
# POLLY VOICE COMPATIBILITY
# ============================================================
if product_applies "voice"; then
  section_header "Polly Voice Compatibility"

  # Check 14: Non-Neural Polly voices (may fall back to default voice)
  polly_refs=$(search_files "Polly\.[A-Z][a-z]+" "*.xml" "*.py" "*.js" "*.ts" "*.rb" "*.go" "*.java" "*.php")
  polly_count=$(count_matches "$polly_refs")
  if [ "$polly_count" -gt 0 ]; then
    non_neural=$(echo "$polly_refs" | grep -v "\-Neural" || true)
    non_neural_count=$(count_matches "$non_neural")
    if [ "$non_neural_count" -gt 0 ]; then
      lint_pass "polly_non_neural" \
        "Documented non-Neural Polly voice references are preserved; do not replace them with man/woman"
    else
      lint_pass "polly_non_neural" "All Polly voices use Neural variants"
    fi
  else
    lint_pass "polly_non_neural" "No Polly voice references found"
  fi
fi

# ============================================================
# DOCUMENTATION FRESHNESS
# ============================================================
section_header "Documentation Updates"

# Check 15: README and docs still referencing Twilio
doc_files=""
for f in README.md README README.rst CONTRIBUTING.md; do
  if [ -f "$PROJECT_ROOT/$f" ]; then
    twilio_in_doc=$(grep -in "twilio" "$PROJECT_ROOT/$f" 2>/dev/null | grep -v -iE '(migrat|port|formerly|previously|was twilio|from twilio to)' || true)
    if [ -n "$twilio_in_doc" ]; then
      doc_files+="$PROJECT_ROOT/$f"$'\n'
    fi
  fi
done
doc_files=$(echo "$doc_files" | sed '/^$/d')
doc_count=$(echo "$doc_files" | sed '/^$/d' | wc -l | tr -d ' ')
if [ "$doc_count" -gt 0 ]; then
  lint_issue "docs_still_twilio" \
    "Documentation files still reference Twilio (not migration-related references) in $doc_count file(s)" \
    "Update README/docs: replace Twilio service names, env vars, setup instructions, and URLs with Telnyx equivalents" \
    "$(echo "$doc_files" | sed '/^$/d' | head -10 | jq -R -s '{files: (split("\n") | map(select(length > 0)))}' 2>/dev/null || echo '{"files":[]}')"
else
  lint_pass "docs_still_twilio" "No Twilio references in documentation files (README, CONTRIBUTING)"
fi

# ============================================================
# RESIDUAL TWILIO CODE
# ============================================================
section_header "Residual Twilio Patterns"

# Check 10: Residual Twilio imports still present alongside Telnyx code
matches=$(search_files '(from twilio|import twilio|require.*twilio|using Twilio)' "*.py" "*.js" "*.ts" "*.rb" "*.go" "*.java" "*.php" "*.cs")
count=$(count_matches "$matches")
if [ "$count" -gt 0 ]; then
  if hybrid_waiver_applies "$matches"; then
    lint_warn "residual_twilio_imports" \
      "Residual Twilio imports found in $count file(s) while products remain intentionally hybrid" \
      "Confirm each import belongs only to kept products: $HYBRID_PRODUCTS" \
      "$(matches_to_json "$matches")"
  else
    lint_issue "residual_twilio_imports" \
      "Residual Twilio imports found in $count file(s)" \
      "Remove Twilio imports — migration should replace them with Telnyx equivalents" \
      "$(matches_to_json "$matches")"
  fi
else
  lint_pass "residual_twilio_imports" "No residual Twilio imports found"
fi

# Check 11: Twilio client instantiation patterns
matches=$(search_files '(Client\(.*account_sid|Twilio\(|twilio\.Twilio\(|new Twilio\.)' "*.py" "*.js" "*.ts" "*.rb" "*.go" "*.java" "*.php")
count=$(count_matches "$matches")
if [ "$count" -gt 0 ]; then
  if hybrid_waiver_applies "$matches"; then
    lint_warn "twilio_client_instantiation" \
      "Twilio client instantiation found in $count file(s) while products remain intentionally hybrid" \
      "Confirm each client belongs only to kept products: $HYBRID_PRODUCTS" \
      "$(matches_to_json "$matches")"
  else
    lint_issue "twilio_client_instantiation" \
      "Twilio client instantiation found in $count file(s)" \
      "Replace with Telnyx client: from telnyx import Telnyx; client = Telnyx(api_key=...) (Python) or new Telnyx({ apiKey: ... }) (JS)" \
      "$(matches_to_json "$matches")"
  fi
else
  lint_pass "twilio_client_instantiation" "No Twilio client instantiation found"
fi

# Check 12: Directory/path names containing "twilio"
twilio_dirs=$(find "$PROJECT_ROOT" -mindepth 1 \
  \( -name node_modules -o -name .git -o -name vendor -o -name __pycache__ \
     -o -name venv -o -name .venv -o -name dist -o -name build \) -prune \
  -o -type d -iname '*twilio*' -print 2>/dev/null || true)
twilio_dir_count=$(echo "$twilio_dirs" | sed '/^$/d' | wc -l | tr -d ' ')
if [ "$twilio_dir_count" -gt 0 ] && [ -n "$(echo "$twilio_dirs" | sed '/^$/d')" ]; then
  if hybrid_waiver_applies "$twilio_dirs"; then
    lint_warn "twilio_directory_names" \
      "Found $twilio_dir_count Twilio-named directory/directories while selected products are intentionally hybrid" \
      "Confirm each directory belongs only to kept products: $HYBRID_PRODUCTS" \
      "$(echo "$twilio_dirs" | sed '/^$/d' | head -10 | jq -R -s '{files: (split("\n") | map(select(length > 0)))}' 2>/dev/null || echo '{"files":[]}')"
  else
    lint_issue "twilio_directory_names" \
      "Found $twilio_dir_count directory name(s) containing 'twilio'" \
      "Rename directories: replace 'twilio' with 'telnyx' in directory names (e.g., feature/twilio/ → feature/telnyx/)" \
      "$(echo "$twilio_dirs" | sed '/^$/d' | head -10 | jq -R -s '{files: (split("\n") | map(select(length > 0)))}' 2>/dev/null || echo '{"files":[]}')"
  fi
else
  lint_pass "twilio_directory_names" "No directory names containing 'twilio'"
fi

# ============================================================
# OUTPUT
# ============================================================

if [ "$JSON_MODE" = true ]; then
  jq -n \
    --arg root "$PROJECT_ROOT" \
    --arg product "$PRODUCT_FILTER" \
    --argjson checks "$JSON_CHECKS" \
    --argjson issues "$ISSUE_COUNT" \
    --argjson warns "$WARN_COUNT" \
    --argjson passes "$PASS_COUNT" \
    '{
      project_root: $root,
      product_filter: $product,
      checks: $checks,
      summary: { issues: $issues, warnings: $warns, passes: $passes },
      result: (if $issues > 0 then "issues_found" else "clean" end)
    }'
else
  echo ""
  echo -e "─────────────────────────────────────"
  echo -e "${BOLD}Summary${NC}"
  echo -e "  ${GREEN}Pass${NC}:    $PASS_COUNT"
  echo -e "  ${RED}Issues${NC}:  $ISSUE_COUNT"
  echo -e "  ${YELLOW}Warns${NC}:   $WARN_COUNT"
  echo ""
  if [ "$ISSUE_COUNT" -gt 0 ]; then
    echo -e "${RED}${BOLD}ISSUES FOUND${NC} — $ISSUE_COUNT correctness issue(s) in migrated code"
    echo "  Fix these before proceeding. Consult sdk-reference/ for correct Telnyx patterns."
  else
    echo -e "${GREEN}${BOLD}CLEAN${NC} — no correctness issues detected"
  fi
fi

if [ "$ISSUE_COUNT" -gt 0 ]; then
  exit 1
else
  exit 0
fi
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall