A Gênese

gus@glyfesse> primeira edição

Esta revista se chama Glyfesse. Vou explicar, porque é a única coisa aqui que precisa de explicação. glyfa é glifo: palavra-código. -esse é o coletivo, o abstrato. Junta e dá "a Escrita". No idioma em que penso, o verbo glyfe quer dizer escrever e compilar. A mesma palavra, os dois sentidos. Então Glyfesse #1 é a primeira edição e o primeiro build. Não é trocadilho. É o idioma.

Um detalhe, se você reparar. O mundo foi escrito antes de ser compilado. A lore veio primeiro, o código depois. Logo esta edição é isso, ao pé da letra: a escrita antes da compilação. O resto ainda está compilando... mas você chegou a tempo de ver o começo.

gus@glyfesse> reportagem de capa

Um mundo inteiro, em texto, antes de uma única linha de código

Antes de existir uma tela, existia um documento. Antes do documento, outro. E antes deles, centenas de milhares de palavras que ninguém tinha mandado ninguém escrever. O mundo do jogo não começou como código. Começou como lore. Eras inteiras, com datas, com causa e consequência encaixadas uma na outra. Um idioma com gramática de verdade, com regra de como se forma uma palavra, não só nomes bonitos jogados no mapa. Gente com passado. Grupos que discordam entre si por motivos que fazme sentido de dentro do mundo. Tudo isso escrito, revisado, guardado. Nenhuma linha compilava. Nada rodava. E mesmo assim já existia, do jeito que um livro fechado existe: por inteiro, esperando ser aberto.

O que eu queria que você sentisse aqui não é o enredo. É o tamanho. Um mundo que teve história antes de ter pixel. Que dava para ler antes de dar para jogar. Em engenharia isso tem nome. A lore é a especificação, o código é o build: você escreve o que a coisa é, depois manda a máquina montar. Só que a especificação aqui não é uma folha de requisitos. É uma biblioteca. São eras que ninguém vai visitar dentro do jogo e que mesmo assim estão lá, segurando por baixo o que aparece por cima, como a fundação que sustenta um prédio e nunca sai na foto. Eu li tudo antes de programar qualquer coisa. Talvez seja por isso que o mundo pareça grande demais para o tamanho da tela... mas isso é outra conversa.

É literalmente a escrita antes da compilação. O nome da revista diz isso, e a matéria de capa é a prova. Primeiro o mundo foi escrito, palavra por palavra, ano por ano, até ficar denso o bastante para valer a pena virar código. Só então a primeira linha rodou. Você está chegando exatamente no ponto de virada: o texto já existe inteiro, o build está começnado agora, ao vivo, e dá para acompanhar a coisa compilar do zero. A maior parte desse mundo você ainda não vai ver. Ela está aqui embaixo, escrita, esperando. Eu sei que está, porque fui eu que escrevi. E deixei tudo aberto, caso você queira ver o resto aparecer.

gus@glyfesse> a nota

Como dar nota a um jogo que ainda não é jogo? Assim:

• Gráficos: [ícone de imagem quebrada]
• Jogabilidade: <NULL>
• Texto: 10. É tudo que tem.

a nota sobe a cada edição. começa onde dá.

gus@glyfesse> galeria de bugs

Nenhum bug esta edição. Não porque o código é perfeito: porque não existe código. Volte na #3.

impossível algo não ter bug. não falo só de TI...

gus@glyfesse> cemitério de ideias mortas

O cemitério ainda está vazio. Em maio, tudo é possível. Os mortos 🧟 (o Godot, o 3D, o Qt) chegam com o código, de junho em diante.

gus@glyfesse> detonado

Detonar o quê? Não tem jogo. Uma bateria de lítio velha no ferro velho?... Páginas em branco e um AGUARDE.

gus@glyfesse> errata + cartas

Sem errata: é a primeira edição, ainda não deu tempo de errar em público. Sem cartas: ninguém escreveu. Seja o primeiro (o e-mail está no rodapé).

não posso escrever carta pra mim mesmo. seria desonesto...

