Guias
Escolha um modo de condução
Compare os pontos de HITL e os limites de cada modo.
Escolha pela decisão necessária
#Classic tem três pontos de HITL: objetivo, plano e evidências. #Maestro concentra o ponto de HITL nas premissas e no plano. #Auto percorre o ciclo completo sem ponto de HITL previsto. Em todos eles, bloqueios e escalações continuam ativos.
ork modos
ork modos --do-pedido "revisar a documentação #Maestro"O limite de #Fast
#Fast executa somente GO, com prova proporcional ao pedido pequeno. Não concede push automático e não permite alterar contratos públicos protegidos. Uma mudança na matriz de modos, nos schemas ou em contratos de integração precisa de um modo de ciclo completo.
Confira o manifesto
Sem tag, vale conduction.default_mode. O núcleo valida a escolha contra conduction.allowed_modes. Tags não são autorização para ignorar o escopo explícito do dono.
A troca de perfil por cota
Com a troca por cota ligada, o padrão, esgotamento de cota, crédito ou limite do plano marca o perfil e passa para o próximo perfil ativo do mesmo runtime. O prompt que segue depende do que a sessão produziu: sem produção, vai o prompt original; com produção, vai um prompt de retomada com o checkpoint. Sem perfil ativo, o núcleo segue para o runtime de fallback do bloco e depois para a fila durável. Rate limit comum de curta janela nunca troca de perfil: espera a janela na fila.
O checkpoint leva fase, HEAD, estado da worktree, claims e rodada, preserva o prompt e o SHA-256 originais e manda continuar sem repetir GOAL nem PLAN. A produção parcial não recebe o prompt original sobre a worktree alterada; sem retomada segura, a sessão vira human.pending. Em #Classic o bloco espera a resposta ao ork gate request; em #Maestro e #Auto ele troca sozinho e grava runtime_profile_rotated com quem decidiu, a evidência e a razão. Estourar retry.max_tentativas interrompe qualquer modo, inclusive o #Auto, e perfil não é eixo de independência do CHECK.
ork accounts
ork setup <modo>Só com o Codex
O setup padrão despacha os blocos pelo claude-bg. Para usar só o Codex, passe cada bloco dos modos permitidos para ele; ork setup <modo> lista os blocos. ork doctor reprova a falta do claude só enquanto algum bloco de modo permitido despachar pelo claude-bg; um fallback que cai nele só gera aviso.
ork setup classic
ork setup classic --bloco 1 --runtime codex --model <modelo>A worktree da thread
O modo diz quantos pontos de HITL a thread tem; a worktree diz onde ela escreve. Com worktree.por_thread: true, o valor que o ork init grava, ork thread new cria a worktree e a branch ork/<slug> em qualquer modo, sem flag, e ork ship entrega essa branch. Com a chave false ou ausente, a worktree só nasce com --worktree auto ou com um ciclo que a exige.
--worktree <DIR> reusa um diretório existente. --sem-worktree cria a thread na raiz do projeto: na branch base, ork ship é barrado por push_direto_na_base: block, o padrão do ork init, e antes do GO ork worktree ensure <thread> ainda cria a worktree. --dry-run mostra a worktree e a branch que seriam criadas, ou por que a criação seria recusada. Os ciclos greenfield, merge-branch e feature-xl-faseada exigem worktree e recusam --sem-worktree. Num repositório sem commit, a thread nasce na raiz, com aviso.
ork thread new "corrigir o filtro" --modo classic --dry-run
ork thread new "corrigir o filtro" --modo classic --sem-worktree
ork worktree ensure <thread>