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.

Memória navegável

Atlas — grafo de memória

O Atlas transforma a memória do projeto num grafo navegável estilo "segundo cérebro". Unifica .forkly/memory.md, Lore, docs/decisions.md, docs/tasks-log.md e docs/*.md num único grafo com wikilinks bidirecionais, backlinks e conexões sugeridas. Escopo por-projeto — não substitui nenhum fluxo existente, é camada de visualização.

  1. Fontes indexadas

    Cada seção de memória, decisão, task-log, doc de feature e skill Lore vira um nó tipado (memory, decision, task-log, feature-doc, lore). Wikilinks [[slug]] sem alvo geram nós ghost.
  2. Arestas explícitas e sugeridas

    Wikilinks viram arestas sólidas (explicit). O Lore calcula similaridade (jaccard) e propõe até 5 conexões tracejadas (suggested) por nó, sem duplicar links já explícitos.
  3. Backlinks

    Para cada aresta A→B, o nó B expõe A na seção "citado por" do painel lateral — contexto reverso sem abrir arquivos.
  4. Constelação navegável

    Canvas react-force-graph-2d com orbes por tipo, zoom/pan/drag e painel lateral com excerpt, backlinks e sugestões. Botão "enquadrar" recentraliza o grafo.
Como abrir
Painel direito → Plugins → card Atlas explorar →. Overlay fullscreen; fechar com ×, ESC ou clique no backdrop.
Cache
O grafo é cacheado em memória e invalidado por mtime das fontes — reabrir sem mudanças é instantâneo.