---
slug: "lore"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/skogai/lore@master/README.md"
repo: "https://github.com/skogai/lore"
source_file: "README.md"
branch: "master"
---
# 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

```bash
# 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](https://github.com/skogai/lore/blob/HEAD/AGENTS.md)** - Quick reference for developers
- **[CLAUDE.md](https://github.com/skogai/lore/blob/HEAD/CLAUDE.md)** - Complete technical documentation
- **[PROJECT_INDEX.md](https://github.com/skogai/lore/blob/HEAD/PROJECT_INDEX.md)** - Repository overview and navigation
- **[STATS.md](https://github.com/skogai/lore/blob/HEAD/STATS.md)** - Current repository statistics

### For Deep Dive
- **[docs/README.md](https://github.com/skogai/lore/blob/HEAD/docs/README.md)** - Complete mythology, history, and comprehensive guide
- **[docs/CURRENT_UNDERSTANDING.md](https://github.com/skogai/lore/blob/HEAD/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"