ghostbuster

What problem does it solve?

Dead code forensics and spec cross-reference. Finds unreachable functions, orphaned implementations, specs pointing at deleted code, and transitive dead code chains. Categorizes as DEAD (safe to delete), ZOMBIE (in spec but unwired), GHOST (spec references nonexistent code), or DORMANT (entry point is dead, taking dependents with it). Use when the user says "find dead code", "what's unused", "clean up unused functions", "are there stale specs", "what code can I delete", "check for orphaned implementations", "spec drift", "what's incomplete", "find zombie code", or asks about code that was started but never finished. Also use when reviewing a module and wanting to know what's wired up vs what's just sitting there. Do NOT use for code quality review (/age), NIH/reinvented-wheel detection (/nih-audit), or security scanning (/audit).

Core Features & Use Cases

• Cross-reference specs and code to surface dead, zombie, ghost, and dormant items.
• Provide triage guidance with concrete examples and recommended actions.
• Scale from single module to entire repo with scope control via ARGUMENTS.

Quick Start

Provide a working scope (or leave blank for repo root) and ask the tool to run a dead-code forensics pass.