Skip to content
Manual
EN PT-BR
PDF em preparação

FlowForge Manual

CHAPTER 07 PT-BR

ForgePlay e o Cockpit

O cockpit no terminal e os fluxos guiados do ForgePlay que executam a cerimônia do FlowForge por você.

ForgePlay e o Cockpit

A disciplina do FlowForge poderia ser um monte de comandos para decorar. Em vez disso, ela é um lugar onde você se senta e um conjunto de fluxos guiados. O cockpit é o lar do seu trabalho no terminal; um ForgePlay é a execução, em um único comando, de uma cerimônia inteira. Este capítulo cobre os dois.

O cockpit

Inicie-o com:

Terminal window
flowforge tui

O cockpit é uma interface de terminal em tela cheia — a superfície de destaque do FlowForge e uma peça deliberada de artesanato. A partir dele, você consegue ver e conduzir todo o fluxo de trabalho:

  • Tempo e tickets — o que está rodando, o que está atribuído, o que está em andamento.
  • O quadro — o trabalho transitando entre estados, incluindo workers ao vivo.
  • Despacho — subir um worker sobre um ticket, ou iniciar um fluxo, sem sair da tela.

O cockpit é construído sobre um sistema de design disciplinado — um manual de design e um cânone de espaçamento que viajam com cada tela — de modo que ele se lê como um produto coeso, e não como uma pilha de painéis. A cor nunca é o único sinal (cada status combina cor com um glifo e um rótulo), as paletas são escolhidas para permanecerem legíveis a usuários com deficiência de visão de cores, e o NO_COLOR é respeitado. Bom artesanato de terminal faz parte da proposta, não é um detalhe deixado para depois.

A visão FLEET do cockpit — workers ao vivo com seu estado, contexto e telemetria de tokens por worker, e o histórico de PRs merged do dia, tudo em uma só tela.

O que é um ForgePlay

Um ForgePlay é uma execução nomeada e guiada de uma cerimônia do FlowForge — uma sequência dirigida de passos, com os portões de aprovação do fundador embutidos exatamente onde o plano precisa. Você inicia um fluxo com uma intenção em linguagem natural, e ele percorre a cerimônia por você, parando nos portões que projetou e em nenhum outro lugar.

Um ForgePlay em andamento — a swim lane de uma execução de Análise de Código Legado, com cada passo da cerimônia transitando de concluído → ativo → na fila conforme o fluxo avança.

Planejar uma Feature

O fluxo emblemático é Planejar uma Feature. Você descreve uma feature em palavras comuns, e o FlowForge roda a disciplina completa de blueprint por você:

requisitos → arquitetura → design → PRD → (você ratifica) → decompor → (você revisa) → tickets vinculados
  • Você nunca escreve os documentos à mão.
  • Você nunca entra em um worker para fazê-lo.
  • Você toca exatamente dois portões: ratificar o plano empacotado e, depois, revisar antes de os tickets serem escritos.
  • Quando o segundo portão passa, os tickets são emitidos automaticamente — derivados do plano ratificado, cada um levando o seu rastro de documentos. Não há uma nova pergunta separada de “criar os tickets?”, porque o plano ratificado já é a autorização.

Outros fluxos cobrem outros formatos de trabalho — aterrissar uma base de código legada, levantar uma landing page —, mas Planejar uma Feature é o que transforma uma ideia em trabalho devidamente vinculado e documentado, em um único ciclo guiado.

Guiado, não automatizado-para-longe

Os fluxos não removem o seu julgamento; eles removem o trabalho braçal em torno dele. A cerimônia — a ordenação, os artefatos, os portões — roda sozinha, para que a sua atenção vá para as duas decisões que realmente importam: o plano está certo, e os tickets estão certos.

Por que isso importa

O cockpit e o ForgePlay são onde a disciplina do FlowForge deixa de ser uma lista de regras que você precisa lembrar e se torna um lugar onde você trabalha e um botão que você aperta. O jeito certo não é apenas aplicado — ele é agradável, que é o único jeito de a disciplina sobreviver ao contato com um prazo.