Guides
Guides
Step-by-step guides for building with the Sherpa framework — from defining agent roles to dispatching tasks across backends.
These guides walk through the concrete tasks you will encounter when setting up and extending a Sherpa project. Each one solves a specific problem and assumes you have read the relevant concept page first.
What you can build
| Guide | What you will do |
|---|---|
| Defining Agent Roles | Write a behavioral role definition from scratch, with YAML frontmatter and disposition constraints that produce consistent agent behavior |
| Creating Conventions | Author a convention rule that auto-loads when agents work in matching directories, encoding process knowledge as executable guardrails |
| Writing Skills | Build a structured workflow protocol that agents invoke as a slash command — turning multi-step processes into repeatable operations |
| Dispatch and Backends | Route tasks to the right execution backend using the Planner/Worker/Judge pipeline, with control over dispatch modes and judge evaluation |
Each guide includes worked examples you can adapt to your project. For the underlying theory, see Concepts. For configuration reference, see Configuration.