minion-patch

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.

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