| name | slop-removal |
| description | Remove AI-generated comment slop from a branch diff. Use when the user asks to clean up AI comments, remove slop, or strip unnecessary comments from a branch. |
Remove AI Slop from Branch Diff
What counts as slop
Remove ONLY clearly AI-generated filler:
- Comments that restate what the code obviously does (e.g.,
# Increment counter, # Return the result)
- Phrases like "This is important because...", "Note that...", "We need to..."
- Overly verbose docstrings that describe trivial behavior
- Section headers that add no information (e.g.,
# Main logic, # Helper function)
What to keep
Do NOT remove:
- Comments that explain non-obvious logic, edge cases, or algorithmic choices
- References to external specs, papers, or issues
- TODOs and FIXMEs
- Type annotations or parameter descriptions in docstrings
Workflow
- Run
git diff origin/main..HEAD to see all changes on the branch
- Identify slop comments introduced in this branch (not pre-existing)
- Show me the list of proposed removals BEFORE making any edits
- After confirmation, make the edits — only comment/docstring deletions, no code changes
- Run the linter (
make style && make quality) and confirm tests still pass
- Commit with message "Remove AI-generated comment slop"
