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.

Conceito central

Multi-agent paralelo

O Pilot é a thread principal — conversa com você, decompõe pedidos e despacha tasks via MCP (forkly_spawn). Os roles que executam trabalho especializado:

Task
Implementa código (features, refactor, bugfix, integrações). Pool até 3 vivos simultaneamente.
Review
Revisa implementação ou PR. Pool até 3.
Testing
Escreve testes ou orienta cobertura. Pool até 3.
Iris
Design / UI / identidade visual / motion. Singleton — uma instância ativa por vez.
Ask
Modo read-only no Studio pra perguntar sem efeito colateral (sem editar nada).

Cada pane tem status em tempo real (running, thinking, done, error). Spawns além das vagas entram em fila — quando um agent fica idle, puxa a próxima task automaticamente.

Depois de concluir, roles operacionais entram em Auto Sleep: Task, Review e Testing após 2 minutos idle; Iris após 30 minutos para preservar contexto visual. O Pilot nunca dorme.

A comunicação Pilot ↔ agents é 100% via MCP: forkly_spawn, forkly_next_task, forkly_complete, forkly_await_done. Watchdog de 20min detecta agents travados.