The handwritten manifestoTờ tuyên ngôn chép tay
Some things I write down so I won't forget them. This one I wrote down to keep a promise.Có những thứ tôi chép tay để khỏi quên. Tờ này thì tôi chép để giữ lời.

In one of my notebooks there is a page where I copied out, by hand, the Manifesto for Software Craftsmanship. It's a short text by people who treat software as a craft. At the bottom of the page is my signature.
I didn't copy it to hang on a wall. At the time, it said exactly what I wanted to do but didn't yet have the words for.

Four lines of “not only… but also”
The manifesto comes down to four lines:
What I like most is the phrase “not only”. It doesn't throw away the first half. Software still has to work. It still has to change with the customer. The manifesto just says that's not enough.
Craft is a business decision
Many people think craftsmanship is an engineering concern: clean code, nice architecture. I see it differently.
Rushed work can still ship on time. But a few months later the system sends the bill. Small bugs. Fixing one thing breaks another. Every change comes with a little more fear. The customer pays twice, and the team slowly wears out.
Careful work does the opposite. The system can change without falling apart. That's why a project can live for fifteen years instead of fifteen months.
Rushed work is fast once. Careful work stays fast.
The tools change, the standard doesn't
Since I copied that page, the way software gets written has changed many times. Today a developer with a machine assistant at their side can write in an afternoon what used to take a week.
Reading the page again, none of it feels dated. If anything, the cheaper code becomes, the more those four lines are worth. Anyone can make software that works. Far fewer can make software that, five years later, people can still understand, still change and still trust.
What craft looks like on an ordinary day
Craft is easy to praise and hard to see. On an ordinary day it looks like small, unglamorous choices. Writing the test before the code, so that the code has a clear target. Renaming a variable so the next person understands it. Refusing to merge a change that works but that nobody else could maintain. Spending twenty minutes on a commit message that explains why a decision was made, because in two years someone will need to know.
None of these choices shows up in a demo. Clients rarely notice them directly. They notice them indirectly, months later, when a change they asked for takes two days instead of two weeks, or when a new developer joins the project and is productive in a week. Craft is invisible in the short run and very visible in the long run, which is exactly why it is easy to skip under deadline pressure.
Extreme Programming gave many of these habits a name and a reason: pair programming, test-first development, continuous integration, refactoring, small releases. The manifesto I copied out describes the attitude behind them. The practices are how the attitude becomes daily work. A team can claim to value craft and still ship without tests. The practices are where the claim gets checked.
Craft when machines write the code
AI assistants make one part of the manifesto more urgent. When a tool can generate a working feature in minutes, the temptation to accept it as it is grows strong. The code runs, the tests the tool wrote pass, the deadline is met. Whether anyone on the team understands that code, and whether it fits the rest of the system, becomes a question nobody has time to ask.
The craft response is to treat generated code like code from a new colleague: read it, question it, test it against cases the author did not think of, and refactor it until it belongs. That takes time, and it is the time that keeps a system changeable. Teams that skip it will find that the cost of change rises quietly, release after release, until a simple request needs a rewrite. The tool made the first version cheap. Only craft keeps the tenth version cheap.
Community, the third line of the manifesto, matters here too. A single developer can be careful. A team where careful work is expected, reviewed and taught to newcomers keeps its standard when people come and go. That is why code review, pairing and shared conventions matter more than any individual's talent. They are how a standard outlives the person who first wrote it down.
Craft also has a commercial side that clients come to value. A system built carefully can be handed over to another team, audited, extended or integrated with new tools without drama. That makes the client less dependent on the original vendor, which sounds like a disadvantage for the vendor. In practice it builds trust, and clients who trust a team tend to stay. Over sixteen years, the clients who stayed longest were rarely the ones locked in. They were the ones who could have left and chose not to.
For young developers, the manifesto offers something useful as well: a way to judge their own growth that does not depend on job titles or the latest framework. Can you write code that a colleague understands without asking you? Can you change a system without fear? Do you leave the code a little better than you found it? Those questions stay relevant whatever tools arrive next.
Why keep the handwritten copy
A printed version would look better. But the handwritten one, with a name at the bottom, reminds me that a manifesto isn't decoration. It's a promise one person makes to their craft.
Green System was built on that promise, and it still decides how the work is done.
Trong cuốn sổ của tôi có một trang chép tay bản Manifesto for Software Craftsmanship, tuyên ngôn của những người coi việc làm phần mềm là một nghề thủ công. Cuối trang có chữ ký của tôi.
Tôi không chép nó để trang trí. Lúc ấy tôi thấy nó nói đúng điều mình muốn làm mà chưa biết gọi tên.

