Nexus Lab đã mã nguồn mở ack-is-not-done-guard, một tiện ích nhỏ giúp ngăn chặn các agent dựa trên tệp của Claude Code tuyên bố hoàn thành nhiệm vụ cho đến khi chúng đạt đến trạng thái “proven done” đã được xác minh. Các nhà phát triển mệt mỏi với những lần hoàn thành ảo (phantom completions) giờ đây đã có một cơ chế bảo vệ cụ thể để đưa vào các pipeline của mình.
Tại sao công cụ này lại quan trọng
Các agent của Claude Code đọc và ghi tệp, một quy trình làm việc dễ gây nhầm lẫn giữa điểm bắt đầu và điểm kết thúc của một tiến trình.
Cách thức hoạt động
Tiện ích này định nghĩa bốn trạng thái rõ ràng:
- Acknowledged – nhiệm vụ đã được ghi nhận.
- Working – agent đang tích cực xử lý.
- Artifact delivered – các kết quả đầu ra bắt buộc đã được ghi lại.
- Proven done – tất cả các điều kiện hoàn thành đã được thỏa mãn.
Chỉ khi một agent đạt đến trạng thái “proven done”, cơ chế bảo vệ mới cho phép xác nhận hoàn thành đi qua. Việc kiểm tra này rất nhẹ; nó không giám sát các tiến trình không liên quan hoặc đóng vai trò như một khung điều phối (orchestration framework) quy mô đầy đủ. Nó kết nối trực tiếp vào quy trình làm việc dựa trên tệp mà Claude Code mong đợi.
Ai được lợi, ai bị bỏ lại
Vì cơ chế bảo vệ này chỉ tập trung hẹp vào các trạng thái dựa trên tệp, nó sẽ không giúp ích cho các dự án sử dụng các kiến trúc agent khác hoặc cần sự giám sát quy trình làm việc rộng hơn. Những nhóm đó vẫn phải dựa vào việc giám sát bên ngoài hoặc logic tùy chỉnh.
Bài học rút ra
ack-is-not-done-guard chứng minh rằng một mô hình trạng thái khiêm tốn, được định nghĩa rõ ràng có thể lấp đầy lỗ hổng về độ tin cậy dai dẳng trong các quy trình làm việc dựa trên tệp do AI điều khiển, mang lại cho các nhà phát triển một cách rõ ràng, ít tốn kém tài nguyên để tin tưởng rằng trạng thái "xong" của một agent thực sự có nghĩa là đã hoàn tất.