ระดับ 7d · บทที่ 5/6

หลาย agent พร้อมกัน — git worktree, แบ่งงานไม่ให้ชน และรวมผล

⏱ 35 นาทีลองในClaude ↗

เป้าหมาย

รัน agent หลายตัวพร้อมกันบน repo เดียวโดยไฟล์ไม่ทับกัน แบ่งงานให้ชนกันน้อยที่สุด และรวมผลกลับอย่างมีคนตรวจ

หลักการ

ทำไมรันสองตัวในโฟลเดอร์เดียวกันไม่ได้

agent สองตัวในโฟลเดอร์เดียวกันจะแก้ไฟล์ทับกัน git commit ของตัวหนึ่งเก็บงานครึ่งๆ กลางๆ ของอีกตัวไปด้วย และเทสต์ของตัวหนึ่งพังเพราะอีกตัวแก้อยู่ — ผลคือ PROGRESS.md และ git log ที่เชื่อไม่ได้

git worktree = โฟลเดอร์ทำงานแยก แต่ใช้ repo เดียวกัน

git worktree add ../loop-lab-a -b agent/a     # โฟลเดอร์ใหม่ บน branch ใหม่
git worktree list                             # ดูทั้งหมด
git worktree remove ../loop-lab-a             # ลบเมื่อเสร็จ (branch ยังอยู่)

แต่ละ worktree มีไฟล์ของตัวเองแต่แชร์ประวัติ git ร่วมกัน commit ในตัวหนึ่งเห็นได้จากทุกตัวทันที ไม่ต้อง clone ซ้ำ

Claude Code มีทางลัด: claude -w ชื่อ (หรือ --worktree) สร้าง worktree ที่ .claude/worktrees/ชื่อ/ บน branch worktree-ชื่อ แล้วเปิด Claude ในนั้นเลย

  • เพิ่ม .claude/worktrees/ ใน .gitignore
  • claude -p --worktree จะไม่ลบ worktree ให้เมื่อจบ → เก็บกวาดเองด้วย git worktree remove

แบ่งงานให้ไม่ชน

หลัก ตัวอย่าง
แบ่งตาม "เจ้าของไฟล์" ไม่ใช่ตามประเภทงาน agent A ดูแล src/billing/ ส่วน agent B ดูแล src/reports/
ไฟล์ส่วนกลางมีเจ้าของคนเดียว package.json, lockfile, schema, config → ให้คน (หรือ agent ตัวเดียว) แก้
PROGRESS แยกต่อ agent แต่ละ worktree มี PROGRESS.md ของตัวเอง
ทรัพยากรที่ชนกันได้ port ของ dev server, ฐานข้อมูลทดสอบ, ไฟล์ cache → ให้แต่ละตัวใช้ค่าแยก (เช่น PORT=3001)
เริ่มที่ 2 ตัว ตัวที่ 3+ มักได้งานเพิ่มน้อยกว่าเวลาที่คุณเสียไปกับการตรวจและรวมผล

Subagents vs หลาย session

Subagents (บท 6d-04) หลาย session ใน worktree
ใครสั่ง Claude ตัวหลักแตกงานเอง แล้วรวมผลกลับมาใน session เดียว เรา (หรือสคริปต์) เปิดแยกกัน
ไฟล์ อยู่ในโฟลเดอร์เดียวกัน แยกโฟลเดอร์
เหมาะกับ ค้นหา/อ่าน/รีวิวคู่ขนาน งานสั้น งานแก้โค้ดยาวๆ ที่อิสระต่อกัน

รวมผล

  1. ตรวจทีละ branch: git log --oneline main..agent/a และ git diff main...agent/a
  2. รวมเข้า branch ทดสอบก่อน: git switch -c integrate main && git merge agent/a agent/b
  3. รันเทสต์ทั้งชุดหลังรวม เพราะแต่ละตัวผ่านเทสต์ของตัวเอง แต่รวมกันอาจพัง
  4. ถ้าชนกัน: ให้ Claude ช่วยแก้ conflict ใน session ที่คุณเฝ้าดู ไม่ใช่ใน loop

ตั้งค่า ⚙️

