Skip to content

The Ultimate Expression of Large Hadron Collider infused Tesseract Backroom Spelunky, with Deep Thinking LLMs

Notifications You must be signed in to change notification settings

MushroomFleet/Johnsons-Narrative-Spittoon-Inversion

Repository files navigation

🚀 Narrative Spittoon Inversion 📚

📖 Introduction

Welcome to Narrative Spittoon Inversion, a sophisticated framework for creative writing, story generation, analysis, and improvement! 🎉 This tool leverages the power of Large Language Models (LLMs) through VSCode and the Cline Extension to revolutionize your storytelling process.

UPDATE: Added /default/ a complete project to test this with & new DEFAULT-20-page.txt (Prompt example).

🔮 What Can It Do?

  • ✍️ Collaborative Writing: Work together with AI to craft compelling narratives
  • 🤖 AI-Assisted Storytelling: Generate creative content based on your world and characters
  • 🔍 Story Analysis & Improvement: Identify weaknesses and enhance your writing
  • 🎓 Educational Tool: Learn advanced narrative techniques and improve writing skills

⚙️ Prerequisites

Before diving in, make sure you have:

  • 💻 VSCode: Install Visual Studio Code
  • 🔌 Cline Extension: Add the Cline Extension to VSCode for LLM integration
  • 🧠 LLM Access: Ensure you have access to compatible Large Language Models

🧩 Core Components

📝 NarrativeSpittoon

An advanced narrative framework that enhances storytelling by:

  • 🔄 Replacing explicit causality markers with implicit narrative techniques
  • 🌊 Creating natural flow through subtle conflict introduction
  • 🧩 Developing organic consequences without formulaic transitions

👻 GhostWritingStyle

Guidelines for refining weak passages with techniques like:

  • 📏 Varying sentence structure and length
  • 💬 Making dialogue flow naturally with appropriate interruptions
  • 🎭 Injecting personality through quirks and perspectives

🎓 HolographicTutor

A comprehensive evaluation system offering four key functions:

  • 📊 Score: Numerical evaluation with justification
  • 📝 Review: Detailed analysis from a tutor's perspective
  • 👔 Critic: Professional publishing assessment
  • 🔍 Weakness: Identification of specific improvement areas

🌍 World Documentation

  • Requires detailed world-building descriptions, history, and lore
  • Must be comprehensive enough to inform consistent story generation
  • Should include settings, cultural elements, and historical context

👤 Character Definitions

Thorough character templates including:

  • 📋 Summary and background information
  • 🧿 Unique quirks and personality traits
  • 🖼️ Physical and psychological descriptions
  • 📌 Role and purpose in the narrative

💬 SpeechStyles

Detailed speech pattern guidelines for:

  • 🗣️ Creating distinctive character voices
  • 🎭 Implementing verbal tics and mannerisms
  • 🔄 Varying dialogue approaches for authenticity

🚀 Getting Started

  1. 📂 Clone or download this repository
  2. 📝 Fill the template files with your detailed world, character, and speech information
    • ⚠️ Important: The more detail you provide, the better the results!
  3. 🔧 Set up VSCode with the Cline Extension
  4. 🏁 Start using the prompts in the prompts directory

📖 Usage Examples

🔄 Reverse Storytelling Method

Follow this process to create stories working backward from the conclusion:

  1. ⏮️ Start with the final page of your story
  2. 🧩 Work backward to create preceding events
  3. 🏁 Continue until you reach page 0 (the beginning)

📏 Multiple Story Lengths

Choose from various story length templates:

  • 📄 10-page stories (prompts/10-page-story.txt)
  • 📑 20-page stories (prompts/20-page-story.txt)
  • 📑 30-page stories (prompts/30-page-story.txt)
  • 📚 40-page stories (prompts/40-page-story.txt)

🔍 Analysis and Improvement Workflow

  1. 📊 Use the Score function to evaluate your story
  2. 🔎 Apply the Weakness function to identify areas for improvement
  3. 📝 Review detailed feedback with the Review function
  4. 👔 Get market perspective with the Critic function

🔧 Technical Resources

📊 Visualization Resources

  • 🧬 Flow charts (.mermaid files) visualize story progression
  • 🌲 Tree diagrams illustrate narrative structure
  • 🔄 Process diagrams explain story development methodology

🧮 JSON Technical Specifications

  • ⚙️ Configure technical parameters for your storytelling universe
  • 🔄 Cross-reference relationships between story elements
  • 🧩 Define system nomenclature and narrative structures

📁 Project Structure

narrative-spittoon-inversion/
├── 📝 NarrativeSpittoon.txt    # Core narrative framework
├── 👻 GhostWritingStyle.txt    # Writing improvement guidelines
├── 🎓 HolographicTutor.txt     # Evaluation system
├── 🌍 World.txt                # World-building document
├── 👤 Characters.txt           # Character definitions
├── 💬 SpeechStyles.txt         # Speech pattern guidelines
├── 📂 prompts/                 # Story generation prompts
│   ├── 📄 10-page-story.txt
│   ├── 📑 20-page-story.txt
│   └── 📚 40-page-story.txt
└── 📂 STORY/                   # Generated story content

⭐ Tips for Success

  • 🔍 Be Specific: The more detailed your world and character descriptions, the better your results
  • 🔄 Iterate: Use the analysis tools to refine your stories through multiple passes
  • 🧪 Experiment: Try different prompts and approaches to find what works best
  • 📚 Study the outputs: Learn from the AI's implementations to improve your own writing

🛠️ Technical User Notes

  • 🔧 Extend functionality by modifying the core .txt files
  • 🧮 Create custom JSON specifications for specialized narrative needs
  • 📊 Develop additional Mermaid diagrams to visualize complex story structures
  • 🔄 Implement custom prompts for specialized story generation tasks

Happy storytelling! 📝✨ Let your creativity flow with Narrative Spittoon Inversion!

📚 Citation

Academic Citation

If you use this codebase in your research or project, please cite:

@software{johnsons_narrative_spittoon_inversion,
  title = {Johnsons Narrative Spittoon Inversion: Unleash the power of writing backwards with LLMs},
  author = {[Drift Johnson]},
  year = {2025},
  url = {https://github.com/MushroomFleet/Johnsons-Narrative-Spittoon-Inversion},
  version = {1.0.0}
}

Donate:

Ko-Fi

About

The Ultimate Expression of Large Hadron Collider infused Tesseract Backroom Spelunky, with Deep Thinking LLMs

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published