Flowness / Explicação de design

Dar ao trabalho um endereço fora da conversa

O desenho Work do Flowness reúne objetivos, fundamentos e ações restantes em um estado atual consultável, preparado para a retomada.

Ilustração conceitual de estruturas de papel e vidro conectadas
Ilustração editorial · Gerada por IA

Uma alteração de agendador poderia deixar este registro de passagem:

Objetivo: parar de receber novas tarefas e deixar as importações em andamento terminarem.
Artefato: patch central salvo; entrada de linha de comando ainda não conectada.
Conflito: o patch atual cancela tarefas em andamento, e os testes verificam esse comportamento antigo.
Próximo passo: corrigir a semântica de pausa e continuar a integração.
Executor: nenhum.

Mesmo sem agente em execução, o trabalho tem estado definido. Quem assume pode identificar o defeito principal antes de ler toda a conversa: o núcleo contradiz o objetivo; conectá-lo agora entregaria o comportamento errado ao usuário.

É um exemplo didático do desenho Work proposto no commit público c9d6abe do Flowness. Essa versão ainda classifica a continuidade completa entre agentes como design; o exemplo não é uma execução concluída. Design e estado das evidências

O endereço precisa levar aos fundamentos

Work oferece um ponto estável de consulta para trabalho persistente. Um identificador permite encontrá-lo, mas não garante fatos atuais ao abrir.

O Flowness desenha Work como projeção dos registros subjacentes. Código fica no repositório, testes apontam para versões e decisões e mudanças ficam em eventos; a visão reúne esses fatos. Se o patch muda, ela deve indicar qual versão foi testada, em vez de apenas mostrar um “passou” verde.

A visão também tem posição temporal. as_of_seq indica até que evento houve agregação. Se para no 147 e o responsável muda a pausa no 148, o sistema pode reconhecer que falta a decisão nova. Design de WorkView

Isso pode apoiar a ação seguinte melhor que um resumo de passagem. O resumo explica o pensamento de então; a visão atual também precisa saber quais interpretações mudaram depois.

Quando o executor é interrompido, primeiro se confere o que restou: a execução realmente parou, o patch foi commitado, quais arquivos estão no ambiente temporário e quais resultados foram verificados? A recuperação depende do estado real, não da estimativa anterior de “quase pronto”.

Depois prepara-se o contexto da próxima ação. O Flowness chama isso de Context Capsule: seleciona, a partir de um corte factual explícito, objetivo, versões, restrições vigentes, artefatos e problemas. No agendador, resolver o conflito de pausa vem primeiro; entregar todo o chat pode esconder os materiais decisivos. Verificação do estado e compilação de contexto

O novo agente inicia sua execução no mesmo Work. Depois de conferidos, seus resultados fundamentam a consulta seguinte.

Mudou a premissa, muda a leitura do concluído

A pausa pode ter sido inicialmente entendida como “parar todas as tarefas”. Depois, o responsável confirmou que as importações em andamento deveriam terminar. Isso afeta mais que a descrição.

Os testes antigos passaram, mas verificavam cancelamento. Núcleo, asserções e ajuda do comando podem depender da mesma premissa antiga. O formato de logs, sem relação com pausa, talvez não precise ser refeito.

Para distinguir, é preciso guardar duas dependências: a ordem das tarefas e a versão da interpretação que fundamenta cada artefato. A primeira diz que a integração vem depois dos testes; a segunda revela que os testes usam requisitos superados.

Flowness chama de Finding uma observação que altera o trabalho seguinte; Reflow localiza premissas e dependências afetadas e organiza a continuação. Aqui: “O núcleo cancela importações em andamento, contrariando o requisito atual”. O plano retorna ao comportamento central, verifica a conclusão das tarefas em curso e depois conecta o comando. Relação entre Finding e Reflow

Os artefatos permanecem; muda o que sustentam. Testes antigos explicam o histórico, mas não comprovam atendimento aos requisitos novos.

Poupar esforço com retrabalho localizado depende de registros corretos. Relações ausentes pedem investigação; com alcance incerto, ampliar testes pode custar menos que classificar detalhadamente. O desenho precisa ser testado em alterações reais: quantos caminhos errados evita e quanto registro acrescenta.

Execução persistente já tem ferramentas maduras. Temporal recupera estado de workflows pelo histórico de eventos e recebe Signal, Update e outras entradas; LangGraph mantém estado de grafos e dados entre threads com checkpoints e armazenamento persistente. Workflows do Temporal, mensagens, persistência do LangGraph

Work enfoca como interpretar o estado salvo: versão do objetivo, julgamentos substituídos, artefatos afetados e materiais necessários agora. Essas regras podem usar motores existentes. Se tickets, repositório e workflow já guardam as relações, outra base paralela só acrescenta sincronização.

O endereço ainda serve depois de “concluído”

Corrigir o núcleo não elimina o restante. O Flowness distingue quatro estados, ligados a continuidades diferentes:

Estado Significado no exemplo
Construído (built) Existe artefato verificável da função de pausa.
Integrado (integrated) Entrada de comando e caminho real de chamada estão conectados.
Ativado em uso real (activated) O uso natural no ambiente de destino invoca a capacidade.
Aceito (accepted) A pessoa responsável confirma que atende à necessidade.

Ativação real exclui testes, demonstrações, ensaios e mero deploy. A aceitação deve indicar qual versão do resultado foi reconhecida. Definições de ativação e aceitação

A espera fica concreta. A função pode estar integrada sem demanda real de pausa, ou ter sido usada sem aceite ainda. Não é preciso manter um agente rodando: basta conservar evento esperado, responsável e condições de revisão.

Quando as condições chegarem, abre-se o mesmo Work, confere-se a versão e inicia-se a próxima ação. A especificação pública de demonstração prepara esse teste: outro executor consegue continuar após interrupção, a partir do estado persistente, sem a memória temporária do agente anterior? Especificação da demonstração

Para quem mantém o sistema, o endereço deve responder algo prático: voltando hoje ao agendador, por onde começo? Responder continuamente permite ao trabalho atravessar fim de conversas, troca de pessoas e mudanças de requisitos.

Next step

If your team is putting agents into real work and wants to talk about Flowness or enterprise AI deployment, email us your industry and the problem you want to solve. hi@towow.ai