forklystudio

Documentação

Como usar Forkly

Guia prático pra entender o que o Forkly faz, como instalar e como aproveitar cada feature. Pra contexto de produto, veja a landing.

Fluxo de trabalho

Missões — o quadro

O quadro é onde o trabalho disparado fica visível. Você escreve o que quer feito, o Forkly sobe um agente próprio para aquilo e a missão anda sozinha pelas colunas — você entra de novo só na hora de decidir o que vira código.

  1. Backlog

    Ideias que ainda não viraram trabalho. Um card aqui é um lembrete, não uma tarefa: nada roda enquanto você não disparar.

  2. A fazer

    A missão está na fila. Isso acontece quando todos os agentes do papel estão ocupados — o Forkly segura e despacha assim que um vagar.

  3. Em progresso

    Um agente pegou. O card mostra qual CLI está executando, e o trabalho acontece numa cópia isolada do projeto — nunca na sua pasta.

  4. Revisão

    Terminou e mexeu em código. O card traz o diff pronto com Abrir PR, Ver o diff e Descartar.

  5. Concluído

    Mergeado, PR aberto, ou concluído sem mudança de código. É o histórico do que aquele projeto já produziu.
Cópia isolada por missão
Cada agente trabalha numa git worktree própria, com branch própria. Dois agentes nunca escrevem no mesmo arquivo ao mesmo tempo, e o seu trabalho não commitado fica fora do caminho deles.
Quem pediu decide o destino
Missão disparada pelo quadro para na coluna Revisão — revisar depois é o ponto. Tarefa que você pediu ao Pilot na conversa aterrissa direto na sua pasta quando termina, porque você está ali esperando para testar. Só vira card se conflitar com algo que você mexeu enquanto ela rodava.
Mergear tudo
Resolve a fila inteira de uma vez: sincroniza a base, aplica os merges na ordem e faz um push só. Conflito é resolvido com IA e, se não der, aquele card fica para você.
Tarefa repetida
O Forkly recusa despachar duas vezes o mesmo trabalho. A comparação ignora acento, maiúscula e pontuação, e reconhece o número do ticket no título — mesmo ticket escrito com outras palavras é o mesmo trabalho.
O diff do card é calculado contra o ponto em que a cópia nasceu, não contra o estado atual do projeto. É o que impede um card antigo de mostrar o seu trabalho como se fosse remoção dele.

Para disparar sem sair do chat, peça ao Pilot. Ele quebra o pedido em tarefas, escolhe o papel de cada uma (task, review, testing, iris) e acompanha o desfecho — você recebe o resultado na conversa.