Cấu Trúc Dự Án Của Bạn Để AI Có Thể Định Hướng

Các mô hình AI suy luận về mã của bạn bằng cách đọc nó. Một dự án lộn xộn, dàn trải, không nhất quán khó khăn cho chúng cũng như cho bạn. Bạn không cần một kiến trúc hoàn hảo, nhưng vài thói quen sẽ mang lại lợi ích ngay lập tức:

• Giữ một bố cục dễ đoán. Mã nguồn ở một chỗ, test nằm cạnh hoặc phản chiếu mã nguồn, cấu hình ở gốc.
• Dùng tên rõ ràng, mô tả cụ thể. calculateMonthlyInvoiceTotal tốt hơn calc2. AI dùng tên như những manh mối.
• Ưu tiên file nhỏ hơn. Một file 200 dòng dễ thay đổi đúng hơn một file 2.000 dòng, cho cả bạn lẫn AI.
• Đặt các thứ liên quan cạnh nhau. Khi mã, style, và test của một tính năng nằm cùng nhau, AI thu thập ngữ cảnh chỉ trong một lần đọc.
• Giữ một điểm vào rõ ràng. Một nơi duy nhất, rõ ràng nơi ứng dụng bắt đầu cho AI một đầu mối để lần theo khi nó đang lập bản đồ dự án.

Một bố cục điển hình, thân thiện với AI có thể trông như thế này:

my-app/
├── AGENTS.md            # project rules & context for the AI
├── README.md            # what the project is, how to run it
├── .env.example         # documents needed secrets (no real values)
├── .gitignore           # excludes .env, build output, node_modules
├── package.json         # scripts: dev, test, lint, build
├── src/
│   ├── features/
│   │   └── invoices/    # code + tests for one feature, together
│   ├── lib/             # shared helpers
│   └── index.ts         # entry point
└── tests/               # cross-cutting / integration tests

Lợi ích cộng dồn: dự án của bạn càng dễ cho AI định hướng, những thay đổi của nó càng nhỏ và chính xác hơn. Một repo được tổ chức tốt cho phép AI chạm vào ba file liên quan thay vì phải đoán mò qua ba mươi — nghĩa là các diff nhỏ hơn, ít sự cố hơn, và các bản xem xét (review) mà bạn thực sự có thể đọc được. Nếu bạn từng thấy AI thực hiện những chỉnh sửa tràn lan, thiếu tập trung, thủ phạm thực sự thường là cấu trúc, chứ không phải câu lệnh (prompt).