Model đắt không nên làm việc bưng bê file. Stop paying a frontier model to move files around.

Viết luật định tuyến vào CLAUDE.md rồi coi là xongPutting routing rules in CLAUDE.md and calling it done

Luật ở đó là khuyến nghị; model bỏ qua được và mỗi repo cần một bản copy.Rules there are advisory; the model can ignore them and every repo needs a copy.

Hạ luật xuống lớp hook, giữ markdown làm phần hướng dẫn cú pháp.Move the rule down to the hook layer; keep markdown for syntax guidance.

Hook thoát bằng exit code 1 khi muốn chặnExiting a hook with code 1 to block

Chỉ exit 2 mới chặn; mã khác bị coi là lỗi không chặn và tool vẫn chạy.Only exit 2 blocks; other codes count as non-blocking errors and the tool still runs.

Dùng exit 2 kèm lý do ra stderr, hoặc JSON permissionDecision: "deny".Use exit 2 with the reason on stderr, or JSON permissionDecision: "deny".

Đặt ngưỡng rất thấp cho “tiết kiệm tối đa”Setting a very low threshold for “maximum savings”

Mỗi lần uỷ thác tốn 10–30 giây; dưới ngưỡng, phí tổn vượt khoản tiết kiệm.Every delegation costs 10–30 seconds; below the threshold the overhead exceeds the saving.

Đo phân bố độ dài file và p50 độ trễ, rồi chỉnh SHUNT_MIN_LINES.Measure file-length distribution and p50 latency, then tune SHUNT_MIN_LINES.

Gọi code-write không kèm --referenceCalling code-write without --reference

Không có mẫu, worker sinh code không khớp quy ước nào trong dự án.With no pattern, the worker generates code that matches nothing in the project.

Coi --reference là bắt buộc; thiếu thì script báo lỗi ngay.Treat --reference as mandatory; fail loudly in the script if it's missing.

Uỷ thác việc sửa codeDelegating edits

Tóm tắt của worker không có số dòng đáng tin.The worker's summaries carry no reliable line numbers.

Uỷ thác phần hiểu, đọc trực tiếp phần sửa.Delegate the understanding, read directly for the editing.

Uỷ thác debug và quyết định kiến trúcDelegating debugging and architecture

Worker bắt mẫu bề mặt; một lỗi thread-safety trong thử nghiệm đã bị bỏ lọt.The worker finds surface patterns; a thread-safety bug slipped past it in testing.

Loại trừ tường minh: debug, kiến trúc, code an toàn luôn ở model chính.Exclude explicitly: debugging, architecture and safety-critical code stay on the main model.

Để worker trả về markdown fence và lời giải thíchLetting the worker return markdown fences and prose

Phần dọn dẹp phía sau ăn lại chính khoản token vừa tiết kiệm.The cleanup downstream eats the tokens you just saved.

Ghi “chỉ xuất code” vào instruction và strip fence trong script.Put “output only the code” in the instruction and strip fences in the script.

Tin vào con số 90% cho repo của mìnhTrusting the 90% figure for your own repo

90% là trung bình trên monorepo Java nhiều mẫu lặp — gần với trường hợp tốt nhất.90% is a mean on a pattern-heavy Java monorepo — close to the best case.

Đo trên chính repo của bạn, trên vài kịch bản thật.Measure on your own repo, across a few real scenarios.

Không báo token đã dùngNot reporting token usage

Không đo thì không biết mình tiết kiệm hay chỉ chuyển chi phí sang chỗ khác.Without measurement you can't tell saving from cost-shifting.

Script in token usage ra stderr mỗi lần gọi.Have the script print token usage to stderr on every call.

Ghi đè file thật ngay từ lần chạy đầuOverwriting real files on the first run

Sai đường dẫn hoặc output tệ sẽ phá code đang chạy.A wrong path or a bad generation damages working code.

Chạy ra stdout trước, ghi vào đường dẫn mới, để git diff làm trọng tài.Run to stdout first, write to a new path, let git diff be the referee.