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.

Desenvolvimento guiado por spec

Blueprint (Spec Mode)

Quando o projeto tem um diretório docs/begin/ com os artefatos SDD, o Pilot entra em modo autônomo. Ordem de leitura obrigatória:

docs/begin/
├── constitution.md  ← princípios inegociáveis
├── PRD.md           ← requisitos de produto
├── spec.md          ← user stories + acceptance criteria
├── plan.md          ← arquitetura + fases
└── tasks.md         ← lista de tasks (lido por grep, nunca inteiro)

Em modo autoChain (Pro), o Pilot identifica batches paralelizáveis (até 5 tasks) respeitando dependências, conflitos de arquivo e limites de fase. Despacha tudo num turn e processa os resultados juntos. Para quando termina, quando o dev manda nova mensagem, ou quando 3 batches seguidos têm failure.

Cada task concluída gera um doc em docs/[feature].md e uma entrada em docs/tasks-log.md. Ambiguidades vão pra docs/decisions.md — Pilot nunca improvisa quando a spec tem lacuna.

O painel Blueprint (tab strip lateral direita) mostra o progresso visual: tasks concluídas, em execução e pendentes, com watcher de arquivo em tempo real. Inclui wizard pra criar docs/begin/ do zero quando o projeto não tem spec ainda.