feat(ia-prototype): docs IA restructure for Factories + TUI launches

src/content/docs/404.mdx

@@ -16,6 +16,6 @@ import Docs404Tracking from '@components/Docs404Tracking.astro';
 
 The page you are looking for does not exist or has been moved. Use the search or navigation to find what you need.
 
-[Go to the docs home](/)
+[Go to the docs home](/platform/)
 
 <Docs404Tracking />

src/content/docs/agent-platform/warp-tui/getting-started.mdx

@@ -0,0 +1,32 @@
+---
+title: Getting started with Warp TUI
+description: >-
+  Install and run the Warp TUI to use Warp's agent from any terminal
+  without installing the Warp app.
+sidebar:
+  label: Getting started
+---
+
+:::note
+The Warp TUI is coming soon. Installation instructions will be added here at launch.
+:::
+
+The Warp TUI gives you an interactive agent session in your terminal by running a single command. No Warp app installation required.
+
+## Requirements
+
+- Any terminal (macOS, Linux, Windows)
+- Works inside IDEs (VS Code terminal, JetBrains, etc.)
+- Works in cloud environments and remote dev boxes
+
+## Run the TUI
+
+```bash
+/warp
+```
+
+This opens an interactive interface similar to the Claude Code CLI — you can prompt Warp's agent, review responses, and iterate from wherever you work.
+
+## Supported environments
+
+The Warp TUI works in any terminal that supports standard I/O. It connects to the same Warp agents available in the Warp app and will eventually support kicking off [Software Factory](/platform/software-factory/) runs directly from the TUI.

src/content/docs/agent-platform/warp-tui/overview.mdx

@@ -0,0 +1,26 @@
+---
+title: Warp TUI
+description: >-
+  The Warp TUI lets you use Warp's agent from any terminal, IDE, or cloud
+  environment — no Warp app installation required.
+sidebar:
+  label: Overview
+---
+
+:::note
+The Warp TUI is coming soon. This page will be updated when it launches.
+:::
+
+The Warp TUI opens an interactive agent interface directly in your terminal when you run `/warp`. It gives you access to Warp's agents from any environment — your IDE terminal, a cloud shell, or a terminal of your choice — without installing the Warp app.
+
+## Why Warp TUI
+
+Using Warp's agents today requires downloading the Warp application. The Warp TUI removes that requirement, giving developers a new entry point:
+
+- Run Warp agents from any terminal or IDE
+- Use Warp in cloud environments and remote dev boxes
+- Kick off Software Factory runs from wherever you work
+
+## Getting started
+
+See [Getting started with Warp TUI](/agent-platform/warp-tui/getting-started/) to install and run your first session.

src/content/docs/terminal/index.mdx

@@ -0,0 +1,18 @@
+---
+title: Getting started with Warp Terminal
+description: >-
+  Get started with Warp, a fast, modern terminal built for coding. Learn the
+  key features and how to set up your environment.
+sidebar:
+  label: Getting started with Warp
+---
+
+Warp is a modern, high-performance terminal built for coding. This section covers the key features of the Warp terminal and how to get set up.
+
+import { CardGrid, LinkCard } from '@astrojs/starlight/components';
+
+<CardGrid>
+  <LinkCard title="Warp quickstart" href="/quickstart/" description="Install Warp and run your first command." />
+  <LinkCard title="Installation and setup" href="/getting-started/quickstart/installation-and-setup/" description="Full setup guide for macOS, Linux, and Windows." />
+  <LinkCard title="Migrate to Warp" href="/getting-started/migrate-to-warp/" description="Moving from another terminal? Start here." />
+</CardGrid>