Adaptador para agentes em nuvem

Agentes em nuvem e em segundo plano — tarefas remotas do Claude Code, Codex cloud da OpenAI, agentes classe Jules e ambientes de execução assíncrona similares — são efêmeros por design: uma sessão começa, executa por um tempo limitado e termina. O DWP transforma essa restrição em uma vantagem ao tornar o plano o artefato durável, não a sessão.

O insight central

O diretório .dwp/ do repositório é a camada de spec e estado durável. As sessões em nuvem são executores efêmeros. O plano diz ao executor o que fazer; o state.json diz onde retomar. A sessão pode ser qualquer coisa — um modelo diferente, um provedor diferente, um novo contêiner — e o plano continua exatamente de onde parou.

Nível de suporte

Completo (Documentado) — plataformas de agentes em nuvem leem AGENTS.md ou instruções nativas e executam comandos através de seu ambiente de terminal ou contêiner.

O loop de acordar-retomar-ceder

Cada turno de agente em nuvem segue o padrão:

1. Acordar — a sessão começa (acionada por um agendamento cron, um evento de CI ou uma ação do usuário).
2. Executar o Protocolo de Retomada DWP — ler o README do plano, localizar o ponto de verificação, reconstruir o estado a partir de journal.ndjson via ledger.py project, inspecionar a costura, executar um teste de fumaça. Veja Especificação DWP.
3. Verificar o estado bloqueado — se state.json.blocked estiver definido, reportar o motivo e ceder sem executar.
4. Executar a próxima tarefa atômica — uma tarefa, passando pelo seu validation gate completo.
5. Registrar no diário — anexar eventos a journal.ndjson via verbos do ledger.py (start, gate, complete); ledger.py project atualiza a projeção de snapshot de state.json atomicamente. Em planos v5 legados, a atualização direta do arquivo de estado é preservada.
6. Ceder — a sessão termina de forma limpa; o próximo turno retoma a partir do estado atualizado.

Requisitos

• O plano DEVE (MUST) carregar a camada de estado legível por máquina (manifest.json + state.json). Sem ela, uma sessão efêmera não tem forma confiável de determinar a posição de retomada. Veja Estado do plano.
• O plano DEVE (MUST) ter sido aprovado por um humano antes de qualquer turno em nuvem não supervisionado. A aprovação do plano é o ponto de controle.
• O agente opera sob autoridade limitada: NÃO DEVE (MUST NOT) expandir o escopo, executar ações destrutivas que o plano não autoriza explicitamente, nem improvisar além das instruções da tarefa atual. Veja Protocolo do agente.

Notas

As sessões de agentes em nuvem são o caso extremo do perfil de execução não supervisionada: zero continuidade de sessão, máxima durabilidade do plano. O diretório .dwp/ do DWP é especificamente projetado para que isso funcione — todo o estado que um agente precisa para iniciar, continuar e concluir um conjunto de trabalho vive em arquivos markdown e JSON simples que qualquer sessão pode ler a partir de um checkout recente.