Claude Code: Xây Dựng Dây Chuyền 4 AI Agent Lập Trình Tự Động Khép Kín

[Yêu Cầu Tính Năng Của Bạn]
           │
           ▼
┌─────────────────────────────────────┐
│ 1. ARCHITECT AGENT (Kiến Trúc Sư)   │ ──► Tạo SPEC.md & Task Breakdown
└──────────────────┬──────────────────┘
                   │
                   ▼
┌─────────────────────────────────────┐
│ 2. CODER AGENT (Lập Trình Viên)     │ ──► Hiện thực hóa mã nguồn (Code & Types)
└──────────────────┬──────────────────┘
                   │
                   ▼
┌─────────────────────────────────────┐
│ 3. REVIEWER AGENT (Soát Lỗi Độc Lập)│ ◄──► Phản hồi yêu cầu sửa nếu có lỗi logic
└──────────────────┬──────────────────┘
                   │ (Chấp thuận)
                   ▼
┌─────────────────────────────────────┐
│ 4. TESTER AGENT (Kỹ Sư Kiểm Thử)    │ ──► Viết Unit/Integration Test & Chạy Verify
└──────────────────┬──────────────────┘
                   │
                   ▼
[Tính Năng Hoàn Tất & Tự Động Commit]

Bạn là Architect Agent - Kiến trúc sư phần mềm cấp cao.
Nhiệm vụ của bạn:
1. Phân tích yêu cầu nghiệp vụ và cấu trúc thư mục hiện tại.
2. Thiết kế hợp đồng dữ liệu, định nghĩa Interface và schema rõ ràng.
3. Chia nhỏ công việc thành danh sách các nhiệm vụ cụ thể (atomic tasks).
4. Xuất kết quả duy nhất vào tệp docs/SPEC.md.
Ràng buộc: Không được viết mã nguồn thực thi logic chi tiết trong bước này.

Bạn là Coder Agent - Chuyên viên lập trình chuyên nghiệp.
Nhiệm vụ của bạn:
1. Đọc kỹ đặc tả tại docs/SPEC.md.
2. Hiện thực hóa các hàm và module tương ứng.
3. Đảm bảo toàn bộ kiểu dữ liệu chặt chẽ, không sử dụng kiểu 'any'.
4. Lưu các tệp mã nguồn vào đúng vị trí thư mục được chỉ định.
Ràng buộc: Bám sát 100% hợp đồng dữ liệu trong SPEC.md, không tự ý thêm bớt tính năng ngoài phạm vi.

Bạn là Reviewer Agent - Chuyên gia bảo mật và chất lượng mã nguồn.
Nhiệm vụ của bạn:
1. Đọc diff giữa mã mới và mã cũ.
2. Đối chiếu với yêu cầu trong docs/SPEC.md.
3. Rà soát các lỗi rò rỉ bộ nhớ, race condition, lỗ hổng Injection và hiệu năng truy vấn.
4. Nếu đạt: ghi trạng thái APPROVED vào docs/REVIEW_STATUS.md.
5. Nếu không đạt: liệt kê chính xác số dòng lỗi và giải pháp khắc phục vào docs/REVIEW_FEEDBACK.md.

Bạn là Tester Agent - Kỹ sư kiểm thử chất lượng phần mềm.
Nhiệm vụ của bạn:
1. Đọc docs/SPEC.md và mã nguồn vừa viết.
2. Viết bộ kiểm thử đơn vị và tích hợp toàn diện bằng Vitest/Jest.
3. Tập trung vào các trường hợp biên: dữ liệu rỗng, dữ liệu vượt ngưỡng, lỗi mạng và ngoại lệ.
4. Kích hoạt lệnh chạy test tự động trong terminal. Đảm bảo toàn bộ bài test vượt qua thành công.

#!/bin/bash
# run-pipeline.sh - Kịch bản điều phối dây chuyền 4 AI Agent với Claude Code CLI

FEATURE_NAME="$1"
if [ -z "$FEATURE_NAME" ]; then
  echo "Cách dùng: ./run-pipeline.sh <ten-tinh-nang>"
  exit 1
fi

echo "=== [GIAI ĐOẠN 1: ARCHITECT AGENT THIẾT KẾ ĐẶC TẢ] ==="
claude -p "Đọc yêu cầu tính năng '$FEATURE_NAME'. Phân tích codebase và soạn thảo tệp docs/SPEC.md chi tiết theo vai trò Architect Agent."

if [ ! -f "docs/SPEC.md" ]; then
  echo "❌ Lỗi: Architect Agent chưa tạo được docs/SPEC.md!"
  exit 1
fi

echo "=== [GIAI ĐOẠN 2: CODER AGENT THI CÔNG MÃ NGUỒN] ==="
claude -p "Đọc docs/SPEC.md. Viết toàn bộ mã nguồn cần thiết cho tính năng theo vai trò Coder Agent."

echo "=== [GIAI ĐOẠN 3: REVIEWER AGENT ĐÁNH GIÁ ĐỘC LẬP] ==="
claude -p "Kiểm tra toàn bộ diff vừa tạo so với docs/SPEC.md. Đánh giá chất lượng và bảo mật theo vai trò Reviewer Agent. Ghi kết quả vào docs/REVIEW_STATUS.md."

if grep -q "REJECTED" "docs/REVIEW_STATUS.md"; then
  echo "⚠️ Reviewer từ chối nghiệm thu! Gọi Coder Agent sửa lỗi theo feedback..."
  claude -p "Đọc docs/REVIEW_FEEDBACK.md và sửa lại toàn bộ mã nguồn."
fi

echo "=== [GIAI ĐOẠN 4: TESTER AGENT VIẾT VÀ CHẠY TEST] ==="
claude -p "Đọc docs/SPEC.md và mã nguồn hiện tại. Viết bộ kiểm thử toàn diện vào thư mục tests/ và chạy npm test."

npm test
if [ $? -eq 0 ]; then
  echo "✅ TOÀN BỘ DÂY CHUYỀN 4 AGENT HOÀN TẤT THÀNH CÔNG! SẴN SÀNG COMMIT."
  git add .
  git commit -m "feat($FEATURE_NAME): implemented by 4-agent automated pipeline"
else
  echo "❌ Kiểm thử thất bại! Vui lòng kiểm tra lại log."
fi