Bốn câu “không chỉ… mà còn”
Bản tuyên ngôn chỉ có bốn dòng chính:
Tôi thích nhất hai chữ “không chỉ”. Nó không phủ nhận vế trước. Phần mềm vẫn phải chạy, vẫn phải đổi theo khách hàng. Nó chỉ nói: chừng đó chưa đủ.
Làm kỹ là một quyết định kinh doanh
Nhiều người nghĩ làm kỹ là chuyện riêng của kỹ sư: code sạch, thiết kế đẹp. Tôi nghĩ khác.
Làm vội vẫn giao đúng hạn được. Nhưng vài tháng sau, hệ thống sẽ đòi nợ: lỗi lặt vặt, sửa chỗ này hỏng chỗ kia, mỗi lần thay đổi lại thêm một lần lo. Khách hàng trả tiền hai lần. Đội ngũ thì mệt dần.
Làm kỹ thì ngược lại. Hệ thống thay đổi được mà không sợ vỡ. Đó là lý do một dự án có thể sống mười lăm năm thay vì mười lăm tháng.
Làm vội thì nhanh một lần. Làm kỹ thì nhanh mãi.
Công cụ đổi, chuẩn mực không đổi
Từ ngày chép trang ấy, cách viết phần mềm đã đổi nhiều lần. Hôm nay, một lập trình viên có trợ lý máy bên cạnh có thể viết trong một buổi những gì trước đây mất cả tuần.
Đọc lại tờ giấy, tôi không thấy dòng nào cũ. Ngược lại, khi viết code rẻ đi, bốn dòng ấy càng đắt giá. Ai cũng tạo được phần mềm chạy được. Ít ai tạo được phần mềm mà năm năm sau vẫn hiểu được, vẫn sửa được, vẫn tin được.
Tay nghề trông như thế nào trong một ngày bình thường
Tay nghề thì dễ khen mà khó thấy. Trong một ngày bình thường, nó là những lựa chọn nhỏ, chẳng hào nhoáng. Viết test trước khi viết code, để code có một đích rõ ràng. Đổi tên một biến để người sau hiểu được. Từ chối gộp một thay đổi chạy được nhưng không ai khác duy trì nổi. Dành hai mươi phút cho một lời ghi chú commit giải thích vì sao một quyết định được đưa ra, vì hai năm sau sẽ có người cần biết.
Không lựa chọn nào hiện ra trong buổi demo. Khách hàng hiếm khi nhận ra chúng trực tiếp. Họ nhận ra gián tiếp, nhiều tháng sau, khi một thay đổi họ yêu cầu mất hai ngày thay vì hai tuần, hay khi một lập trình viên mới vào dự án và làm việc hiệu quả sau một tuần. Tay nghề vô hình trong ngắn hạn và rất rõ trong dài hạn, chính vì thế nó dễ bị bỏ qua khi hạn chót dồn tới.
Extreme Programming đặt tên và lý do cho nhiều thói quen trong số này: lập trình cặp, viết test trước, tích hợp liên tục, tái cấu trúc code, phát hành nhỏ. Bản tuyên ngôn tôi chép tay mô tả thái độ đằng sau chúng. Các thực hành là cách thái độ đó trở thành công việc hằng ngày. Một đội có thể nói mình coi trọng tay nghề mà vẫn phát hành không có test. Các thực hành là nơi lời nói đó được kiểm chứng.
Tay nghề khi máy viết code
Trợ lý AI làm một phần của bản tuyên ngôn trở nên cấp bách hơn. Khi công cụ có thể tạo ra một tính năng chạy được trong vài phút, cám dỗ chấp nhận nó nguyên trạng trở nên rất mạnh. Code chạy, các test do công cụ viết đều qua, hạn chót được đáp ứng. Liệu có ai trong đội hiểu đoạn code đó không, và nó có khớp với phần còn lại của hệ thống không, trở thành câu hỏi không ai có thời gian đặt ra.
Phản ứng của người có tay nghề là đối xử với code máy sinh như code của một đồng nghiệp mới: đọc nó, chất vấn nó, kiểm thử nó với những trường hợp tác giả chưa nghĩ tới, và tái cấu trúc cho đến khi nó thuộc về hệ thống. Việc đó tốn thời gian, và chính thời gian đó giữ cho hệ thống còn thay đổi được. Đội nào bỏ qua sẽ thấy chi phí thay đổi lặng lẽ tăng lên qua từng lần phát hành, cho đến khi một yêu cầu đơn giản cũng cần viết lại. Công cụ làm phiên bản đầu tiên trở nên rẻ. Chỉ tay nghề mới giữ cho phiên bản thứ mười còn rẻ.
Cộng đồng, dòng thứ ba của bản tuyên ngôn, cũng quan trọng ở đây. Một lập trình viên có thể cẩn thận. Một đội nơi làm kỹ được kỳ vọng, được review và được dạy cho người mới sẽ giữ được chuẩn mực khi người đến người đi. Đó là lý do review code, lập trình cặp và các quy ước chung quan trọng hơn tài năng của bất kỳ cá nhân nào. Chúng là cách một chuẩn mực sống lâu hơn người đầu tiên viết nó ra.
Tay nghề còn có một mặt thương mại mà khách hàng dần coi trọng. Một hệ thống được xây cẩn thận có thể bàn giao cho đội khác, kiểm toán, mở rộng hay tích hợp với công cụ mới mà không gặp sóng gió. Điều đó làm khách hàng bớt phụ thuộc vào nhà cung cấp ban đầu, nghe có vẻ bất lợi cho nhà cung cấp. Trên thực tế nó xây niềm tin, và khách hàng tin một đội thì thường ở lại. Qua mười sáu năm, những khách hàng gắn bó lâu nhất hiếm khi là những người bị trói buộc. Họ là những người hoàn toàn có thể rời đi mà chọn ở lại.
Với lập trình viên trẻ, bản tuyên ngôn cũng mang lại một điều hữu ích: một cách tự đánh giá sự trưởng thành không phụ thuộc vào chức danh hay framework mới nhất. Bạn có viết được code mà đồng nghiệp hiểu mà không cần hỏi bạn không? Bạn có thay đổi một hệ thống mà không sợ không? Bạn có để lại code tốt hơn một chút so với lúc nhận không? Những câu hỏi đó vẫn còn nguyên giá trị dù công cụ nào xuất hiện tiếp theo.
Vì sao giữ bản viết tay
Bản in thì đẹp hơn. Nhưng bản viết tay, có chữ ký, nhắc tôi rằng tuyên ngôn không phải để treo tường. Nó là lời hứa của một người cụ thể với nghề của mình.
Green System được xây trên lời hứa ấy, và lời hứa đó vẫn quyết định cách làm việc mỗi ngày.
