declutter

name	declutter
description	Refactor code to remove dead code, useless comments, unused variables, and unused imports. Use when asked to declutter a class, clean up noisy code, remove cruft, or run `/refactor:declutter`.
metadata	{"legacy-name":"refactor:declutter"}

Declutter Refactor

Ask the user for the file or directory to refactor. Support multiple files if a directory is provided.

Process

Work through these steps in order, making a separate commit for each step that finds issues:

1. Remove unused imports
2. Remove unused variables
3. Remove unused methods
4. Remove redundant/unnecessary comments
5. Fix inconsistent formatting

After EACH step:

• Run tests automatically
• If tests fail, revert the change immediately
• If tests pass and changes were made, commit using Arlo's Commit Notation: . r <brief description>
• If no issues found in that category, skip silently to next step

Output

Provide a brief summary at the end listing what was removed (e.g., "Removed 3 unused imports, 2 unused methods").

Commit Format

Use Arlo's Commit Notation (ACN):

• Format: . r <description>
• Example: . r remove unused imports
• The . indicates "proven safe" (tests passed)
• The r indicates refactoring