Адаптер хмарних агентів

Хмарні та фонові агенти — віддалені завдання Claude Code, OpenAI Codex cloud, агенти класу Jules та подібні асинхронні середовища виконання — є ефемерними за своєю природою: сесія починається, виконується протягом обмеженого часу й завершується. DWP перетворює це обмеження на перевагу, роблячи план довговічним артефактом, а не сесію.

Ключова ідея

Каталог .dwp/ репозиторію є довговічним рівнем специфікації та стану. Хмарні сесії є ефемерними виконавцями. План повідомляє виконавцю, що робити; state.json повідомляє, де відновити роботу. Сесія може бути будь-якою — інша модель, інший провайдер, новий контейнер — і план продовжиться з рівно того місця, де зупинився.

Рівень підтримки

Повна (Документовано) — платформи хмарних агентів читають AGENTS.md або нативні інструкції та виконують команди через термінал або контейнерне оточення.

Цикл прокидання-відновлення-поступки

Кожен поворот хмарного агента слідує паттерну:

Прокидання — сесія починається (ініційована cron-розкладом, подією CI або дією користувача).
Виконати протокол відновлення DWP — прочитати README плану, знайти контрольну точку, відновити стан із journal.ndjson за допомогою ledger.py project, перевірити стик, запустити димовий тест. Див. Специфікація DWP.
Перевірка заблокованого стану — якщо state.json.blocked встановлено, звітувати про причину й поступитися без виконання.
Виконання наступного атомарного завдання — одне завдання, з повним проходженням його валідаційного gate.
Запис у журнал — додавання подій до journal.ndjson за допомогою дієслів ledger.py (start, gate, complete); ledger.py project атомарно оновлює проекцію знімка state.json. У застарілих планах v5 зберігається пряме оновлення файлу стану.
Поступка — сесія завершується чисто; наступний поворот продовжує з оновленого стану.

Вимоги

План MUST нести машиночитаний рівень стану (manifest.json + state.json). Без нього ефемерна сесія не має надійного способу визначити позицію відновлення. Див. Стан плану.
План MUST бути схвалений людиною перед будь-яким автономним хмарним поворотом. Схвалення плану є контрольною точкою.
Агент діє в межах обмежених повноважень: він MUST NOT розширювати scope, виконувати деструктивні або зовнішньоспрямовані дії, що план явно не авторизує, та MUST NOT розтягувати інструкції завдання для охоплення виявленої, але незапланованої роботи — виявлена робота фіксується для наступного refine, а не імпровізується. Див. Протокол агента.

Нотатки

Хмарні агентні сесії є граничним випадком профілю автономного виконання: нульова неперервність сесії, максимальна довговічність плану. Каталог .dwp/ DWP спеціально розроблений для забезпечення цього — весь стан, потрібний агенту для початку, продовження та завершення обсягу роботи, зберігається у звичайних markdown і JSON-файлах, які будь-яка сесія може прочитати зі свіжого checkout.