dead-code-scan

Dead Code Scan

Comprehensive scan for dead code across the project. Reports findings without making changes. Use /dead-code-clean to actively remove.

CRITICAL: This is a scan, not a fix. Document issues thoroughly with clear evidence and confidence levels. Use /dead-code-clean to remove issues after the scan.

First: Use the dead-code-expert skill for detection catalog, language tools, and false-positive awareness.

Preparation

1. Detect the project language from file extensions and config files (package.json, Cargo.toml, pyproject.toml, go.mod, *.csproj, Package.swift).
2. Identify entry points (main, index, App, etc.).
3. Determine the target. If no target specified, scan from project root focusing on source directories.

Automated Scans

Run all applicable scans based on detected language.

Universal Scans (all languages)

# Debug artifacts
rg -c '(console\.log|print\(|dbg!\(|println!\(|debugger|breakpoint\(\)|System\.out\.print)' . --glob '!*test*' --glob '!*spec*' --glob '!node_modules*' --glob '!target*' --glob '!.git*' --glob '!__pycache__*' 2>/dev/null | awk -F: '{s+=$2} END {print "Debug artifacts:", s+0}'

# Lint suppressions hiding dead code
rg -c '(#\[allow\((dead_code|unused)|eslint-disable.*unused|# noqa: F4|@SuppressWarnings.*unused|#pragma warning disable)' . --glob '!node_modules*' --glob '!target*' 2>/dev/null | awk -F: '{s+=$2} END {print "Lint suppressions:", s+0}'

# Commented-out code (heuristic)
rg -c '^\s*(//|#)\s*(const|let|var|function|class|import|from|if|for|while|return|def |fn |pub |async |await )\b' . --glob '!node_modules*' --glob '!target*' 2>/dev/null | awk -F: '{s+=$2} END {print "Commented code:", s+0}'

# TODO/FIXME/HACK markers
rg -c '\b(TODO|FIXME|HACK|XXX|TEMP|TEMPORARY)\b' . --glob '!node_modules*' --glob '!target*' 2>/dev/null | awk -F: '{s+=$2} END {print "TODO/FIXME/HACK:", s+0}'

# Skipped tests
rg -c '(@skip|@ignore|xit\(|xdescribe\(|\.skip\(|#\[ignore\]|\[Ignore\]|@Disabled|@pytest\.mark\.skip)' . --glob '*test*' --glob '*spec*' 2>/dev/null | awk -F: '{s+=$2} END {print "Skipped tests:", s+0}'