batch-editing

What problem does it solve?

Provides a structured workflow for performing deterministic, repeatable edits across multiple files while minimizing risk of partial failures and ensuring idempotency and verification.

Core Features & Use Cases

• Threshold guidance: Advises when to run ad-hoc edits versus plan-and-execute workflows and mandates parallelization for very large batches.
• Execution patterns: Recommends tool-first approaches, simple shell iteration, find-based searches, and dividing work for sub-agent parallel runs.
• Safety practices: Emphasizes dry-run planning, atomic temporary-file swap updates to avoid intermediate states, and clear success/failure reporting.
• Failure handling: Stop-on-first-error for single-file failures and explicit partial-success reporting with file lists.
• Use case: Apply consistent refactors, mass search-and-replace, or repetitive file transformations across many project files while preserving recoverability.

Quick Start

Perform a dry-run replacement across the target files, review the results for idempotency and correctness, then execute atomic batch updates in groups of ten.