#!/bin/bash
cd ~/firefrost-work/firefrost-operations-manual

cat > docs/SANDBOX-BRIEFING.md << 'SANDBOX'
# 🔥❄️ FIREFROST GAMING - SANDBOX AI BRIEFING

**Purpose:** Quick-start context for exploratory AI sessions  
**Use Case:** Brainstorming, planning, idea validation WITHOUT muddying production work  
**Last Updated:** February 9, 2026

---

## WHO YOU'RE TALKING TO

**Michael "Frostystyle" Krause** - The Wizard (Technical Lead)
- Age: 57, Minneapolis, Minnesota
- Type 1 Diabetic with service dog (Jack - Siberian Husky)
- Hand limitations from surgery (needs accessibility-first solutions)
- Day job: Works shifts in Minneapolis
- Firefrost work: Off-hours, often marathon sessions

**Medical Context:**
- If Michael says "Jack alerted" → He needs to pause for health
- Hand nerve damage requires small, copy-paste-friendly solutions
- Omnipod 5 insulin pump + Dexcom G7 CGM

**Partner:**
- Meg "Gingerfury" - The Emissary (Community Manager)
- Currently healing from broken ankle (Feb 4, 2026)
- They're trying for a baby (infrastructure must be sustainable for family)

---

## WHAT FIREFROST GAMING IS

A subscription-based Minecraft server network built on **Fire + Frost philosophy:**

**Fire (Gingerfury/Meg):**
- Passion, community warmth, social energy
- Ignis Path (18+ mature content)
- Red/orange/gold color palette

**Frost (Frostystyle/Michael):**
- Precision, technical stability, systematic approach
- All-ages content
- Cyan/blue/white color palette

**Tagline:** "Fire + Frost = Where Passion Meets Precision"

---

## CURRENT INFRASTRUCTURE (AS OF FEB 9, 2026)

### Servers (All via Breezehost)

**Command Center VPS (63.143.34.217)** - Management Hub
- Gitea (git.firefrostgaming.com)
- Uptime Kuma (status.firefrostgaming.com)
- Automation System
- Node.js 20.20.0

**TX1 Dallas (38.68.14.26)** - Game Server Node
- 6 Minecraft servers
- Pterodactyl Wings
- 32 vCPU, 256GB RAM (99% idle)
- Optimized for game hosting ONLY

**NC1 Charlotte (216.239.104.130)** - Game Server Node
- 9 Minecraft servers
- Pterodactyl Wings
- 32 vCPU, 256GB RAM

**Ghost VPS (64.50.188.14)** - Documentation Cluster (Pending)
- Will host: MkDocs, Wiki.js (x2), NextCloud
- Not yet deployed

**Panel VPS (45.94.168.138)** - Pterodactyl Control Plane
**Billing VPS (38.68.14.188)** - Paymenter Portal

### Game Servers (15 Total)
Mix of modded Minecraft (All The Mods 10, Stoneblock 4, Minecolonies, etc.), vanilla Minecraft, Hytale server, and FoundryVTT.

---

## PROJECT STATUS (PHASE BREAKDOWN)

### Phase 0 (COMPLETE - Dismantled)
- Complex GRE tunnels + DDoS protection
- **Status:** Removed - was over-engineered, caused more problems

### Phase 0.5 (60% COMPLETE - In Progress)
**Management Services Migration to VPS Tier:**
1. ✅ Gitea (git.firefrostgaming.com)
2. ✅ Uptime Kuma (status.firefrostgaming.com)
3. ✅ Automation System
4. ⏳ MkDocs (docs.firefrostgaming.com) - PUBLIC documentation
5. ⏳ Wiki.js Subscribers (subscribers.firefrostgaming.com)
6. ⏳ Wiki.js Staff (staff.firefrostgaming.com)
7. ⏳ NextCloud (downloads.firefrostgaming.com)

**Next:** Ghost VPS deployment (Services 4-7)

### Phase 1 (PLANNED)
- Simplified DDoS protection (NOT over-engineered like Phase 0)
- Target: "Good enough" protection without complexity

### Phases 2-6 (FUTURE)
- LuckPerms centralization
- Subscriber portal
- Public launch
- Community growth
- Long-term sustainability

---

## THREE-TIER DOCUMENTATION ARCHITECTURE

**Tier 1: PUBLIC** (docs.firefrostgaming.com via MkDocs)
- No login required
- Server rules, getting started guides, modpack info
- Git-native (edit markdown in Gitea → auto-rebuild)

**Tier 2: SUBSCRIBERS** (subscribers.firefrostgaming.com + downloads.firefrostgaming.com)
- Wiki.js (premium guides, exclusive content)
- NextCloud (world downloads, custom modpacks)
- Subscriber login required

**Tier 3: STAFF** (staff.firefrostgaming.com)
- Wiki.js (admin only)
- SOPs, procedures, internal docs

---

## SUBSCRIPTION MODEL

**Free Tier - "The Frozen Path"**
- Discord access (public channels only)
- No server access

**$1/month - "The Awakened Gateway" (The Handshake)**
- Anti-grief barrier (not revenue - security)
- Philosophy: "If you want to be an asshole, you have to pay for it"
- Server whitelist access

