Nexus Lab відкрила вихідний код ack-is-not-done-guard — крихітної утиліти, яка заважає файловим агентам Claude Code заявляти про завершення завдання, доки вони не досягнуть перевіреного стану «proven done». Розробники, втомлені від «фантомних» завершень, тепер мають конкретний механізм захисту, який можна інтегрувати у свої конвеєри.
Чому цей інструмент важливий
Агенти Claude Code читають і записують файли — такий робочий процес легко сприймає початок процесу за його завершення.
Як це працює
Утиліта визначає чотири чіткі стани:
- Acknowledged — завдання розпізнано.
- Working — агент активно обробляє дані.
- Artifact delivered — необхідні результати записані.
- Proven done — усі умови завершення виконані.
Тільки коли агент досягає стану «proven done», механізм захисту дозволяє підтвердити завершення. Перевірка є легковесною; вона не відстежує непов'язані процеси та не є повномасштабним фреймворком оркестрації. Вона безпосередньо вбудовується у файловий робочий процес, який очікує Claude Code.
Хто виграє, а хто залишиться осторонь
Оскільки цей захисний механізм зосереджений вузько на станах, пов'язаних із файлами, він не допоможе проєктам, які використовують інші архітектури агентів або потребують ширшого нагляду за робочим процесом. Такі команди все ще мають покладатися на зовнішній моніторинг або власну логіку.
Підсумок
ack-is-not-done-guard доводить, що скромна, чітко визначена модель станів може заповнити постійну прогалину в надійності файлових робочих процесів під керуванням ШІ, надаючи розробникам зрозумілий і невимогливий спосіб переконатися, що «готово» агента справді означає завершення.