---

name: s-clean description: > Find and remove dead code and stale documentation. Covers unused functions, orphaned files, dead links, and outdated references. Use for maintenance, pre-release cleanup, or codebase hygiene. Triggers: clean, dead code, unused, orphan, stale, cruft, maintenance.

Cleaning WoW Addons

Expert guidance for finding and removing cruft in addon codebases.

Related Commands

• c-clean - Cleanup workflow
• c-review - Full review (includes clean step)

MCP Tools

Capabilities

1. Dead Code Detection — Find unused functions, orphaned files, dead exports
2. Stale Docs Detection — Find broken links, outdated refs, version drift
3. Confidence Levels — Definite (100%), Likely (90%+), Suspicious (70%+)

Detection Categories

Dead Code (addon.deadcode)

Stale Docs (docs.stale)

Workflow

Quick Cleanup

1. Run addon.deadcode with include_suspicious=false for high-confidence issues only
2. Remove identified dead code
3. Run docs.stale to find documentation issues
4. Fix broken links and update outdated references

Deep Cleanup

1. Run addon.deadcode with all confidence levels
2. Manually verify suspicious findings before removal
3. Run docs.stale with all techniques
4. Update documentation to match current code

Confidence Interpretation

Best Practices

1. Start with definite issues — These are safe to fix immediately
2. Check dynamic patterns — _G, rawget, loadstring may hide usage
3. Preserve intentional dead code — Mark with -- KEEP: comment if needed
4. Update docs after code changes — Run docs.stale after refactoring