name: minion-polish description: > PROACTIVELY USE after implementing code to add docstrings, type hints, cleanup. Delegates grunt work to local LLMs — saves cloud tokens. Files must be <500 lines. Use for mechanical polish, not logic changes. Changes are auto-applied. allowed-tools: Bash, Read

Minion Polish

Dispatch local model to add mechanical polish. Changes are auto-applied.

When to Invoke

• After implementing a feature
• Files need docstrings, type hints, cleanup
• Mechanical changes only (no logic changes)

Command

source .venv/bin/activate && python scripts/minions.py --json polish <files> --task <task>

Tasks

Examples

# Polish single file
python scripts/minions.py --json polish src/foo.py --task all

# Multiple files
python scripts/minions.py --json polish src/foo.py src/bar.py --task docstrings

# Dry run
python scripts/minions.py --json polish src/foo.py --task all --dry-run

Output

{
  "applied": true,
  "files_modified": ["src/foo.py"],
  "changes": ["src/foo.py: Added 3 docstring(s)"],
  "errors": [],
  "stats": {"total": 1, "applied": 1, "failed": 0}
}

Claude Integration

After completing code:

• Small (1-2 files): Auto-invoke, report summary
• Medium (3+ files): Ask user "Want me to dispatch minions for polish?"