Tutorials
Step-by-step, end-to-end tutorials for learning pair, pick the one that matches your context.
Tutorials are learning-oriented, guided walkthroughs that you complete in a single session. Each one takes you from start to finish with a working result.
Different from the Getting Started pages (5 to 10 minutes) and the Guides (one task each), tutorials go deeper (20 to 60 minutes) and cover a workflow end to end.
Pick your tutorial
Your First Project
New project · ~30 min: Install pair, bootstrap a project, create a PRD, generate your first initiative/epic/story, and run your first skill.
Existing Project
Existing codebase · ~30 min: Add pair to a project with existing code. Reverse-engineer PRD and adoption files from your codebase, then refine with AI.
Team Setup
Team lead · ~45 min: Install a shared Knowledge Base, customize guidelines, configure PM tool integration, and establish the team's way-of-working.
Brainstorming
Product owner · ~20 min: From a raw idea to a Draft epic and story tree with /pair-process-brainstorm.
Refinement
Product owner / developer · ~30 min: Take one story from Draft to Ready: grill sync, refine, plan tasks, read Assumptions and Open Questions.
Automated Development
Team lead · ~30 min: Supervised and Autonomous delivery: from one card you watch to a daemon that watches your backlog.
Enterprise Adoption
Enterprise architect · ~60 min: Create an org-level KB, structure it for multiple teams, distribute via npm, set governance policies, and onboard the first team.
Release Testing
QA / release owner · ~30 min: Design a manual test suite, execute it against a release, and interpret the validation report with AI-assisted skills.
Share AI artifacts
Team lead · ~30 min: Version skills and AGENTS.md in a Git repository and install them in every project, for one or several assistants.
How tutorials differ from other docs
| Section | Purpose | Length |
|---|---|---|
| Getting Started | Quick setup, get running fast | 5–10 min |
| Process Lifecycle | The flow itself: phases, workflows, modes | 15 min |
| Tutorials (you are here) | Learn by doing, full end-to-end workflow | 30–60 min |
| Guides | Do one task: configure, deliver, measure | 5–10 min |
| Concepts | Understand how things work, explanation | 5–15 min |
| Reference | Look up details, complete specifications | As needed |