Skill · Rule CLAUDE.md

Lập bản đồ ảnh hưởng trước khi sửa

Một forcing function buộc agent truy ai đang phụ thuộc vào một symbol, trước khi nó đổi.

DạngRule CLAUDE.md

Đổi tên một hàm, chỉnh cái nó trả về, sửa một giá trị mặc định — cảm giác như chỉ là một dòng. Agent sửa, file trông sạch, cái test nó chạy vẫn xanh. Cái nó không hề thấy là mười một chỗ khác từng gọi hàm đó và đang trông chờ hình dạng cũ. Những chỗ đó không vỡ ầm ĩ; chúng vỡ sau, ở nơi bạn không nhìn tới, lần lượt từng cái một.

Một symbol dùng chung không có khái niệm "sửa cục bộ". Mọi thay đổi lên nó là thay đổi lên tất cả những gì phụ thuộc vào nó — mà agent, khi làm trong một file, chỉ thấy đúng cái file trước mặt. Rule này buộc nó nhìn ra ngoài trước khi đụng vào bất cứ thứ gì đang gánh:

✕ Không có rule

Sửa thẳng hàm tại chỗ — file trông sạch

▼

Cái test duy nhất trong file này vẫn xanh

▼

Mười một nơi gọi vỡ sau — từng cái, ở production

✓ Có rule

Liệt kê trước mọi nơi gọi symbol đó

▼

Nói rõ cái gì vỡ nếu đổi hình dạng

▼

Bạn duyệt những chỗ đang gánh, trước khi sửa

Dán vào CLAUDE.md của bạn. Với một hàm riêng tư, độc lập, nó không tốn gì — chẳng có nơi gọi nào để liệt kê, rule tự nhường đường. Chỗ nó đáng giá là đúng nơi thiệt hại ẩn nấp: cái helper dùng chung, cái config key, cái signature công khai mà năm mươi thứ ngầm dựa vào. Find-and-replace là công cụ nguy hiểm nhất trong tình huống đó, vì nó thay chữ mà không hiểu đồ thị gọi — nên rule bắt agent truy trước khi đụng.

Dán vào CLAUDE.md

## Before editing shared code
Before changing a function, type, signature, or config value that other code depends on:
1. List every caller or dependent of the symbol you are about to change.
2. State the blast radius: what breaks if the change is wrong, and how far it reaches.
3. If it touches a widely-used symbol or a public interface, say so and wait for my go-ahead before editing.
Never change a shared signature with blind find-and-replace — trace the callers first, then edit.

Muốn agent tự cài hộ?

Thêm rule này vào CLAUDE.md của tôi, nguyên văn:

## Before editing shared code
Before changing a function, type, signature, or config value that other code depends on:
1. List every caller or dependent of the symbol you are about to change.
2. State the blast radius: what breaks if the change is wrong, and how far it reaches.
3. If it touches a widely-used symbol or a public interface, say so and wait for my go-ahead before editing.
Never change a shared signature with blind find-and-replace — trace the callers first, then edit.