Nexus Lab ได้เปิดซอร์สโค้ด ack-is-not-done-guard ซึ่งเป็นยูทิลิตี้ขนาดเล็กที่ช่วยป้องกันไม่ให้เอเจนต์แบบอิงไฟล์ (file-based agents) ของ Claude Code ประกาศว่างานเสร็จสิ้น จนกว่าจะเข้าสู่สถานะ “proven done” ที่ได้รับการตรวจสอบแล้ว นักพัฒนาที่เหนื่อยหน่ายกับการแจ้งว่างานเสร็จสิ้นทั้งที่ยังไม่เสร็จจริง (phantom completions) ตอนนี้มีเกราะป้องกันที่จับต้องได้เพื่อนำไปใส่ไว้ใน pipeline ของตนเอง

ทำไมเครื่องมือนี้ถึงสำคัญ

เอเจนต์ของ Claude Code มีการอ่านและเขียนไฟล์ ซึ่งเป็นเวิร์กโฟลว์ที่อาจทำให้เกิดความสับสนระหว่างจุดเริ่มต้นของกระบวนการกับจุดสิ้นสุดได้ง่าย

หลักการทำงาน

ยูทิลิตี้นี้กำหนดสถานะที่ชัดเจนไว้ 4 สถานะ:

  • Acknowledged – รับทราบงานแล้ว
  • Working – เอเจนต์กำลังประมวลผลอยู่
  • Artifact delivered – ส่งมอบอาร์ทิแฟกต์ (เขียนเอาต์พุตที่จำเป็นเรียบร้อยแล้ว)
  • Proven done – เสร็จสิ้นอย่างสมบูรณ์ (เงื่อนไขการเสร็จสิ้นทั้งหมดได้รับการตอบสนองแล้ว)

ตัวป้องกันจะอนุญาตให้การประกาศว่างานเสร็จสิ้นผ่านไปได้ ก็ต่อเมื่อเอเจนต์เข้าสู่สถานะ “proven done” เท่านั้น การตรวจสอบนี้มีน้ำหนักเบา (lightweight) โดยจะไม่เฝ้าติดตามกระบวนการที่ไม่เกี่ยวข้อง หรือทำหน้าที่เป็นเฟรมเวิร์กการจัดการ (orchestration framework) แบบเต็มรูปแบบ แต่มันจะเชื่อมต่อเข้ากับเวิร์กโฟลว์แบบอิงไฟล์ที่ Claude Code คาดหวังไว้โดยตรง

ใครได้ประโยชน์ และใครที่ยังไม่ครอบคลุม

เนื่องจากตัวป้องกันนี้มุ่งเน้นไปที่สถานะแบบอิงไฟล์อย่างเฉพาะเจาะจง จึงไม่สามารถช่วยโปรเจกต์ที่ใช้สถาปัตยกรรมเอเจนต์แบบอื่น หรือต้องการการควบคุมเวิร์กโฟลว์ที่กว้างกว่านี้ได้ ทีมเหล่านั้นยังคงต้องพึ่งพาการตรวจสอบจากภายนอกหรือตรรกะที่ปรับแต่งขึ้นเอง (custom logic)

บทสรุป

ack-is-not-done-guard พิสูจน์ให้เห็นว่าโมเดลสถานะที่เรียบง่ายและมีการกำหนดไว้อย่างชัดเจน สามารถเติมเต็มช่องว่างด้านความน่าเชื่อถือที่เกิดขึ้นซ้ำๆ ในเวิร์กโฟลว์ไฟล์ที่ขับเคลื่อนด้วย AI ช่วยให้นักพัฒนามีวิธีที่ชัดเจนและมีภาระงานต่ำ (low-overhead) เพื่อให้มั่นใจว่าคำว่า “done” ของเอเจนต์นั้นหมายถึงเสร็จสิ้นจริงๆ