ตั้งอะไร ค่าที่แนะนำเริ่ม เปลี่ยนเมื่อไร ตรวจยังไง
จำนวน agent 2 เพิ่มเมื่อการตรวจและรวมผลไม่ใช่คอขวดแล้ว —
.claude/worktrees/ ใน .gitignore ใส่ตั้งแต่ก่อนใช้ claude -w ครั้งแรก ไม่เปลี่ยน git status ใน checkout หลักไม่เห็นไฟล์ของ worktree
.worktreeinclude (ไวยากรณ์เดียวกับ .gitignore) ใส่ไฟล์ที่ถูก gitignore แต่ต้องใช้ เช่น .env โปรเจกต์ต้องมี config ในเครื่องถึงจะรันเทสต์ได้ · ใช้กับ worktree ที่ Claude Code สร้างเท่านั้น ไม่ใช่ git worktree add worktree ใหม่จาก claude -w มีไฟล์นั้นครบ
worktree.baseRef ใน settings "fresh" (ค่าเริ่ม: แตกจาก default branch บน remote) อยากให้ worktree มีงานที่ยังไม่ push → "head" · ถ้าไม่มี remote จะแตกจาก HEAD ในเครื่องอยู่แล้ว git log -1 ใน worktree ใหม่
ติดตั้ง dependency npm install (หรือเทียบเท่า) ในทุก worktree — เทสต์ผ่านใน worktree ก่อนเริ่ม loop
MAX_TOTAL_USD และ PORT ต่อ worktree แยกค่าต่อตัว เช่น 2 USD ต่อ agent — log ของแต่ละตัวแสดงยอด รวม≈ แยกกัน
ชื่อไฟล์สถานะ PROGRESS.md ต่อ worktree (ทดลอง B จะเห็นว่าทำไมควรใช้ชื่อแยก) ใช้กับ repo จริง → ตั้งชื่อแยก เช่น PROGRESS-a.md หรือไม่ merge เข้า main merge แล้วไม่ conflict ที่ไฟล์สถานะ

ลองเลย 🧪

ทดลอง A — สอง loop พร้อมกัน (ใน loop-lab จากบท 7d-02 บน branch main ที่ commit ล่าสุดแล้ว)

git switch main
git worktree add ../loop-lab-a -b agent/a
git worktree add ../loop-lab-b -b agent/b

cat > ../loop-lab-a/PROGRESS.md <<'EOF'
# PROGRESS — agent A ดูแลเฉพาะ src/text/ และ test/text/

## งาน
- [ ] เพิ่ม src/text/reverse.js ฟังก์ชัน reverse(text) พร้อมเทสต์ใน test/text/reverse.test.js
- [ ] เพิ่ม src/text/truncate.js ฟังก์ชัน truncate(text, n) ต่อท้าย … เมื่อยาวเกิน พร้อมเทสต์ใน test/text/truncate.test.js

## บันทึก

## ติดปัญหา
EOF
cat > ../loop-lab-b/PROGRESS.md <<'EOF'
# PROGRESS — agent B ดูแลเฉพาะ src/math/ และ test/math/

## งาน
- [ ] เพิ่ม src/math/sum.js ฟังก์ชัน sum(numbers) พร้อมเทสต์ใน test/math/sum.test.js
- [ ] เพิ่ม src/math/average.js ฟังก์ชัน average(numbers) คืน 0 เมื่อ array ว่าง พร้อมเทสต์ใน test/math/average.test.js

## บันทึก

## ติดปัญหา
EOF

(cd ../loop-lab-a && MAX_ITER=3 MAX_TOTAL_USD=2 ./loop.sh > ../loop-a.log 2>&1) &
(cd ../loop-lab-b && MAX_ITER=3 MAX_TOTAL_USD=2 ./loop.sh > ../loop-b.log 2>&1) &
wait
tail -3 ../loop-a.log ../loop-b.log

→ PROGRESS.md ของแต่ละ worktree ยังไม่ได้ commit ไม่เป็นไร เพราะ agent จะ commit ไปพร้อมงานข้อแรก → node --test หาไฟล์ *.test.js ในโฟลเดอร์ย่อยของ test/ ให้เอง → ผลที่ควรได้: ทั้งสองจบด้วย "ไม่มีงาน - [ ] เหลือ" และมี commit ของตัวเองบน agent/a และ agent/b

ทดลอง B — รวมผล

git switch -c integrate main
git merge --no-edit agent/a
git merge --no-edit agent/b
npm test

