/refactor-clean

Refactor Clean

Safely identify and remove dead code with test verification:

1. Run dead code analysis tools:

• vulture: Find unused Python code (functions, classes, variables)
• pyflakes: Detect unused imports and variables
• ruff check --select F401: Find unused imports
• pip-audit: Check for security vulnerabilities

2. Generate comprehensive report in .reports/dead-code-analysis.md

3. Categorize findings by severity:

• SAFE: Test files, unused utilities, unused imports
• CAUTION: API routes, models, fixtures
• DANGER: Config files, main entry points, registry decorators

4. Propose safe deletions only

5. Before each deletion:

• Run full test suite (pytest)
• Verify tests pass
• Apply change
• Re-run tests
• Rollback if tests fail

6. Show summary of cleaned items

Never delete code without running tests first!