aethex-forge/docs/GAMEFORGE-ARCHITECTURE.md
2025-11-17 08:47:57 +00:00

244 lines
9.2 KiB
Markdown

# GameForge Architecture: The Ecosystem's Connective Tissue
## Overview
**GameForge is not just one thing.** It has **three distinct, critical roles** in the AeThex ecosystem:
1. **The Product** - A dashboard workspace on aethex.dev (For-Profit)
2. **The Program** - A non-profit mentorship initiative run by AeThex Foundation
3. **The Strategic Asset** - A dual-purpose system that benefits both entities
---
## Role 1: The "Product" (The User's Workspace)
### What It Is
The tangible dashboard where GameForge participants manage their team, tasks, and sprint progress.
### Details
- **URL:** `/dashboard/gameforge`
- **Theme:** "Modern Retro" (Green accents, Pixel fonts, Hex grid wallpaper)
- **Access:** Soft-gated - Any logged-in user with an AeThex Passport can view. Non-team members see "Join the Next Game Jam!" CTA linking to Foundation
- **JTBD:** "As a GameForge mentee, I need to see my team, my tasks, and my deadline for this month's game."
### Bespoke Features (Planned for Phase 3)
- **"Active Sprint" Header** - Prominent "Mission Control" header with live countdown to 4-week deadline
- **"The Scope Anchor"** - Read-only widget displaying the 1-Paragraph GDD (KND-001) as the "North Star"
- **"My Sprint Team"** - 5-person master-apprentice widget showing Forge Master and 4 Mentees (Scripter, Builder, Sound, Narrative), each linking to their aethex.me Passport
- **"My Tasks" (Kanban)** - Embedded, live Kanban board pre-filtered for user's role
- **"Submit Final Build" CTA** - Pushes final game to aethex.fun Arcade
### Current Status (Phase 1)
**V0 (MVP):** Simple placeholder page with CTA links to Foundation and Discord channels.
**Timeline:** Full dashboard deferred to Phase 3 (Post-Monetization) per strategic roadmap.
---
## Role 2: The "Program" (The Non-Profit's Mission)
### What It Is
The **legal and cultural** "why" behind GameForge. This is the educational program run by **The AeThex Foundation** (Non-Profit) that lives inside the aethex.dev app.
### The Foundation's Role
#### 1. The "University" (Mentorship Program - Part VIII)
- **Purpose:** GameForge is the flagship "master-apprentice" program of the Foundation's Mentorship Program
- **Function:** The "lab" for our educational "university"
- **Model:** NOT a commercial venture; an **educational program**
#### 2. The "Community Builder" (Community is Our Core - Part I)
- **Purpose:** The "campfire" where developers meet, collaborate, and build community
- **Function:** A non-profit "gym" where developers can meet, collaborate, build their aethex.me Passports, and **ship a real product in 30 days**
- **Value:** Proves our community is talented and serves as a marketing funnel
#### 3. The "Showcase" (Portfolio Platform - aethex.fun)
- **Purpose:** Host non-commercial games as "social proof"
- **Function:** Games ship to aethex.fun Arcade after completion
- **Impact:** Attracts new developers to the Foundation and demonstrates capability
### How It Works
**Team Structure (SOP-008 / Master-Apprentice Model)**
- **Forge Master (1)** - Experienced mentor who guides the team
- **Apprentices (4)** - Specialized roles:
- **Scripter** - Gameplay programming
- **Builder** - Level design, world building
- **Sound** - Audio design, music
- **Narrative** - Story, dialogue, characters
**Sprint Structure (30-Day Cycle)**
1. **Team Formation** - Developers are matched with mentors
2. **Scope Setting (KND-001)** - Create 1-paragraph GDD to prevent feature creep
3. **Sprint Work** - 4 weeks of focused development
4. **Shipping** - Publish game to aethex.fun
5. **Evaluation** - Mentor feedback and performance assessment
**Program Goals**
- Developers learn professional practices (Code Review, Scope Management, Shipping Excellence)
- Top performers (3+ shipped games) earn **"Architect" 🛡️** status
- Build aethex.me Passport portfolio with shipping experience
- Create lasting professional relationships within the community
---
## Role 3: The "Strategic Asset" (The For-Profit's Advantage)
### What It Is
How the **Non-Profit "Guardian"** provides massive, tangible value to the **For-Profit "Engine."**
GameForge is a **"dual-purpose" asset** that serves both:
- The Foundation's mission (education, community, non-profit)
- AeThex.dev's commercial goals (revenue, talent, R&D)
### Asset 1: The "Talent Flywheel" (Funnel 3)
#### The Problem
A random developer applies to NEXUS marketplace. How do we know if they can truly "Execute with Excellence"? We don't.
#### The Solution: GameForge as Internal Vetting
1. **Entry:** New dev joins the Foundation and enters GameForge
2. **Battleground:** They ship **3 games in 3 months**, learning:
- **SOP-102** (Code Review standards)
- **KND-001** (Scope management discipline)
- **Shipping Excellence** (Shipping culture)
3. **Validation:** A "Forge Master" (Mentor) **vouches for them**
4. **Promotion:** Developer is now **battle-tested** and promoted to **"Architect" 🛡️** status
#### The Payoff
- **Scenario:** CORP signs a **$250,000** enterprise client project
- **Question:** Who does CORP hire from NEXUS?
- NOT the random dev with 0 shipping experience
- **YES:** The "Architect" with a proven, 3-game GameForge track record
- **Result:** GameForge is our **internal "bootcamp"** that creates the elite, trusted talent we sell to enterprise clients at high margins
**Revenue Impact:** High-quality talent → Premium pricing ($250k+ contracts) → Predictable CORP revenue
### Asset 2: The "R&D Testbed" (LABS Integration)
#### The Problem
LABS invents a new, proprietary **"AI-Powered Procedural Content Generation (PCG) Engine."** It's a buggy, experimental "beta." We _cannot_ sell this to a $250k client—it's too risky.
#### The Solution: GameForge as Free QA Army
1. **The Bridge:** LABS licenses the "beta" engine to GameForge (Non-Profit) as a "new tool" for the next month's game jam
2. **The Pressure Test:** **100 GameForge teams (500 developers)** compete to use this new AI engine
- They find hundreds of bugs
- They discover 10+ new, creative uses for it
3. **The Feedback:** LABS gets **thousands of hours of free, real-world QA and user feedback**
#### The Payoff
- **V0 → V1 Development:** LABS patches bugs, integrates new ideas
- **Result:** Rock-solid, battle-tested V2.0 of the "secret weapon"
- **Deployment:** Now LABS can confidently sell this to high-paying enterprise clients
- **Revenue Impact:** De-risked IP → Higher client confidence → Premium pricing
**Example Timeline:**
- **Month 1:** LABS releases "beta AI-PCG" to GameForge
- **Month 1-4:** 500 GameForge devs use it, report bugs, discover uses
- **Month 5:** LABS releases V2.0 (polished, battle-tested)
- **Month 6:** CORP sells AI-PCG to enterprise client for $100k+ licensing fee
---
## The Strategic Flywheel: How It All Works Together
```
FOUNDATION (Non-Profit)
├─ GameForge Program
│ ├─ Role 1: Educational mentorship
│ ├─ Role 2: Community building
│ └─ Role 3: Talent vetting
AETHEX.DEV (For-Profit)
├─ GameForge Workspace (Dashboard)
├─ NEXUS (Marketplace)
│ └─ Hires "Architects" from GameForge
├─ LABS (R&D)
│ └─ Licenses beta tech to GameForge for testing
└─ CORP (Enterprise Services)
└─ Sells verified "Architects" and battle-tested IP to clients
```
### The Complete Loop
1. **Foundation runs GameForge** (non-profit, educational)
2. **Developers ship games, build portfolios, learn from mentors**
3. **Top performers become "Architects"** (verified by 3 shipped games)
4. **NEXUS recruits these "Architects"** (higher margins than unvetted devs)
5. **CORP hires "Architects" for $250k+ projects** (confidence in quality)
6. **LABS tests beta tech with GameForge devs** (free QA, real-world validation)
7. **CORP sells battle-tested IP to enterprise** (premium pricing)
8. **Revenue from CORP/NEXUS funds Foundation** (operational sustainability)
---
## Implementation Roadmap
### Phase 1 (Current): MVP
- ✅ Foundation landing page featuring GameForge
- ✅ Simple `/dashboard/gameforge` placeholder with Discord/Foundation CTAs
- 🔄 Manual operations via Discord and Trello
### Phase 2 (Post-Monetization)
- Implement basic GameForge dashboard
- Integrate with team management
- Link to aethex.fun (basic MVP)
### Phase 3 (Ecosystem Scale)
- Full bespoke dashboard with all 4 widgets
- aethex.fun Arcade with full game hosting
- LABS → GameForge beta tech distribution system
- Advanced analytics and performance tracking
---
## Success Metrics
### Foundation Side (Non-Profit)
- Number of GameForge cohorts per month
- Developer retention and progression
- Mentorship satisfaction scores
- Games shipped per cycle
- Community engagement metrics
### For-Profit Side (aethex.dev)
- % of NEXUS contractors who are "Architects"
- Average project value for "Architect" projects
- Time-to-hire reduction through verified talent
- LABS bug reports and feature requests from GameForge
- Revenue impact of high-quality, battle-tested talent and IP
---
## References
- **SOP-008:** Master-Apprentice Model (Part VIII)
- **KND-001:** Game Design Document Standard
- **Part I:** Community is Our Core (Core Values)
- **Part VIII:** Mentorship Program & Business Model
- **NEXUS-ARCHITECTURE.md:** Marketplace structure
- **LABS-ARCHITECTURE.md:** R&D engine structure