# Quick Start: OpenViking GitHub Edition

Welcome to OpenViking! This guide helps you understand what this repository contains, how to explore it, and what to do next.

## What This Repository Is (and Isn't)

This is the **GitHub Edition** of OpenViking -- a public base version designed to demonstrate capability, not a full commercial product.

**You will find here:**
- Core memory compilation and orchestration logic
- Basic working examples
- Supervisor skill patterns
- Architecture documentation

**You will NOT find here:**
- A one-click installer
- Full production deployment tooling
- Enterprise governance features
- Commercial support

This is intentional. The GitHub Edition exists to help you verify the approach and build trust before deciding to upgrade.

## Step 1: Understand the Core Problem

OpenViking solves "how should an agent manage memory," not just "can we store a memory."

Start by reading the [README.md](../README.md) to understand:
- What problems OpenViking solves
- What's included in this edition
- The three-tier edition strategy

## Step 2: Explore the Supervisor Skill Example

This repository includes a practical supervisor skill that demonstrates structured knowledge packaging.

Go to [supervisor/skills/video-prompt-engineering/SKILL.md](../supervisor/skills/video-prompt-engineering/SKILL.md) to see:
- How structured memory/prompt packages are defined
- How input contracts normalize messy user requests
- How output contracts deliver reliable, reusable results
- How references and examples accumulate knowledge over time

This skill shows the kind of structured, verifiable capability that OpenViking orchestrates.

## Step 3: Review Edition Boundaries

Read [docs/editions.md](./editions.md) to understand:
- What capabilities are included in each edition
- Where the GitHub Edition stops
- What you get with Pro and Enterprise

This helps you decide when you might want to upgrade.

## Step 4: Try the Concepts

While this edition doesn't include a full installer, you can:
1. Study the core concepts in the documentation
2. Examine the supervisor skill pattern
3. Understand how memory compilation works
4. Map these patterns to your own agent projects

The goal is to verify that the approach makes sense for your use case.

## When to Stay on GitHub Edition

The GitHub Edition is perfect if you:
- Are exploring and learning
- Want to understand the architecture
- Are prototyping concepts
- Don't need production deployment yet
- Are comfortable with self-support

## When to Upgrade to Pro

Consider upgrading to Pro Edition when you:
- Need a standard installer
- Want acceptance verification
- Need upgrade/rollback capability
- Want basic audit reports
- Need standard support

## When to Consider Enterprise

Consider Enterprise Edition when you:
- Need offline execution windows
- Require full audit evidence
- Need strict production governance
- Operate in regulated environments
- Want enterprise-grade support

## Next Steps

1. Read the [README.md](../README.md) if you haven't yet
2. Explore the [supervisor skill example](../supervisor/skills/video-prompt-engineering/SKILL.md)
3. Review [edition boundaries](./editions.md)
4. Check the [architecture overview](./architecture.md)
5. Learn about [pricing and upgrade paths](./pricing-and-upgrade.md)