Entra uma base de código. Saem dois handbooks: um que a sua equipe lê, outro pelo qual o seu agente se orienta.
Seu agente de codificação faz grep de um símbolo, encontra três dos sete lugares que importam e entrega meia mudança. Isso não é falha de raciocínio: é falha de roteamento. O Handbooks dá a ele o mapa.
# pipeline inteiro, offline, sem chave de API, ~30 s
pnpm install && pnpm build
pnpm demoProjeto de exemplo embutido, LLM simulado embutido. Zero tokens gastos.
Sete comandos, um só ciclo
Os passos turquesa são determinísticos — sem LLM, sem rede, dá para reexecutar de graça na CI. Os passos âmbar falam com o seu endpoint e guardam em cache o que aprendem.
- 1
analyzeSEM LLMAnalisa cada arquivo num grafo de chamadas tipado.
- 2
generateLLMFichas, etapas, prosa, estado entre etapas.
- 3
renderSEM LLMMarkdown, HTML, índice para agentes, llms.txt.
- 4
skillSEM LLMEmpacota tudo para o seu agente de codificação.
- 5
planLLMLocaliza uma mudança em edições exatas ao byte.
- 6
applySEM LLMPatch tudo-ou-nada, com rollback.
- 7
resyncLLMAvança o handbook. Sem reconstruir.
- Como cada fase funciona →
Por que você pode confiar no que lê
Os fatos vêm de um parser
O tree-sitter constrói o grafo de chamadas: funções, arestas resolvidas, chamadas de borda e as chamadas que ele não conseguiu resolver — postas em quarentena, nunca adivinhadas. Essa camada nunca toca um LLM, então é a mesma em toda execução.
A prosa fica por cima, e diz isso
Um LLM escreve para que serve um arquivo e como um subsistema se encaixa, sempre ancorado no grafo. Onde falha, a estrutura ainda é entregue — com uma descrição vazia. Uma frase ausente é melhor do que uma inventada.
Feito para rotear, não para ler
A saída responde “quais arquivos, funções e estados esta mudança precisa tocar?” — inclusive os espalhados e nada óbvios que uma busca textual não acha. Depois o planner lê o código-fonte real em cada endereço.
Aplicar é chato de propósito
As âncoras precisam casar exatamente byte a byte e uma única vez. Tudo é verificado antes de qualquer escrita. Todo arquivo tocado é copiado junto com seu hash pré-patch, para que o rollback consiga provar o que está restaurando.
Ele se mantém atual de forma incremental
O resync compara o grafo antigo com o novo e regenera só o que realmente mudou. Toque três arquivos, pague por três arquivos. A documentação para de apodrecer porque atualizá-la parou de ser caro.
E ele declara os próprios limites
As linguagens lidas pelo analisador guiado por configuração são nomeadas na visão geral, para que “relações de chamada de melhor esforço” nunca passem por “exatas”.
Fidelidade da análise →Uma execução. Seis formatos de entrega.
A geração é a parte cara e acontece uma vez. Tudo abaixo é re-renderização determinística que você pode rodar a cada commit.
Handbooks em Markdown
visão geral · índice · uma página por etapa · tabela de registradores de estado
Site HTML multipágina
TOC fixo, breadcrumbs, troca de tema — funciona via file://
Uma página autocontida
um único .html para mandar por e-mail ou anexar a um ticket
Índice localizador para agentes
dever · conceitos de entrada · estado · exemplares · co-mudanças
llms.txt + llms-full.txt
a convenção llms.txt, mais o handbook inteiro achatado
Pacote SKILL de agente
SKILL.md + references/ + um hash de conteúdo por arquivo
Comece pelo comando gratuito
O handbook analyze nunca precisa de chave de API. Rode no seu repositório, olhe as contagens de arquivos e funções e decida se o resto vale um único token.