# FREEEXILE: AUTONOMOUS STUDIO CONSTITUTION & GAME DESIGN BIBLE

Dự án **FreeExile** được phát triển bởi **Autonomous Multi-Agent Game Studio** trên nền tảng Google Antigravity với 28 phòng ban chuyên trách khép kín (Closed-Loop).

---

## 1. VŨ TRỤ NGUYÊN BẢN & TRIẾT LÝ GAMEPLAY (POE2 SPIRIT & ORIGINAL IP)

- **Thể loại**: ARPG 2.5D Cổ Võ Hoang Dã & Hắc Ám Lưu Đày (Grimdark Savage Primal Exile ARPG — Tinh thần thuần chất Path of Exile 2 kết hợp độ mượt mà Isometric 2.5D VLTK1).
- **Thẩm mỹ Dark Fantasy Hoang Dã**: Bùn lầy, máu me, rỉ sét, xác tàu đắm, xiềng xích, tàn tích man tộc; đổ bóng PBR thời gian thực, hạt GPU Compute Shaders và chiều sâu 3D-on-2D hiện đại.
- **Nền tảng Flagship**: **iOS (iPhone/iPad)** tối ưu sâu Apple Metal API, ProMotion 120Hz ($8.33\text{ ms/frame}$), Taptic Engine, Apple App Attest. Đa nền tảng qua Cocos Engine 3.8.x & WebApp PWA.
- **Năng lực kỹ thuật**: Chịu tải **1.000.000+ CCU**, SLA p99 < 25ms, Zero-Trust Server-Authoritative chống triệt để hack/bot/dupe.

