From ed90b049afceb5758285316cb1a0fdcabcee08ea Mon Sep 17 00:00:00 2001 From: HiranoMasaaki Date: Wed, 11 Feb 2026 20:18:12 +0900 Subject: [PATCH] docs: Add documentation landing page Co-Authored-By: Claude Opus 4.6 --- docs/index.md | 55 +++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 docs/index.md diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 00000000..840d0937 --- /dev/null +++ b/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