# Scope: AI Agent Gaming Research 2026, Feral Totem Breakthroughs & Official Roadmap 2026-2027

## Architecture & Scope
- **Domain**: R&D Game Intelligence, CEO Strategic Alignment, Systems Design, and Official Diátaxis Roadmap Documentation.
- **Context**: FreeExile (Cổ Võ Hoang Dã Dark Fantasy 2.5D, ARPG PoE2 seasonal realm, Feral Totem delegation, 120 FPS Metal/WebGL engine, anti-VLTK siege).
- **Core Systems**:
  - Dual-Layer Cognition Brain (Local Tactical 30Hz vs Cloud LLM Strategic Brain).
  - Feral Totem (Chiến Hồn Tế Cốt) Tiered Delegation (2H, 8H, 24H).
  - Server-Authoritative Combat & Movement Verification.
  - Roadmap 2026-2027 & Next Version Engineering Plan.

## Feature Inventory
| # | Feature | Description | Milestone | Source |
|---|---------|-------------|-----------|--------|
| 1 | Global AI Games Market Survey 2026 | In-depth analysis of >= 5 games released Jan-Oct 2026 with AI Agents (companions, NPCs, delegation) | M1 | ORIGINAL_REQUEST §R1 |
| 2 | Technical Latency & Architecture Matrix | Local latency (<20ms) vs Cloud LLM orchestration, hybrid multi-tier cognition | M1 | ORIGINAL_REQUEST §R1 |
| 3 | Isometric 2.5D & ARPG Loop Comparison | Market comparison with ARPG grind, loot loop, and visual styles | M1 | ORIGINAL_REQUEST §R1 |
| 4 | CEO Vision & Strategic Alignment | Dark Fantasy Cổ Võ 2.5D, PoE2 dual-realm, anti-VLTK faction siege purity | M2 | ORIGINAL_REQUEST §R2 |
| 5 | >= 3 Feral Totem Breakthrough Mechanics | Co-op hunting, natural language strategic guidance, adaptive instinct evolution | M2 | ORIGINAL_REQUEST §R2 |
| 6 | Dual-Layer Cognition Architecture Specs | Local Tactical 30Hz Reflex + Cloud LLM Strategic Stream integration specs | M2 | ORIGINAL_REQUEST §R2 |
| 7 | ROADMAP_2026_2027.md Creation | Strategy roadmap, feature phases, releases from Q4/2026 to end of 2027 in `docs/roadmap/` | M3 | ORIGINAL_REQUEST §R3 |
| 8 | NEXT_VERSION_DEVELOPMENT_PLAN.md Creation | Technical specs for next version: Dual-Brain, Metal 120 FPS, Anti-Dupe, Acceptance gates | M3 | ORIGINAL_REQUEST §R3 |
| 9 | Diátaxis & Frontmatter Compliance | Full YAML frontmatter, tables, Mermaid diagrams, clickable links | M3 | ORIGINAL_REQUEST §R4 |
| 10 | Strict Hygiene Gate Pass | Soft cap <= 400 lines (hard cap <= 600 lines), `check_code_and_doc_hygiene.py --strict` exit 0 | M3 | ORIGINAL_REQUEST §R4 |

## Milestones
| # | Name | Scope | Dependencies | Status |
|---|------|-------|-------------|--------|
| M1 | AI Agent Games Deep Research 2026 | Survey 5+ games (01/2026-10/2026), architecture comparison, local vs cloud, ARPG loop | none | IN_PROGRESS |
| M2 | CEO Strategic Alignment & Feral Totem Breakthroughs | Align with CEO vision, formulate 3+ breakthrough mechanics, dual-layer cognition spec | M1 | PLANNED |
| M3 | Formal Diátaxis Roadmap & Development Plan | Draft `docs/roadmap/` files, Mermaid diagrams, run hygiene audit linter to exit 0 | M1, M2 | PLANNED |

## Document Contracts
### ROADMAP_2026_2027.md
- Location: `docs/roadmap/ROADMAP_2026_2027.md`
- Diátaxis: `explanation` / `reference` (category: `operations`)
- Must contain: YAML frontmatter, Executive Summary, 2026-2027 Strategic Vision, Phase Breakdown (Q4/2026, Q1-Q4/2027), Milestone Deliverables, Release Cadence & Seasonal Calendar, Mermaid Roadmap Diagram, Anti-VLTK & ARPG Purity Commitments.
- Cap: <= 400 lines (Hard cap <= 600 lines).

### NEXT_VERSION_DEVELOPMENT_PLAN.md
- Location: `docs/roadmap/NEXT_VERSION_DEVELOPMENT_PLAN.md`
- Diátaxis: `how-to` / `reference` (category: `operations` or `standards`)
- Must contain: YAML frontmatter, Next Version Scope, Dual-Brain AI Agent Architecture (Tactical 30Hz + LLM Strategic), Metal Compute 120 FPS Engine Optimization, Security & Anti-Dupe 2PC Ledger, Sprint Breakdown, Acceptance Criteria & Test Strategy, Mermaid Architecture Diagram.
- Cap: <= 400 lines (Hard cap <= 600 lines).

## Code & Doc Layout
- `docs/roadmap/ROADMAP_2026_2027.md`: Strategy and release schedule (Docs <= 400 lines).
- `docs/roadmap/NEXT_VERSION_DEVELOPMENT_PLAN.md`: Technical execution plan (Docs <= 400 lines).
- `tools/lint/check_code_and_doc_hygiene.py`: Quality gating script.