Một nỗi thất vọng thường gặp khi dùng AI: mỗi lần yêu cầu, Claude lại tạo ra một mảnh code có vẻ ổn, nhưng ghép lại thì rời rạc, chồng chéo, khó bảo trì. Vấn đề không nằm ở AI mà ở cách bạn dẫn dắt nó. Bài viết này chỉ ra những điều cần nắm để sản phẩm — dù là trang HTML đơn giản hay app mobile — luôn thống nhất và liền mạch. Đây là tư duy kiến trúc mà khóa học Claude AI tại Dev1Day tập trung rèn luyện.

Vì sao code do AI viết dễ rời rạc

Khi bạn hỏi từng việc riêng lẻ mà không cho AI thấy bức tranh tổng, mỗi câu trả lời sẽ tối ưu cho riêng nó — không nhất thiết khớp với phần trước. Kết quả là các mảnh ghép cùng chức năng nhưng khác phong cách, đặt tên lung tung, lặp logic. Đây là hệ quả tự nhiên của việc thiếu một 'bản thiết kế chung'.

Bắt đầu bằng kiến trúc tổng thể

Trước khi viết dòng code đầu tiên, hãy cùng Claude phác kiến trúc tổng: sản phẩm có những phần nào, dữ liệu tổ chức ra sao, các phần giao tiếp với nhau thế nào. Khi có bản đồ này, mọi yêu cầu sau đều được đặt trong bối cảnh chung, và AI viết code khớp với tổng thể thay vì tùy hứng.

Thiết lập quy ước nhất quán

Sự liền mạch đến từ quy ước: cách đặt tên, cấu trúc thư mục, phong cách giao diện, cách xử lý lỗi. Hãy thống nhất những quy ước này từ sớm và nhắc Claude tuân theo. Ví dụ 'mọi nút chính dùng cùng một kiểu', 'mọi danh sách đều có trạng thái khi rỗng'. Quy ước rõ giúp sản phẩm trông như do một người làm.

Cho AI thấy code đã có trước khi viết tiếp

Một mẹo quan trọng: khi yêu cầu phần mới, hãy cung cấp ngữ cảnh phần đã có liên quan. Khi Claude thấy cấu trúc hiện tại, nó sẽ viết phần mới ăn khớp thay vì tạo một hướng đi khác. Đừng để AI 'đoán' những gì đã tồn tại — hãy cho nó nhìn thấy.

Từ web đến mobile: nguyên tắc không đổi

Dù bạn làm trang HTML, web có database hay app mobile, nguyên tắc giữ sự thống nhất là như nhau: có kiến trúc rõ, có quy ước chung, có ngữ cảnh đầy đủ. Công nghệ thay đổi nhưng tư duy tổ chức thì xuyên suốt. Khi nắm được, bạn chuyển giữa các loại sản phẩm dễ dàng hơn nhiều.

Tái cấu trúc khi cần

Đôi khi sản phẩm lớn dần và phần code cũ trở nên rối. Đừng ngại yêu cầu Claude tái cấu trúc (refactor): gom phần lặp lại, đặt lại tên cho rõ, tách phần quá dài. Tái cấu trúc định kỳ giữ cho sản phẩm dễ mở rộng. Một sản phẩm gọn gàng bên trong là sản phẩm bạn còn muốn làm việc cùng sau nhiều tuần.

Kết quả: sản phẩm bạn kiểm soát được

Khi áp dụng những nguyên tắc trên, bạn không còn nhận về một đống mảnh ghép rời rạc, mà là một sản phẩm có cấu trúc bạn hiểu và kiểm soát được. Đó là khác biệt giữa 'nhờ AI viết hộ' và 'dùng AI để xây dựng' — và là điều bạn luyện được qua lộ trình học thực chiến.

Điểm chính cần nhớ

  • Code rời rạc do thiếu bản thiết kế chung, không phải do AI kém.
  • Bắt đầu bằng kiến trúc tổng thể trước khi viết dòng đầu tiên.
  • Thiết lập quy ước nhất quán và cho AI thấy ngữ cảnh code đã có.
  • Tái cấu trúc định kỳ để sản phẩm dễ mở rộng và dễ kiểm soát.