Uma metodologia de engenharia de contexto para autores e criadores que desejam escrever romances e ficção longa com IA sem perder coerência nem consistência.
O cordel é uma metodologia e conjunto de ferramentas criado por Alex Santos para solucionar os problemas mais críticos da geração de textos longos com LLMs: perda de memória ao longo dos capítulos, contradições de causa e efeito (plot holes), mudanças repentinas de personalidade dos personagens e vazamento precoce de revelações do clímax (spoilers). Utilizando técnicas avançadas de gerenciamento de janela de contexto e rastreamento de estado em grafos direcionados, o cordel permite construir obras literárias coesas do início ao fim.
Visão macro de como o projeto processa requisições, gerencia dados e entrega valor técnico com máxima eficiência.
+--------------------+ +--------------------+ +--------------------+
| Bíblia do Mundo | ---> | Grafo Temporal & | ---> | Orçamento Restrito|
| (Worldbible) | | Estado do Person. | | de Janela Context.|
+--------------------+ +--------------------+ +--------------------+
|
+--------------------+ +--------------------+ v
| Manuscrito Final | <--- | Revisão Multi-Pass | <--- +--------------------+
| (Sem Plot Holes) | | (Plot, Tom, Estilo)| | Rascunho de Cena |
+--------------------+ +--------------------+ +--------------------+Decisões de design, algoritmos e técnicas aplicadas para garantir confiabilidade, segurança e excelência operacional.
O universo da história é dividido em arquivos atômicos de verdade: geografia, sistema de magia/tecnologia, fichas de personagens com limites de conhecimento e matriz de relacionamentos. A cada novo capítulo, apenas os fatos estritamente pertinentes à cena são injetados no contexto do modelo.
Cada evento da narrativa é registrado como um nó em um grafo de causa e efeito. Um personagem não pode saber de um segredo antes da cena de revelação, nem possuir um item que foi deixado em outro local em capítulos anteriores.
Os prompts de escrita são blindados com restrições temporais de revelação. O LLM recebe instruções claras sobre o que o leitor e os personagens devem presumir naquele momento exato, cultivando pistas sutis (foreshadowing) sem queimar o clímax antecipadamente.
A escrita de uma cena é dividida em etapas especializadas: Passada 1 (Esqueleto de Ações e Batidas Dramáticas), Passada 2 (Diálogos com Subtexto e Voz Própria), Passada 3 (Imersão Sensorial e Atmosfera) e Passada 4 (Polimento Sintático e Métrico).
Exemplo concreto de uso, configuração e integração técnica.
cordel-projeto/
├── worldbible/
│ ├── characters/
│ │ ├── helena_silva.md # Ficha com objetivos, falhas e inventário
│ │ └── davi_moraes.md # Segredos que Helena desconhece
│ ├── rules/
│ │ └── tecnologia.md # Regras físicas e limites tecnológicos
│ └── timeline.json # Grafo de causa e efeito timestamped
├── outlines/
│ ├── ato_1.md
│ └── ato_2.md
├── drafts/
│ ├── cap_01_rascunho.md
│ └── cap_01_revisado.md
└── scripts/
└── validate_continuity.py # Script de auditoria de consistênciaEsclarecimentos detalhados sobre funcionamento, licenças, compatibilidade e privacidade.
O cordel é primariamente uma metodologia de engenharia de prompts e arquitetura de contexto, complementada por scripts Python utilitários para validação de consistência e montagem de rascunhos.
Sim. A metodologia é agnóstica a provedor e obtém resultados extraordinários especialmente em modelos com forte raciocínio analítico e grandes janelas de contexto.
A licença CC0 1.0 (Domínio Público) foi escolhida para que escritores, roteiristas e estúdios possam adotar e comercializar suas histórias livremente sem amarras de propriedade intelectual.
Embora tenha sido concebido para livros inteiros de 50.000+ palavras, os princípios de worldbible e revisão em passadas elevam consideravelmente a qualidade de contos e novelas.