Lore - Digital Mythology Generation System

Multi-agent system that transforms technical changes (git commits, code changes, chat logs) into narrative lore entries. Acts as persistent memory for AI agents using narrative compression.

Quick Start

# View stats
argc list-books
argc list-entries

# Create lore from git commit
./integration/lore-flow.sh git-diff HEAD

# Manual lore creation
./integration/lore-flow.sh manual "Fixed quantum mojito mixer bug"

# Create entry directly
tools/manage-lore.sh create-entry "The Discovery" "lore"

Core Concepts

• Entry - Atomic unit of lore (character, place, event, object, concept)
• Book - Collection of entries organized by theme/persona
• Persona - AI character profile with unique voice and traits
• Context - Session state binding data+agent+time+history

Architecture

Git Commit → Extract → Persona Selection → LLM Generation → Store as JSON

Files stored in knowledge/expanded/lore/ as JSON with schema validation.

Documentation

For Developers

• AGENTS.md - Quick reference for developers
• CLAUDE.md - Complete technical documentation
• PROJECT_INDEX.md - Repository overview and navigation
• STATS.md - Current repository statistics

For Deep Dive

• docs/README.md - Complete mythology, history, and comprehensive guide
• docs/CURRENT_UNDERSTANDING.md - Latest system understanding
• 1211 lore entries - Narrative units
• 107 books - Collections
• 93 personas - AI characters

The Prime Directive

"Automate EVERYTHING so we can drink mojitos on a beach"