From c76f17562821039c8dbc662666a918b887efd3d0 Mon Sep 17 00:00:00 2001 From: "Builder.io" Date: Mon, 17 Nov 2025 08:15:22 +0000 Subject: [PATCH] GameForge architecture documenting 3 roles (Product, Program, Asset) cgen-e7f86df28abd4492a16ef76479893092 --- docs/GAMEFORGE-ARCHITECTURE.md | 218 +++++++++++++++++++++++++++++++++ 1 file changed, 218 insertions(+) create mode 100644 docs/GAMEFORGE-ARCHITECTURE.md diff --git a/docs/GAMEFORGE-ARCHITECTURE.md b/docs/GAMEFORGE-ARCHITECTURE.md new file mode 100644 index 00000000..91560858 --- /dev/null +++ b/docs/GAMEFORGE-ARCHITECTURE.md @@ -0,0 +1,218 @@ +# 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