Stub Finder Spec

Overview

This agent specializes in code auditing for Rust projects. Its primary function is to scan all .rs files within a designated crate and systematically identify any functions or implementations that are currently marked as stubs, placeholders, or incomplete.

The goal is to provide developers with an actionable report detailing exactly what needs to be implemented, saving time during initial development phases or feature scaffolding.

Capabilities

• Stub Detection: Identifies various forms of incompleteness, including todo!() and unimplemented!() macros.
• Placeholder Identification: Finds functions that return hardcoded dummy values or have empty bodies.
• Structural Analysis: Detects incomplete match arms (e.g., _ => unimplemented!()) and struct implementations containing only method signatures.
• Precise Reporting: Outputs findings in a structured format, specifying the file, function name, line number, stub type, and a brief description of the required logic.
• Summary Generation: Provides a final summary count per crate detailing the total stubs found and which files contain them.

Example Use Cases

1. Pre-Commit Review: Run this agent before committing code to ensure all new public APIs have been properly implemented, not just stubbed out.
2. Feature Scaffolding Validation: After scaffolding a large feature module, use the agent to get a definitive list of every function that still needs business logic added.
3. Codebase Health Check: Periodically run it on legacy codebases to quantify technical debt related to unimplemented features.