| name | minion-sweep |
| description | > Use when this capability is needed. |
Minion Sweep
Codebase-wide maintenance scan.
When to Invoke
- User requests "add docstrings to all files"
- Periodic codebase cleanup
- Tech debt reduction
Commands
source .venv/bin/activate && python scripts/minions.py --json sweep <dir> --task <task>
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
python scripts/minions.py --json sweep src/ --task docstrings
python scripts/minions.py --json sweep src/ --task docstrings --apply
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
Converted and distributed by TomeVault — claim your Tome and manage your conversions.