Velith — pipeline de criação de conteúdo longo com IA

Olá.

Originalmente, este não era um projeto que começou com a ideia de fazer um livro.

No dia a dia, eu gerenciava conhecimento com o Obsidian e o conectava a agentes de IA como o Claude Code para organizar documentos ou gerar relatórios técnicos. A ideia era analisar as notas, organizar suas relações e até gerar automaticamente documentos técnicos sobre temas específicos.

Um dia, de repente, pensei o seguinte:

Já tenho centenas de notas acumuladas no Obsidian; será que não daria para fazer um livro com isso?

Então, no começo, criei um workflow para geração de relatórios técnicos. Depois adicionei white papers, tutoriais, não ficção e vários outros gêneros com a mentalidade de "vamos ver até onde isso pode chegar". Quando percebi, já não era mais um simples gerador de documentos, mas sim um pipeline de escrita de livros que vai da ideia ao resultado final de publicação.

Organizei tudo isso e publiquei com o nome Velith.

GitHub: https://github.com/epicsagas/Velith

Que tipo de projeto é esse?

Velith é um workflow de criação de conteúdo longo que roda em ambientes com agentes de IA. Foi desenvolvido principalmente com Claude Code, mas também funciona em ambientes de agentes como Codex CLI e Antigravity.

Em vez de gerar um livro com um único prompt, ele foi projetado para seguir o mais de perto possível o processo real de escrita humana.

/book-ideation   → exploração do tema e definição do conceito  
/book-outline    → desenho do sumário e da estrutura  
/book-draft      → escrita do rascunho por capítulo  
/book-edit       → revisão de estilo e consistência  
/book-publish    → saída em EPUB / PDF  

Com um único comando, o agente executa aquela etapa, e a decisão de seguir para a próxima fica com a pessoa.

Em que situações os resultados são melhores

Os resultados melhoram de forma bem clara quando existe um vault do Obsidian ou um workspace em que os materiais já foram reunidos. Em especial, quando há conexões entre as notas, como em um Zettelkasten ou uma LLM Wiki, o agente tende a acompanhar melhor o contexto. Testei isso diretamente em um vault que opero com Zettelkasten, e o resultado foi visivelmente diferente de quando havia apenas recortes reunidos de forma dispersa.

Mais do que esperar que a IA escreva um livro do zero, a proposta está mais próxima de um workflow que transforma notas, pesquisas e memos já organizados em um resultado estruturado. Funciona melhor quando você tem muito material acumulado, mas ainda não conseguiu organizá-lo em forma de livro ou documento.

Até onde eu testei

Na prática, já consegui gerar resultados com mais de 100 páginas. Testei gêneros como livro técnico, ficção e ensaio, e a exportação para EPUB e PDF funciona bem.

Mas, para ser sincero, o nível do resultado atual é algo como "dá para ler, mas não está perfeito". Em especial, os arquivos EPUB e PDF ainda ficam bem aquém do ideal para uso imediato e exigem bastante trabalho manual. Ele combina mais com um workflow em que se gera um rascunho rapidamente e depois uma pessoa faz o refinamento.

Daqui para frente

Ainda é um projeto que continuo desenvolvendo por interesse pessoal e diversão, então há muitos pontos a melhorar.

Se você mantém uma base de conhecimento pessoal no Obsidian, Notion ou algo parecido e vive pensando "um dia preciso transformar isso em livro", ou se já tentou escrever documentos longos com agentes de IA e ficou frustrado porque o contexto se perdia no meio do caminho, eu gostaria de conversar.

Feedback é bem-vindo.

Documentação em coreano