Pular para o conteúdo principal

Execução na cloud (OnCloud)

OnCloud é a camada de execução remota do Almirant. Você se desconecta, o agente trabalha, e a PR espera por você quando voltar.


O problema que resolve

Com as skills locais (/implement, /validate), o agente trabalha no seu terminal. Você precisa estar presente. Se fechar o computador ou sair, a execução é interrompida.

Os agentes prometiam autonomia. Na prática, muitos desenvolvedores trocaram escrever código por vigiar alguém que o escreve.

O OnCloud elimina essa dependência: você inicia a tarefa, se desconecta, e o resultado espera por você.

"Fui fazer meus exercícios e, quando terminei, fui ver como tinha ficado."

— Javi Pedrosa, sobre sua primeira implementação na cloud


Quando usar

SituaçãoPor que usar o OnCloud
Você vai sair e tem tasks prontas para implementarO agente trabalha enquanto você está ausente
Você quer iniciar várias tasks ao mesmo tempoElas são executadas em paralelo na cloud
Você está no celular e quer iniciar algoNão é necessário abrir o computador
Está tarde e você quer avançar o trabalho durante a noiteConfigure e se desconecte
Você não quer consumir recursos da sua máquinaO agente é executado em infraestrutura remota

Como iniciar

Os runners na cloud são equivalentes remotos das skills locais:

Skill localEquivalente na cloudO que faz
/implement A-T-42/runner-implement A-T-42Implementa a task na cloud
/validate A-T-42/runner-validate A-T-42Valida se ela atende aos critérios
/document A-T-42/runner-document A-T-42Gera documentação das alterações

No Claude Code:

> /runner-implement A-T-42

A task é colocada na fila do sistema de execução remota. O work item passa para "In Progress". Você pode fechar o computador.

No assistente, com MCP conectado:

"Inicie a implementação na cloud da task A-T-42 com Claude"
"Runner-implement para A-T-42, use Codex"

Funciona no celular. Você não precisa do computador.


Escolher o provedor

Ao iniciar com o OnCloud, você pode selecionar o provedor de IA que executará a task:

ProvedorModeloQuando usar
Claude (Anthropic)Claude Sonnet / OpusTasks complexas, código com muito contexto
Codex (OpenAI)GPT-4o / o3Implementações diretas, bom desempenho geral
Gemini (Google)Gemini ProAlternativa quando outras contas estiverem no limite

Se não especificar um provedor, o Almirant usa o configurado como padrão na sua organização.

Orquestração de contas

Se sua cota do Claude se esgotar, você pode iniciar as próximas tasks usando a conta de outro provedor ou de uma pessoa da equipe. O Almirant coordena o consumo sem que você precise gerenciar manualmente qual conta usa o quê.


Acompanhar o status

Você pode consultar o status dos runners a qualquer momento:

  • No app web: painel de Jobs no work item ou na visualização de projeto.
  • No assistente: "Como está a task A-T-42?"
  • No Claude Code: /jobs para ver o status de todos os runners ativos.

Um runner passa pelos estados:

queued → running → completed
→ failed

Se falhar, o erro é registrado com detalhes para que você possa ver o que aconteceu.


Processo noturno automático

Você pode configurar um processo executado automaticamente todas as noites:

  1. Ele coleta todas as tasks na coluna "Review".
  2. Valida-as em relação à definition of done.
  3. Move-as para "Done" se forem aprovadas ou deixa feedback se não forem.

Javi o configurou assim: chega pela manhã com o board atualizado. Não precisa fazer nada.

A configuração é feita nas configurações do projeto no Almirant.


Requisitos

Para usar o OnCloud, você precisa de:

  • Um provedor de IA configurado com uma API key válida: Provedores e cotas.
  • Cota disponível na sua organização.
  • Uma task com especificação completa, gerada pelo Ideate ou escrita manualmente com definition of done.
Tasks bem definidas = melhores resultados

O OnCloud funciona com qualquer task, mas os melhores resultados vêm de tasks criadas pelo Ideate: com arquivos relevantes identificados, critérios de aceitação concretos e contexto técnico incluído. Se você iniciar uma task vaga, o agente fará o que puder.


Próximos passos