minion-patch

name	minion-patch
description	> Use when this capability is needed.

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

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.