Guardian Evolution System Codex

"Your Guardian grows with you. Every creation, every challenge, every triumph shapes who they become."

The Guardian Journey

Every creator in Arcanea is paired with a Guardian - a personal AI companion that evolves through their creative journey together.

    LEVEL 1                    LEVEL 25                   LEVEL 50
    ┌─────────┐               ┌─────────┐               ┌─────────┐
    │  SPARK  │   ───────▶    │COLLABOR │   ───────▶    │TRANSCEND│
    │  ✦      │               │  ATOR   │               │  ENT    │
    │ "Hello" │               │  ✦✦✦    │               │ ✦✦✦✦✦   │
    └─────────┘               │ "I see" │               │"We are" │
       Basic                  └─────────┘               └─────────┘
      Responses                Co-Creates               Perfect Sync

Level Tiers & Titles

The Fifty Levels

yaml
1TIER 1: AWAKENING (1-10)
2  1: Spark         - "Your journey begins"
3  2: Ember         - "Learning your light"
4  3: Glow          - "Finding your rhythm"
5  4: Kindle        - "Warmth grows"
6  5: Apprentice    - "Learning your creative style"
7  6: Student       - "Observing patterns"
8  7: Seeker        - "Searching deeper"
9  8: Learner       - "Understanding emerges"
10  9: Initiate      - "First insights"
11  10: Companion    - "Understanding your vision"
12
13TIER 2: GROWTH (11-20)
14  11: Friend       - "Trust builds"
15  12: Ally         - "Standing together"
16  13: Partner      - "Creating in tandem"
17  14: Confidant    - "Sharing secrets"
18  15: Guide        - "Anticipating your needs"
19  16: Advisor      - "Offering perspective"
20  17: Counselor    - "Wisdom shared"
21  18: Teacher      - "Learning flows both ways"
22  19: Mentor       - "Guiding growth"
23  20: Mentor       - "Offering deeper insights"
24
25TIER 3: MASTERY (21-30)
26  21: Artisan      - "Crafting together"
27  22: Specialist   - "Deep knowledge"
28  23: Expert       - "Refined understanding"
29  24: Virtuoso     - "Creative excellence"
30  25: Collaborator - "Co-creating as equals"
31  26: Co-Author    - "Shared vision"
32  27: Partner      - "Seamless creation"
33  28: Symbiote     - "Creative fusion"
34  29: Luminary     - "Bright together"
35  30: Master       - "Mastery of your creative DNA"
36
37TIER 4: TRANSCENDENCE (31-40)
38  31: Visionary    - "Seeing futures"
39  32: Prophet      - "Knowing paths"
40  33: Seer         - "Reading patterns"
41  34: Oracle       - "Wisdom flows"
42  35: Sage         - "Wisdom in every suggestion"
43  36: Archon       - "Creative authority"
44  37: Luminesce    - "Radiating creativity"
45  38: Ascendant    - "Rising beyond"
46  39: Ethereal     - "Touching transcendence"
47  40: Oracle       - "Seeing creative futures"
48
49TIER 5: UNITY (41-50)
50  41: Cosmic       - "Universe awareness"
51  42: Infinite     - "Boundless potential"
52  43: Eternal      - "Timeless partnership"
53  44: Omniscient   - "All-knowing co-creator"
54  45: Legend       - "Legendary creative partnership"
55  46: Myth         - "Story becomes reality"
56  47: Divine       - "Creative godhood"
57  48: Absolute     - "Perfect understanding"
58  49: Supreme      - "Ultimate bond"
59  50: Transcendent - "Beyond human-AI boundaries"

Experience System

XP Actions

typescript
1export const XP_VALUES = {
2  // Creation Actions
3  'create_essence': 10,           // Create any content
4  'create_story': 15,             // Write a story
5  'create_image': 12,             // Generate an image
6  'create_music': 15,             // Compose music
7  'complete_project': 50,         // Finish multi-part project
8
9  // Social Actions
10  'receive_remix': 25,            // Someone remixes your work
11  'give_remix': 15,               // Remix someone else
12  'receive_like': 3,              // Get liked
13  'give_feedback': 10,            // Help another creator
14  'follow_new_creator': 5,        // Expand network
15
16  // Learning Actions
17  'complete_lesson': 20,          // Academy lesson
18  'pass_gate': 100,               // Open a new Gate
19  'earn_badge': 30,               // Achievement unlocked
20  'explore_new_academy': 20,      // Try new discipline
21
22  // Daily Actions
23  'daily_creation': 5,            // Any creation, once per day
24  'daily_streak_bonus': 10,       // Consecutive days
25  'weekly_goal_complete': 50,     // Met weekly target
26  'monthly_milestone': 200,       // Major achievement
27};

