> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vers.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Tutorials

> Long-form guides that show Vers earning its keep on real workloads.

These are the tutorials worth reading front-to-back. Each one takes 20–40 minutes and ends with a working system you can keep.

Pick the one closest to what you're building — the patterns translate.

<CardGroup cols={2}>
  <Card title="Agent swarms" icon="robot" href="/tutorials/agent-swarms">
    Fork one golden VM into N parallel agents. Build a full-stack app (server + client + landing) in \~60 seconds by running three agents simultaneously.
  </Card>

  <Card title="Parallel scenario testing" icon="code-branch" href="/tutorials/parallel-web-testing">
    Drive a real webapp to a stateful point, branch the live VM, then run every checkout scenario in parallel against isolated copies of the state.
  </Card>

  <Card title="Database state testing" icon="database" href="/tutorials/database-state-testing">
    Snapshot a seeded database, branch per migration scenario, run them in parallel, compare outcomes. Reproducible schema changes at the speed of `git checkout`.
  </Card>

  <Card title="Building pi extensions" icon="puzzle-piece" href="/tutorials/pi-extensions">
    Extend the pi coding agent with custom tools inside Vers VMs — a pattern that generalizes to any agent framework.
  </Card>
</CardGroup>

## The shape of a Vers workflow

Every tutorial here follows the same arc:

<Steps>
  <Step title="Provision once">
    Boot a root VM, install everything your workload needs, get to a "golden" state.
  </Step>

  <Step title="Commit">
    Snapshot the golden state so you can restore it later, anywhere, forever.
  </Step>

  <Step title="Branch per task">
    Every task, test, or agent trajectory runs in its own branch — parallel, isolated, microseconds to spawn.
  </Step>

  <Step title="Collect and discard">
    Pull results out, keep the branches that matter as commits, let the rest go.
  </Step>
</Steps>

Once you've read one tutorial, the next will feel familiar — the primitives are the same, only the workload changes.

## Want to contribute a tutorial?

The docs source lives at [github.com/hdresearch/vers-docs](https://github.com/hdresearch/vers-docs). Tutorials live in `tutorials/`, follow the existing structure, and welcome PRs.