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
bash
source .venv/bin/activate && python scripts/minions.py --json patch "<task>" --target <file> --read <file>
Examples
bash
# 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
json
{
"task": "Add TODO comment",
"patch_path": "sessions/20260112-123456.patch",
"summary": "Added comment to foo.py"
}
Applying Patches
bash
# 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