Files
Aodhan Collins 41975ecfe2 Phase 2 complete
2025-10-12 02:18:56 +01:00
..
2025-10-12 02:18:56 +01:00
2025-10-11 21:21:36 +01:00
2025-10-12 02:18:56 +01:00
2025-10-11 21:21:36 +01:00

📚 Storyteller RPG Documentation

Welcome to the Storyteller RPG documentation hub. All project documentation is organized here for easy navigation.


📂 Documentation Structure

Features

Comprehensive feature documentation with examples and guides.

🚀 Setup Guides

Get started quickly with installation and configuration guides.

📋 Planning & Roadmap

Project vision, milestones, and future plans.

🔧 Development

Technical implementation details and testing.

📖 Reference

Technical guides and comprehensive references.


For New Users

  1. Start with Quickstart Guide
  2. 🎮 Try the Demo Session (pre-configured!)
  3. 📖 Review Features Overview to see what's possible
  4. 🤖 Check LLM Guide for model selection

For Developers

  1. 🔧 Read MVP Progress for current state
  2. 🧪 Check Testing Guide
  3. 📁 Review Project Files Reference
  4. 🚀 Follow Next Steps for contribution areas

For Storytellers

  1. 🎭 See Features Guide for all tools
  2. 🧠 Learn about Context-Aware Responses
  3. 💡 Use Quick Reference for common tasks
  4. 🎲 Start with Demo Session for practice

📊 Current Status (v0.2.0)

Completed Features

  • Private/public/mixed messaging system
  • Context-aware AI response generator
  • Demo session with pre-configured characters
  • Real-time WebSocket communication
  • Multi-LLM support (GPT-4o, Claude, Llama, etc.)
  • AI-assisted storyteller suggestions
  • Session ID quick copy
  • Full conversation history

🚧 Coming Soon

  • Database persistence
  • Character sheets & stats
  • Dice rolling mechanics
  • Combat system
  • Image generation
  • Voice messages

See MVP Roadmap for the complete timeline.


📝 Documentation Principles

This documentation follows these principles:

  • Progressive Disclosure: Start simple, dive deeper as needed
  • Always Current: Updated with each feature implementation
  • Example-Driven: Real code examples and use cases
  • Clear Structure: Logical organization for easy navigation
  • Feature-Focused: Detailed guides for every feature

🎯 Documentation Map

docs/
├── features/           ← Feature guides & examples
│   ├── README.md
│   ├── DEMO_SESSION.md
│   ├── CONTEXTUAL_RESPONSE_FEATURE.md
│   ├── PROMPT_IMPROVEMENTS.md
│   └── FIXES_SUMMARY.md
├── setup/              ← Installation & quick start
│   ├── QUICKSTART.md
│   └── QUICK_REFERENCE.md
├── planning/           ← Roadmap & future plans
│   ├── PROJECT_PLAN.md
│   ├── MVP_ROADMAP.md
│   └── NEXT_STEPS.md
├── development/        ← Technical & testing docs
│   ├── MVP_PROGRESS.md
│   ├── TESTING_GUIDE.md
│   └── TEST_RESULTS.md
└── reference/          ← Technical references
    ├── LLM_GUIDE.md
    └── PROJECT_FILES_REFERENCE.md

🤝 Contributing to Documentation

Found a typo or want to improve the docs? Contributions are welcome!

  1. Documentation lives in the docs/ folder
  2. Use clear, concise language
  3. Include examples where helpful
  4. Keep formatting consistent
  5. Update relevant indexes when adding new docs

Need help? Start with the Quickstart Guide or check the main README.


Last updated: October 11, 2025