Docs: Fix broken internal links and add sidebar ordering

docs/index.md

@@ -0,0 +1,55 @@
+---
+title: Perstack Documentation
+description: Define AI agents as declarative Experts in TOML. Execute them with deterministic, event-derived tracking.
+slug: docs
+pagefind: true
+---
+
+Define AI agents as declarative **Experts** in TOML. Execute them with deterministic, event-derived tracking. Each Expert runs in its own isolated context — no shared state, no prompt bloat, full execution history.
+
+## Quick Start
+
+Perstack is an open-source runtime for executing AI agents defined as Experts. Define behavior in TOML, run from the CLI or embed in your application.
+
+```bash
+# Generate an Expert interactively
+npx create-expert "Create a code-reviewer that delegates to a style-checker"
+
+# Run it
+npx perstack start code-reviewer "Review PR #42 for security issues"
+```
+
+## Why Perstack?
+
+Agent frameworks help you **build** agents. Perstack is a **runtime** that **executes** them. You define Experts declaratively in TOML — Perstack handles execution, isolation, and state.
+
+| | |
+| :--- | :--- |
+| **Declarative definitions** | Expert definitions in `perstack.toml` are plain text. Domain experts write the behavior; developers focus on integration. |
+| **Isolation by design** | Each Expert runs in its own context — workspace boundaries, environment sandboxing, and tool whitelisting. No shared state between runs. |
+| **Event-derived execution** | Step-level checkpoints make runs reproducible. Resume from any step, debug, replay, and audit every decision. |
+| **Multi-provider support** | Anthropic, OpenAI, Google, DeepSeek, Ollama, Azure, Bedrock, Vertex. Switch providers with one config change. |
+
+## Explore the Docs
+
+### Learn
+
+- [**Getting Started**](/docs/getting-started/walkthrough/) — create your first Expert and walk through the core workflow
+- [**Concepts**](/docs/understanding-perstack/concept/) — understand the architecture behind Experts, runtime, isolation, and the boundary model
+
+### Build
+
+- [**Making Experts**](/docs/making-experts/best-practices/) — complete guide to defining Experts with skills, delegation, testing, and best practices
+- [**Guides**](/docs/guides/rapid-prototyping/) — task-oriented walkthroughs from rapid prototyping to production deployment
+
+### Reference
+
+- [**CLI Reference**](/docs/references/cli/) — all commands and options for the Perstack CLI
+- [**perstack.toml Reference**](/docs/references/perstack-toml/) — complete configuration specification
+- [**API Reference**](/api/v1/spec) — REST API documentation for the Execution API
+
+## Community
+
+- [GitHub](https://github.com/perstack-ai/perstack) — source code and issues
+- [Discord](https://discord.gg/perstack) — chat with the community
+- [X (@perstack_ai)](https://x.com/perstack_ai) — updates and announcements