> ## Documentation Index
> Fetch the complete documentation index at: https://evoke-f0bfabff.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> From zero to a governed AI run in under 5 minutes.

RStack plugs into the AI coding framework you already use. The fastest path is
the same for everyone:

<Steps>
  <Step title="Install RStack in your project">
    ```bash theme={null}
    cd your-project
    npm install rstack-agents
    ```
  </Step>

  <Step title="Set it up for your framework and business profile">
    ```bash theme={null}
    npx rstack-agents init --profile business-flex
    ```

    `init` auto-detects your framework (Pi, Claude Code, Operator, or custom),
    creates the `.rstack/` state directory, writes `.rstack/rstack.config.json`
    and `.rstack/budget.json`, registers the project with the Business Hub,
    writes framework-specific glue, and prints your next steps. Running it twice
    is safe — it never overwrites your files.

    Force a specific framework or profile:

    ```bash theme={null}
    npx rstack-agents init --framework pi --profile business-flex
    npx rstack-agents init --profile lean-mvp
    npx rstack-agents init --profile enterprise-webapp
    ```
  </Step>

  <Step title="Start a governed run from your agent session">
    ```text theme={null}
    sdlc_start(goal="Build a checkout flow with Stripe, tests, and release readiness")
    sdlc_clarify()
    sdlc_plan()
    ```
  </Step>

  <Step title="Approve the gates, then build">
    ```text theme={null}
    sdlc_approve(artifact="plan.md", status="APPROVED")
    sdlc_approve(artifact="requirements.json", status="APPROVED")
    sdlc_approve(artifact="architecture.md", status="APPROVED")
    sdlc_build_next()
    sdlc_validate()
    ```
  </Step>

  <Step title="Watch it live in the Business Hub">
    The dashboard opens automatically when your session starts. Bring it up
    any time from any framework:

    ```bash theme={null}
    npx rstack-agents hub
    ```

    Open [http://localhost:3008](http://localhost:3008) — runs, the Studio
    live agent view, approvals, and traceability.
  </Step>
</Steps>

<Note>
  New to your AI framework too? Start with
  [Install your framework](/getting-started/install-your-framework) — it covers
  installing Pi, Claude Code, Codex CLI, Gemini CLI, and Operator first, then
  adding RStack.
</Note>

## What `init` created

```text theme={null}
your-project/
├── .rstack/
│   ├── runs/                 # every governed run lands here
│   ├── rstack.config.json     # active profile, enabled domains/plugins, pages
│   ├── budget.json            # run budget, thresholds, stage budget envelopes
│   ├── registry/              # agent / skill / plugin catalog
│   └── policy.json            # (optional) approval policy you control
└── .claude/rstack-sdlc.md    # (claude-code only) usage guide + session hook
```

Every run is inspectable, resumable, and auditable. See
[Your first run](/getting-started/your-first-run) for the full walkthrough.

## Pick your path

<CardGroup cols={2}>
  <Card title="Install your framework" icon="plug" href="/getting-started/install-your-framework">
    Pi, Claude Code, Codex, Gemini CLI, Operator — step by step.
  </Card>

  <Card title="Your first run" icon="play" href="/getting-started/your-first-run">
    Clarify → plan → approve → build → validate, explained.
  </Card>

  <Card title="The Business Hub" icon="chart-line" href="/reference/business-hub">
    The live dashboard, Studio 3D, Business Flex, and team views.
  </Card>

  <Card title="Business Flex profiles" icon="sliders" href="/getting-started/business-flex-profiles">
    Select only the teams, plugins, budget guardrails, and dashboard pages a request needs.
  </Card>

  <Card title="Builder & validator sandbox" icon="shield-halved" href="/getting-started/builder-validator-sandbox">
    Scoped builder packets, read-only validator packets, and Contract v2 telemetry.
  </Card>

  <Card title="Notifications" icon="bell" href="/reference/webhooks">
    Slack, Teams, Discord, Telegram, WhatsApp.
  </Card>
</CardGroup>