Vì Sao Tài Liệu Sắp Trở Nên Quan Trọng Trở Lại
Tài liệu có vấn đề về danh tiếng. Nó bị xem là chi phí — thứ bạn viết vì phải viết, chứ không phải vì nó tạo ra giá trị. Những kỹ sư giỏi nhất viết code. Những người kém hơn mới viết tài liệu. Đây là thái độ phổ biến trong hầu hết các tổ chức kỹ thuật, và nó sắp trở nên rất đắt đỏ.
Vì Sao Tài Liệu Từng Thất Bại
Tài liệu thất bại vì lý do cấu trúc, không phải văn hóa. Viết nó tốn công sức, khó duy trì cập nhật và khó tìm kiếm. ROI không rõ ràng vì phần thưởng luôn nằm ở tương lai — khi ai đó cần hiểu một quyết định được đưa ra từ nhiều tháng trước.
Kết quả là tài liệu bị teo tóp. Các đội ngừng viết nó. Thành viên mới học từ code và từ việc hỏi đồng nghiệp. Kiến thức trở nên mang tính bộ lạc và mong manh. Điều này hiệu quả vì phương án dự phòng luôn là “hỏi người đã có mặt lúc đó”.
Điều Gì Thay Đổi Với AI
AI thay đổi căn bản tính kinh tế của tài liệu.
Thứ nhất, AI làm cho tài liệu trở nên hữu ích. Một bản ghi quyết định kiến trúc được viết tốt trở thành thứ AI có thể đọc, lập chỉ mục và trả lời câu hỏi dựa trên đó. Nó trở thành đầu vào hạng nhất cho trí tuệ tổ chức. Tài liệu không còn là tài liệu tham khảo mà bạn có thể đọc vào một ngày nào đó — nó là nguồn tri thức sống mà các hệ thống AI của bạn sử dụng mỗi ngày.
Thứ hai, AI làm cho việc tạo tài liệu trở nên dễ dàng. AI có thể soạn thảo tài liệu từ code, từ các cuộc thảo luận pull request, từ dòng thời gian sự cố. Công việc của con người chuyển từ viết tài liệu sang xem xét và xác thực nó — nhanh hơn và chính xác hơn.
Bánh Đà Tài Liệu Mới
Các tổ chức đang giải quyết vấn đề tài liệu đã tìm ra một vòng tuần hoàn tích cực:
- AI tạo bản nháp tài liệu từ code và các cuộc trò chuyện
- Con người xem xét và xác thực bản nháp, bổ sung bối cảnh mà AI không thể suy luận
- AI lập chỉ mục tài liệu đã được xác thực và dùng nó để trả lời các câu hỏi trong tương lai
- Càng có nhiều tài liệu, câu trả lời của AI càng tốt
- Câu trả lời của AI càng tốt, con người càng ít thời gian dành cho việc trả lời lặp lại các câu hỏi giống nhau
Điều này thay đổi cấu trúc khuyến khích. Tài liệu không còn là nỗ lực bỏ ra cho lợi ích tương lai không chắc chắn. Nó là nỗ lực bỏ ra hôm nay và cộng hưởng — bởi mỗi phần kiến thức được xác thực đều khiến mọi tương tác AI trong tương lai chính xác hơn.
Điều Gì Khiến Tài Liệu Có Giá Trị Với AI
Không phải tài liệu nào cũng hữu ích như nhau đối với AI. Tài liệu có giá trị nhất cho AI sử dụng có ba đặc điểm:
- Có cấu trúc: Các phần rõ ràng, định dạng nhất quán, các quyết định rõ ràng kèm lý do
- Có bối cảnh: Tại sao một quyết định được đưa ra, không chỉ là điều gì đã được quyết định
- Được liên kết: Các kết nối đến các quyết định, hệ thống và sự cố liên quan
Định dạng tốt nhất cho tài liệu thân thiện với AI là Architecture Decision Record (Bản ghi quyết định kiến trúc). Mỗi ADR ghi lại một quyết định, các phương án thay thế đã cân nhắc và lý do. Các hệ thống AI có thể nạp ADR và suy luận về chúng theo những cách mà tài liệu dạng tự do không hỗ trợ.
Khởi Đầu Thực Tế
Nếu bạn muốn làm cho tài liệu của tổ chức sẵn sàng cho AI, hãy bắt đầu với các ADR của bạn. Ngay cả khi bạn chỉ có vài cái, hãy đảm bảo chúng tuân theo một định dạng nhất quán. Sau đó yêu cầu trợ lý AI của bạn trả lời câu hỏi dựa trên chúng. Khoảng cách giữa những gì AI có thể trả lời và những gì mọi người hỏi sẽ cho bạn thấy chính xác nơi cần viết tiếp theo.
Sự Thật Khó Chịu
Trong kỷ nguyên AI, tài liệu không phải là chi phí. Nó là cơ sở hạ tầng. Các tổ chức đầu tư vào nó sẽ có các hệ thống AI hiểu bối cảnh, lịch sử và ràng buộc của họ. Các tổ chức không đầu tư sẽ có các hệ thống AI chung chung — và AI chung chung ngày càng khó phân biệt với hàng hóa thông thường.
Nếu trợ lý AI của bạn có thể đọc mọi quyết định mà tổ chức bạn từng đưa ra, nó có thể trả lời bao nhiêu câu hỏi mà không cần chuyển lên cho con người?
Nghĩ rằng lập luận này phù hợp với sự kiện của bạn? Hãy kể cho tôi về khán phòng — lịch trình có chọn lọc.
Bắt đầu trò chuyện