Skip to content

PROJECT_SUMMARY.md

Latest commit

 

History

History
167 lines (130 loc) · 5.07 KB

PROJECT_SUMMARY.md

File metadata and controls

167 lines (130 loc) · 5.07 KB

🎮 Quota Quest - Project Summary

✅ What Was Built

A fully functional retro-styled educational game for sales training with:

Frontend

  • index.html - Retro 1980s terminal-style interface with 5 game screens
  • styles.css - Authentic CRT monitor effects (scanlines, flicker, green-on-black)
  • game.js - Complete game logic with state management and API integration
  • levels.js - 8 carefully crafted levels from your Service Sales Playbook

Backend

  • server.js - Express API server with OpenAI integration
  • AI-powered response grading (0-100 scoring) using GPT-4o-mini
  • Smart evaluation of sales techniques at low cost

Game Features

  • ✅ 8 progressive levels covering Discovery, Positioning, and Objections
  • ✅ AI grading that evaluates concept understanding, not just word matching
  • ✅ 80% passing score requirement
  • ✅ Instant feedback with reference answers
  • ✅ Retry failed levels or continue on success
  • ✅ Space-themed victory screen
  • ✅ Retro 1980s aesthetic (VT323 font, scanlines, CRT effects)

📚 Game Content

Level Breakdown:

  1. Discovery - Hidden Volume (Mac Duggal win) - Break Room
  2. Discovery - Workflow Friction (One Condoms win) - Copy Room
  3. Positioning vs Gorgias (Deflection Economy) - Hallway
  4. Positioning vs Zendesk (Single Pane) - Conference Room
  5. Objection - AI Fears (J. Peterman) - CEO's Office
  6. Objection - Pricing (Blended cost) - Finance
  7. Objection - Timing (Crawler approach) - Near Exit
  8. Objection - Phone (Roadmap honesty) - Exit Door

Each level includes:

  • Authentic prospect dialogue
  • Strategic question to answer
  • Reference answer from playbook
  • Helpful hint system
  • AI-powered grading

🚀 How to Launch

Easiest Method:

./start-game.sh

This automatically:

  1. Checks for dependencies
  2. Prompts for API key if needed
  3. Starts the server
  4. Opens the game in your browser

Manual Method:

# Terminal 1: Start server
cd server
npm install
npm start

# Terminal 2: Access game
# Visit http://localhost:3000 in your browser

🎯 How It Works

  1. Player starts → Welcome screen explains the mission
  2. Each level → Prospect appears with a question/concern
  3. Player responds → Types their sales approach
  4. AI grades → GPT-4o-mini evaluates the response (0-100)
  5. Pass/Fail → 80+ passes, under 80 can retry
  6. Victory → Complete all 8 levels, escape to Austin! 🚀

🛠️ Technical Stack

  • Frontend: Vanilla JavaScript (ES6 modules)
  • Backend: Node.js + Express
  • AI: OpenAI API (GPT-4o-mini for low-cost grading)
  • Styling: Pure CSS with retro effects
  • No frameworks - Simple, maintainable, fast

📊 Grading System

The AI evaluates responses on:

  • Concept capture - Do they understand the strategy?
  • Positioning techniques - Are they using the right framework?
  • Professionalism - Is it appropriate for sales?
  • Pain addressing - Do they hit the core issue?

The AI is lenient - players don't need word-for-word matches, just demonstrate understanding.

🎨 Design Philosophy

Why retro 1980s?

  • Nostalgic and engaging
  • Reduces pressure (it's "just a game")
  • Distinctive and memorable
  • Fits the space-themed GTM kickoff

Why text-based?

  • Focus on sales messaging (not graphics)
  • Easy to update content
  • Fast loading
  • Accessible on any device

📁 File Structure

quota-quest/
├── index.html          # Main game interface
├── styles.css          # Retro styling + animations
├── game.js            # Game logic + API calls
├── levels.js          # 8 levels from playbook
├── start-game.sh      # Easy launcher
├── README.md          # Full documentation
├── QUICKSTART.md      # 3-minute setup guide
└── server/
    ├── server.js      # Express + AI grading
    ├── package.json   # Dependencies
    └── .env.example   # API key template

🔄 Future Enhancements (v2 Ideas)

If you want to expand:

  • User authentication and profiles
  • Leaderboards with high scores
  • More levels from other playbooks
  • Multiplayer competitive mode
  • Analytics dashboard for training managers
  • Mobile app version
  • Save/resume progress
  • Custom level editor

🎓 Educational Value

This game teaches:

  1. Discovery techniques - How to uncover hidden pain
  2. Value positioning - Framing vs competitors
  3. Objection handling - Real prospect concerns
  4. Sales messaging - Effective language patterns

Players learn by:

  • Doing not just reading
  • Immediate feedback from AI
  • Reference answers to study
  • Retry opportunities to improve

🎉 Ready to Play!

Your sales team now has an engaging way to prepare for the GTM Kickoff. The game reinforces the playbook content in a fun, low-pressure format.

To launch: ./start-game.sh

To customize: Edit levels.js to add/modify scenarios

To deploy: See README.md for hosting options

Questions or issues? Check the full README.md or QUICKSTART.md

🚀 Good luck escaping the office! 🚀