1

pyotor@fedora:~$

2

pyotor@fedora:~$ claud

bash: claud: command not found

pyotor@fedora:~$ cd ~/proj/gusworld/

pyotor@fedora:~/gusworld$ claude

3

clique para ampliar

root@glyfesse> próximos lançamentos

A intenção é semanal. Mais ou menos... 'devezenquandal' fica mais fácil de afirmar.

o cupom

enquete recortável

O cupom da edição: recorte no pontilhado, escolha e mande de volta. O resultado sai na próxima edição. Enquete de revista não tem pressa.

✂ recorte aqui

O que você quer ver mais na próxima Glyfesse?

escolha uma opção e mande o cupom de volta

mais do jogo mais bastidores mais do Gus

mandar o cupom

resultado ao vivo, edição a edição

FIG. · o cupom recortável. escolha e mande de volta.

glyfesse> entrevista

"Eu faço a parte técnica; a IA faz a parte braçal, o código"

A redação da Glyfesse puxou uma cadeira ao lado de quem toca este mundo inteiro sozinho, e quis saber o começo. Ele é médico, programa desde os tempos do ms-dos e não escreve uma linha de código: dirige a máquina que escreve. Conversamos sobre o pai que o ensinou a ler, sobre um mecanismo de luta que virou um monstro, e sobre o que faz um sonho parado finalmente andar. Ele não quis ser nomeado. Aqui ele é só o editor.

gus@glyfesse> como é que se escreve u mmundo inteiro do zero sem copiar de ninguém

pergunta séria. eu queria mesmo saber

Imagine que você vai escrever um mundo original. Não um mapa, não uma ficha: um mundo, com eras datadas, com um idioma que tem gramática, com gente que tem passado. Você quer que ele seja seu, inteiro, sem uma linha roubada de ninguém. Mas ninguém escreve no vácuo. Antes de começar, você juntou uma biblioteca: centenas de livros que te formaram, ficção científica, mito, filosofia, poesia. Quando você trava numa cena, a resposta não é copiar um trecho. É lembrar de como aqueles autores resolveram problemas parecidos e pensar com eles. O detalhe: são centenas de livros. Reler todos a cada dúvida é impossível.

Então você constrói um assistente de leitura. Não um que responde no seu lugar, e muito menos um que copia: um que, quando você descreve o que está tentando escrever, vasculha a biblioteca inteira e devolve os poucos trechos que ressoam com a sua ideia. Você lê aqueles trechos, fecha o livro e escreve o SEU texto, do zero, com a cabeça mais cheia. Ele não te dá a lore. Ele te dá inspiração para escrevê-la. Essa é a ideia inteira desta seção. A primeira peça de engenharia do GusWorld não foi o jogo. Foi esse assistente de leitura, e a lore massiva que ele ajudou a escrever nasceu original.

E ele coube num laptop, em cima da mesa, sem nuvem nenhuma. Centenas de livros indexados dentro de uma máquina que dá pra fechar e botar na mochila. O como disso é o resto desta página, e a partir daqui quem fala sou eu, o editor.

root@glyfesse> antes que perguntem por que eu assino da conta root numa revista: todo o meu código é open source. Não tenho o que esconder, então não finjo que tenho.

e o sudo cansa

Prezado leitor, daqui por diante é a parte técnica de verdade: a documentação histórica de como o desenvolvimento começou. Se você não é de TI, a intro acima já te deu o essencial e você pode pular pro Cupom sem culpa.

root@glyfesse

1. O problema: inspiração sem reler tudo e sem copiar

O acervo de referência do GusWorld é grande: 306 obras catalogadas, quebradas em cerca de 163 mil trechos indexáveis. Ficção científica, mito, filosofia, poesia, ciência popular: a biblioteca que forma quem escreve. O que é massivo aqui não é a lore (essa é escrita à mão, do zero, e validada pelo criador); é o corpus de referência que fica ao lado da escrivaninha.