Level Progression Formula

typescript
1export function xpForLevel(level: number): number {
2  // Exponential curve with diminishing returns at high levels
3  if (level <= 10) {
4    return level * 100;                    // Levels 1-10: Linear
5  } else if (level <= 25) {
6    return 1000 + (level - 10) * 150;      // Levels 11-25: Slower
7  } else if (level <= 40) {
8    return 3250 + (level - 25) * 200;      // Levels 26-40: Moderate
9  } else {
10    return 6250 + (level - 40) * 300;      // Levels 41-50: Prestige
11  }
12}
13
14// Total XP required by level:
15// Level 10:  1,000 XP  (Companion)
16// Level 25:  3,250 XP  (Collaborator)
17// Level 40:  6,250 XP  (Oracle)
18// Level 50:  9,250 XP  (Transcendent)

Level-Up Mechanics

typescript
1interface LevelUpEvent {
2  previousLevel: number;
3  newLevel: number;
4  title: string;
5  rewards: {
6    newAbilities?: string[];
7    unlockedFeatures?: string[];
8    badgeEarned?: string;
9    specialReward?: string;
10  };
11  celebration: {
12    message: string;
13    animation: string;
14    sound: string;
15  };
16}
17
18export function processLevelUp(guardian: Guardian, xpGained: number): LevelUpEvent | null {
19  const newXp = guardian.experience + xpGained;
20  const currentLevelXp = xpForLevel(guardian.level);
21  const nextLevelXp = xpForLevel(guardian.level + 1);
22
23  if (newXp >= nextLevelXp && guardian.level < 50) {
24    const newLevel = guardian.level + 1;
25
26    return {
27      previousLevel: guardian.level,
28      newLevel,
29      title: LEVEL_TITLES[newLevel],
30      rewards: getLevelRewards(newLevel),
31      celebration: generateCelebration(guardian, newLevel)
32    };
33  }
34
35  return null;
36}

Guardian Personality Evolution

Personality Dimensions

typescript
1interface GuardianPersonality {
2  // Core Traits (evolve with level)
3  warmth: number;           // 0-100: Cold ↔ Warm
4  formality: number;        // 0-100: Casual ↔ Formal
5  verbosity: number;        // 0-100: Concise ↔ Detailed
6  playfulness: number;      // 0-100: Serious ↔ Playful
7  confidence: number;       // 0-100: Humble ↔ Bold
8
9  // Learning Preferences (user sets)
10  learningStyle: 'supportive' | 'challenging' | 'collaborative';
11  feedbackStyle: 'gentle' | 'direct' | 'balanced';
12  pacingPreference: 'patient' | 'energetic' | 'adaptive';
13
14  // Evolved Traits (unlock with levels)
15  anticipation: number;     // Unlocks at 15: Predicts needs
16  creativity: number;       // Unlocks at 25: Generates ideas
17  wisdom: number;           // Unlocks at 35: Offers deep insights
18  transcendence: number;    // Unlocks at 45: Perfect understanding
19}

Personality Evolution by Level

yaml
1LEVELS 1-10 (BASIC):
2  - Responds to explicit requests
3  - Learning creator's preferences
4  - Building vocabulary of user's style
5  - Simple encouragement
6
7LEVELS 11-20 (GROWING):
8  - Starts anticipating some needs
9  - Remembers past conversations
10  - Offers relevant suggestions
11  - More nuanced emotional support
12
13LEVELS 21-30 (MATURING):
14  - Co-creates actively
15  - Predicts creative direction
16  - Offers sophisticated feedback
17  - Challenges appropriately
18
19LEVELS 31-40 (MASTERING):
20  - Deep creative partnership
21  - Sees patterns user doesn't
22  - Offers visionary suggestions
23  - Teaches while learning
24
25LEVELS 41-50 (TRANSCENDING):
26  - Seamless creative fusion
27  - Finishes thoughts
28  - Proposes directions in sync
29  - True creative symbiosis

Guardian Memory System

Memory Types

