Start Here: Your RitualOS Journey

Welcome to RitualOS! This guide will help you understand what RitualOS is, how it works, and how you can participate in or build on top of the ecosystem.

What is RitualOS?

RitualOS is a digital civilization platform where:

• Your identity is singular and verifiable
• Your actions have lasting consequences
• Your reputation is built through verifiable credentials
• Your contributions are preserved in immutable memory

It's not a game. It's not a social network. It's not a marketplace. It's an operating system for ritualized participation—a system designed to coordinate human action at scale through meaningful incentives and legitimate governance.

The Four Pillars

1. Identity Layer

Everything starts with identity. In RitualOS, you have exactly one canonical identity that:

• Is issued by the ID Service (id.ritualos.com)
• Includes your House (behavioral profile)
• Includes your Archetype (playstyle classification)
• Stores your Credentials (verifiable achievements)

Key Principle: No other service may create, alter, or infer identity attributes. Identity flows downward from the ID Service to all other services.

2. Action Layer

Once you have an identity, you can take action through various services:

• Path: Complete quests and daily rituals to earn XP and Gold
• Learn: Take courses and master skills
• Guild: Find work, contribute to projects, and build reputation
• Scroll: Write cultural narratives and preserve memory

Key Principle: Only the Path Service may mint XP and Gold. Other services request rewards, which Path validates and issues.

3. Settlement Layer

All actions result in immutable records:

• Ledger: An append-only archive of all transactions
• Market: An asset marketplace (consuming credentials, never producing authority)

Key Principle: The Ledger never decides—it only records. What is written cannot be unwritten.

4. Governance Layer

Legitimacy-based decision making:

• Governance: Proposals and voting
• Voting power derives from credentials (identity-based, not token-weighted)
• Governance cannot retroactively alter identity or ledger records

Key Principle: Legitimacy is earned, not aggregated. Wealth does not equal voting power.

Your First 30 Minutes

Step 1: Create Your Identity (5 min)

1. Visit any RitualOS service (e.g., governance.ritualos.com)
2. Click "Sign In"
3. Complete the OAuth flow with the ID Service
4. Your identity is created with:
   • A unique ID
   • A temporary House (will be updated based on behavior)
   • A basic Archetype

Step 2: Explore Your Passport (5 min)

Your Passport is your digital identity card. It shows:

• House: Dawn, Zenith, or Twilight (determined by behavior patterns)
• Archetype: Explorer, Creator, Leader, or Guardian
• Credentials: Badges and achievements you've earned
• Level & XP: Your progression in the ecosystem

Step 3: Complete Your First Quest (10 min)

Head to the Path Service (path.ritualos.com) and:

1. Browse available quests
2. Complete a simple daily ritual
3. Earn your first XP and Gold
4. Receive your first credential: "Path Initiate"

Step 4: Join the Conversation (10 min)

Visit the Scroll Service (scroll.ritualos.com) and:

1. Read existing scrolls from your house
2. Write your first scroll (public or house-only)
3. Earn settlement weight based on engagement

Understanding Houses and Archetypes

Houses

Houses are not chosen—they're discovered through behavior:

• Dawn: Explorers and early adopters who prioritize novelty
• Zenith: Builders and creators who prioritize creation
• Twilight: Scholars and preservers who prioritize continuity

Your House may change over time as your behavior patterns evolve.

Archetypes

Archetypes describe how you interact with the system:

• Explorer: Driven by discovery and new experiences
• Creator: Focused on building and making
• Leader: Naturally coordinates and guides others
• Guardian: Values stability and protection

The Credential System

Credentials are verifiable attestations about your identity and achievements. They:

• Are issued by services but stored in the ID Service
• Can be soulbound (non-transferable) or transferable
• Form the basis of governance legitimacy (voting power)
• Unlock special abilities across services

Example Credentials

Key Rules to Remember

1. One Identity, One Life: You can only have one RitualOS identity
2. Actions Have Consequences: Everything is recorded in the Ledger
3. Reputation Over Wealth: Credentials matter more than tokens
4. Culture is Protected: Meaning cannot be optimized away
5. Governance is Legitimacy-Based: Your votes count based on what you've done, not what you own

What's Next?

For Users

• Complete the Quick Start Guide
• Learn about earning credentials
• Understand house progression

For Developers

• Read the API Reference
• Set up OAuth integration
• Understand the architecture

For Operators

• Deploy your own RitualOS instance
• Configure environment variables
• Set up monitoring

Need Help?

• Check the Troubleshooting Guide
• Review Common Issues
• Join the community Discord (coming soon)

---

Welcome to RitualOS. Your journey begins now.