refactor-clean

If $ARGUMENTS is empty or not provided:

Find and clean dead code across the entire Go project.

Usage: /refactor-clean [path] [options]

Examples:

• /refactor-clean - Analyze entire project for dead code
• /refactor-clean ./pkg/... - Analyze specific package tree
• /refactor-clean --dry-run - Report findings without applying fixes
• /refactor-clean ./internal/auth --dry-run - Report-only for a specific package

Analysis categories: unused exported functions/types, orphaned test files, overly complex functions, unused imports.

Workflow: detect tools → parallel-dispatch 4 analysis subagents → present findings report → apply fixes only after user confirmation → verify build + tests.

Set default: TARGET_PATH="./..." and proceed.

---

If $ARGUMENTS is provided:

Parse $ARGUMENTS:

• Argument starting with ./ or a package pattern → TARGET_PATH
• --dry-run → set DRY_RUN=true, default TARGET_PATH="./..."
• Both: extract path to TARGET_PATH, set DRY_RUN=true

Loop Initialization

!if [ ! -x "${CLAUDE_PLUGIN_ROOT}/scripts/setup-loop.sh" ]; then echo "ERROR: Plugin cache stale. Run /gopher-ai-refresh (or refresh-plugins.sh) and restart Claude Code."; exit 1; else "${CLAUDE_PLUGIN_ROOT}/scripts/setup-loop.sh" "refactor-clean" "COMPLETE"; fi

Step 1: Verify Go Project

if [ ! -f go.mod ]; then
  echo "ERROR: No go.mod found. This command must be run from a Go project root."
  exit 1
fi
head -5 go.mod

Capture the module path from go.mod for import analysis.

Step 2: Detect Available Analysis Tools

echo "=== Tool Detection ==="
which staticcheck 2>/dev/null && staticcheck --version || echo "staticcheck: NOT FOUND"
which deadcode 2>/dev/null || echo "deadcode: NOT FOUND (golang.org/x/tools/cmd/deadcode)"
which gocyclo 2>/dev/null || echo "gocyclo: NOT FOUND"
which gocognit 2>/dev/null || echo "gocognit: NOT FOUND"
which goimports 2>/dev/null || echo "goimports: NOT FOUND"
go version