→ ผลที่ควรได้: งานโค้ดไม่ชนกันเพราะแบ่งโฟลเดอร์ไว้ แต่ PROGRESS.md จะ conflict เพราะทั้งสองตัวแก้ไฟล์ชื่อเดียวกัน — นี่คือบทเรียน: ไฟล์สถานะของแต่ละ agent ควรตั้งชื่อแยก (เช่น PROGRESS-a.md) หรืออย่า merge มันเข้า main · แก้ตอนนี้ด้วย git checkout --theirs PROGRESS.md && git add PROGRESS.md && git commit --no-edit แล้วรัน npm test

ทดลอง C — ทางลัดของ Claude Code

echo ".claude/worktrees/" >> .gitignore
claude -w docs-update

→ ผลที่ควรได้: Claude เปิดใน .claude/worktrees/docs-update/ บน branch worktree-docs-update สั่งงานเล็กๆ แล้วออก จากนั้น git worktree list จะเห็น worktree นี้

เก็บกวาด

git worktree remove ../loop-lab-a && git worktree remove ../loop-lab-b
git worktree prune

ถ้าพัง

อาการ สาเหตุที่พบบ่อย
fatal: 'agent/a' is already checked out branch หนึ่ง checkout ได้ worktree เดียว → ใช้ชื่อ branch ใหม่
เทสต์ใน worktree ใหม่พังทันที ยังไม่ได้ติดตั้ง dependency (worktree ไม่มี node_modules ให้) → npm install ในแต่ละ worktree
merge แล้วเทสต์พังทั้งที่แยกกันผ่าน สองงานพึ่งกันโดยไม่รู้ตัว → แบ่งงานใหม่ หรือให้ทำตามลำดับแทนพร้อมกัน
git worktree remove ไม่ยอม มีไฟล์ที่ยังไม่ commit (เช่น log) → ตรวจก่อน แล้วใช้ --force ถ้าแน่ใจว่าทิ้งได้

ข้อดี / ข้อเสีย

✅ ข้อดี ❌ ข้อเสีย / ต้นทุน
งานที่อิสระต่อกันเสร็จเร็วขึ้นตามเวลานาฬิกา เวลาตรวจและรวมผลเพิ่มตามจำนวน agent และมักกินเวลาที่ประหยัดได้ไปเกือบหมด
ไฟล์ไม่ทับกัน commit ไม่ปนกัน ค่าใช้จ่ายเพิ่มตามจำนวน agent ตรงๆ — เร็วขึ้นไม่ได้แปลว่าถูกลง
แชร์ประวัติ git ร่วมกัน ไม่ต้อง clone ซ้ำ ทุก worktree ต้องติดตั้ง dependency เอง (เวลาและพื้นที่ดิสก์) และไฟล์ที่ gitignore อย่าง .env ไม่ตามมาให้
งานที่พึ่งกันโดยไม่รู้ตัวจะไปพังตอน merge · port/ฐานข้อมูลทดสอบชนกันได้

ทางเลือกที่ง่ายกว่า

  • งานข้ามคืน: loop เดียวทำต่อกันตามลำดับ — กลางคืนเวลาไม่ใช่ของหายาก ไม่ต้องรวมผล ไม่มี conflict
  • งานอ่าน/ค้น/รีวิวคู่ขนาน: subagents ใน session เดียว (บท 6d-04) ไม่ต้องมี worktree

เมื่อไรไม่ควรใช้: งานแตะไฟล์ชุดเดียวกัน · งานที่ต้องทำตามลำดับ · คุณยังตรวจผลของ agent ตัวเดียวไม่ทันในแต่ละวัน

สังเกตอะไร

  • worktree แยกไฟล์ได้ แต่ไม่ได้แยกงานที่พึ่งกันให้ — การแบ่งงานยังเป็นหน้าที่ของคน
  • เวลาที่ประหยัดได้จากการรันคู่ขนาน มักถูกกินด้วยเวลาตรวจและรวมผล เริ่มจาก 2 ตัว แล้วเพิ่มเมื่อการตรวจไม่ใช่คอขวด
  • ค่าใช้จ่ายเพิ่มตามจำนวน agent ตรงๆ ตั้ง MAX_TOTAL_USD แยกต่อตัว และรวมดูทั้งหมดทุกเช้า

สรุปจำง่าย

หนึ่ง agent = หนึ่ง worktree = หนึ่งโฟลเดอร์ที่มันเป็นเจ้าของ — แบ่งให้ไม่ชนตั้งแต่ต้น แล้วรวมผลในที่ที่มีคนตรวจ