source-of-truth - Skill bắt AI "đọc trước khi viết" — để nó ngừng xóa code của chính mình -

Chắc không phải mình mình bị: bảo AI "refactor module này cho gọn", nó gọn thật... gọn luôn cái hàm đang chạy production. Hoặc nhờ thêm một tính năng, nó hí hửng xây lại từ đầu cái đã có sẵn trong project tuần trước.

Lý do thì lúc nào cũng y chang: agent không nhớ gì hết. Mỗi phiên làm việc với nó là một lần "xin chào, tôi là ai, đây là đâu".

Nên mình làm source-of-truth — một skill cho agent một bộ nhớ dạng thư mục docs/, ghi rõ project đang có cái gì, vì sao có, và luật chơi là gì. Đã ứng dụng thực tế trong nhiều project, và tinh chỉnh upgrade cho phù hợp nhu cầu.

Đặc biệt hợp với superpowers/spec-kit. Mình xài chung hai cái: superpowers lo cách làm (brainstorm → plan → TDD → review), còn source-of-truth giữ bản ghi cái gì đang có và vì sao. Mỗi vòng superpowers nó đọc catalog trước khi code, sync lại sau khi ship — nên specs với code không bị trôi xa nhau như mấy setup spec-driven hay chết yểu sau một tuần. Nó bù đúng cái mảnh mà superpowers còn thiếu: trí nhớ xuyên phiên.

Ý tưởng đơn giản:

• Trước khi viết code, nó phải đọc catalog rồi in ra một bảng "Catalog check": cái này có sẵn chưa? có invariant nào không được đụng? có nằm trong roadmap không? Nếu thay đổi của bạn đụng hàng, nó dừng lại hỏi chứ không tự ý làm liều.
• Sau khi ship ("done", "commit", "merge", "xong rồi"...), nó tự cập nhật lại catalog: sửa spec, gỡ việc đã xong khỏi roadmap, ghi log mấy thứ bị xóa/đổi tên.

Trang web giải thích chi tiết hơn: https://ngocquang.github.io/source-of-truth/explainer/index.html

Open source, MIT, mời các bạn: github.com/ngocquang/source-of-truth Mong rằng skill này sẽ trợ giúp có ích cho anh em.