Kịch bản dẫn nhập (Setup)
Một Kiến trúc sư có mặt tại mọi quyết định thiết kế sẽ nắm giữ toàn bộ lý do lập luận (rationale) đằng sau tất cả các quyết định đó. Việc viết chúng ra giấy có cảm giác như bị dư thừa khi bản thân bạn đã biết quá rõ, và luôn có những việc khác khẩn cấp hơn công tác tài liệu hóa. Đó chính xác là cách mà lý do lập luận sẽ rời đi cùng với con người.
Phân tích sau sự cố (Postmortem): Một đợt bàn giao dịch vụ tài chính nơi lý do lập luận chưa bao giờ lên trang giấy
Trong trường hợp này, Kiến trúc sư ban đầu đã rời khỏi một dự án dịch vụ tài chính quy mô vừa 12 tuần sau khi ra mắt. Người thay thế họ kế thừa một sơ đồ kiến trúc rất đầy đủ nhưng không đi kèm bất kỳ lý do lập luận nào.
Một vấn đề về hiệu năng xuất hiện đã thúc đẩy đề xuất thay đổi chiến lược ngữ cảnh (context strategy). Người thay thế đã thực hiện sự thay đổi đó, và nó đã vô tình đưa trở lại một mẫu xử lý dữ liệu vi phạm ràng buộc về lưu trữ dữ liệu nội địa (data-residency) của bản triển khai.
Bản phân tích sau sự cố đã truy vết thất bại về đúng một dòng duy nhất bị thiếu trong tài liệu. Dưới đây là hình ảnh của sự cố đó trong bản ghi:
Giai đoạn | Những gì đã xảy ra | Những gì tài liệu mang theo |
Ra mắt (Launch) | Kiến trúc sư ban đầu thiết kế một chiến lược ngữ cảnh đặc biệt để giữ dữ liệu bị kiểm soát nằm đúng trong vùng (in-region). | Một sơ đồ kiến trúc thể hiện bản thiết kế cuối cùng. |
Bàn giao (Handoff) | Kiến trúc sư ban đầu rời đi ở tuần 12. Không có buổi họp thiết kế nào được ghi lại. | Sơ đồ kiến trúc, không có các phương án thay thế bị từ chối và không có lý do lập luận. |
Thay đổi (Change) | Người thay thế gặp sự cố về hiệu năng và chuyển đổi chiến lược ngữ cảnh để khắc phục nó. | Không có gì giải thích lý do tại sao chiến lược ban đầu lại được lựa chọn. |
Thất bại (Failure) | Sự thay đổi tái thiết lập một mẫu xử lý dữ liệu làm phá hỏng quy tắc lưu trữ dữ liệu nội địa. | Lý do bản thiết kế ban đầu tránh mẫu xử lý đó chỉ tồn tại duy nhất trong đầu của Kiến trúc sư đã rời đi. |
Vấn đề cốt lõi: Sơ đồ hiển thị Cái Gì (WHAT) nhưng làm mất đi Lý do Tại Sao (WHY)
Người thay thế là một người có năng lực và đã hành động rất hợp lý dựa trên thông tin mà họ có trong tay.
Sơ đồ đã nói cho họ biết hệ thống là gì, chứ không nói tại sao nó lại như vậy.
Chiến lược ngữ cảnh ban đầu là một lựa chọn có chủ đích nhằm đáp ứng ràng buộc tuân thủ lưu trữ dữ liệu, và lý do lập luận đó chưa bao giờ được viết ra dưới dạng một quyết định đi kèm sự đánh đổi rõ ràng và các phương án thay thế bị từ chối.
Nếu không có lý do lập luận được tài liệu hóa, người thay thế không thể biết được rằng chiến lược họ đang thay đổi là một thành phần chịu tải (load-bearing) cho sự tuân thủ, vì vậy họ đã đảo ngược một quyết định đúng đắn vì một lý do sai lầm hoàn toàn có thể hiểu được.
Tại sao điều này lại gây ra sự cố?
Một bản thiết kế không có lý do lập luận đi kèm là một bản thiết kế KHÔNG THỂ thay đổi một cách an toàn.
Bài kiểm thử tính đầy đủ là: Liệu một Kiến trúc sư có năng lực không có mặt trong phòng họp có thể đưa ra một thay đổi an toàn sau khi đọc tài liệu hay không?
Ở trường hợp này, câu trả lời là KHÔNG, và không một ai biết điều đó cho đến khi môi trường production bị phá hỏng.
Bài học cốt lõi: Hãy ghi lại quyết định, các phương án thay thế bị từ chối, và sự đánh đổi mà mỗi phương án đã giải quyết. Hãy luôn nhớ rằng: nếu nó chưa từng được viết ra, nó sẽ rời đi cùng với bạn.
Nội dung bài viết thuộc lộ trình chuẩn bị chứng chỉ Claude Certified Architect, được tổng hợp và biên dịch từ tài liệu đào tạo chính thức của Anthropic PBC. Bản quyền nội dung gốc thuộc về Anthropic PBC. Bản dịch tiếng Việt và chú giải thực hành bởi HungPH Blog.
Thành viên gia nhập từ 19/09/2026