widescreen-research: Command for Claude Code

/refactoring-game

Execute a game-theoretic refactoring protocol that prevents perfectionism spirals while maintaining code quality.

Usage

/refactoring-game [codebase_path] [ship_deadline] [budget] [max_iterations] [confidence_threshold]

Arguments

• codebase_path (required): Path to the codebase to refactor
• ship_deadline (optional): ISO 8601 deadline (default: 4 hours from now)
• budget (optional): Energy units for refactoring (default: 100)
• max_iterations (optional): Maximum refactoring rounds (default: 5)
• confidence_threshold (optional): Quality threshold 0-1 (default: 0.8)
• comments (optional): developer comments on the task

Algorithm

Phase 0: Initialize Game State

# Create game state tracking
mkdir -p .refactoring-game
cat > .refactoring-game/state.json << 'EOF'
{
  "round": 0,
  "budget_remaining": $BUDGET,
  "improvements": [],
  "spiral_detections": [],
  "commitment_level": 0,
  "players": {
    "perfectionist": { "satisfaction": 0.0, "weight": 0.8 },
    "shipper": { "urgency": 0.5, "weight": 0.9 },
    "maintainer": { "debt_concern": 0.7, "weight": 0.7 },
    "user": { "patience": 0.9, "weight": 1.0 }
  }
}
EOF

# Analyze codebase health
echo "🎮 Starting Refactoring Game for $CODEBASE_PATH"
echo "⏰ Ship deadline: $SHIP_DEADLINE"
echo "💰 Budget: $BUDGET energy units"

Phase 1: Codebase Auction Analysis

# Calculate refactoring bids for each component
echo "🔍 Analyzing codebase for refactoring candidates..."

# Find all source files and calculate pain metrics
find "$CODEBASE_PATH" -type f \( -name "*.js" -o -name "*.ts" -o -name "*.jsx" -o -name "*.tsx" \) | while read -r file; do
  # Calculate complexity score
  complexity=$(npx complexity "$file" 2>/dev/null | grep -oE '[0-9]+' | head -1 || echo "10")

  # Calculate churn (number of commits)
  churn=$(git log --oneline -- "$file" 2>/dev/null | wc -l)

  # Search for bug-related commits
  bugs=$(git log --grep="fix\|bug\|issue" --oneline -- "$file" 2>/dev/null | wc -l)

  # Calculate bid (willingness to pay for refactoring)
  bid=$(echo "scale=2; ($complexity * 0.4) + ($churn * 0.3) + ($bugs * 10 * 0.3)" | bc)

  echo "{\"file\": \"$file\", \"bid\": $bid, \"complexity\": $complexity, \"churn\": $churn, \"bugs\": $bugs}"
done | jq -s 'sort_by(.bid) | reverse' > .refactoring-game/auction.json

echo "📊 Auction complete. Top candidates identified."