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.