Skip to content

Commit b93b6a7

Browse files
committed
docs: add critical warning against sed/awk/python mass changes
- Added explicit prohibition against sed, awk, python scripts for mass replacements - Documents the systematic corruption these tools previously caused - Requires all code changes use direct Edit/MultiEdit tools only - Each change must be carefully reviewed and tested on individual files This prevents future mass corruption incidents that broke syntax across hundreds of files with patterns like missing parentheses and malformed struct initializations.
1 parent c79f22d commit b93b6a7

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

CLAUDE.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -226,6 +226,23 @@ When encountering "prefix is unknown" or "unterminated double quote string" erro
226226
- `#[cfg(feature = ")]` (incomplete feature flag)
227227
4. **Fix at the source** - Add the missing error message, don't just add spaces at the reported line
228228

229+
## ⚠️ CRITICAL: NO MASS CHANGES WITH sed/awk/python
230+
231+
**NEVER use sed, awk, python scripts, or any mass text replacement tools on this codebase.**
232+
233+
This codebase has previously suffered from systematic corruption caused by faulty sed replacements that broke syntax across hundreds of files. The damage included:
234+
- Missing closing parentheses (`;` instead of `);`)
235+
- Malformed struct initializations (`;` instead of `};`)
236+
- Broken function calls and array syntax
237+
- Corrupted assert macros and error constructors
238+
239+
**ONLY use direct Edit/MultiEdit tools for code changes.** Each change must be:
240+
- Carefully reviewed and tested on individual files
241+
- Applied with precise context to avoid unintended replacements
242+
- Verified through compilation before proceeding
243+
244+
**If you encounter systematic issues, fix them one file at a time using Edit commands, never with mass replacement tools.**
245+
229246
## Code Style Guidelines
230247

231248
### General Formatting

0 commit comments

Comments
 (0)