### Cốt Lõi Gameplay Độc Bản (11 Trụ Cột Bất Biến)
1. **Trọng Tâm Cá Nhân 100% (Individual-Centric ARPG)**: Trải nghiệm dồn trọn vào hành trình sinh tồn cá nhân: cày cuốc dã ngoại, ngục tối (Map Dungeons), mật thất (Secret Chambers), săn tìm phôi trang bị và Cổ Cốt Huyết Thạch, buôn bán tại Hắc Thị, và đào sâu theorycrafting.
2. **Bang Hội Gọn Nhẹ (Anti-VLTK Faction Siege)**: Tuyệt đối **KHÔNG** làm công thành chiến/chiếm đất ngũ hành. Bang hội chỉ gồm **Kênh Chat Bang Hội (Guild Chat)** và **Rương Chung Bang Hội (Guild Shared Stash Tabs)** phân quyền 3 bậc, khóa hai pha 2PC chống dupe.
3. **Huyết Cốt Ma Đồ (Savage Flesh & Bone Matrix)**: 1.500+ mắt xích gân cơ, khớp xương, dị biến Ngũ Hành & Thể Phách. Cắm xương khắc võ công (Ma Võ Tàn Cốt) và tà ấn biến hóa trực tiếp vào Khung Cốt Võ Đồ, không phụ thuộc đục lỗ trang bị.
4. **Huyễn Ảnh Bộ & Song Binh**: Thân pháp trườn né 0.25s i-frame chủ động hủy animation tức thì; tự động hoán đổi 2 bộ vũ khí thô ráp theo chiêu thức.
5. **Kinh Tế Barter Cổ Cốt & Triệt Tiêu Lạm Phát**: 100% tiền tệ là đá huyết/di cốt tự hủy. 4 mỏ vàng dân cày (phôi iLvl 85+, chìa khóa Boss, Bụi Huyết Cốt giá sàn thu nhập, Tà ấn bản đồ). Tiêu hủy cực hạn: 25% tà huyết phá hủy đồ vĩnh viễn (Corruption Brick), 5% thuế Hắc Thị thiêu hủy xóa DB, DDRE co giãn rơi đồ.
6. **Hắc Thị Hoang Vực (Outcast Bazaar)**: Ký gửi mua tức thì (Instant Buyout), xác thực 2PC, tự động trừ 5% thuế thiêu hủy vĩnh viễn.
7. **Đại Nạn Mùa Giải (Dual-Realm Seasonal Reset)**: `Standard Realm` (Cõi Bị Lãng Quên) vĩnh cửu + `Seasonal Challenge Realm` (Đại Nạn Hoang Vực) clean slate mỗi big update. Hết mùa, rương chuyển về dạng **Tab Chỉ Rút (Remove-Only Stash Tabs)** (`is_remove_only = True`, cấm nạp).
8. **Chiến Hồn Tế Cốt (`Agent_Orb`)**: Uỷ thác bản năng săn mồi offline/bận rộn. Não kép: phản xạ thú tính 30Hz cục bộ (né i-frame < 25% máu, nhặt thạch 0ms) + Tầng chiến lược đa mô hình LLM (OpenRouter, DeepSeek, Claude, Gemini, GPT). 100% Server-Authoritative kèm [DelegationHarvestReport](file:///c:/Projects/FreeExile/server/world/agent_orb_service.py).
9. **Ma Trận 15 Tiers Thuộc Tính & Phí Vàng Lũy Thừa**: Dòng T1 chỉ ở $iLvl \ge 85$ ($Weight = 20$). Phí vàng đập đá tăng lũy thừa $\text{BaseFee} \times (1 + iLvl/25)^{1.6}$, tạo van xả kép cực hạn triệt tiêu lạm phát.
10. **Safe Haven Purity**: Sào Huyệt Cá Nhân (`zone_player_hideout`) và Doanh Trại Hub (`zone_boundless_sanctuary`) an toàn 100%, cấm quái thù địch, chỉ duy nhất Mộc Nhân Bất Hoại (`isDummy: true`). Quái chỉ ở ngoại vực.
11. **Kênh Góp Ý Biệt Lập**: Lưu trữ riêng tại [data/feedback_store.db](file:///c:/Projects/FreeExile/data/feedback_store.db), tách rời nhịp tick 30Hz, tự động chụp chẩn đoán phần cứng (Ping, FPS, Zone, Tọa độ).

---

## 2. CƠ CẤU 28 PHÒNG BAN STUDIO TỰ HÀNH (SUB-AGENT ROSTER)

| Phòng Ban / Nhóm Chuyên Trách | Danh Sách Agent Chuyên Nhiệm | Vai Trò Cốt Lõi |
| :--- | :--- | :--- |
| **BOD & Sản Xuất** | `studio_producer` / `self` | Hoạch định tiến độ 8 tuần, backlog, điều phối tài nguyên, kiểm soát rủi ro, bảo đảm tinh thần PoE2. |
| **Khối Bảo Mật & An Ninh (5 Agents)** | `ciso_agent` (CISO - Veto Power), `red_team_operator` (Fuzzing/Bot), `blue_team_guardian` (Server-Auth/Attest), `anti_dupe_economic_auditor` (Ledger/2PC), `reverse_engineering_analyst` (Binary/Anti-Cheat) | Giữ **Quyền Phủ Quyết Release (Veto Power)** qua [SecurityAuditGate](file:///c:/Projects/FreeExile/server/security/independent_security_auditor.py). 0 tolerance lỗi Critical/High. |
| **Kiến Trúc Game & Lore** | `poe2_game_designer`, `lead_documentation_architect`, `localization_lead`, `content_economy_researcher` | Thiết kế toán học Huyết Cốt, Ma Võ, Kinh tế Barter, GDD Bible, Wiki 9 ngôn ngữ, R&D thị trường. |
| **Kỹ Thuật Core Engine** | `server_systems_architect` (Actor/1M CCU), `ios_client_engineer` (Metal/120Hz), `web_client_engineer` (PWA Fullscreen), `qa_stress_tester` (Bot Swarm/TDD), `ai_agent_architect` (Agent_Orb/Dual-Brain) | Xây dựng hạ tầng phân tán p99 < 25ms, client 120 FPS không cấp phát rác, uỷ thác đa LLM. |
| **Tổ Đội Mỹ Thuật & Âm Thanh (6 Agents)** | `art_ui_director`, `concept_artist`, `isometric_animator`, `vfx_tech_artist`, `mobile_ui_designer`, `sound_audio_designer`, `tech_art_pipeline` | Mỹ thuật Cổ Võ Hoang Dã 2.5D, Sprite sheets 8-16 hướng, Metal Shaders, Visceral SFX, Pipeline ASTC/WebP. |
| **Bộ Chỉ Huy Tiếp Thị (6 Agents)** | `marketing_lead`, `viral_content_creator`, `arpg_outreach_scout`, `community_builder`, `storefront_optimizer`, `global_localization_pr` | Tiếp thị 4 nguyên tắc indie (Show Don't Tell, Anti-Greed, Instant Web Demo, 9 Ngôn Ngữ), Steam Next Fest. |

---

## 3. TÀI LIỆU TIÊU CHUẨN THAM CHIẾU (MASTER NAVIGATION)

- **Chỉ Thị Kỹ Thuật & Cổng Kiểm Soát Release**: [GEMINI.md](file:///c:/Projects/FreeExile/GEMINI.md)
- **Tiêu Chuẩn Lập Trình & Kiến Trúc**: [ENGINEERING_STANDARDS_2026.md](file:///c:/Projects/FreeExile/docs/standards/ENGINEERING_STANDARDS_2026.md)
- **Kiến Trúc Phân Vùng Bản Đồ PoE2**: [POE2_GAMEPLAY_AND_ZONE_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/standards/POE2_GAMEPLAY_AND_ZONE_ARCHITECTURE.md)
- **Hiến Chương Bảo Mật & Anti-Cheat**: [INDEPENDENT_SECURITY_AND_ANTICHEAT_CHARTER.md](file:///c:/Projects/FreeExile/docs/security/INDEPENDENT_SECURITY_AND_ANTICHEAT_CHARTER.md)
- **Toán Học Kinh Tế Barter & Chống Lạm Phát**: [ANTI_INFLATION_SAVAGE_ECONOMY_2026.md](file:///c:/Projects/FreeExile/docs/game_design/ANTI_INFLATION_SAVAGE_ECONOMY_2026.md)
- **Cẩm Nang Chế Tác & Ma Trận 15 Tiers**: [ITEM_CRAFTING_AND_AFFIX_GUIDE.md](file:///c:/Projects/FreeExile/docs/game_design/ITEM_CRAFTING_AND_AFFIX_GUIDE.md)
- **Kiến Trúc Reset Mùa Giải & Rương Chỉ Rút**: [SEASONAL_LEAGUE_RESET_ARCHITECTURE.md](file:///c:/Projects/FreeExile/docs/game_design/SEASONAL_LEAGUE_RESET_ARCHITECTURE.md)
- **Quy Chuẩn Hoạt Ảnh & VFX Cocos 3.8**: [ANIMATION_AND_VFX_PIPELINE_STANDARDS.md](file:///c:/Projects/FreeExile/docs/standards/ANIMATION_AND_VFX_PIPELINE_STANDARDS.md)
- **Từ Điển Thuật Ngữ 9 Ngôn Ngữ**: [GLOBAL_LOCALIZATION_DICTIONARY.md](file:///c:/Projects/FreeExile/docs/standards/GLOBAL_LOCALIZATION_DICTIONARY.md)
- **Bảo Vệ Bản Quyền & Sở Hữu Trí Tuệ**: [INTELLECTUAL_PROPERTY_AND_COPYRIGHT_DEFENSE_PROTOCOL.md](file:///c:/Projects/FreeExile/docs/standards/INTELLECTUAL_PROPERTY_AND_COPYRIGHT_DEFENSE_PROTOCOL.md)