# Welcome to the Adastrea Director Wiki

> **🏠 Your comprehensive guide to the Adastrea Director AI Game Development Assistant**

## 🚀 Quick Navigation

### Getting Started
- **[Installation & Setup](installation/Getting-Started.md)** - Get up and running quickly
- **[Quick Start Guide](installation/Quick-Start.md)** - Start using Adastrea Director in minutes
- **[System Requirements](installation/System-Requirements.md)** - Check compatibility

### Core Features
- **[Context-Aware Assistant (P1)](usage/Context-Aware-Assistant.md)** - RAG-based Q&A system
- **[Planning System (P2)](usage/Planning-System.md)** - Goal decomposition and task planning
- **[Autonomous Agents (P3)](usage/Autonomous-Agents.md)** - Proactive monitoring and optimization
- **[GUI Application](usage/GUI-Application.md)** - User-friendly graphical interface

### Architecture & Design
- **[System Architecture](architecture/System-Architecture.md)** - Overall system design
- **[Agent Architecture](architecture/Agent-Architecture.md)** - How agents work
- **[Deployment Modes](architecture/Deployment-Modes.md)** - Standalone vs Plugin

### Development
- **[Contributing Guide](development/Contributing.md)** - How to contribute
- **[Testing Guide](development/Testing.md)** - Running and writing tests
- **[Code Reference](development/Code-Reference.md)** - API documentation

### Design & UI
- **[Design System](design/Design-System.md)** - UI/UX guidelines
- **[Component Library](design/Component-Library.md)** - Reusable UI components

## 📖 What is Adastrea Director?

Adastrea Director is an **AI-powered game development assistant** designed to revolutionize the game development lifecycle. It provides:

- **Context-aware documentation search** across all project guides
- **Intelligent planning** with automatic task decomposition
- **Autonomous agents** for performance profiling, bug detection, and code quality
- **Integrated workflows** for both standalone and Unreal Engine environments

## 🎯 Project Phases

### ✅ Phase 1: Foundation (Complete)
The Context-Aware Assistant provides RAG-based document understanding and natural language query capabilities.
- [Learn more →](phases/Phase-1-Foundation.md)

### ✅ Phase 2: The Planner (Complete)
Intelligent goal decomposition that breaks down high-level development goals into actionable tasks.
- [Learn more →](phases/Phase-2-Planner.md)

### 🚀 Phase 3: Autonomous Agents (In Progress)
Proactive agents for performance profiling, bug detection, and code quality monitoring.
- [Learn more →](phases/Phase-3-Autonomous-Agents.md)

### 🌟 Phase 4: Creative Partner (Vision)
AI-assisted content generation and creative design suggestions.
- [Learn more →](phases/Phase-4-Creative-Partner.md)

## 🎮 Deployment Options

Adastrea Director offers **two deployment modes** using the same Python backend:

### 🖥️ Standalone Mode
- Python GUI or CLI
- Perfect for development, testing, and standalone use
- **Status:** ✅ Fully functional (P1-P3)
- [Setup Guide →](installation/Standalone-Setup.md)

### 🎮 Unreal Engine Plugin
- Integrated in-editor experience
- Direct access to UE Python API
- **Status:** 🚧 In development (Weeks 1-6 complete)
- [Plugin Guide →](installation/Plugin-Setup.md)

## 🌟 Value Proposition

### Current Value (P1-P2): ⭐⭐⭐⭐⭐⭐⭐ 7/10
- Context-aware documentation search
- Intelligent planning and task decomposition
- Code generation assistance
- 230+ comprehensive tests (100% passing)
- **ROI: 210% return in 6 months**

### Future Potential (P3-P4): ⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐ 10/10
- Autonomous performance profiling
- Automated bug detection and playtesting
- Real-time code quality monitoring
- AI-assisted content generation
- **ROI: 63% return in 12 months**

## 📚 Documentation Structure

### Installation & Setup
Everything you need to install and configure Adastrea Director on your system.

### Usage Guides
Step-by-step guides for using all features, from basic Q&A to advanced agent orchestration.

### Architecture
Deep dives into system design, agent architecture, and technical implementation details.

### Phase Documentation
Comprehensive guides for each project phase with examples and best practices.

### Development
Contributing guidelines, testing procedures, and code reference for developers.

### Design System
UI/UX design guidelines, component library, and visual mockups.

### API Reference
Remote control API documentation and integration guides.

## 🤝 Getting Help

- **📖 Search the Wiki** - Use the search bar above to find answers
- **🐛 [Report Issues](https://github.com/Mittenzx/Adastrea-Director/issues)** - Found a bug? Let us know!
- **💬 [Discussions](https://github.com/Mittenzx/Adastrea-Director/discussions)** - Ask questions and share ideas
- **📧 Contact** - Reach out to [Mittenzx](https://github.com/Mittenzx)

## 🚀 Quick Links

- [Installation Guide](installation/Getting-Started.md)
- [Quick Start Tutorial](installation/Quick-Start.md)
- [FAQ](installation/FAQ.md)
- [Troubleshooting](installation/Troubleshooting.md)
- [Contributing](development/Contributing.md)
- [Roadmap](development/Roadmap.md)

---

**Ready to get started?** → [Installation & Setup](installation/Getting-Started.md)

*Last updated: 2025-11-22*