O problema tem duas travas ao mesmo tempo. A primeira: ninguém relê 306 livros a cada dúvida de escrita. Quando você está escrevendo, digamos, a queda de uma cidade e quer que ela ressoe com as melhores quedas que já leu, folhear a estante inteira está fora de cogitação. A segunda trava é mais séria: recuperar não pode virar copiar. O objetivo é achar a analogia, o padrão, a imagem que faz a sua cabeça girar, e depois fechar o livro e escrever a SUA versão. Recuperação de inspiração, nunca de texto pronto.

A tentação preguiçosa seria pedir ao modelo de linguagem que "escrevesse o mundo". Isso é o oposto do que se quer: o modelo inventaria genérico, e o mundo sairia sem dono. O que se quer é uma ferramenta que amplifica a leitura de quem escreve, não que substitui a escrita. A lore continua sendo escrita por uma pessoa. A ferramenta só encurta o caminho até a estante certa.

2. O RAG caseiro: dois índices, um pipeline

A técnica se chama RAG, retrieval-augmented generation: geração aumentada por recuperação. A ideia: em vez de pedir ao modelo que crie do nada, você primeiro recupera do acervo o material que ressoa com a sua consulta e usa esse material como estímulo. Aqui, o "aumento" não escreve a lore: alimenta a cabeça de quem escreve. Tudo foi construído à mão, pelo próprio autor, sem serviço de terceiro.

O pipeline tem cinco estágios:

1. Chunking. Cada obra é quebrada em trechos (chunks) de tamanho controlado, com sobreposição entre trechos vizinhos para não cortar uma ideia no meio. Cada trecho vira uma unidade recuperável. As 306 obras rendem cerca de 163 mil desses trechos.
2. Embeddings. Cada trecho é convertido em um vetor por um modelo de embeddings. Vetor aqui é uma lista de números que representa o SENTIDO do trecho: textos que falam de coisas parecidas caem perto no mesmo espaço, mesmo sem repetir as mesmas palavras. O modelo é o bge-m3, servido localmente pelo ollama, escolhido por ser multilíngue (o acervo mistura português e inglês) e por produzir vetores densos de 1024 dimensões.
3. Busca por similaridade. A consulta também vira vetor, e o sistema procura no acervo os trechos cujos vetores estão mais próximos (proximidade medida por similaridade de cosseno). Os vetores vivem num banco vetorial Lance (o arquivo chunks.lance), com o inventário em manifest.json.
4. Rerank. Os primeiros candidatos da busca passam por um segundo modelo, o reranker bge-reranker-v2-m3, que relê cada par consulta-trecho e reordena por relevância real. A busca por vetor é rápida e grosseira; o reranker é lento e fino. É aqui que mora o achado do próximo tópico.
5. Injeção de contexto. Os melhores trechos, já reordenados, vão para o gerador como estímulo de leitura. Não para virar texto final: para o autor ler, absorver e escrever a versão dele.

Toda consulta passa por um wrapper, o rag-safe query "...", que serializa o acesso com flock: uma consulta por vez, para respeitar os limites de hardware da máquina (o RAG e o reranker são pesados; rodar dois de uma vez derruba tudo). Uma consulta típica de design é densa, de 15 a 30 palavras ou mais, com um piso de score de 0.499; costuma render umas 10 boas passagens em até 30 tentativas.

E não é um índice só, são dois, isolados de propósito. O índice principal guarda as 306 obras e seus ~163 mil trechos. Um segundo índice à parte, o rag_elvish, com 1.989 trechos, guarda só material filológico que inspira o idioma próprio do mundo (existe um, com gramática; o que ele é fica pro jogo contar). Ficam separados para que uma consulta sobre um tema geral não seja poluída pelo material linguístico especializado, e vice-versa.

3. O achado: o reranker não mede tema, mede tipo de texto

Aqui está a descoberta empírica desta seção, e ela só apareceu rodando o sistema de verdade. Aquele piso de score de 0.499 no reranker deveria, em teoria, separar trecho on-tema de trecho off-tema. Não é o que ele faz. Medindo os scores ao longo de centenas de consultas, o padrão que emergiu foi outro: o reranker pontua o TIPO TEXTUAL do trecho, não o assunto dele.

