name: minion-patch description: > Use when a mechanical code change needs review before applying. Delegates grunt work to local LLMs — saves cloud tokens. Generates patch for review. Use for changes that might need adjustment. Files must be <500 lines. allowed-tools: Bash, Read, Glob, Grep

Minion Patch

Generate a patch for manual review.

When to Invoke

• Changes need careful review before applying
• User wants to see diff before commit
• Complex changes that might need adjustment

Command

source .venv/bin/activate && python scripts/minions.py --json patch "<task>" --target <file> --read <file>

Examples

# Generate patch
python scripts/minions.py --json patch "Add TODO comment at top" --target src/foo.py --read src/foo.py

# Multiple targets
python scripts/minions.py --json patch "Add header" --target src/a.py --target src/b.py --read src/a.py --read src/b.py

Output

{
  "task": "Add TODO comment",
  "patch_path": "sessions/20260112-123456.patch",
  "summary": "Added comment to foo.py"
}

Applying Patches

# Review
cat sessions/*.patch

# Dry-run
patch -p1 --dry-run < sessions/*.patch

# Apply
patch -p1 < sessions/*.patch

Limits

• Files <500 lines (32K context)
• Mechanical changes only
• Always pass --read with target file