Multi Agent Shift Handoff — AI skill for Claude Code

🩺 Multi-Agent Shift Handoff & Blackboard Protocol (WAT System)

**Standard Operating Procedure (SOP) & Architecture for Asynchronous Multi-Agent Collaboration** รองรับการทำงานร่วมกันระหว่าง **GPT Codex**, **Claude Code**, **Antigravity (Agy)**, และ AI Agents อื่นๆ โดยใช้ **Filesystem Blackboard** เป็น Single Source of Truth (SSOT)

---

🌟 ทำไมต้องใช้ระบบนี้? (Why Shift Handoff?)

เมื่อเราใช้ AI หลายตัวทำงานร่วมกันในโปรเจกต์เดียวกัน ปัญหาที่พบบ่อยคือ:

1. บริบทในแชตหาย (Context Loss): เมื่อเปิด session ใหม่ หรือสลับไปคุยกับอีก Agent หนึ่ง Agent ตัวใหม่จะไม่รู้ว่าตัวก่อนหน้าทำอะไรไปบ้าง
2. แก้ไฟล์ชนกัน (Race Conditions / Code Conflicts): Agent หลายตัวแก้ไฟล์เดียวกันพร้อมกันจนโค้ดพัง
3. คำสั่ง Owner คลาดเคลื่อน: เจ้าของโปรเจกต์บอก Agent ตัวแรกอย่างหนึ่ง แล้วเปลี่ยนใจหรือบอก Agent ตัวที่สองอีกอย่าง ทำให้ Agent สับสนว่าต้องเชื่อใคร
4. ขาด Audit Trail: ไม่รู้ว่าใครรัน build, ใคร deploy, หรือใครแก้อะไรเมื่อไหร่

**ระบบนี้แก้ปัญหาด้วย "การส่งเวรเหมือนทีมแพทย์/พยาบาลในโรงพยาบาล" ผ่าน Filesystem ใน `.wat/`**

---

🏗️ สถาปัตยกรรม (Architecture)

.wat/
├── active-handoff.md          # 📌 กระดานส่งเวรกลาง (ชาร์ตเวรล่าสุด ใครทำอะไรค้างไว้ ใครต้องรับช่วงต่อ)
├── queue.md                   # 🎯 คิวงานย่อยระดับ Atomic (Release gates, DoD)
├── packets/                   # 📦 ใบสั่งงานเฉพาะเรื่อง (Work Packets พร้อม File Lock)
│   └── .md
├── reports/                   # 📋 รายงานผลการตรวจสอบ/ผลงาน (Audit, Review, Specs)
│   └── .md
└── runs/                      # 🧪 บันทึกประวัติการรัน script หรือ security operations

---

🔄 วงรอบ 3 ขั้นตอน (Check-in ➔ Act ➔ Check-out)

+-------------------------------------------------------------------+
| 1. CHECK-IN (ก้าวแรกก่อนเริ่มงาน)                                    |
|    - อ่าน .wat/active-handoff.md ทันทีเมื่อเปิดเซสชัน                 |
|    - ดูสถานะปัจจุบัน, ผู้รับมอบงาน, ข้อห้าม, คิวงาน               |
|    - ปรับสถานะเป็น IN_PROGRESS_