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.

Multi-agent colaborativo

Squadron — sala viva

Squadron é um modo explícito que você liga/desliga por projeto. Quando ativo, transforma o workspace numa sala viva onde múltiplos agentes compartilham contexto, coordenam claims de área e fazem handoff direto — sem substituir o fluxo Pilot→agent existente.

  1. Mailbox compartilhada

    Agentes leem e escrevem eventos (claim, progress, question, handoff, blocker, done) via forkly_squad_read / forkly_squad_post antes de agir.
  2. Claim de área

    Cada agente reivindica arquivo ou módulo para evitar duplicação. Claims expiram após 15 min sem progresso; conflito retorna conflict: true.
  3. Handoff direto

    Agentes transferem trabalho entre si sem intervenção do Pilot. Guardrails server-side limitam saltos em cadeia (máx. 3) e deduplicam handoffs repetidos.
  4. Sala viva (UI)

    Painel em tempo real: cards com mascote por role (Task azul, Review roxo, Testing âmbar, Iris laranja), feed cronológico e swarm interativo com raias por papel.
Ativar
Toggle por projeto no painel direito. Quando ON, a tab "Squadron" aparece e as tools MCP forkly_squad_* ficam disponíveis.
Context Pack
Com Squadron ativo, o briefing da task injeta seção de mailbox instruindo o agente a ler, claimar, reportar progresso e concluir com done.
Feature atrás do gate Pro — early access libera todos; com Stripe ativo, só assinantes Pro podem ativar.