Quy trình phát triển phần mềm thực tế với coding agent

Coding agent hiệu quả khi hoạt động trong một engineering loop có kỷ luật. Developer vẫn chịu trách nhiệm về scope, quyết định kiến trúc, risk và review cuối; agent giúp tăng tốc discovery, implementation và quality check.

Vòng lặp làm việc

flowchart LR
    A[Định nghĩa outcome] --> B[Đọc repository]
    B --> C[Lập kế hoạch tập trung]
    C --> D[Implement]
    D --> E[Chạy check liên quan]
    E --> F[Review diff]
    F --> G{Đạt acceptance criteria?}
    G -->|Chưa| C
    G -->|Đạt| H[Commit hoặc deploy]

Mỗi vòng lặp nên đủ nhỏ để một người hiểu được diff. Goal lớn được tách thành chuỗi thay đổi có thể kiểm chứng độc lập.

Trước khi yêu cầu viết code

Cung cấp cho agent một task contract gọn:

• Outcome: behavior người dùng hoặc hệ thống cần thay đổi.
• Scope: directory, component hoặc service được phép sửa.
• Constraints: compatibility, security, style và performance.
• Evidence: test, build output, screenshot hoặc command tái tạo được.
• Exclusions: công việc liên quan nhưng thuộc task khác.

Ví dụ:

Thêm empty-state message vào trang search result.
Giữ nguyên routing và query behavior. Chỉ sửa search component và focused test.
Chạy lint, typecheck và search test. Không redesign trang hoặc đổi content index.

Để repository cung cấp context

Yêu cầu agent đọc instruction file gần nhất và search symbol liên quan trước khi mở documentation rộng. Context hữu ích gồm:

• implementation hiện tại và test kế bên;
• package script và framework version;
• component/design token đã có;
• error hoặc acceptance criterion chính xác.

Mặc định không đính kèm build output cũ, generated folder và tài liệu không liên quan. Chúng tiêu tốn sự chú ý nhưng không cải thiện quyết định.

Chọn check tương ứng với risk

Thay đổi	Evidence tối thiểu hữu ích
Copy hoặc documentation	Link/format check và đọc trực quan
Pure function	Focused unit test và typecheck
UI behavior	Component/e2e check và responsive review
API hoặc data	Contract/integration test và migration review
Build configuration	Clean production build trong target environment
Auth, payment, deletion	Negative case, permission test và human review

Chạy toàn bộ test liên tục gây lãng phí; không chạy test liên quan sẽ chuyển sự bất định cho reviewer. Bắt đầu focused và mở rộng khi change hoặc failure yêu cầu.

Review diff, không chỉ đọc summary

Final response giúp định hướng nhưng không phải evidence. Hãy kiểm tra:

1. file hoặc dependency thay đổi ngoài dự kiến;
2. behavior ngoài scope;
3. error state và empty state bị thiếu;
4. test chỉ lặp lại implementation;
5. secret, personal data hoặc command không an toàn;
6. generated output vô tình được commit.

Với công việc rủi ro cao, yêu cầu preview hoặc isolated branch trước khi change đi vào main checkout hay production.

Thực hành: một cải tiến có giới hạn

Chọn một issue nhỏ trong project có version control.

1. Viết một acceptance criterion quan sát được.
2. Ghi file area có khả năng liên quan và một exclusion rõ ràng.
3. Yêu cầu agent inspect, implement và chạy focused check.
4. Review git diff --stat, sau đó đọc toàn bộ diff.
5. Tự tái tạo behavior.
6. Chỉ commit khi criterion và check cho cùng kết luận.

Checkpoint: bạn phải giải thích được từng file thay đổi và chỉ ra command hoặc quan sát chứng minh task đã hoàn tất.

Khi nào nên tách công việc?

Tạo task riêng khi change có acceptance criterion khác nhau, chạm subsystem độc lập hoặc cần reviewer khác nhau. Parallel work chỉ hữu ích khi ownership boundary rõ; nếu không, nhiều agent có thể sửa cùng shared file và tạo merge conflict.

Definition of done

• Scope và exclusion rõ ràng.
• Convention của project được tìm hiểu trước khi implement.
• Các check liên quan tối thiểu đã pass.
• Diff không có change ngoài scope hoặc dữ liệu nhạy cảm.
• Một người đã kiểm tra outcome hiển thị cho user.
• Risk và failure còn lại được báo cáo chính xác.

Ghi chú nguồn

Bài viết được tổng hợp từ CLAUDE CODE FULL COURSE 4 HOURS: Build & Sell (2026) [QoQBzR1NIqI].en.srt, thể hiện bằng cặp English/Vietnamese trong web-content cho đoạn 00:00:00–04:10:42. Nội dung cài đặt, giá và claim capability thay đổi nhanh đã được loại bỏ. Task-contract example, evidence table và bài tập giới hạn là phần biên tập bổ sung có thể áp dụng chung cho coding-agent workflow.