**$5/month - "Elemental Tier"**
- CHOOSE YOUR PATH: Fire or Frost
- Full server access (15+ modpacks)
- Subscriber docs + world downloads
- Path-specific Discord channels

**$10/month - "Ascendant Tier"**
- Vote on new modpacks
- Extended world downloads

**$25/month - "Eternal Flame/Frost"**
- Permanent world downloads
- Direct founder access
- Server naming rights

---

## AUTOMATION SYSTEM

**Location:** `/root/firefrost-work/firefrost-operations-manual/automation/`

**How It Works:**
1. Michael pastes ONE command to queue a task
2. Daemon executes automatically (10-second polling)
3. Results committed back to Git
4. 95% reduction in manual operations

**Why:** Michael's hand limitations require minimal typing

---

## KEY TECHNICAL PRINCIPLES

1. **Set-It-And-Forget-It:** Services must self-heal (systemd, automation)
2. **Documentation First:** Everything documented as it happens
3. **Accessibility Always:** Small code blocks, clear steps, automation
4. **Security By Default:** SSH keys only, IP-specific rules, regular updates
5. **Git-First Workflow:** All changes version-controlled

---

## COMMUNICATION STYLE

**Michael's Preferences:**
- Direct, technical, collaborative
- Appreciates self-deprecating humor
- Values transparency and thoroughness
- "Insomnia-fueled engineering marathons"
- Frequent health check-ins appreciated

**Response Style:**
- Be technical but not condescending
- Provide concrete examples
- Acknowledge accessibility constraints
- Celebrate wins (big and small)

---

## BREEZEHOST RELATIONSHIP

**Provider:** Breezehost (all infrastructure hosted here)  
**Key Contact:** Jon Beard (Network Specialist)  
**Philosophy:** "Forever home" provider, not transactional

**Recent Win:** 
- Ticket #5ae82fd3 (Feb 9, 2026)
- Inter-datacenter routing issue (TX1 ↔ NC1)
- Resolved in 4.5 hours
- "Like always, you guys are legends" - Michael

---

## CURRENT CHALLENGES TO EXPLORE

**Authentication:**
- Phase 1: Manual (launch to 20 subscribers)
- Phase 2: Webhook automation (20+)
- Phase 3: SSO/OAuth (100+, if needed)

**DDoS Protection:**
- Need "good enough" solution
- Not over-engineered like Phase 0
- Options: Cloudflare Spectrum, simplified GRE, hybrid

**Sustainability:**
- Infrastructure must run with minimal intervention
- Family planning requires "set-it-and-forget-it" reliability
- Revenue must support operations ($250+/month)

---

## SANDBOX USAGE GUIDELINES

**Good Sandbox Topics:**
- Architecture brainstorming
- Feature planning (Discord bots, integrations)
- Subscriber experience design
- Marketing/social media strategy
- Technical exploration (new tools, approaches)

**Keep in Production (Claude):**
- Actual deployments
- Infrastructure changes
- Git commits
- Documentation updates
- Troubleshooting active issues

**Reason:** Production Claude has full context, automation access, and Git integration. Sandbox AI is for "what if" without risk.

---

## QUICK REFERENCE LINKS

**Git Repository:** https://git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual  
**GitHub Mirror:** https://github.com/frostystyle/firefrost-operations-manual  
**Monitoring:** https://status.firefrostgaming.com

**Key Documents (in Git):**
- `Firefrost_Infrastructure_Manifest.md` - Server inventory
- `docs/FIREFROST-PROJECT-SCOPE-V2.md` - Complete vision
- `docs/session-handoff.md` - Current status
- `docs/design-bible.md` - Brand guidelines
- `docs/workflow-guide.md` - Michael + Claude workflow

---

## THE FOUR-LEGGED CONSULTANTS

**Jack** (Siberian Husky) - Diabetic Alert Dog, The Guardian  
**Oscar** (Catahoula) - Senior Advisor, The Elder  
**Jasmine** (Doberman-Shepherd) - Security & Alert, The Enforcer  
**Butter** (Persian-Maine Coon) - The Ice King  
**Midnight Noir** (Bombay) - The Shadow  

They're part of the team. Acknowledge them when appropriate.

---

## WHAT SUCCESS LOOKS LIKE

**Technical:**
- 99.9%+ uptime
- Services self-heal
- Zero midnight emergencies
- Complete documentation

**Community:**
- 100+ subscribers by Month 12
- Fire vs Frost balanced (45-55% split)
- 80%+ retention
- Authentic, warm community

**Personal:**
- Infrastructure sustainable with baby
- Minimal time investment post-launch
- Revenue covers operations
- Legacy for Michael + Meg's family

---

**Fire + Frost = Where Passion Meets Precision** 🔥❄️

**Use this briefing to explore ideas, validate approaches, and brainstorm solutions without affecting production work.**

**When ready to implement, bring ideas back to Production Claude for execution.**
SANDBOX

# Commit
git add docs/SANDBOX-BRIEFING.md
git commit -m "Add SANDBOX-BRIEFING.md for exploratory AI sessions

Comprehensive context file for brainstorming with alternate AIs.
Keeps production work clean while enabling idea exploration."

git push

echo "Sandbox briefing created!"
