CREATIVE AI · PROMPT ENGINEERING

cordel

A systematic, context-aware framework for authoring coherent long-form novels and stories using AI assistance.

Discipline
Narrative AI
Language
Python / Markdown
License
CC0-1.0 (Public Domain)
Focus
Zero Plot Holes

Executive TL;DR — Engineering Brief

cordel is a structured writing methodology created by Alex Santos that overcomes the context decay problem in LLM-assisted storytelling. By dividing narrative production into modular world-bibles, character trackers, and outline stages, cordel guarantees flawless continuity.

DIAGRAM & WORKFLOW

Phase-Driven Writing Pipeline

From core premise to world-bible, beat sheet, chapter drafts, and continuity auditing.

DETAILED ENGINEERING

Core Technical Pillars

Design choices, architectural patterns, and engineering decisions implemented for extreme reliability and developer experience.

01

Worldbible & Character State Tracking

External memory stores preventing hallucinations and personality drifts

Maintains structured markdown registries of character traits, relationships, knowledge states, and inventory, injected dynamically as targeted context.

02

Hierarchical Scene Outlining

Decomposing chapters into beat-level prompts with explicit narrative goals

Prevents meandering narrative by constraining each generation step to specific scene conflicts, character turns, and emotional beats.

03

Continuity Verification & Consistency Auditing

Self-correcting revision cycles that catch plot holes before publishing

Specialized auditor prompts cross-reference newly written prose against previous chapters to verify timeline integrity and character motivation.

04

Public Domain Knowledge Base

Released under CC0-1.0 for writers, creators, and game developers

Freely usable for commercial authors, game designers, and screenwriters seeking to integrate AI without sacrificing artistic cohesion.

CODE IN ACTION

Structure of a cordel Narrative Project

Real-world usage, terminal configuration, and technical integration commands.

Terminal Example SHELL
book-project/
├── 01_worldbible/
│   ├── characters.md       # Knowledge states, arcs, voice guidelines
│   ├── setting.md          # Geography, magic systems, technology rules
│   └── timeline.md         # Canonical chronological events
├── 02_outline/
│   ├── master_beats.md     # 3-act or 5-act narrative framework
│   └── chapter_01_beats.md # Granular scene goals
└── 03_drafts/
    ├── ch01_draft_v1.md
    └── ch01_revised.md
QUESTIONS & ANSWERS

Technical Frequently Asked Questions

Key clarifications regarding licensing, compatibility, deployment, and security.

Which AI models work best with cordel?

Claude 3.5 Sonnet, GPT-4o, and DeepSeek-V3 excel due to their strong stylistic nuances and reasoning capabilities.

Can cordel be used for non-fiction or game lore?

Yes. The world-bible and state tracking principles apply equally well to RPG game design and worldbuilding.

Is any software installation required?

No special dependencies required; cordel works with standard Markdown files and any LLM interface.

How does cordel prevent repetitive AI writing tropes?

By providing strict negative constraints and emphasizing physical sensory details over abstract exposition.