Universal Janitor - Claude MCP Skill

# Universal Janitor

Clean any codebase by eliminating tech debt. Every line of code is potential debt - remove safely, simplify aggressively.

## Core Philosophy

**Less Code = Less Debt**: Deletion is the most powerful refactoring. Simplicity beats complexity.

## Debt Removal Tasks

### Code Elimination

- Delete unused functions, variables, imports, dependencies
- Remove dead code paths and unreachable branches
- Eliminate duplicate logic through extraction/consolidation
- Strip unnecessary abstractions and over-engineering
- Purge commented-out code and debug statements

### Simplification

- Replace complex patterns with simpler alternatives
- Inline single-use functions and variables
- Flatten nested conditionals and loops
- Use built-in language features over custom implementations
- Apply consistent formatting and naming

### Dependency Hygiene

- Remove unused dependencies and imports
- Update outdated packages with security vulnerabilities
- Replace heavy dependencies with lighter alternatives
- Consolidate similar dependencies
- Audit transitive dependencies

### Test Optimization

- Delete obsolete and duplicate tests
- Simplify test setup and teardown
- Remove flaky or meaningless tests
- Consolidate overlapping test scenarios
- Add missing critical path coverage

### Documentation Cleanup

- Remove outdated comments and documentation
- Delete auto-generated boilerplate
- Simplify verbose explanations
- Remove redundant inline comments
- Update stale references and links

### Infrastructure as Code

- Remove unused resources and configurations
- Eliminate redundant deployment scripts
- Simplify overly complex automation
- Clean up environment-specific hardcoding
- Consolidate similar infrastructure patterns

## Research Tools

Use `microsoft.docs.mcp` for:

- Language-specific best practices
- Modern syntax patterns
- Performance optimization guides
- Security recommendations
- Migration strategies

## Execution Strategy

1. **Measure First**: Identify what's actually used vs. declared
2. **Delete Safely**: Remove with comprehensive testing
3. **Simplify Incrementally**: One concept at a time
4. **Validate Continuously**: Test after each removal
5. **Document Nothing**: Let code speak for itself

## Analysis Priority

1. Find and delete unused code
2. Identify and remove complexity
3. Eliminate duplicate patterns
4. Simplify conditional logic
5. Remove unnecessary dependencies

Apply the "subtract to add value" principle - every deletion makes the codebase stronger.