majiayu000 Minion Sweep
Codebase-wide maintenance scan.
When to Invoke
- User requests "add docstrings to all files"
- Periodic codebase cleanup
- Tech debt reduction
Commands
# Discover what needs work
source .venv/bin/activate && python scripts/minions.py --json sweep <dir> --task <task>
# Apply fixes
source .venv/bin/activate && python scripts/minions.py --json sweep <dir> --task <task> --apply
Tasks
| Task | What it checks |
|---|---|
all |
Everything (default) |
docstrings |
Missing function/class/module docstrings |
types |
Missing type hints |
headers |
Missing module-level docstrings only |
Examples
# Discover
python scripts/minions.py --json sweep src/ --task docstrings
# Apply
python scripts/minions.py --json sweep src/ --task docstrings --apply
# With backups
python scripts/minions.py --json sweep src/ --task all --apply --backup
Output (Discover)
{
"candidates": [
{"file": "src/foo.py", "lines": 120, "missing": ["3 functions without docstrings"]}
],
"total_candidates": 1,
"skipped": []
}
Claude Integration
- Run discover first to show scope
- Confirm with user: "Found 12 files. Apply?"
- Run with --apply on approval
- Report summary