Champfubu

Multi Agent Shift Handoff — AI skill for Claude Code

AI community

Standard Operating Procedure (SOP) & filesystem blackboard protocol for asynchronous multi-agent collaboration (Claude Code, GPT Codex, Antigravity).

How to install Multi Agent Shift Handoff

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Champfubu/multi-agent-shift-handoff and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Multi Agent Shift Handoff does

Standard Operating Procedure (SOP) & filesystem blackboard protocol for asynchronous multi-agent collaboration (Claude Code, GPT Codex, Antigravity). คำอธิบายภาษาไทย (สำหรับใส่ในหัวข้อ README หรือสรุปย่อ): ระบบกระดานส่งเวรกลาง (Shift Handoff) และธรรมนูญสำหรับ AI Multi-Agent ทำงานร่วมกันแบบ Asynchronous ไร้รอยต่อ ป้องกัน Context Loss และไฟล์ชนกัน

Alternatives in AI

  • Omnara — by Ishaan Sehgal - A command center for AI agents that syncs Claude Code sessions across terminal, web, and mo 2.6k ★
  • StereOS — A Linux based operating system hardened and purpose built for AI agents 489 ★
  • Fusion Plan — OMC interview (interactive) → 3-round Opus 4.8 + GPT-5.5 fusion deepening → concise .omc/plans/ output → revie 468 ★

README

🩺 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_