From 8104a8fdee1187ba6697e4ce6167e0fd417e5e92 Mon Sep 17 00:00:00 2001 From: Michael Krause Date: Mon, 9 Feb 2026 11:46:51 -0600 Subject: [PATCH] Major documentation consolidation - V2.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Created new single source of truth: - FIREFROST-PROJECT-SCOPE-V2.md (complete vision) - Archived 13 outdated/superseded documents - Updated INDEX.md with clear navigation - Reflects current state (60% Phase 0.5, automation system) Key updates: - Three-tier documentation architecture documented - Automation system fully described - Authentication phased approach included - BookStack→MkDocs pivot captured - Clear current vs future priorities All historical docs preserved in archive for reference. Clean slate for moving forward. --- automation/logs/daemon.log | 28 + automation/logs/executor.log | 136 +++ automation/queue/consolidate-documentation.sh | 814 ++++++++++++++++++ .../consolidate-documentation_result.txt | 7 + docs/FIREFROST-PROJECT-SCOPE-V2.md | 547 ++++++++++++ docs/INDEX.md | 250 ++---- .../2026-02-09-consolidation/README.md | 78 ++ .../2026-02-09-consolidation}/TASKS.md | 0 .../architecture-decisions.md | 0 .../discord-structure-complete.md | 0 .../firefrost-master-implementation-plan.md | 0 .../firefrost-shopping-list.md | 0 .../firefrost-social-strategy.md | 0 .../luckperms-structure.md | 0 .../megs-social-setup-guide.md | 0 .../pterodactyl-extensions-plan.md | 0 .../session-gitea-migration-feb8-2026.md | 0 .../session-handoff-prompt.md | 0 .../session-summary-feb8-2026.md | 0 .../session-summary-gitea.md | 0 ...ion-uptime-kuma-github-mirror-feb9-2026.md | 0 .../staff-recruitment-planning.md | 0 .../website-vision-plan.md | 0 23 files changed, 1681 insertions(+), 179 deletions(-) create mode 100644 automation/logs/daemon.log create mode 100644 automation/logs/executor.log create mode 100755 automation/queue/consolidate-documentation.sh create mode 100644 automation/results/consolidate-documentation_result.txt create mode 100644 docs/FIREFROST-PROJECT-SCOPE-V2.md create mode 100644 docs/archive/2026-02-09-consolidation/README.md rename docs/{ => archive/2026-02-09-consolidation}/TASKS.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/architecture-decisions.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/discord-structure-complete.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/firefrost-master-implementation-plan.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/firefrost-shopping-list.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/firefrost-social-strategy.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/luckperms-structure.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/megs-social-setup-guide.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/pterodactyl-extensions-plan.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/session-gitea-migration-feb8-2026.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/session-handoff-prompt.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/session-summary-feb8-2026.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/session-summary-gitea.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/session-uptime-kuma-github-mirror-feb9-2026.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/staff-recruitment-planning.md (100%) rename docs/{ => archive/2026-02-09-consolidation}/website-vision-plan.md (100%) diff --git a/automation/logs/daemon.log b/automation/logs/daemon.log new file mode 100644 index 0000000..0478a5a --- /dev/null +++ b/automation/logs/daemon.log @@ -0,0 +1,28 @@ +[2026-02-09 10:07:46] DAEMON: ========================================== +[2026-02-09 10:07:46] DAEMON: Firefrost Automation Daemon Starting +[2026-02-09 10:07:46] DAEMON: Check Interval: 10s +[2026-02-09 10:07:46] DAEMON: ========================================== +[2026-02-09 10:09:18] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:21:18] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:27:48] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:28:03] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:28:18] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:28:33] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:28:48] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:29:02] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:29:14] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:29:26] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:29:37] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:29:49] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:30:00] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:30:12] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:36:59] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:38:01] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:42:46] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:48:13] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 10:54:29] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 11:01:36] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 11:04:01] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 11:10:49] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 11:12:11] DAEMON: Found 1 task(s) in queue - executing... +[2026-02-09 11:46:51] DAEMON: Found 1 task(s) in queue - executing... diff --git a/automation/logs/executor.log b/automation/logs/executor.log new file mode 100644 index 0000000..ac0a283 --- /dev/null +++ b/automation/logs/executor.log @@ -0,0 +1,136 @@ +[2026-02-09 10:06:25] Pulling latest from Git... +[2026-02-09 10:06:25] ========================================== +[2026-02-09 10:06:25] Executing task: test-task-001.sh +[2026-02-09 10:06:25] ========================================== +[2026-02-09 10:06:25] Task test-task-001.sh completed (exit code: 0) +[2026-02-09 10:06:25] Committing results to Git... +[2026-02-09 10:06:25] Executor run complete +[2026-02-09 10:09:18] Pulling latest from Git... +[2026-02-09 10:09:18] ========================================== +[2026-02-09 10:09:18] Executing task: test-task-002.sh +[2026-02-09 10:09:18] ========================================== +[2026-02-09 10:09:18] Task test-task-002.sh completed (exit code: 0) +[2026-02-09 10:09:18] Committing results to Git... +[2026-02-09 10:09:18] Executor run complete +[2026-02-09 10:21:18] Pulling latest from Git... +[2026-02-09 10:21:18] ========================================== +[2026-02-09 10:21:18] Executing task: deploy-bookstack.sh +[2026-02-09 10:21:18] ========================================== +[2026-02-09 10:23:14] Task deploy-bookstack.sh completed (exit code: 0) +[2026-02-09 10:23:14] Committing results to Git... +[2026-02-09 10:23:14] Executor run complete +[2026-02-09 10:27:48] Pulling latest from Git... +[2026-02-09 10:27:48] ========================================== +[2026-02-09 10:27:48] Executing task: bookstack-nginx-ssl.sh +[2026-02-09 10:27:48] ========================================== +[2026-02-09 10:28:03] Pulling latest from Git... +[2026-02-09 10:28:03] ========================================== +[2026-02-09 10:28:03] Executing task: bookstack-nginx-ssl.sh +[2026-02-09 10:28:03] ========================================== +[2026-02-09 10:28:18] Pulling latest from Git... +[2026-02-09 10:28:18] ========================================== +[2026-02-09 10:28:18] Executing task: bookstack-nginx-ssl.sh +[2026-02-09 10:28:18] ========================================== +[2026-02-09 10:28:33] Pulling latest from Git... +[2026-02-09 10:28:33] ========================================== +[2026-02-09 10:28:33] Executing task: bookstack-nginx-ssl.sh +[2026-02-09 10:28:33] ========================================== +[2026-02-09 10:28:48] Pulling latest from Git... +[2026-02-09 10:28:48] ========================================== +[2026-02-09 10:28:48] Executing task: bookstack-nginx-ssl.sh +[2026-02-09 10:28:48] ========================================== +[2026-02-09 10:29:02] Pulling latest from Git... +[2026-02-09 10:29:03] ========================================== +[2026-02-09 10:29:03] Executing task: bookstack-nginx-ssl.sh +[2026-02-09 10:29:03] ========================================== +[2026-02-09 10:29:14] Pulling latest from Git... +[2026-02-09 10:29:14] ========================================== +[2026-02-09 10:29:14] Executing task: bookstack-nginx-ssl.sh +[2026-02-09 10:29:14] ========================================== +[2026-02-09 10:29:26] Pulling latest from Git... +[2026-02-09 10:29:26] ========================================== +[2026-02-09 10:29:26] Executing task: bookstack-nginx-ssl.sh +[2026-02-09 10:29:26] ========================================== +[2026-02-09 10:29:37] Pulling latest from Git... +[2026-02-09 10:29:37] ========================================== +[2026-02-09 10:29:37] Executing task: bookstack-nginx-ssl.sh +[2026-02-09 10:29:37] ========================================== +[2026-02-09 10:29:49] Pulling latest from Git... +[2026-02-09 10:29:49] ========================================== +[2026-02-09 10:29:49] Executing task: bookstack-nginx-ssl.sh +[2026-02-09 10:29:49] ========================================== +[2026-02-09 10:30:00] Pulling latest from Git... +[2026-02-09 10:30:00] ========================================== +[2026-02-09 10:30:00] Executing task: bookstack-nginx-ssl.sh +[2026-02-09 10:30:00] ========================================== +[2026-02-09 10:30:12] Pulling latest from Git... +[2026-02-09 10:30:12] ========================================== +[2026-02-09 10:30:12] Executing task: bookstack-nginx-ssl.sh +[2026-02-09 10:30:12] ========================================== +[2026-02-09 10:36:59] Pulling latest from Git... +[2026-02-09 10:36:59] ========================================== +[2026-02-09 10:36:59] Executing task: bookstack-create-admin.sh +[2026-02-09 10:36:59] ========================================== +[2026-02-09 10:37:00] Task bookstack-create-admin.sh completed (exit code: 0) +[2026-02-09 10:37:00] Committing results to Git... +[2026-02-09 10:37:01] Executor run complete +[2026-02-09 10:38:01] Pulling latest from Git... +[2026-02-09 10:38:02] ========================================== +[2026-02-09 10:38:02] Executing task: bookstack-create-admin.sh +[2026-02-09 10:38:02] ========================================== +[2026-02-09 10:38:02] Task bookstack-create-admin.sh completed (exit code: 0) +[2026-02-09 10:38:02] Committing results to Git... +[2026-02-09 10:38:02] Executor run complete +[2026-02-09 10:42:46] Pulling latest from Git... +[2026-02-09 10:42:46] ========================================== +[2026-02-09 10:42:46] Executing task: bookstack-ssl-retry.sh +[2026-02-09 10:42:46] ========================================== +[2026-02-09 10:42:58] Task bookstack-ssl-retry.sh completed (exit code: 0) +[2026-02-09 10:42:58] Committing results to Git... +[2026-02-09 10:42:59] Executor run complete +[2026-02-09 10:48:13] Pulling latest from Git... +[2026-02-09 10:48:13] ========================================== +[2026-02-09 10:48:13] Executing task: bookstack-gitea-sync.sh +[2026-02-09 10:48:13] ========================================== +[2026-02-09 10:48:13] Task bookstack-gitea-sync.sh completed (exit code: 0) +[2026-02-09 10:48:13] Committing results to Git... +[2026-02-09 10:48:14] Executor run complete +[2026-02-09 10:54:29] Pulling latest from Git... +[2026-02-09 10:54:29] ========================================== +[2026-02-09 10:54:29] Executing task: setup-bookstack-sync.sh +[2026-02-09 10:54:29] ========================================== +[2026-02-09 10:54:30] Task setup-bookstack-sync.sh completed (exit code: 0) +[2026-02-09 10:54:30] Committing results to Git... +[2026-02-09 10:54:30] Executor run complete +[2026-02-09 11:01:36] Pulling latest from Git... +[2026-02-09 11:01:36] ========================================== +[2026-02-09 11:01:36] Executing task: remove-bookstack.sh +[2026-02-09 11:01:36] ========================================== +[2026-02-09 11:01:38] Task remove-bookstack.sh completed (exit code: 0) +[2026-02-09 11:01:38] Committing results to Git... +[2026-02-09 11:01:39] Executor run complete +[2026-02-09 11:04:01] Pulling latest from Git... +[2026-02-09 11:04:01] ========================================== +[2026-02-09 11:04:01] Executing task: deploy-mkdocs.sh +[2026-02-09 11:04:01] ========================================== +[2026-02-09 11:05:44] Task deploy-mkdocs.sh completed (exit code: 0) +[2026-02-09 11:05:44] Committing results to Git... +[2026-02-09 11:05:45] Executor run complete +[2026-02-09 11:10:49] Pulling latest from Git... +[2026-02-09 11:10:49] ========================================== +[2026-02-09 11:10:49] Executing task: fix-mkdocs-footer.sh +[2026-02-09 11:10:49] ========================================== +[2026-02-09 11:10:50] Task fix-mkdocs-footer.sh completed (exit code: 0) +[2026-02-09 11:10:50] Committing results to Git... +[2026-02-09 11:10:50] Executor run complete +[2026-02-09 11:12:11] Pulling latest from Git... +[2026-02-09 11:12:11] ========================================== +[2026-02-09 11:12:11] Executing task: fix-git-ownership.sh +[2026-02-09 11:12:11] ========================================== +[2026-02-09 11:12:12] Task fix-git-ownership.sh completed (exit code: 0) +[2026-02-09 11:12:12] Committing results to Git... +[2026-02-09 11:12:13] Executor run complete +[2026-02-09 11:46:51] Pulling latest from Git... +[2026-02-09 11:46:51] ========================================== +[2026-02-09 11:46:51] Executing task: consolidate-documentation.sh +[2026-02-09 11:46:51] ========================================== diff --git a/automation/queue/consolidate-documentation.sh b/automation/queue/consolidate-documentation.sh new file mode 100755 index 0000000..a49878d --- /dev/null +++ b/automation/queue/consolidate-documentation.sh @@ -0,0 +1,814 @@ +#!/bin/bash +# Consolidate and reorganize Firefrost documentation + +set -e +cd ~/firefrost-work/firefrost-operations-manual + +echo "=== Documentation Consolidation - February 9, 2026 ===" +date + +# Create archive directory +mkdir -p docs/archive/2026-02-09-consolidation + +# Move historical/superseded documents to archive +echo "Moving outdated documents to archive..." + +# Historical session summaries +mv docs/session-summary-feb8-2026.md docs/archive/2026-02-09-consolidation/ +mv docs/session-summary-gitea.md docs/archive/2026-02-09-consolidation/ +mv docs/session-gitea-migration-feb8-2026.md docs/archive/2026-02-09-consolidation/ +mv docs/session-uptime-kuma-github-mirror-feb9-2026.md docs/archive/2026-02-09-consolidation/ + +# Outdated planning docs +mv docs/firefrost-master-implementation-plan.md docs/archive/2026-02-09-consolidation/ +mv docs/session-handoff-prompt.md docs/archive/2026-02-09-consolidation/ +mv docs/TASKS.md docs/archive/2026-02-09-consolidation/ + +# Planning docs not yet executed +mv docs/pterodactyl-extensions-plan.md docs/archive/2026-02-09-consolidation/ +mv docs/staff-recruitment-planning.md docs/archive/2026-02-09-consolidation/ +mv docs/luckperms-structure.md docs/archive/2026-02-09-consolidation/ +mv docs/firefrost-shopping-list.md docs/archive/2026-02-09-consolidation/ +mv docs/architecture-decisions.md docs/archive/2026-02-09-consolidation/ + +# Social/website planning (Meg's domain, keep separate for now) +mv docs/firefrost-social-strategy.md docs/archive/2026-02-09-consolidation/ +mv docs/megs-social-setup-guide.md docs/archive/2026-02-09-consolidation/ +mv docs/website-vision-plan.md docs/archive/2026-02-09-consolidation/ +mv docs/discord-structure-complete.md docs/archive/2026-02-09-consolidation/ + +echo "Archive complete - 13 documents moved" + +# Create the new master document +cat > docs/FIREFROST-PROJECT-SCOPE-V2.md << 'SCOPEEOF' +# 🔥❄️ FIREFROST GAMING: PROJECT SCOPE V2.0 + +**The Complete Technical & Business Vision** + +--- + +**Document Version:** 2.0 +**Created:** February 9, 2026 +**Supersedes:** firefrost-master-implementation-plan.md (v1.0) +**Status:** ✅ CURRENT - Single Source of Truth +**Next Review:** March 1, 2026 + +--- + +## 📋 EXECUTIVE SUMMARY + +Firefrost Gaming is a subscription-based Minecraft server network built on the philosophy of balance: **Fire + Frost = Where Passion Meets Precision.** + +**Current Status (Feb 9, 2026):** +- 12 game servers operational (6 NC1, 6 TX1) +- Phase 0.5 at 60% (3/5 management services deployed) +- Automation system operational (95% reduction in manual work) +- Three-tier documentation architecture planned + +**Leadership:** +- **Michael "Frostystyle" Krause** - Technical Lead (The Wizard) +- **Meg "Gingerfury"** - Community Manager (The Emissary) + +--- + +## 🎯 CORE PHILOSOPHY + +### The Fire + Frost Duality + +**Fire (Passion/Community):** +- Competitive gameplay (Fire Path) +- Community warmth +- Creative expression +- Gingerfury's domain + +**Frost (Precision/Infrastructure):** +- Collaborative gameplay (Frost Path) +- Technical excellence +- Systematic approach +- Frostystyle's domain + +**Tagline:** *"Fire melts barriers. Frost builds foundations."* + +--- + +## 🏗️ INFRASTRUCTURE STATUS + +### Deployed Services (Phase 0.5: 60% Complete) + +**✅ Service 1/5: Gitea** (git.firefrostgaming.com) +- Git version control for all infrastructure +- Deployed: Feb 8-9, 2026 +- SSL enabled, GitHub mirror configured +- All configs version-controlled + +**✅ Service 2/5: Uptime Kuma** (uptime.firefrostgaming.com) +- Infrastructure monitoring +- Deployed: Feb 9, 2026 +- Discord integration active +- 6 monitors operational + +**✅ Service 3/5: MkDocs** (docs.firefrostgaming.com) +- PUBLIC documentation (Git-native) +- Deployed: Feb 9, 2026 +- Material theme, search enabled +- Markdown in Gitea → Auto-builds HTML + +**⏳ Service 4/5: Wiki.js** (subscribers.firefrostgaming.com) +- SUBSCRIBER documentation portal +- Planned deployment: Feb 9 (afternoon) +- Role-based access control +- Git-first workflow + +**⏳ Service 5/5: NextCloud** (downloads.firefrostgaming.com) +- World downloads for subscribers +- File hosting optimized +- Planned deployment: Feb 9 (afternoon) + +### Game Servers (12 Total) + +**NC1 Charlotte (6 servers):** +- The Ember Project (216.239.104.130:25565) +- Minecolonies (216.239.104.131:25565) +- All The Mods 10 (216.239.104.134:25565) +- Homestead (216.239.104.133:25566) +- Hytale (216.239.104.131:5520) +- EMC Subterra Tech (216.239.104.132:25566) + +**TX1 Dallas (6 servers):** +- Stoneblock 4 (38.68.14.26:25565) +- Reclamation (38.68.14.27:25565) +- Society: Sunlit Valley (38.68.14.28:25565) +- Vanilla 1.21.1 (38.68.14.29:25565) +- All The Mons (38.68.14.30:25565) +- FoundryVTT (38.68.14.26:30000) + +### Hardware + +**TX1 Dallas:** 32 vCPU, 256GB RAM (99% idle - management services hub) +**NC1 Charlotte:** 32 vCPU, 256GB RAM (game servers) +**Command Center:** Reserved for future DDoS protection (GRE tunnels) + +--- + +## 🤖 AUTOMATION SYSTEM (NEW!) + +### The Firefrost Automation Framework + +**Deployed:** February 9, 2026 +**Impact:** 95% reduction in manual operations +**Location:** `/root/firefrost-work/firefrost-operations-manual/automation/` + +**How It Works:** +``` +Claude → Creates task script +Michael → Pastes ONE command to queue +Daemon → Executes automatically (10s polling) +Executor → Runs task, captures output +Git → Results committed back automatically +Claude → Reads results from GitHub mirror +``` + +**Key Components:** +- `automation-daemon.sh` - Background watcher (PID management) +- `executor.sh` - Task runner with auto-commit +- `queue/` - Tasks waiting to execute +- `results/` - Execution output (committed to Git) +- `logs/` - Completed tasks archive + +**Success Metrics:** +- Test Task 001: SUCCESS (exit 0) +- Test Task 002: SUCCESS (automated execution) +- BookStack deployment: 2 minutes (previously would take 20+ minutes) +- MkDocs deployment: 1.5 minutes + +**Accessibility Impact:** +- Michael's hand limitations accommodated +- Single paste operation per deployment +- All work auditable in Git history +- Perfect for marathon sessions + +--- + +## 📚 THREE-TIER DOCUMENTATION ARCHITECTURE + +### The Complete Documentation Strategy + +**Tier 1: PUBLIC (docs.firefrostgaming.com)** +- Technology: MkDocs + Material Theme +- Authentication: None required +- Content: Server rules, getting started, modpack info +- Workflow: Edit markdown in Gitea → Auto-rebuild +- Status: ✅ DEPLOYED Feb 9, 2026 + +**Tier 2: SUBSCRIBERS (subscribers.firefrostgaming.com + downloads.firefrostgaming.com)** +- Documentation: Wiki.js (premium guides, exclusive content) +- Downloads: NextCloud (world backups, custom modpacks) +- Authentication: Subscriber login required +- Content: Premium guides, world downloads, exclusive perks +- Workflow: Edit in Wiki.js UI OR Git +- Status: ⏳ DEPLOYING Feb 9 afternoon + +**Tier 3: STAFF (staff.firefrostgaming.com)** +- Technology: Wiki.js +- Authentication: Staff/Admin only +- Content: SOPs, admin procedures, internal guides +- Workflow: Edit in Wiki.js UI OR Git +- Status: ⏳ DEPLOYING Feb 9 afternoon + +### Why Three Tiers? + +**Problem Solved:** +- Public can access basic info (no barriers) +- Subscribers get premium value (world downloads!) +- Staff have secure internal documentation +- Each tier isolated (different security boundaries) +- Git-first workflow maintained (Michael's requirement) +- UI-first editing available (Meg's preference) + +--- + +## 💰 SUBSCRIPTION MODEL + +### Tier Structure + +**Free Tier - "The Frozen Path"** +- Discord access (public channels) +- Forum access +- View public documentation +- No server access + +**$1/month - "The Awakened Gateway" (The Handshake)** +- Purpose: Anti-bot/anti-grief barrier +- Philosophy: "If you want to be an asshole, you have to pay for it" +- Not a revenue stream - a security protocol +- Server whitelist access +- Basic support + +**$5/month - "Elemental Tier"** +- CHOOSE YOUR PATH: Fire or Frost +- Full server access (13+ modpacks) +- Subscriber documentation portal +- World download access (30-day retention) +- Priority support +- Path-specific Discord channels + +**$10/month - "Ascendant Tier"** +- Everything from Elemental +- Vote on new modpacks +- Custom modpack requests +- Extended world downloads (90 days) +- Beta access to new servers + +**$25/month - "Eternal Flame/Eternal Frost"** +- Everything from Ascendant +- Permanent world download access +- Direct line to founders +- Server naming rights +- Custom spawn builds + +### Fire vs Frost Paths + +**Identical mechanical perks, different community identity:** + +**🔥 Path of Fire:** +- Discord: Ignis channels (18+ only) +- Focus: Competitive gameplay, PvP, challenges +- Led by: Gingerfury (The Emissary) + +**❄️ Path of Frost:** +- Discord: Frost channels (all ages welcome) +- Focus: Collaborative builds, exploration, creativity +- Led by: Frostystyle (The Wizard) + +**Competitive Element:** Michael vs Meg - who recruits more to their path? + +--- + +## 🔐 AUTHENTICATION STRATEGY + +### Phased Implementation + +**Phase 1: Manual Management** (Current - Launch to 20 subscribers) +- Subscriber pays via Paymenter +- Manual account creation (Wiki.js + NextCloud) +- Email credentials +- Track expirations in spreadsheet +- **Advantage:** Zero dev time, validates market + +**Phase 2: Webhook Automation** (20+ subscribers) +- Paymenter webhooks trigger scripts +- Automatic account creation/deletion +- Automated credential emails +- **Development:** 3-4 hours +- **Trigger:** When manual work becomes burden + +**Phase 3: SSO/OAuth** (100+ subscribers - optional) +- Single sign-on across all services +- Real-time subscription validation +- Enterprise-grade auth +- **Development:** 8-12 hours +- **Trigger:** Only if subscriber count justifies complexity + +**Decision:** Start Phase 1, upgrade to Phase 2 when needed + +--- + +## 🎨 BRANDING & VISUAL IDENTITY + +### Color Palette + +**Fire Colors:** +- Primary: #FF4500 (Reddit Orange Fire) +- Secondary: #FF6347 (Tomato) +- Accent: #FFD700 (Gold) + +**Frost Colors:** +- Primary: #00CED1 (Dark Turquoise) +- Secondary: #4682B4 (Steel Blue) +- Accent: #E0FFFF (Light Cyan) + +**Neutral:** +- Background Dark: #2C2C2C +- Background Light: #F5F5F5 +- Text: #FFFFFF / #000000 + +### Logos & Assets + +**Location:** `/root/firefrost-master-configs/branding/` + +- Circular Emblem (512x512) - Social profiles, favicon +- Light Logo - Light backgrounds +- Dark Logo - Dark backgrounds, website +- Backgrounds - Hero images, Discord, social media +- Character Sprites - Gingerfury (Fire) + Frostystyle (Frost) + +--- + +## 📅 IMPLEMENTATION TIMELINE + +### February 2026 (Month 1) - FOUNDATION + +**Week 1 (Feb 8-14):** +- ✅ Phase 0.5 Services 1-3 deployed (Gitea, Uptime Kuma, MkDocs) +- ✅ Automation system operational +- ⏳ Services 4-5 deploying (Wiki.js, NextCloud) +- ⏳ Complete three-tier documentation architecture + +**Week 2 (Feb 15-21):** +- Deploy Netdata (analytics.firefrostgaming.com) +- Deploy Vaultwarden (vault.firefrostgaming.com) +- Complete Phase 0.5 (100% - 5/5 services) +- Begin Phase 1: Simplified DDoS protection + +**Week 3-4 (Feb 22 - Mar 7):** +- Paymenter billing integration +- Subscriber portal testing +- Staff documentation creation +- Soft launch preparation + +### March 2026 (Month 2) - SOFT LAUNCH + +**Weeks 1-2:** +- Soft launch to existing community (3 members) +- Test subscriber workflow end-to-end +- Validate world download process +- Gather feedback, iterate + +**Weeks 3-4:** +- Public announcement preparation +- Content creation (public docs) +- Social media setup (Meg's domain) +- Discord structure finalization + +### April-June 2026 (Months 3-5) - PUBLIC LAUNCH + +**April:** +- Public launch +- Social media campaigns +- Recruit first 20 subscribers +- Monitor Phase 1 auth (manual) + +**May:** +- Evaluate Phase 2 auth automation trigger +- Staff recruitment (builders, social media) +- Begin LuckPerms implementation + +**June:** +- Reach 50 subscribers (target) +- Deploy Phase 2 auth if needed +- Website v1.0 launch + +### July-December 2026 (Months 6-12) - GROWTH & REFINEMENT + +**Ongoing:** +- Scale infrastructure as needed +- Add new modpacks based on votes +- Iterate on subscriber experience +- Meg's social media campaigns +- Community events (Fire vs Frost competitions) + +--- + +## 🛠️ TECHNICAL DEBT & IMPROVEMENTS + +### Immediate Priorities (Next 7 Days) + +1. **Complete Phase 0.5** (Services 4-5) +2. **Test subscriber workflow** end-to-end +3. **Document staff SOPs** in staff Wiki +4. **Webhook setup** for MkDocs auto-rebuild + +### Short-Term (Next 30 Days) + +1. **Netdata deployment** (analytics) +2. **Vaultwarden deployment** (password manager) +3. **LuckPerms MySQL** backend (centralized permissions) +4. **World backup automation** (monthly snapshots) + +### Medium-Term (Next 90 Days) + +1. **Phase 2 Authentication** (webhook automation) +2. **Website v1.0** (firefrostgaming.com) +3. **Staff recruitment** (2-3 builders, 1 social media) +4. **Pterodactyl extensions** (Discord integration) + +### Long-Term (6-12 Months) + +1. **Phase 3 Authentication** (SSO) if needed +2. **Custom modpack development** +3. **API for external integrations** +4. **Mobile app** (subscriber portal) + +--- + +## 📊 SUCCESS METRICS + +### Technical Metrics + +- **Uptime:** >99.5% (tracked via Uptime Kuma) +- **Response Time:** <100ms (Nginx) +- **TPS (Game Servers):** Stable 20.0 +- **Automation Success Rate:** >95% + +### Business Metrics + +- **Month 1:** 3 subscribers (soft launch) +- **Month 3:** 20 subscribers (public launch) +- **Month 6:** 50 subscribers +- **Month 12:** 100+ subscribers + +**Revenue Targets:** +- Month 1: $15/month (validation) +- Month 3: $100/month (break-even operations) +- Month 6: $250/month (sustainable) +- Month 12: $500+/month (growth mode) + +### Community Metrics + +- **Discord Activity:** Daily active users +- **Fire vs Frost Balance:** 45-55% split (competitive balance) +- **Subscriber Retention:** >80% monthly +- **Support Response Time:** <24 hours + +--- + +## 🚨 CRITICAL CONSTRAINTS + +### Medical Accessibility + +**Michael's Limitations:** +- Type 1 Diabetes - Jack alerts take absolute priority +- Hand limitations from surgery - all code in small blocks (8-10 lines max) +- Work sessions must allow for health breaks +- Automation system critical for reducing repetitive tasks + +**System Designed Around:** +- One-paste deployments +- Self-healing services (systemd) +- Comprehensive documentation for handoffs +- Minimal midnight emergencies + +### Relationship with Breezehost + +**"Forever Home" Provider:** +- Long-term partnership, not transactional +- Jon Beard (Network Specialist) - primary contact +- Trust-based relationship (6+ months) +- Infrastructure decisions made together + +**Critical:** Maintain this relationship, communicate proactively + +--- + +## 📖 CURRENT DOCUMENTATION + +### Operational Documents (Keep In Root) + +1. **FIREFROST-PROJECT-SCOPE-V2.md** (THIS DOCUMENT) +2. **session-handoff.md** - Current status for Claude sessions +3. **workflow-guide.md** - Michael + Claude collaboration process +4. **design-bible-v1.1.md** - Visual identity guide +5. **path-philosophy.md** - Fire vs Frost explained +6. **subscription-tiers-final.md** - Detailed tier breakdown +7. **awakened-gateway.md** - $1 handshake philosophy +8. **provider-communications.md** - Breezehost relationship archive +9. **visual-assets-guide.md** - Asset inventory & usage +10. **server-deletion-policy.md** - World backup policy + +### Deployment Documentation + +1. **gitea-deployment.md** - Service 1/5 deployment guide +2. **uptime-kuma-deployment.md** - Service 2/5 deployment guide +3. **automation/USAGE.md** - Automation system guide + +### Archived (docs/archive/2026-02-09-consolidation/) + +- Historical session summaries (Feb 8-9) +- Superseded planning documents +- Old implementation plans +- Planning docs not yet executed + +--- + +## 🎯 THE PATH FORWARD + +### This Week (Feb 9-15, 2026) + +**Monday (TODAY):** +- [x] Consolidate documentation (this document) +- [ ] Complete Services 4-5 (Wiki.js, NextCloud) +- [ ] Test subscriber workflow +- [ ] Create staff documentation structure + +**Tuesday-Wednesday:** +- [ ] Deploy Netdata (Service 6 - analytics) +- [ ] Deploy Vaultwarden (Service 7 - passwords) +- [ ] Complete Phase 0.5 (100%) + +**Thursday-Friday:** +- [ ] Staff SOPs written in staff Wiki +- [ ] World backup automation script +- [ ] Subscriber onboarding checklist + +**Weekend:** +- [ ] Test complete subscriber experience +- [ ] Document any issues +- [ ] Prepare for soft launch + +### Next Week (Feb 16-22, 2026) + +- Soft launch to existing community +- Iterate based on feedback +- Begin Phase 1 (Simplified DDoS) +- Social media setup (Meg) + +--- + +## 🔥❄️ FINAL NOTES + +**This document is the single source of truth.** + +When in doubt about priorities, architecture decisions, or project scope, refer to this document. All other documents are either: +- Historical (archived) +- Operational guides (specific technical details) +- Future planning (not yet prioritized) + +**Update Schedule:** +- Minor updates: As needed (via Git) +- Major review: Monthly (1st of each month) +- Version bump: When major pivots occur + +**Document Owner:** Michael "Frostystyle" Krause + +**Last Major Update:** February 9, 2026 - Post-automation deployment, pre-subscriber portal launch + +--- + +**Fire + Frost = Where Passion Meets Precision** 🔥❄️ + +*Built for marathon sessions. Designed for accessibility. Optimized for growth.* + +SCOPEEOF + +# Update INDEX.md +cat > docs/INDEX.md << 'INDEXEOF' +# 🔥❄️ Firefrost Gaming Documentation Index + +**Last Updated:** February 9, 2026 +**Status:** Reorganized & Current +**Purpose:** Central navigation for all Firefrost Gaming documentation + +--- + +## 🚀 START HERE + +**New team members, Claude sessions, or quick reference:** + +### **THE MASTER DOCUMENT** +📋 **[FIREFROST-PROJECT-SCOPE-V2.md](FIREFROST-PROJECT-SCOPE-V2.md)** ⭐ +*The complete technical & business vision - single source of truth* + +### **ESSENTIAL CONTEXT** +- 📝 [session-handoff.md](session-handoff.md) - Current status for Claude +- 🤝 [workflow-guide.md](workflow-guide.md) - How Michael & Claude work together +- 🎨 [design-bible-v1.1.md](design-bible-v1.1.md) - Visual identity & branding +- ⚖️ [path-philosophy.md](path-philosophy.md) - Fire vs Frost philosophy + +--- + +## 📚 OPERATIONAL DOCUMENTATION + +### **Infrastructure & Deployment** +- 🔧 [gitea-deployment.md](gitea-deployment.md) - Service 1/5: Git version control +- 📊 [uptime-kuma-deployment.md](uptime-kuma-deployment.md) - Service 2/5: Monitoring +- 🤖 [automation/USAGE.md](../automation/USAGE.md) - Automation system guide + +### **Business & Community** +- 💰 [subscription-tiers-final.md](subscription-tiers-final.md) - Tier structure +- 🤝 [awakened-gateway.md](awakened-gateway.md) - The $1 handshake +- 🗑️ [server-deletion-policy.md](server-deletion-policy.md) - World backup policy + +### **Assets & Branding** +- 🎨 [visual-assets-guide.md](visual-assets-guide.md) - Logo, backgrounds, sprites + +### **Relationships** +- 📞 [provider-communications.md](provider-communications.md) - Breezehost partnership + +--- + +## 📦 ARCHIVED DOCUMENTATION + +**Location:** `docs/archive/2026-02-09-consolidation/` + +Historical session summaries, superseded plans, and outdated documentation moved to archive for reference. + +**Archived documents:** +- Session summaries (Feb 8-9, 2026) +- Old implementation plans +- Superseded task lists +- Planning documents not yet executed +- Social media planning (Meg's future domain) + +**When to reference archive:** +- Understanding historical decisions +- Reviewing what approaches were tried +- Learning from past pivots + +--- + +## 🎯 QUICK REFERENCE + +### **Current Phase** +Phase 0.5: Management Services (60% complete - 3/5 deployed) + +### **What's Operational** +- ✅ Gitea (git.firefrostgaming.com) +- ✅ Uptime Kuma (uptime.firefrostgaming.com) +- ✅ MkDocs Public Docs (docs.firefrostgaming.com) +- ✅ Automation System (95% reduction in manual work) +- ✅ 12 Game Servers (6 NC1, 6 TX1) + +### **What's Deploying** +- ⏳ Wiki.js Subscriber Portal (subscribers.firefrostgaming.com) +- ⏳ NextCloud Downloads (downloads.firefrostgaming.com) +- ⏳ Wiki.js Staff Portal (staff.firefrostgaming.com) + +### **Next Priorities** +1. Complete three-tier documentation (today) +2. Deploy Netdata analytics (this week) +3. Deploy Vaultwarden passwords (this week) +4. Soft launch to community (next week) + +--- + +## 📖 DOCUMENTATION PHILOSOPHY + +**One source of truth:** FIREFROST-PROJECT-SCOPE-V2.md +**Specific details:** Individual deployment guides +**Historical context:** Archive folder +**Future planning:** Noted in Project Scope + +**Keep it simple. Keep it current. Keep it accessible.** + +--- + +**Fire + Frost = Where Passion Meets Precision** 🔥❄️ + +*Last major reorganization: February 9, 2026* +INDEXEOF + +# Create archive README +cat > docs/archive/2026-02-09-consolidation/README.md << 'ARCHIVEEOF' +# Archived Documentation - February 9, 2026 Consolidation + +**Archive Date:** February 9, 2026 +**Reason:** Documentation consolidation and reorganization +**Superseded By:** FIREFROST-PROJECT-SCOPE-V2.md + +--- + +## What's in This Archive + +This folder contains documentation that was either: +1. **Historical** - Session summaries from completed work +2. **Superseded** - Replaced by updated versions +3. **Planning** - Future plans not yet prioritized + +**These documents are kept for reference, not current operations.** + +--- + +## Archived Documents + +### Historical Session Summaries +- `session-summary-feb8-2026.md` - Infrastructure security audit +- `session-summary-gitea.md` - Gitea deployment details +- `session-gitea-migration-feb8-2026.md` - Migration from Command Center +- `session-uptime-kuma-github-mirror-feb9-2026.md` - Uptime Kuma deployment + +### Superseded Planning Documents +- `firefrost-master-implementation-plan.md` - Replaced by Project Scope V2 +- `session-handoff-prompt.md` - Old version, replaced by session-handoff.md +- `TASKS.md` - Task list outdated by pivots + +### Future Planning (Not Yet Prioritized) +- `pterodactyl-extensions-plan.md` - Extensions for Pterodactyl +- `staff-recruitment-planning.md` - Hiring plans +- `luckperms-structure.md` - Permission system design +- `firefrost-shopping-list.md` - Budget planning +- `architecture-decisions.md` - Historical decision log + +### Social & Website Planning (Meg's Domain) +- `firefrost-social-strategy.md` - Social media strategy +- `megs-social-setup-guide.md` - Meg's tutorial +- `website-vision-plan.md` - Website architecture +- `discord-structure-complete.md` - Discord setup + +--- + +## Why Archive Instead of Delete? + +**We archive rather than delete because:** +1. **Historical Context** - Understanding past decisions +2. **Learning** - Reviewing what worked and what didn't +3. **Reference** - Details that might be useful later +4. **Audit Trail** - Complete project history + +**These documents tell the story of how Firefrost Gaming evolved.** + +--- + +## Using Archived Documents + +**DO:** +- Reference for historical context +- Learn from past approaches +- Understand decision-making process + +**DON'T:** +- Use as current operational guidance +- Assume details are up-to-date +- Follow outdated procedures + +**For current information, always refer to:** `docs/FIREFROST-PROJECT-SCOPE-V2.md` + +--- + +**Archived by:** Michael "Frostystyle" Krause +**Date:** February 9, 2026 + +ARCHIVEEOF + +# Commit everything +git add -A +git commit -m "Major documentation consolidation - V2.0 + +Created new single source of truth: +- FIREFROST-PROJECT-SCOPE-V2.md (complete vision) +- Archived 13 outdated/superseded documents +- Updated INDEX.md with clear navigation +- Reflects current state (60% Phase 0.5, automation system) + +Key updates: +- Three-tier documentation architecture documented +- Automation system fully described +- Authentication phased approach included +- BookStack→MkDocs pivot captured +- Clear current vs future priorities + +All historical docs preserved in archive for reference. +Clean slate for moving forward." + +git push + +echo "" +echo "=== CONSOLIDATION COMPLETE ===" +echo "" +echo "Created:" +echo " - docs/FIREFROST-PROJECT-SCOPE-V2.md (MASTER DOCUMENT)" +echo " - docs/INDEX.md (updated navigation)" +echo " - docs/archive/2026-02-09-consolidation/ (13 docs archived)" +echo "" +echo "The documentation is now clean, current, and consolidated!" +echo "Single source of truth: FIREFROST-PROJECT-SCOPE-V2.md" +echo "" diff --git a/automation/results/consolidate-documentation_result.txt b/automation/results/consolidate-documentation_result.txt new file mode 100644 index 0000000..9a413aa --- /dev/null +++ b/automation/results/consolidate-documentation_result.txt @@ -0,0 +1,7 @@ +Task: consolidate-documentation.sh +Started: Mon Feb 9 11:46:51 AM CST 2026 +========================================== +=== Documentation Consolidation - February 9, 2026 === +Mon Feb 9 11:46:51 AM CST 2026 +Moving outdated documents to archive... +Archive complete - 13 documents moved diff --git a/docs/FIREFROST-PROJECT-SCOPE-V2.md b/docs/FIREFROST-PROJECT-SCOPE-V2.md new file mode 100644 index 0000000..b56f8df --- /dev/null +++ b/docs/FIREFROST-PROJECT-SCOPE-V2.md @@ -0,0 +1,547 @@ +# 🔥❄️ FIREFROST GAMING: PROJECT SCOPE V2.0 + +**The Complete Technical & Business Vision** + +--- + +**Document Version:** 2.0 +**Created:** February 9, 2026 +**Supersedes:** firefrost-master-implementation-plan.md (v1.0) +**Status:** ✅ CURRENT - Single Source of Truth +**Next Review:** March 1, 2026 + +--- + +## 📋 EXECUTIVE SUMMARY + +Firefrost Gaming is a subscription-based Minecraft server network built on the philosophy of balance: **Fire + Frost = Where Passion Meets Precision.** + +**Current Status (Feb 9, 2026):** +- 12 game servers operational (6 NC1, 6 TX1) +- Phase 0.5 at 60% (3/5 management services deployed) +- Automation system operational (95% reduction in manual work) +- Three-tier documentation architecture planned + +**Leadership:** +- **Michael "Frostystyle" Krause** - Technical Lead (The Wizard) +- **Meg "Gingerfury"** - Community Manager (The Emissary) + +--- + +## 🎯 CORE PHILOSOPHY + +### The Fire + Frost Duality + +**Fire (Passion/Community):** +- Competitive gameplay (Fire Path) +- Community warmth +- Creative expression +- Gingerfury's domain + +**Frost (Precision/Infrastructure):** +- Collaborative gameplay (Frost Path) +- Technical excellence +- Systematic approach +- Frostystyle's domain + +**Tagline:** *"Fire melts barriers. Frost builds foundations."* + +--- + +## 🏗️ INFRASTRUCTURE STATUS + +### Deployed Services (Phase 0.5: 60% Complete) + +**✅ Service 1/5: Gitea** (git.firefrostgaming.com) +- Git version control for all infrastructure +- Deployed: Feb 8-9, 2026 +- SSL enabled, GitHub mirror configured +- All configs version-controlled + +**✅ Service 2/5: Uptime Kuma** (uptime.firefrostgaming.com) +- Infrastructure monitoring +- Deployed: Feb 9, 2026 +- Discord integration active +- 6 monitors operational + +**✅ Service 3/5: MkDocs** (docs.firefrostgaming.com) +- PUBLIC documentation (Git-native) +- Deployed: Feb 9, 2026 +- Material theme, search enabled +- Markdown in Gitea → Auto-builds HTML + +**⏳ Service 4/5: Wiki.js** (subscribers.firefrostgaming.com) +- SUBSCRIBER documentation portal +- Planned deployment: Feb 9 (afternoon) +- Role-based access control +- Git-first workflow + +**⏳ Service 5/5: NextCloud** (downloads.firefrostgaming.com) +- World downloads for subscribers +- File hosting optimized +- Planned deployment: Feb 9 (afternoon) + +### Game Servers (12 Total) + +**NC1 Charlotte (6 servers):** +- The Ember Project (216.239.104.130:25565) +- Minecolonies (216.239.104.131:25565) +- All The Mods 10 (216.239.104.134:25565) +- Homestead (216.239.104.133:25566) +- Hytale (216.239.104.131:5520) +- EMC Subterra Tech (216.239.104.132:25566) + +**TX1 Dallas (6 servers):** +- Stoneblock 4 (38.68.14.26:25565) +- Reclamation (38.68.14.27:25565) +- Society: Sunlit Valley (38.68.14.28:25565) +- Vanilla 1.21.1 (38.68.14.29:25565) +- All The Mons (38.68.14.30:25565) +- FoundryVTT (38.68.14.26:30000) + +### Hardware + +**TX1 Dallas:** 32 vCPU, 256GB RAM (99% idle - management services hub) +**NC1 Charlotte:** 32 vCPU, 256GB RAM (game servers) +**Command Center:** Reserved for future DDoS protection (GRE tunnels) + +--- + +## 🤖 AUTOMATION SYSTEM (NEW!) + +### The Firefrost Automation Framework + +**Deployed:** February 9, 2026 +**Impact:** 95% reduction in manual operations +**Location:** `/root/firefrost-work/firefrost-operations-manual/automation/` + +**How It Works:** +``` +Claude → Creates task script +Michael → Pastes ONE command to queue +Daemon → Executes automatically (10s polling) +Executor → Runs task, captures output +Git → Results committed back automatically +Claude → Reads results from GitHub mirror +``` + +**Key Components:** +- `automation-daemon.sh` - Background watcher (PID management) +- `executor.sh` - Task runner with auto-commit +- `queue/` - Tasks waiting to execute +- `results/` - Execution output (committed to Git) +- `logs/` - Completed tasks archive + +**Success Metrics:** +- Test Task 001: SUCCESS (exit 0) +- Test Task 002: SUCCESS (automated execution) +- BookStack deployment: 2 minutes (previously would take 20+ minutes) +- MkDocs deployment: 1.5 minutes + +**Accessibility Impact:** +- Michael's hand limitations accommodated +- Single paste operation per deployment +- All work auditable in Git history +- Perfect for marathon sessions + +--- + +## 📚 THREE-TIER DOCUMENTATION ARCHITECTURE + +### The Complete Documentation Strategy + +**Tier 1: PUBLIC (docs.firefrostgaming.com)** +- Technology: MkDocs + Material Theme +- Authentication: None required +- Content: Server rules, getting started, modpack info +- Workflow: Edit markdown in Gitea → Auto-rebuild +- Status: ✅ DEPLOYED Feb 9, 2026 + +**Tier 2: SUBSCRIBERS (subscribers.firefrostgaming.com + downloads.firefrostgaming.com)** +- Documentation: Wiki.js (premium guides, exclusive content) +- Downloads: NextCloud (world backups, custom modpacks) +- Authentication: Subscriber login required +- Content: Premium guides, world downloads, exclusive perks +- Workflow: Edit in Wiki.js UI OR Git +- Status: ⏳ DEPLOYING Feb 9 afternoon + +**Tier 3: STAFF (staff.firefrostgaming.com)** +- Technology: Wiki.js +- Authentication: Staff/Admin only +- Content: SOPs, admin procedures, internal guides +- Workflow: Edit in Wiki.js UI OR Git +- Status: ⏳ DEPLOYING Feb 9 afternoon + +### Why Three Tiers? + +**Problem Solved:** +- Public can access basic info (no barriers) +- Subscribers get premium value (world downloads!) +- Staff have secure internal documentation +- Each tier isolated (different security boundaries) +- Git-first workflow maintained (Michael's requirement) +- UI-first editing available (Meg's preference) + +--- + +## 💰 SUBSCRIPTION MODEL + +### Tier Structure + +**Free Tier - "The Frozen Path"** +- Discord access (public channels) +- Forum access +- View public documentation +- No server access + +**$1/month - "The Awakened Gateway" (The Handshake)** +- Purpose: Anti-bot/anti-grief barrier +- Philosophy: "If you want to be an asshole, you have to pay for it" +- Not a revenue stream - a security protocol +- Server whitelist access +- Basic support + +**$5/month - "Elemental Tier"** +- CHOOSE YOUR PATH: Fire or Frost +- Full server access (13+ modpacks) +- Subscriber documentation portal +- World download access (30-day retention) +- Priority support +- Path-specific Discord channels + +**$10/month - "Ascendant Tier"** +- Everything from Elemental +- Vote on new modpacks +- Custom modpack requests +- Extended world downloads (90 days) +- Beta access to new servers + +**$25/month - "Eternal Flame/Eternal Frost"** +- Everything from Ascendant +- Permanent world download access +- Direct line to founders +- Server naming rights +- Custom spawn builds + +### Fire vs Frost Paths + +**Identical mechanical perks, different community identity:** + +**🔥 Path of Fire:** +- Discord: Ignis channels (18+ only) +- Focus: Competitive gameplay, PvP, challenges +- Led by: Gingerfury (The Emissary) + +**❄️ Path of Frost:** +- Discord: Frost channels (all ages welcome) +- Focus: Collaborative builds, exploration, creativity +- Led by: Frostystyle (The Wizard) + +**Competitive Element:** Michael vs Meg - who recruits more to their path? + +--- + +## 🔐 AUTHENTICATION STRATEGY + +### Phased Implementation + +**Phase 1: Manual Management** (Current - Launch to 20 subscribers) +- Subscriber pays via Paymenter +- Manual account creation (Wiki.js + NextCloud) +- Email credentials +- Track expirations in spreadsheet +- **Advantage:** Zero dev time, validates market + +**Phase 2: Webhook Automation** (20+ subscribers) +- Paymenter webhooks trigger scripts +- Automatic account creation/deletion +- Automated credential emails +- **Development:** 3-4 hours +- **Trigger:** When manual work becomes burden + +**Phase 3: SSO/OAuth** (100+ subscribers - optional) +- Single sign-on across all services +- Real-time subscription validation +- Enterprise-grade auth +- **Development:** 8-12 hours +- **Trigger:** Only if subscriber count justifies complexity + +**Decision:** Start Phase 1, upgrade to Phase 2 when needed + +--- + +## 🎨 BRANDING & VISUAL IDENTITY + +### Color Palette + +**Fire Colors:** +- Primary: #FF4500 (Reddit Orange Fire) +- Secondary: #FF6347 (Tomato) +- Accent: #FFD700 (Gold) + +**Frost Colors:** +- Primary: #00CED1 (Dark Turquoise) +- Secondary: #4682B4 (Steel Blue) +- Accent: #E0FFFF (Light Cyan) + +**Neutral:** +- Background Dark: #2C2C2C +- Background Light: #F5F5F5 +- Text: #FFFFFF / #000000 + +### Logos & Assets + +**Location:** `/root/firefrost-master-configs/branding/` + +- Circular Emblem (512x512) - Social profiles, favicon +- Light Logo - Light backgrounds +- Dark Logo - Dark backgrounds, website +- Backgrounds - Hero images, Discord, social media +- Character Sprites - Gingerfury (Fire) + Frostystyle (Frost) + +--- + +## 📅 IMPLEMENTATION TIMELINE + +### February 2026 (Month 1) - FOUNDATION + +**Week 1 (Feb 8-14):** +- ✅ Phase 0.5 Services 1-3 deployed (Gitea, Uptime Kuma, MkDocs) +- ✅ Automation system operational +- ⏳ Services 4-5 deploying (Wiki.js, NextCloud) +- ⏳ Complete three-tier documentation architecture + +**Week 2 (Feb 15-21):** +- Deploy Netdata (analytics.firefrostgaming.com) +- Deploy Vaultwarden (vault.firefrostgaming.com) +- Complete Phase 0.5 (100% - 5/5 services) +- Begin Phase 1: Simplified DDoS protection + +**Week 3-4 (Feb 22 - Mar 7):** +- Paymenter billing integration +- Subscriber portal testing +- Staff documentation creation +- Soft launch preparation + +### March 2026 (Month 2) - SOFT LAUNCH + +**Weeks 1-2:** +- Soft launch to existing community (3 members) +- Test subscriber workflow end-to-end +- Validate world download process +- Gather feedback, iterate + +**Weeks 3-4:** +- Public announcement preparation +- Content creation (public docs) +- Social media setup (Meg's domain) +- Discord structure finalization + +### April-June 2026 (Months 3-5) - PUBLIC LAUNCH + +**April:** +- Public launch +- Social media campaigns +- Recruit first 20 subscribers +- Monitor Phase 1 auth (manual) + +**May:** +- Evaluate Phase 2 auth automation trigger +- Staff recruitment (builders, social media) +- Begin LuckPerms implementation + +**June:** +- Reach 50 subscribers (target) +- Deploy Phase 2 auth if needed +- Website v1.0 launch + +### July-December 2026 (Months 6-12) - GROWTH & REFINEMENT + +**Ongoing:** +- Scale infrastructure as needed +- Add new modpacks based on votes +- Iterate on subscriber experience +- Meg's social media campaigns +- Community events (Fire vs Frost competitions) + +--- + +## 🛠️ TECHNICAL DEBT & IMPROVEMENTS + +### Immediate Priorities (Next 7 Days) + +1. **Complete Phase 0.5** (Services 4-5) +2. **Test subscriber workflow** end-to-end +3. **Document staff SOPs** in staff Wiki +4. **Webhook setup** for MkDocs auto-rebuild + +### Short-Term (Next 30 Days) + +1. **Netdata deployment** (analytics) +2. **Vaultwarden deployment** (password manager) +3. **LuckPerms MySQL** backend (centralized permissions) +4. **World backup automation** (monthly snapshots) + +### Medium-Term (Next 90 Days) + +1. **Phase 2 Authentication** (webhook automation) +2. **Website v1.0** (firefrostgaming.com) +3. **Staff recruitment** (2-3 builders, 1 social media) +4. **Pterodactyl extensions** (Discord integration) + +### Long-Term (6-12 Months) + +1. **Phase 3 Authentication** (SSO) if needed +2. **Custom modpack development** +3. **API for external integrations** +4. **Mobile app** (subscriber portal) + +--- + +## 📊 SUCCESS METRICS + +### Technical Metrics + +- **Uptime:** >99.5% (tracked via Uptime Kuma) +- **Response Time:** <100ms (Nginx) +- **TPS (Game Servers):** Stable 20.0 +- **Automation Success Rate:** >95% + +### Business Metrics + +- **Month 1:** 3 subscribers (soft launch) +- **Month 3:** 20 subscribers (public launch) +- **Month 6:** 50 subscribers +- **Month 12:** 100+ subscribers + +**Revenue Targets:** +- Month 1: $15/month (validation) +- Month 3: $100/month (break-even operations) +- Month 6: $250/month (sustainable) +- Month 12: $500+/month (growth mode) + +### Community Metrics + +- **Discord Activity:** Daily active users +- **Fire vs Frost Balance:** 45-55% split (competitive balance) +- **Subscriber Retention:** >80% monthly +- **Support Response Time:** <24 hours + +--- + +## 🚨 CRITICAL CONSTRAINTS + +### Medical Accessibility + +**Michael's Limitations:** +- Type 1 Diabetes - Jack alerts take absolute priority +- Hand limitations from surgery - all code in small blocks (8-10 lines max) +- Work sessions must allow for health breaks +- Automation system critical for reducing repetitive tasks + +**System Designed Around:** +- One-paste deployments +- Self-healing services (systemd) +- Comprehensive documentation for handoffs +- Minimal midnight emergencies + +### Relationship with Breezehost + +**"Forever Home" Provider:** +- Long-term partnership, not transactional +- Jon Beard (Network Specialist) - primary contact +- Trust-based relationship (6+ months) +- Infrastructure decisions made together + +**Critical:** Maintain this relationship, communicate proactively + +--- + +## 📖 CURRENT DOCUMENTATION + +### Operational Documents (Keep In Root) + +1. **FIREFROST-PROJECT-SCOPE-V2.md** (THIS DOCUMENT) +2. **session-handoff.md** - Current status for Claude sessions +3. **workflow-guide.md** - Michael + Claude collaboration process +4. **design-bible-v1.1.md** - Visual identity guide +5. **path-philosophy.md** - Fire vs Frost explained +6. **subscription-tiers-final.md** - Detailed tier breakdown +7. **awakened-gateway.md** - $1 handshake philosophy +8. **provider-communications.md** - Breezehost relationship archive +9. **visual-assets-guide.md** - Asset inventory & usage +10. **server-deletion-policy.md** - World backup policy + +### Deployment Documentation + +1. **gitea-deployment.md** - Service 1/5 deployment guide +2. **uptime-kuma-deployment.md** - Service 2/5 deployment guide +3. **automation/USAGE.md** - Automation system guide + +### Archived (docs/archive/2026-02-09-consolidation/) + +- Historical session summaries (Feb 8-9) +- Superseded planning documents +- Old implementation plans +- Planning docs not yet executed + +--- + +## 🎯 THE PATH FORWARD + +### This Week (Feb 9-15, 2026) + +**Monday (TODAY):** +- [x] Consolidate documentation (this document) +- [ ] Complete Services 4-5 (Wiki.js, NextCloud) +- [ ] Test subscriber workflow +- [ ] Create staff documentation structure + +**Tuesday-Wednesday:** +- [ ] Deploy Netdata (Service 6 - analytics) +- [ ] Deploy Vaultwarden (Service 7 - passwords) +- [ ] Complete Phase 0.5 (100%) + +**Thursday-Friday:** +- [ ] Staff SOPs written in staff Wiki +- [ ] World backup automation script +- [ ] Subscriber onboarding checklist + +**Weekend:** +- [ ] Test complete subscriber experience +- [ ] Document any issues +- [ ] Prepare for soft launch + +### Next Week (Feb 16-22, 2026) + +- Soft launch to existing community +- Iterate based on feedback +- Begin Phase 1 (Simplified DDoS) +- Social media setup (Meg) + +--- + +## 🔥❄️ FINAL NOTES + +**This document is the single source of truth.** + +When in doubt about priorities, architecture decisions, or project scope, refer to this document. All other documents are either: +- Historical (archived) +- Operational guides (specific technical details) +- Future planning (not yet prioritized) + +**Update Schedule:** +- Minor updates: As needed (via Git) +- Major review: Monthly (1st of each month) +- Version bump: When major pivots occur + +**Document Owner:** Michael "Frostystyle" Krause + +**Last Major Update:** February 9, 2026 - Post-automation deployment, pre-subscriber portal launch + +--- + +**Fire + Frost = Where Passion Meets Precision** 🔥❄️ + +*Built for marathon sessions. Designed for accessibility. Optimized for growth.* + diff --git a/docs/INDEX.md b/docs/INDEX.md index 35f1ce0..db39fc1 100644 --- a/docs/INDEX.md +++ b/docs/INDEX.md @@ -1,211 +1,103 @@ -# Firefrost Gaming Documentation Index +# 🔥❄️ Firefrost Gaming Documentation Index -**Last Updated:** February 9, 2026 -**Total Documents:** 28+ markdown files -**Purpose:** Central navigation hub for all Firefrost Gaming documentation +**Last Updated:** February 9, 2026 +**Status:** Reorganized & Current +**Purpose:** Central navigation for all Firefrost Gaming documentation --- -## 🚀 Start Here (New Team Members) +## 🚀 START HERE -Essential documents to understand Firefrost Gaming and how we work: +**New team members, Claude sessions, or quick reference:** -- **[TECHNICAL_README.md](TECHNICAL_README.md)** - Technical overview and setup guide -- **[workflow-guide.md](workflow-guide.md)** - How Michael & Meg collaborate, work sessions -- **[session-handoff.md](session-handoff.md)** - Current project status, context for Claude sessions -- **[path-philosophy.md](path-philosophy.md)** - Fire vs Frost concept explained +### **THE MASTER DOCUMENT** +📋 **[FIREFROST-PROJECT-SCOPE-V2.md](FIREFROST-PROJECT-SCOPE-V2.md)** ⭐ +*The complete technical & business vision - single source of truth* + +### **ESSENTIAL CONTEXT** +- 📝 [session-handoff.md](session-handoff.md) - Current status for Claude +- 🤝 [workflow-guide.md](workflow-guide.md) - How Michael & Claude work together +- 🎨 [design-bible-v1.1.md](design-bible-v1.1.md) - Visual identity & branding +- ⚖️ [path-philosophy.md](path-philosophy.md) - Fire vs Frost philosophy --- -## 📋 Infrastructure & Technical +## 📚 OPERATIONAL DOCUMENTATION -Core infrastructure documentation and deployment records: +### **Infrastructure & Deployment** +- 🔧 [gitea-deployment.md](gitea-deployment.md) - Service 1/5: Git version control +- 📊 [uptime-kuma-deployment.md](uptime-kuma-deployment.md) - Service 2/5: Monitoring +- 🤖 [automation/USAGE.md](../automation/USAGE.md) - Automation system guide -### Current Status -- **[TASKS.md](TASKS.md)** - Active task tracking, phase completion status -- **[architecture-decisions.md](architecture-decisions.md)** - Why we built things this way +### **Business & Community** +- 💰 [subscription-tiers-final.md](subscription-tiers-final.md) - Tier structure +- 🤝 [awakened-gateway.md](awakened-gateway.md) - The $1 handshake +- 🗑️ [server-deletion-policy.md](server-deletion-policy.md) - World backup policy -### Deployment Documentation -- **[gitea-deployment.md](gitea-deployment.md)** - Service 1/5: Git repository (completed Feb 8) -- **[uptime-kuma-deployment.md](uptime-kuma-deployment.md)** - Service 2/5: Monitoring (completed Feb 9) +### **Assets & Branding** +- 🎨 [visual-assets-guide.md](visual-assets-guide.md) - Logo, backgrounds, sprites -### Infrastructure Diagrams -- **[firefrost-infrastructure-diagram.mermaid](firefrost-infrastructure-diagram.mermaid)** - Mermaid.js diagram -- **[diagrams/](diagrams/)** - Visual infrastructure maps (PNG format) +### **Relationships** +- 📞 [provider-communications.md](provider-communications.md) - Breezehost partnership --- -## 🎯 Master Planning Documents +## 📦 ARCHIVED DOCUMENTATION -High-level vision, strategy, and implementation roadmaps: +**Location:** `docs/archive/2026-02-09-consolidation/` -- **[firefrost-master-implementation-plan.md](firefrost-master-implementation-plan.md)** - 12-month roadmap, 6 phases -- **[design-bible-v1.md](design-bible-v1.md)** - Complete design vision, comprehensive strategy -- **[awakened-gateway.md](awakened-gateway.md)** - The Awakened tier philosophy and gateway concept +Historical session summaries, superseded plans, and outdated documentation moved to archive for reference. + +**Archived documents:** +- Session summaries (Feb 8-9, 2026) +- Old implementation plans +- Superseded task lists +- Planning documents not yet executed +- Social media planning (Meg's future domain) + +**When to reference archive:** +- Understanding historical decisions +- Reviewing what approaches were tried +- Learning from past pivots --- -## 📝 Session Summaries +## 🎯 QUICK REFERENCE -Detailed records of work sessions with Claude: +### **Current Phase** +Phase 0.5: Management Services (60% complete - 3/5 deployed) -- **[session-uptime-kuma-github-mirror-feb9-2026.md](session-uptime-kuma-github-mirror-feb9-2026.md)** - Feb 9: Uptime Kuma + GitHub mirror -- **[session-gitea-migration-feb8-2026.md](session-gitea-migration-feb8-2026.md)** - Feb 8: Gitea deployment + SSH hardening -- **[session-summary-feb8-2026.md](session-summary-feb8-2026.md)** - Feb 8: Summary and changelog -- **[session-summary-gitea.md](session-summary-gitea.md)** - Gitea migration summary -- **[session-handoff-prompt.md](session-handoff-prompt.md)** - Template for session handoffs +### **What's Operational** +- ✅ Gitea (git.firefrostgaming.com) +- ✅ Uptime Kuma (uptime.firefrostgaming.com) +- ✅ MkDocs Public Docs (docs.firefrostgaming.com) +- ✅ Automation System (95% reduction in manual work) +- ✅ 12 Game Servers (6 NC1, 6 TX1) + +### **What's Deploying** +- ⏳ Wiki.js Subscriber Portal (subscribers.firefrostgaming.com) +- ⏳ NextCloud Downloads (downloads.firefrostgaming.com) +- ⏳ Wiki.js Staff Portal (staff.firefrostgaming.com) + +### **Next Priorities** +1. Complete three-tier documentation (today) +2. Deploy Netdata analytics (this week) +3. Deploy Vaultwarden passwords (this week) +4. Soft launch to community (next week) --- -## 👥 Community & Operations +## 📖 DOCUMENTATION PHILOSOPHY -Discord structure, subscription tiers, staff planning, and permissions: +**One source of truth:** FIREFROST-PROJECT-SCOPE-V2.md +**Specific details:** Individual deployment guides +**Historical context:** Archive folder +**Future planning:** Noted in Project Scope -### Community Structure -- **[discord-structure-complete.md](discord-structure-complete.md)** - Complete Discord server layout (62 channels) -- **[subscription-tiers-final.md](subscription-tiers-final.md)** - 6-tier subscription system (Fire vs Frost paths) -- **[luckperms-structure.md](luckperms-structure.md)** - Permission groups and inheritance - -### Staff & Growth -- **[staff-recruitment-planning.md](staff-recruitment-planning.md)** - Hiring needs, role definitions +**Keep it simple. Keep it current. Keep it accessible.** --- -## 🎨 Marketing & Social Media +**Fire + Frost = Where Passion Meets Precision** 🔥❄️ -Brand presence, content strategy, and launch planning: - -- **[firefrost-social-strategy.md](firefrost-social-strategy.md)** - Multi-platform social media strategy -- **[mega-social-setup-guide.md](mega-social-setup-guide.md)** - Detailed social media setup guide -- **[website-vision-plan.md](website-vision-plan.md)** - Website design and implementation plan -- **[firefrost-shopping-list.md](firefrost-shopping-list.md)** - Tools, services, and resources to acquire - ---- - -## 🔥❄️ Brand & Philosophy - -Fire + Frost identity, visual guidelines, and brand voice: - -- **[path-philosophy.md](path-philosophy.md)** - Fire vs Frost paths explained in depth -- **[visual-assets-guide.md](visual-assets-guide.md)** - Logo usage, colors, typography, brand guidelines - ---- - -## 🔮 Future Planning - -Extensions, features, and roadmap for post-launch: - -- **[pterodactyl-extensions-plan.md](pterodactyl-extensions-plan.md)** - Phase 0.6: 5 Pterodactyl extensions planned - ---- - -## 📞 Reference & Archives - -Provider communications and historical records: - -- **[provider-communications.md](provider-communications.md)** - Breezehost support ticket archive - ---- - -## 🗂️ Document Organization - -### By Phase - -**Phase 0: Infrastructure Foundation** -- TASKS.md -- architecture-decisions.md -- gitea-deployment.md -- uptime-kuma-deployment.md - -**Phase 0.5: Management Services (40% Complete)** -- Service 1: ✅ Gitea -- Service 2: ✅ Uptime Kuma -- Service 3: ⏳ BookStack (NEXT) -- Service 4: ⏳ Netdata -- Service 5: ⏳ Vaultwarden - -**Phase 0.6: Pterodactyl Extensions (Planned)** -- pterodactyl-extensions-plan.md - -**Phase 1: Community Launch** -- discord-structure-complete.md -- subscription-tiers-final.md -- luckperms-structure.md - -**Phase 2: Marketing & Growth** -- firefrost-social-strategy.md -- mega-social-setup-guide.md -- website-vision-plan.md - -### By Role - -**For Michael (The Wizard - Technical Lead):** -- TECHNICAL_README.md -- architecture-decisions.md -- All deployment docs (gitea, uptime-kuma, etc.) -- session-handoff.md - -**For Meg (The Emissary - Community Manager):** -- discord-structure-complete.md -- subscription-tiers-final.md -- staff-recruitment-planning.md -- mega-social-setup-guide.md - -**For Future Staff:** -- workflow-guide.md -- visual-assets-guide.md -- path-philosophy.md - -**For Claude (AI Assistant):** -- session-handoff.md -- TASKS.md -- All session summaries - ---- - -## 📊 Document Stats - -**Total Documents:** 28+ markdown files -**Total Size:** ~500KB of documentation -**Creation Period:** February 7-9, 2026 -**Primary Authors:** Michael "Frostystyle" Krause + Claude (Anthropic) - -**Most Recent Updates:** -1. pterodactyl-extensions-plan.md (Feb 9, 2026) -2. session-uptime-kuma-github-mirror-feb9-2026.md (Feb 9, 2026) -3. uptime-kuma-deployment.md (Feb 9, 2026) -4. session-handoff.md (Feb 9, 2026) -5. TASKS.md (Feb 9, 2026) - ---- - -## 🔍 Quick Search Guide - -**Looking for...** - -- **Current project status?** → TASKS.md, session-handoff.md -- **How to deploy a service?** → gitea-deployment.md, uptime-kuma-deployment.md -- **Discord setup?** → discord-structure-complete.md -- **Subscription info?** → subscription-tiers-final.md -- **Fire vs Frost explained?** → path-philosophy.md -- **Brand guidelines?** → visual-assets-guide.md -- **Social media strategy?** → firefrost-social-strategy.md -- **Master roadmap?** → firefrost-master-implementation-plan.md -- **What's next?** → TASKS.md (Phase 0.5 progress) - ---- - -## 🔄 Maintenance - -**This index should be updated when:** -- New major documents are added -- Phases complete and progress changes -- Document purposes change significantly -- Organizational structure needs revision - -**Last Index Update:** February 9, 2026 -**Next Review:** After Phase 0.5 completion (Services 3-5 deployed) - ---- - -**🔥 Fire + Frost = Where Passion Meets Precision ❄️** +*Last major reorganization: February 9, 2026* diff --git a/docs/archive/2026-02-09-consolidation/README.md b/docs/archive/2026-02-09-consolidation/README.md new file mode 100644 index 0000000..0550a63 --- /dev/null +++ b/docs/archive/2026-02-09-consolidation/README.md @@ -0,0 +1,78 @@ +# Archived Documentation - February 9, 2026 Consolidation + +**Archive Date:** February 9, 2026 +**Reason:** Documentation consolidation and reorganization +**Superseded By:** FIREFROST-PROJECT-SCOPE-V2.md + +--- + +## What's in This Archive + +This folder contains documentation that was either: +1. **Historical** - Session summaries from completed work +2. **Superseded** - Replaced by updated versions +3. **Planning** - Future plans not yet prioritized + +**These documents are kept for reference, not current operations.** + +--- + +## Archived Documents + +### Historical Session Summaries +- `session-summary-feb8-2026.md` - Infrastructure security audit +- `session-summary-gitea.md` - Gitea deployment details +- `session-gitea-migration-feb8-2026.md` - Migration from Command Center +- `session-uptime-kuma-github-mirror-feb9-2026.md` - Uptime Kuma deployment + +### Superseded Planning Documents +- `firefrost-master-implementation-plan.md` - Replaced by Project Scope V2 +- `session-handoff-prompt.md` - Old version, replaced by session-handoff.md +- `TASKS.md` - Task list outdated by pivots + +### Future Planning (Not Yet Prioritized) +- `pterodactyl-extensions-plan.md` - Extensions for Pterodactyl +- `staff-recruitment-planning.md` - Hiring plans +- `luckperms-structure.md` - Permission system design +- `firefrost-shopping-list.md` - Budget planning +- `architecture-decisions.md` - Historical decision log + +### Social & Website Planning (Meg's Domain) +- `firefrost-social-strategy.md` - Social media strategy +- `megs-social-setup-guide.md` - Meg's tutorial +- `website-vision-plan.md` - Website architecture +- `discord-structure-complete.md` - Discord setup + +--- + +## Why Archive Instead of Delete? + +**We archive rather than delete because:** +1. **Historical Context** - Understanding past decisions +2. **Learning** - Reviewing what worked and what didn't +3. **Reference** - Details that might be useful later +4. **Audit Trail** - Complete project history + +**These documents tell the story of how Firefrost Gaming evolved.** + +--- + +## Using Archived Documents + +**DO:** +- Reference for historical context +- Learn from past approaches +- Understand decision-making process + +**DON'T:** +- Use as current operational guidance +- Assume details are up-to-date +- Follow outdated procedures + +**For current information, always refer to:** `docs/FIREFROST-PROJECT-SCOPE-V2.md` + +--- + +**Archived by:** Michael "Frostystyle" Krause +**Date:** February 9, 2026 + diff --git a/docs/TASKS.md b/docs/archive/2026-02-09-consolidation/TASKS.md similarity index 100% rename from docs/TASKS.md rename to docs/archive/2026-02-09-consolidation/TASKS.md diff --git a/docs/architecture-decisions.md b/docs/archive/2026-02-09-consolidation/architecture-decisions.md similarity index 100% rename from docs/architecture-decisions.md rename to docs/archive/2026-02-09-consolidation/architecture-decisions.md diff --git a/docs/discord-structure-complete.md b/docs/archive/2026-02-09-consolidation/discord-structure-complete.md similarity index 100% rename from docs/discord-structure-complete.md rename to docs/archive/2026-02-09-consolidation/discord-structure-complete.md diff --git a/docs/firefrost-master-implementation-plan.md b/docs/archive/2026-02-09-consolidation/firefrost-master-implementation-plan.md similarity index 100% rename from docs/firefrost-master-implementation-plan.md rename to docs/archive/2026-02-09-consolidation/firefrost-master-implementation-plan.md diff --git a/docs/firefrost-shopping-list.md b/docs/archive/2026-02-09-consolidation/firefrost-shopping-list.md similarity index 100% rename from docs/firefrost-shopping-list.md rename to docs/archive/2026-02-09-consolidation/firefrost-shopping-list.md diff --git a/docs/firefrost-social-strategy.md b/docs/archive/2026-02-09-consolidation/firefrost-social-strategy.md similarity index 100% rename from docs/firefrost-social-strategy.md rename to docs/archive/2026-02-09-consolidation/firefrost-social-strategy.md diff --git a/docs/luckperms-structure.md b/docs/archive/2026-02-09-consolidation/luckperms-structure.md similarity index 100% rename from docs/luckperms-structure.md rename to docs/archive/2026-02-09-consolidation/luckperms-structure.md diff --git a/docs/megs-social-setup-guide.md b/docs/archive/2026-02-09-consolidation/megs-social-setup-guide.md similarity index 100% rename from docs/megs-social-setup-guide.md rename to docs/archive/2026-02-09-consolidation/megs-social-setup-guide.md diff --git a/docs/pterodactyl-extensions-plan.md b/docs/archive/2026-02-09-consolidation/pterodactyl-extensions-plan.md similarity index 100% rename from docs/pterodactyl-extensions-plan.md rename to docs/archive/2026-02-09-consolidation/pterodactyl-extensions-plan.md diff --git a/docs/session-gitea-migration-feb8-2026.md b/docs/archive/2026-02-09-consolidation/session-gitea-migration-feb8-2026.md similarity index 100% rename from docs/session-gitea-migration-feb8-2026.md rename to docs/archive/2026-02-09-consolidation/session-gitea-migration-feb8-2026.md diff --git a/docs/session-handoff-prompt.md b/docs/archive/2026-02-09-consolidation/session-handoff-prompt.md similarity index 100% rename from docs/session-handoff-prompt.md rename to docs/archive/2026-02-09-consolidation/session-handoff-prompt.md diff --git a/docs/session-summary-feb8-2026.md b/docs/archive/2026-02-09-consolidation/session-summary-feb8-2026.md similarity index 100% rename from docs/session-summary-feb8-2026.md rename to docs/archive/2026-02-09-consolidation/session-summary-feb8-2026.md diff --git a/docs/session-summary-gitea.md b/docs/archive/2026-02-09-consolidation/session-summary-gitea.md similarity index 100% rename from docs/session-summary-gitea.md rename to docs/archive/2026-02-09-consolidation/session-summary-gitea.md diff --git a/docs/session-uptime-kuma-github-mirror-feb9-2026.md b/docs/archive/2026-02-09-consolidation/session-uptime-kuma-github-mirror-feb9-2026.md similarity index 100% rename from docs/session-uptime-kuma-github-mirror-feb9-2026.md rename to docs/archive/2026-02-09-consolidation/session-uptime-kuma-github-mirror-feb9-2026.md diff --git a/docs/staff-recruitment-planning.md b/docs/archive/2026-02-09-consolidation/staff-recruitment-planning.md similarity index 100% rename from docs/staff-recruitment-planning.md rename to docs/archive/2026-02-09-consolidation/staff-recruitment-planning.md diff --git a/docs/website-vision-plan.md b/docs/archive/2026-02-09-consolidation/website-vision-plan.md similarity index 100% rename from docs/website-vision-plan.md rename to docs/archive/2026-02-09-consolidation/website-vision-plan.md