Git worktree: nền tảng để chạy nhiều AI agent mà không xung đột

Bạn chạy hai agent trên cùng một repo. Một con sửa package.json, con kia cũng sửa luôn. Ba mươi giây sau, code của bạn rơi vào trạng thái không ai merge nổi.

Đó không phải lỗi của agent. Vấn đề là tất cả chúng đều làm việc trong cùng một thư mục.

Cách khắc phục là một công cụ Git đã có từ nhiều năm nhưng gần như không ai dùng: git worktree.

Vấn đề: 3 agent, 1 repo, không thể merge

Một repo Git bình thường là một thư mục, mỗi lần chỉ checkout một branch. Bạn làm việc trên main, bạn đổi branch, cả thư mục lật theo.

Giờ thả ba con agent tự hành vào thư mục đó. Chúng ghi cùng một lúc. Agent A tạo một file, agent B chạy git checkout để bắt đầu sạch sẽ và xóa luôn phần đang làm dở của A. Bạn kết thúc với những file viết dở, một index bị phá nát, và những xung đột mà gỡ ra còn lâu hơn cả tự code.

Chạy song song chỉ tiết kiệm thời gian nếu các agent không đụng vào nhau.

Git worktree là gì

Worktree là một thư mục làm việc thứ hai gắn vào cùng một repo.

Cùng lịch sử, cùng remote, nhưng mỗi worktree checkout branch riêng và có file riêng trên ổ đĩa. Bạn có thể đặt năm cái cạnh nhau, mỗi cái trên một branch khác nhau, mà không cái nào cản đường cái nào.

Một .git, nhiều workspace. Chỉ vậy thôi.

Mỗi agent một worktree, trong thực tế

Đây là cách thiết lập. Từ repo của bạn:

git worktree add ../project-auth -b feature/auth
git worktree add ../project-billing -b feature/billing
git worktree add ../project-export -b feature/export

Bạn vừa tạo ba thư mục, mỗi thư mục trên một branch riêng. Bạn khởi động một agent trong mỗi cái:

cd ../project-auth && claude
cd ../project-billing && codex

Mỗi agent có thư mục riêng, branch riêng, file riêng. Agent auth sẽ không bao giờ thấy được agent billing đang làm gì. Không thể xảy ra va chạm.

Khi một tính năng xong, bạn review branch của nó rồi merge. Sau đó dọn dẹp:

git worktree remove ../project-auth

Thư mục biến mất, branch vẫn nằm trong lịch sử của bạn. Gọn gàng.

3 cái bẫy cần biết

Bẫy thứ nhất: file trung tâm dùng chung. Nếu hai tính năng đều phải đụng vào cùng một routes.ts hoặc cùng một schema database, worktree không cứu bạn được, bạn vẫn dính xung đột lúc merge. Một agent đụng vào những file mà mọi người cùng dùng, các agent khác phải chờ hoặc tìm cách lách qua.

Thứ hai: branch trôi đi. Trong lúc các agent của bạn làm việc, main cứ chạy tiếp. Ba ngày sau, branch của bạn tụt lại phía sau và merge trở nên đau đầu. Rebase sớm và thường xuyên, hoặc giữ phiên làm việc ngắn lại.

Thứ ba: quên dọn dẹp. Mỗi worktree là một thư mục thật trên ổ đĩa. Mười cái một ngày mà không dọn, thư mục cha của bạn thành mớ bòng bong không đọc nổi. git worktree list cho thấy còn cái nào sót lại, git worktree prune xóa những cái đã chết.

Câu hỏi thực sự: ai trông coi năm thư mục đó?

Worktree giải quyết va chạm file. Nó không giải quyết gánh nặng đầu óc của bạn.

Bạn có năm thư mục, năm agent, năm terminal. Cái nào đang chờ bạn review? Cái nào xong mười phút trước trong lúc bạn đang nhìn chỗ khác? Cái nào bị crash?

Đó là lúc mô hình mỗi agent một worktree chạm giới hạn nếu bạn cứ ở trong terminal. Bạn đã giải quyết xung đột kỹ thuật, nhưng lại nhân số cửa sổ phải canh chừng lên gấp bội.

AgentsRoom đặt mỗi agent lên một ô riêng, kèm trạng thái và màu sắc, bất kể nó chạy trong worktree nào. Một agent đang chờ sẽ chuyển sang màu đỏ và báo cho bạn. Đọc cách chạy 3 đến 8 agent song song mà không bị rối để có phương pháp đầy đủ xây dựng trên nền worktree.

Rút ra điều gì

Một agent, một worktree, một branch. Đó là quy tắc nền tảng cho công việc đa agent nghiêm túc.

Các câu lệnh gói gọn trong ba dòng, lợi ích thấy ngay: các agent của bạn thôi ghi đè lên nhau. Thêm một góc nhìn cho bạn biết cái nào đang cần bạn, và bạn thực sự có thể giữ năm việc song song mà không phát điên.