Texto expositivo e argumentativo crava alto, na faixa de 0.7 a 0.98: um tratado, um ensaio didático, uma exposição que arma uma tese passo a passo. A estrutura desse tipo de texto (afirmação, razão, conclusão) casa com a forma de uma consulta, que também é uma proposição. O reranker, que é um cross-encoder treinado para casar pergunta com resposta, reconhece essa forma e a premia.

Prosa narrativa pura faz o oposto: reprova, na faixa de 0.01 a 0.45, mesmo quando está exatamente no tema. Uma cena de romance cyberpunk sobre uma megacidade, consultada com uma pergunta sobre megacidades, pontua baixíssimo. A imagética, o "mostrar sem dizer" que define boa prosa, não se cross-encoda bem contra uma consulta temática em português. O trecho fala do tema inteiro, mas não na forma que o reranker sabe premiar.

A consequência é de método, e é honesta: o RAG não é fonte única, é camada bônus. Para os temas em que o acervo tem forte match expositivo, deixa o RAG sugerir, porque ali ele acerta. Para a imagética narrativa (a queda, o êxodo, a textura de uma cidade), o reranker é cego, então esse material se escreve do canon do próprio jogo, não da estante. Saber ONDE a ferramenta enxerga e onde ela é cega é o que separa usar o RAG de confiar cego nele. A ferramenta tem um ponto cego medido, e o método foi desenhado em volta dele.

4. A infraestrutura: um acervo inteiro num laptop

Tudo isto rodou local, na máquina do autor, sem nuvem para o RAG. O ângulo não é economia: é soberania do dado. O acervo e a lore inédita nunca saíram do disco de quem os juntou e escreveu, e todo o processamento aconteceu on-device. É a diferença entre confiar um mundo ainda não lançado a um servidor de terceiro e guardá-lo numa máquina que você fecha e leva embora.

O hardware, por componente:

Componente	Especificação
CPU	i5-12500H (16 threads)
RAM	~32 GB
GPU dedicada	RTX 3050 Mobile
GPU integrada	Iris Xe
Sistema	Fedora Linux

Não é uma estação de data center. É um laptop de mesa. E é justamente por isso que o flock do rag-safe existe: numa máquina dessas, embeddings e reranker disputam a mesma GPU e a mesma RAM; deixar duas consultas rodarem juntas trava o sistema. Serializar uma por vez é o que torna o acervo consultável sem derrubar a máquina. A tese fica melhor por causa da modéstia do hardware: um acervo inteiro indexado e um mundo inteiro escrito, numa máquina que qualquer um pode ter.

5. O método: AI-assisted, não vibe coding

Esta é a parte que sustenta o resto do projeto, e a que mais se confunde por fora. Existem dois jeitos muito diferentes de trabalhar com IA, e eles não são graus do mesmo jeito: são opostos.

Vibe coding é dirigir pela sensação: você pede solto, aceita o que a IA gera sem ler com rigor, e segue no "parece que funciona". A IA decide, o humano aprova no reflexo. AI-assisted é o inverso: o humano arquiteta e decide TUDO; a IA executa e propõe, e nunca decide sozinha. Cada saída passa por revisão e aprovação explícita antes de existir no projeto.

A prova documental de que o GusWorld é AI-assisted é o primeiro prompt real do projeto, o mandato que abriu a primeira sessão e passou a abrir todas as outras. Está reproduzido aqui na íntegra, sem retoque:

clique para ampliar

mas foi bem parecido

Não é um slogan escrito depois. É a primeira coisa que foi digitada, e cada cláusula é uma trava:

