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.

Economia inteligente

Context Router

Context Router é a camada de economia do Forkly. O Pilot continua montando o time do usuário, mas cada role recebe só um Task Contract inicial: objetivo, arquivos prováveis, critérios de aceite e contexto suficiente para começar.

O restante fica em .forkly/context-packs/<taskId>.json e pode ser carregado sob demanda com MCP. Assim o Forkly economiza sem cegar Task, Review, Testing ou Iris.

Task Contract
Briefing compacto enviado para o agent. Substitui dumps longos de conversa, logs e docs.
Context Pack
Arquivo local com contexto completo, critérios de aceite, memória, graph refs e Lore.
Refs
Ponte entre briefing curto e contexto completo. O agent busca só o que faltar.
Dashboard
Painel lateral com tokens evitados, economia líquida, compactação por role, fetches e alertas de overfetch.
  1. Pilot escreve um contrato

    Em vez de repassar a conversa inteira, o Pilot descreve objetivo, arquivos, restrições e aceite.
  2. Router materializa refs

    O contexto completo vira refs locais como full-context, done-criteria, memory, graph e lore.
  3. Agent busca quando precisar

    A role começa com o mínimo. Se faltar algo concreto, chama forkly_context_get ou forkly_context_search.
  4. Auto Sleep limpa o workspace

    Task, Review e Testing dormem após 2min idle. Iris fica por 30min. Pilot nunca dorme.

Se o dashboard mostrar Tokens evitados = 0, isso geralmente significa que o briefing já estava abaixo do budget da role. A economia também vem de Lore sob demanda, menos roles desnecessárias e panes concluídos saindo da frente.