---

name: God Mode Engine description: Build and manage the 100-game poker training RPG with 3-engine architecture (PIO, CHART, SCENARIO)

God Mode Engine Skill

Complete implementation of the Smarter.Poker "God Mode" training system.

Quick Reference

---

Architecture

Copy     GameSession.tsx
           │ REST
     ┌─────▼─────┐
     │ server.py │ FastAPI
     └─────┬─────┘
           │
     ┌─────▼─────┐
     │engine_core│ GameEngine
     └─────┬─────┘
     ┌─────┼─────┐
    PIO  CHART SCENARIO
    (60)  (19)   (21)

Component Flow

Copy/hub/training
     │
     ▼
GameCard (click)
     │
     ▼
/hub/training/play/[gameId] ──► LevelSelector
     │
     ▼ (select level)
/hub/training/arena/[gameId] ──► GameArena
     │                              │
     │                    ┌─────────┼─────────┐
     │                    ▼         ▼         ▼
     │              PokerTable  ChartGrid  MentalGym
     │                 (PIO)     (CHART)  (SCENARIO)
     │
     ▼ (session complete)
RoundSummary ──► Victory/Defeat screen

---

Run Commands

Copy# API Server
uvicorn server:app --reload --port 8000

# Frontend
npm run dev

# Seed games
python3 scripts/seed_games.py --stats

# Setup dummy data
python3 scripts/setup_dummy_data.py

---

Implementation Steps

Step 1-6: Core Engine (Completed)

• Database schema
• Game seeder (100 games)
• Engine core backend
• Frontend GameSession component
• FastAPI server
• Training Hub enhancements

Step 7: Level Select Screen

• LevelSelector.tsx - 10-level progression display
• Visual indicators: locked/unlocked/current/passed
• Difficulty curve display (85%-100% passing grades)
• XP rewards preview

Step 8: Engine Components

• ChartGrid.tsx - 13x13 push/fold chart
  • Interactive cell selection
  • Color-coded actions (PUSH=green, FOLD=red, 3BET=blue)
  • Position and stack depth display
  • Visual feedback for correct/wrong answers
• MentalGym.tsx - Mental game scenarios
  • Large scenario text display
  • Countdown timer with pressure
  • Emotional type badges
  • Timed decision making

Step 9: Game HUD (GameArena)

• GameArena.tsx - Full game session wrapper
• Health bar with heart icons
• Hand counter (hand X of 20)
• XP display with streak bonus
• Conditional engine rendering
• Demo mode for testing without API

Step 10: Victory/Defeat Screen

• RoundSummary.tsx - Session completion screen
• Phased reveal animation (SCORE → XP → BLUNDERS → ACTIONS)
• Confetti celebration on pass
• Animated score counter
• Top 3 blunders review
• Next level / Retry / Exit buttons

Step 11: Navigation Wiring

• /hub/training/play/[gameId].js → LevelSelector
• /hub/training/arena/[gameId].js → GameArena
• Session params via URL (level, session)

Step 12: Graphics Engine

• Card.tsx - Playing card component
  • SVG suit symbols
  • Color coding (red/black)
  • Sizes: small, medium, large
  • Flip/deal animations
  • CardGroup for hand display
• Chip.tsx - Poker chip component
  • Denomination colors (1=white, 5=red, 25=green, 100=black, 500=purple, 1000=gold)
  • ChipStack for stacking effect
  • PotDisplay for pot visualization

Step 13: Mock Data

• scripts/setup_dummy_data.py - Data setup script
• /data/charts/push_fold_ranges.json - Push/fold charts
• /data/charts/3bet_ranges.json - 3-bet/call ranges
• /data/charts/icm_bubble_ranges.json - ICM bubble charts
• /data/scenarios/mental_game.json - Mental game scenarios
• Validation system for data files

---

Data Files

---

Component Props

ChartGrid

Copyinterface ChartGridProps {
  chartType: 'PUSH_FOLD' | '3BET_CALL' | 'ICM_BUBBLE';
  heroPosition: string;
  stackBB: number;
  phase: 'DISPLAY' | 'SELECT' | 'RESULT';
  selectedCell?: string;
  correctCell?: string;
  resultFeedback?: 'CORRECT' | 'WRONG';
  onAction: (action: string) => void;
}

MentalGym

Copyinterface MentalGymProps {
  scenario: {
    title: string;
    context: string;
    prompt: string;
    options: Array<{
      id: string;
      text: string;
      type: 'rational' | 'impulsive' | 'passive' | 'aggressive';
      correct: boolean;
      feedback: string;
    }>;
    timeout_seconds: number;
  };
  onAnswer: (optionId: string, timedOut: boolean) => void;
  timeRemaining?: number;
}

GameArena

Copyinterface GameArenaProps {
  gameId: string;
  level: number;
  sessionId: string;
  engineType: 'PIO' | 'CHART' | 'SCENARIO';
  onSessionComplete: (result: SessionResult) => void;
  onExit: () => void;
}

RoundSummary

Copyinterface RoundSummaryProps {
  result: {
    passed: boolean;
    score: number;
    totalHands: number;
    correctHands: number;
    xpEarned: number;
    streakBonus: number;
    blunders: Array<{
      hand: number;
      heroCards: string[];
      board: string[];
      yourAction: string;
      correctAction: string;
      evLoss: number;
    }>;
  };
  level: number;
  gameName: string;
  onNextLevel: () => void;
  onRetry: () => void;
  onExit: () => void;
}

---

Deployment Checklist

• Database schema
• Game seeder (100 games)
• Engine core backend
• Frontend component
• FastAPI server
• Training Hub enhancements
• Level Select screen
• Engine components (ChartGrid, MentalGym)
• Game HUD (GameArena)
• Victory/Defeat screen (RoundSummary)
• Navigation wiring
• Graphics engine (Card, Chip)
• Mock data setup
• Production deploy

---

Skill Files