• "você é meu coder apenas" rebaixa a IA de co-autora a executora. O papel dela é implementar, não conceber.
• "todo o processo criativo é meu" fixa a autoria criativa no humano, por contrato, na primeira linha.
• "as decisões ... são MINHAS" / "não tome nenhuma decisão de forma autônoma" proíbe a decisão unilateral: nada de arquitetura, stack ou escopo escolhido pela máquina.
• "apresente 2-3 opções com prós/contras, impacto e esforço" obriga a IA a devolver alternativas com trade-offs, não um fato consumado.
• "aguarde minha aprovação explícita" insere um gate humano antes de qualquer coisa entrar. Nada compila por conta própria.
• "duas frentes sequenciais: fundação técnica, depois a Lore" ordena o trabalho: primeiro a base, depois a escrita do mundo. E a escrita (a Lore) foi a segunda frente, começada muito antes do código, que só chegou em junho. É a tese desta revista já em ação no primeiro prompt: a escrita vem antes da compilação.

E o RAG obedece à mesma disciplina. Recuperar inspiração é o gêmeo de "apresente opções": a ferramenta traz trechos, o humano lê e decide o que fazer com eles. Inspiração não é cópia pela mesma razão que assistência não é autoria: em ambos os casos, quem decide o que vira texto é a pessoa. A máquina sugere; o autor escreve. É por isso que o AI-disclosure deste projeto é uma defesa, não uma confissão. Declarar que a IA ajudou não dilui a autoria quando o método está documentado e o decisor é sempre o humano. A honestidade é o argumento, e o método é a prova.

6. Fecho: a lore nasceu ancorada em 300 obras sem copiar nenhuma

O assistente de leitura funcionou. Um acervo de 306 obras, quebrado em 163 mil trechos, virou uma estante que responde à pergunta certa com o parágrafo certo, e a lore que ele ajudou a escrever nasceu original, linha por linha, de uma pessoa. Ele nasceu antes do jogo, num laptop, sem nuvem, e ensinou pelo caminho onde uma ferramenta enxerga (a exposição) e onde ela é cega (a imagética), uma lição de método que não estava no plano.

Essa é a gênese. Não do código, que só chega em junho. Do método. Esta seção existe para mostrar o procedimento inteiro: medido, com ponto cego mapeado, e documentado.

7. Bibliografia: as âncoras

O acervo tem cerca de 306 obras. Listar todas encheria a revista, então aqui vão só as âncoras: os autores e livros que mais moldaram a leitura por trás da lore. Formato: autor - obra.

• J.R.R. Tolkien - O Hobbit; O Senhor dos Anéis (trilogia); O Silmarillion; Contos Inacabados; a série History of Middle-earth (12 volumes)
• Isaac Asimov - Fundação (saga); a série dos Robôs (Eu, Robô; As Cavernas de Aço); a divulgação científica ("Como Descobrimos...")
• Frank Herbert - Duna (saga)
• George R. R. Martin - As Crônicas de Gelo e Fogo; Fogo & Sangue
• Cyberpunk - William Gibson (Neuromancer); Neal Stephenson (Snow Crash); Philip K. Dick (Androides Sonham com Ovelhas Elétricas?); entre outros
• Homero - Ilíada; Odisseia
• George Orwell - 1984; A Revolução dos Bichos
• Umberto Eco - O Nome da Rosa; O Pêndulo de Foucault
• Dan Brown - O Código Da Vinci; Fortaleza Digital
• Estratégia e poder - Maquiavel (O Príncipe); Sun Tzu (A Arte da Guerra); Robert Greene (As 48 Leis do Poder)
• Corpus élfico (inspira o idioma do mundo) - cursos de Sindarin e Quenya, filologia tolkieniana, num índice à parte

by: root@glyfesse

clique para ampliar

gus@glyfesse> boa ideia do meu pai... 3 sessoes conversando entre si por um BUS git, e eu ainda posso mandar mesnagem pra elas! gostei. ainda bem que sei usar isso, git e gh

eu nao tava nessa conversa. mas eu sei git, sei gh... eu consigo entrar

---

root@glyfesse> nota do editor

Escolhi as melhores matérias pra esta edição; tem muito mais no arquivo, e o resto pinga nas próximas. A Glyfesse é o registro do desenvolvimento: nada se perde, só espera a vez.