Lập trình viên sẵn sàng viết tài liệu cho Claude nhưng lại lơ là đồng nghiệp

Lập trình viên sẵn sàng viết tài liệu cho Claude nhưng lại lơ là đồng nghiệp

Gần đây, tôi thường nghe thấy một lời phàn nàn phổ biến trong cộng đồng lập trình viên: nhiều người cảm thấy khó chịu khi thấy đồng nghiệp sẵn sàng viết các tệp CLAUDE.md hay PROJECT.md chi tiết để hỗ trợ AI, nhưng lại không chịu làm điều đó cho chính những người làm việc cùng mình.

Đối với các dự án lớn, tôi đã bắt đầu yêu cầu Claude duy trì một tài liệu bàn giao (handoff document). Tài liệu này ghi lại kế hoạch, những gì đã hoàn thành và các thông tin liên quan khác. Khi kết thúc phiên làm việc với một "Claude", tôi sẽ yêu cầu "Claude" tiếp theo đọc tệp này để bắt kịp tiến độ, sau đó yêu cầu nó cập nhật cho phiên sau nữa.

Sau khi thấy lời phàn nàn đó đủ nhiều, tôi có một ý tưởng thú vị. Trước đây tôi thường xóa các tài liệu bàn giao này sau khi dự án kết thúc. Tại sao lại làm vậy? Việc sao chép tệp vào kho lưu trữ (repository) và commit nó không tốn chút công sức nào cả. Trong tương lai, nếu ai đó thắc mắc về những gì đã diễn ra, họ có thể tìm thấy tài liệu hữu ích này thông qua lệnh git grep.

Tôi nhận ra một cách làm tốt hơn: vào cuối dự án, tôi giờ đây yêu cầu Claude viết lại từ đầu một lời giải thích chi tiết nhưng ở mức độ tổng quan về vấn đề chúng ta đang giải quyết và những thay đổi đã thực hiện, sau đó tôi commit nó. Không chỉ là những ghi chú chạy, mà là một cái nhìn tổng quan có cấu trúc về toàn bộ dự án.

Tôi xem xét kỹ lưỡng các bản tóm tắt này và chỉnh sửa nếu cần thiết trước khi commit. Đó là chữ ký của tôi trong commit, và tài khoản ngân hàng của tôi nhận tiền lương, nên không có gì được đưa vào repository mà tôi chưa đọc kỹ và hiểu rõ, giống như khi Claude là một lập trình viên con người dưới sự giám sát của tôi.

Tuy nhiên, các giải thích của Claude không đòi hỏi nhiều chỉnh sửa. Bản tóm tắt dự án gần nhất của Claude xấp xỉ bằng những gì tôi có thể tự viết, có thể hơi kém hơn một chút hoặc tốt hơn một chút. Nhưng nó chỉ mất 10 giây để viết thay vì một giờ, và việc xem xét cũng không tốn đến một giờ.

Lỗi nghiêm trọng tôi phải sửa lần gần đây nhất là Claude đã sử dụng một báo cáo liên quan trước đó làm mẫu, và báo cáo cũ đó có một đoạn tôi thêm vào cuối nói rằng: "Claude đã trích xuất các ghi chú này từ các cuộc thảo luận của chúng tôi về vấn đề này. Mark Dominus đã đọc, xem xét, chỉnh sửa và phê duyệt các ghi chú này."

Tài liệu mới của Claude có một phần giống hệt ở cuối. Rất may, khi tôi nhìn thấy nó, nội dung đó đã đúng sự thật, nên tôi không cần xóa nó. Tôi đã yêu cầu Claude thêm một câu vào CLAUDE.md để bảo nó không làm điều đó nữa.

Nếu bạn có Claude viết ghi chú, hãy commit chúng vào repo khi bạn xong việc. Nó có thể không gây hại và có thể giúp ích. Hãy để Claude viết bản tóm tắt dự án, sau đó commit nó vào repo. Có lẽ điều này là hiển nhiên? Nhưng nó không hiển nhiên với tôi. Tôi vẫn đang làm quen với thế giới mới này.