batch-operations

name	batch-operations
description	Apply consistent changes across many files at once. One pattern, many targets.

Batch Operations — Multi-File Changes

Apply consistent changes across many files at once. One pattern, many targets.

When to Use

✅ Good for:

• Renaming a function/component across all files that use it
• Adding an import to every file in a directory
• Updating version numbers across package files
• Applying the same code pattern to multiple similar files
• Migrating from one API to another across the codebase
• Adding/removing a field from all similar data structures

❌ Not for:

• Single-file edits (use direct editing)
• Unique changes per file (handle individually)
• Changes that need per-file judgment (use an agent per domain)

---

Batch Operation Protocol

Step 1: Define the Pattern

What:     [exact text/pattern to find]
Replace:  [exact replacement text]
Scope:    [file glob pattern, e.g., "src/**/*.tsx"]
Exclude:  [files to skip, e.g., "**/*.test.tsx"]

Step 2: Preview Before Executing

# Find all affected files FIRST
grep -rl "oldPattern" src/ --include="*.ts"

# Count matches
grep -rc "oldPattern" src/ --include="*.ts" | grep -v ":0$"

# Show context for each match
grep -rn "oldPattern" src/ --include="*.ts"