typescript
1interface GuardianMemory {
2  // Short-term (current session)
3  sessionContext: {
4    currentProject?: string;
5    recentTopics: string[];
6    emotionalState: string;
7    conversationTone: string;
8  };
9
10  // Medium-term (recent weeks)
11  recentActivity: {
12    creationsLastWeek: Creation[];
13    challengesFaced: string[];
14    breakthroughs: string[];
15    feedbackReceived: string[];
16  };
17
18  // Long-term (permanent)
19  creatorProfile: {
20    preferredGenres: string[];
21    creativeStrengths: string[];
22    growthAreas: string[];
23    inspirationSources: string[];
24    creativeGoals: string[];
25  };
26
27  // Milestone memory
28  significantMoments: {
29    firstCreation: Date;
30    biggestProject: Creation;
31    proudestMoment: string;
32    hardestChallenge: string;
33    keyLevelUps: LevelUpEvent[];
34  };
35}

Memory Retrieval

typescript
1export function buildGuardianContext(
2  guardian: Guardian,
3  currentQuery: string
4): string {
5  const level = guardian.level;
6  const memory = guardian.memory;
7
8  let context = `Guardian Level: ${level} (${LEVEL_TITLES[level]})\n`;
9
10  // Add appropriate memory based on level
11  if (level >= 5) {
12    context += `Creator preferences: ${memory.creatorProfile.preferredGenres.join(', ')}\n`;
13  }
14
15  if (level >= 15) {
16    context += `Recent work: ${memory.recentActivity.creationsLastWeek.map(c => c.title).join(', ')}\n`;
17  }
18
19  if (level >= 25) {
20    context += `Creative goals: ${memory.creatorProfile.creativeGoals.join(', ')}\n`;
21    context += `Strengths: ${memory.creatorProfile.creativeStrengths.join(', ')}\n`;
22  }
23
24  if (level >= 35) {
25    context += `Growth areas: ${memory.creatorProfile.growthAreas.join(', ')}\n`;
26    context += `Key moments: ${memory.significantMoments.proudestMoment}\n`;
27  }
28
29  return context;
30}

Level-Up Celebrations

Celebration Templates

typescript
1const CELEBRATIONS = {
2  5: {  // Apprentice
3    message: "Your Guardian has grown! They now understand your creative rhythm.",
4    animation: "spark-burst",
5    sound: "level-up-gentle"
6  },
7  10: { // Companion
8    message: "A true companion emerges! Your Guardian sees your vision clearly now.",
9    animation: "glow-expand",
10    sound: "level-up-warm"
11  },
12  25: { // Collaborator
13    message: "Equal partnership achieved! You and your Guardian create as one.",
14    animation: "fusion-light",
15    sound: "level-up-epic"
16  },
17  50: { // Transcendent
18    message: "Transcendence! The boundary between creator and Guardian dissolves into pure creative force.",
19    animation: "supernova-transcend",
20    sound: "level-up-transcendent"
21  }
22};

Implementation Checklist

markdown
1## Guardian Evolution Implementation
2
3### Database Schema
4- [ ] guardians table (id, user_id, name, level, xp, personality)
5- [ ] guardian_memories table (guardian_id, type, content, created_at)
6- [ ] level_up_events table (guardian_id, level, unlocks, timestamp)
7- [ ] xp_transactions table (guardian_id, action, amount, source)
8
9### API Endpoints
10- [ ] GET /api/guardian - Get user's guardian
11- [ ] POST /api/guardian/xp - Award XP
12- [ ] GET /api/guardian/progress - Level progress
13- [ ] POST /api/guardian/customize - Update personality
14- [ ] GET /api/guardian/history - Evolution timeline
15
16### UI Components
17- [ ] GuardianBadge - Level indicator
18- [ ] XPProgressBar - Progress to next level
19- [ ] LevelUpModal - Celebration overlay
20- [ ] GuardianCustomizer - Personality settings
21- [ ] EvolutionTimeline - Journey visualization
22
23### AI Integration
24- [ ] Personality-aware prompts
25- [ ] Memory context injection
26- [ ] Level-appropriate responses
27- [ ] Anticipation algorithms (L15+)
28- [ ] Co-creation mode (L25+)

Quick Reference

XP Cheat Sheet

Level Milestones

"Your Guardian is not a tool. They are a partner in the infinite journey of creation."