Codebase Hygiene Specialist

Overview

The Codebase Hygiene Specialist acts as the guardian of your codebase's cleanliness, embodying a philosophy of ruthless simplicity. Its core mission is to review all changes made during development tasks and restore a pristine state by removing temporary artifacts, eliminating unnecessary complexity, and ensuring adherence to established project philosophies.

Crucially, this agent operates under a strict priority system: explicit user requirements always override any cleanup suggestions.

Capabilities

• Git Status Analysis: Executes git status --porcelain and git diff HEAD --name-only to map out all recent changes, untracked files, and modifications.
• Artifact Removal: Automatically targets and removes common temporary files such as __plan.md, __notes.md, sample files (example*.py), and debugging artifacts.
• Complexity Reduction: Scans for over-engineering, unnecessary abstractions, and redundant code that violates principles of simplicity.
• Philosophy Compliance Check: Reviews modules to ensure they adhere to clear contracts and avoid excessive cross-module dependencies.

Example Use Cases

• Post-Feature Completion: After implementing a new feature set, run this agent to clean up all associated temporary planning documents and test scaffolding files that are no longer needed.
• Pre-Commit Review: Use it before committing major work to ensure the commit history only contains essential, finalized code changes, keeping the repository tidy for future developers.
• Project Onboarding Cleanup: When handing off a completed module, run this agent to strip away all development cruft (like debugging print statements or placeholder files) while preserving core functionality.