modify

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty).

Flag Parsing

# Parse flags from arguments
MODIFY_DESC=""
REFACTOR_MODE=false
DEPRECATE_MODE=false
ANALYZE_ONLY=false

for arg in $ARGUMENTS; do
  if [ "${arg:0:2}" != "--" ] && [ -z "$MODIFY_DESC" ]; then
    MODIFY_DESC="$arg"
  elif [ "$arg" = "--refactor" ]; then
    REFACTOR_MODE=true
  elif [ "$arg" = "--deprecate" ]; then
    DEPRECATE_MODE=true
  elif [ "$arg" = "--analyze-only" ]; then
    ANALYZE_ONLY=true
  fi
done

Mode Routing

IF --refactor flag is set, execute metrics-driven behavior-preserving refactoring workflow:

if [ "$REFACTOR_MODE" = true ]; then
  echo "♻️  SpecSwarm Modify --refactor"
  echo "══════════════════════════════════════════"
  echo ""
  echo "Mode: Behavior-Preserving Quality Improvement"
  echo ""
  echo "This workflow will:"
  echo "  1. Establish baseline metrics (complexity, duplication, coverage)"
  echo "  2. Create refactoring specification"
  echo "  3. Execute incremental refactoring steps"
  echo "  4. Verify behavior preservation after each step (test suite)"
  echo "  5. Measure final metrics and compare improvement"
  echo ""
  echo "Key principles:"
  echo "  • No functional changes - behavior must be identical"
  echo "  • Metrics-driven - quantify improvements"
  echo "  • Incremental - small, safe refactoring steps"
  echo "  • Testable - verify identical behavior before/after"
  echo ""
fi

IF REFACTOR_MODE = true: Execute the refactoring workflow:

1. Discover refactor context (find feature directory)
2. Establish baseline metrics (complexity, duplication, coverage, maintainability)
3. Create refactor specification documenting target, approach, and expected improvements
4. Generate incremental refactoring tasks (each followed by test verification)
5. Execute tasks: refactor step → run tests → verify identical results → repeat
6. Measure final metrics and generate before/after comparison report