Roadmap overhaul: milestone-aligned plans with voice-first P0 and 9 new plan documents

CLAUDE.md

@@ -327,6 +327,37 @@ All documentation uses `.mdx` format (Markdown + JSX for Mintlify).
 
 **Specifications:** See `docs/spec/` for 40+ technical specifications.
 
+## Roadmap & Plans
+
+The roadmap is at [`docs/roadmap.mdx`](docs/roadmap.mdx) ([live site](https://amd-gaia.ai/roadmap)). Plan documents are in `docs/plans/`:
+
+**Agent UI:**
+- [`docs/plans/agent-ui.mdx`](docs/plans/agent-ui.mdx) - GaiaAgent comprehensive plan (Phases A-D)
+- [`docs/plans/setup-wizard.mdx`](docs/plans/setup-wizard.mdx) - First-run onboarding and system scanner
+- [`docs/plans/security-model.mdx`](docs/plans/security-model.mdx) - Guardrails, audit trail, credential vault
+- [`docs/plans/email-calendar-integration.mdx`](docs/plans/email-calendar-integration.mdx) - Email triage, calendar, meeting notes
+- [`docs/plans/messaging-integrations-plan.mdx`](docs/plans/messaging-integrations-plan.mdx) - Signal, Discord, Slack, Telegram adapters
+- [`docs/plans/autonomy-engine.mdx`](docs/plans/autonomy-engine.mdx) - Heartbeat, scheduler, background service
+
+**Ecosystem:**
+- [`docs/plans/agent-hub.mdx`](docs/plans/agent-hub.mdx) - Agent marketplace and community hub
+- [`docs/plans/skill-format.mdx`](docs/plans/skill-format.mdx) - SKILL.md specification
+- [`docs/plans/oem-bundling.mdx`](docs/plans/oem-bundling.mdx) - OEM hardware pre-configuration
+
+**Infrastructure:**
+- [`docs/plans/installer.mdx`](docs/plans/installer.mdx) - Desktop installer
+- [`docs/plans/mcp-client.mdx`](docs/plans/mcp-client.mdx) - MCP client integration
+- [`docs/plans/cua.mdx`](docs/plans/cua.mdx) - Computer Use Agent
+- [`docs/plans/docker-containers.mdx`](docs/plans/docker-containers.mdx) - Docker deployment
+
+**Key architectural decisions (April 2026):**
+- ChatAgent renamed to **GaiaAgent** in v0.20.0 (#696)
+- Voice-first is P0 enabling technology (#702)
+- No context compaction — memory + RAG handles long conversations
+- Configuration dashboard + Observability dashboard as separate Agent UI panels
+- MCP servers primary for email/calendar (not browser automation)
+- Signal is Phase 1 messaging priority (privacy-first)
+
 ## Issue Response Guidelines
 
 When responding to GitHub issues and pull requests, follow these guidelines:

README.md

@@ -69,11 +69,12 @@ print(result)
 ## Key Capabilities
 
 - **Agent Framework** — Base class with tool orchestration, state management, and error recovery
-- **RAG System** — Document indexing and semantic search for Q&A
-- **Voice Integration** — Whisper ASR + Kokoro TTS for speech interaction
+- **Agent UI** — Privacy-first desktop app with chat, file browser, document indexing, and tool execution
+- **RAG System** — Document indexing and semantic search for Q&A over 50+ file formats
+- **Voice Integration** — Whisper ASR + Kokoro TTS for speech interaction (P0 enabling technology)
 - **Vision Models** — Extract text from images with Qwen3-VL-4B
+- **MCP Integration** — Connect to any MCP server for external tool access
 - **Plugin System** — Distribute agents via PyPI with auto-discovery
-- **Web UI Packaging** — Generate modern interfaces for your agents
 
 ---
 
@@ -171,5 +172,5 @@ We welcome contributions! See our [Contributing Guide](CONTRIBUTING.md) for deta
 
 [MIT License](./LICENSE.md)
 
-Copyright(C) 2024-2025 Advanced Micro Devices, Inc. All rights reserved.
+Copyright(C) 2024-2026 Advanced Micro Devices, Inc. All rights reserved.
 SPDX-License-Identifier: MIT

cpp/README.md

@@ -3,7 +3,7 @@
 <!-- Copyright(C) 2025-2026 Advanced Micro Devices, Inc. All rights reserved. -->
 <!-- SPDX-License-Identifier: MIT -->
 
-The [GAIA](https://github.com/amd/gaia) C++ agent framework. Implements the core agentic loop — LLM reasoning, tool execution, multi-step planning, and MCP (Model Context Protocol) client integration — as a lightweight, header-friendly C++ library.
+The [GAIA](https://github.com/amd/gaia) C++ agent framework — a native C++17 port of the Python base agent. Part of AMD's open-source AI agent platform for Ryzen AI hardware. See the [Agent UI plan](../docs/plans/agent-ui.mdx) for the consumer desktop experience that this framework supports.
 
 Included demos:
 

docs/docs.json

@@ -351,19 +351,39 @@
             ]
           },
           {
-            "group": "Plans",
+            "group": "Agent UI",
             "pages": [
-              "plans/agent-hub",
-              "plans/installer",
-              "plans/desktop-installer",
               "plans/agent-ui",
+              "plans/setup-wizard",
+              "plans/security-model",
+              "plans/email-calendar-integration",
+              "plans/messaging-integrations-plan",
+              "plans/autonomy-engine"
+            ]
+          },
+          {
+            "group": "Ecosystem",
+            "pages": [
+              "plans/agent-hub",
+              "plans/skill-format",
+              "plans/oem-bundling"
+            ]
+          },
+          {
+            "group": "Infrastructure",
+            "pages": [
               "plans/mcp-client",
               "plans/cua",
               "plans/docker-containers",
-              "plans/image-agent",
-              "plans/vision-sdk",
               "plans/mcp-docs"
             ]
+          },
+          {
+            "group": "Agents",
+            "pages": [
+              "plans/image-agent",
+              "plans/vision-sdk"
+            ]
           }
         ]
       },

docs/guides/docker.mdx

@@ -345,7 +345,7 @@ If the agent doesn't generate a Dockerfile:
 
 #### "Model Not Found"
 
-Verify the Qwen3-Coder model is downloaded:
+Verify the Qwen3.5-35B model is downloaded:
 
 1. Open Lemonade UI: http://localhost:8000
 2. Check Models section for Qwen3.5-35B-A3B-GGUF