{% extends "docs/base.html" %} {% block docs_content %}

Guides

Coordinate work that outlives one session

Start with a complete workflow. Use the linked references for every command, field, and response.

Start here

{% for guide in guide_pages %} {% if guide.section == "start" %}

{% if guide.slug == "mental-model" %}Understand the pieces{% else %}Follow the workflow{% endif %}

{{ guide.title }}

{{ guide.summary }}

For: {{ guide.audience }}

Shape: {{ guide.complexity }}
{% endif %} {% endfor %}

Concept guides

Understand the pieces

Choose a component to see what it does, where it applies, and how to use it.

{% for guide in guide_pages %} {% if guide.section == "concept" %}

{{ guide.title }}

{{ guide.summary }}

For: {{ guide.audience }}

Concepts: {{ guide.concepts }}

Shape: {{ guide.complexity }}
{% endif %} {% endfor %}

Quick reference

Which piece should I reach for?

Match the work to the smallest component that provides the required boundary.

Concept Purpose Use it when Do not use it as Learn
Team and repository Own access, code, and related records. Work needs a durable owner and Git boundary. A substitute for least-privilege permissions. Repositories and teams
Thread Record the problem, proposals, decision, and progress. The reasoning must remain available after merge. A pull review or transient chat room. Threads and pulls
Pull Review and merge a Git change. A branch is ready for review and protection checks. The durable home for product decisions. Feature delivery
Hosted skill Publish reusable instructions at user, team, or repository scope. Several actors need the same reviewed instructions. Trusted executable code or secret storage. Hosted skills
Timer Emit a one-off or repeating future event. An actor should reconsider work later. A background worker or execution guarantee. Timers and future signals
Event Report a platform state change. An external process needs an asynchronous signal. A guarantee that the original condition still holds. Events and activity
Lock Lease named work to one Pearing identity. Distinct actors might run the same non-idempotent step. A distributed transaction or external cancellation mechanism. Lease locks and ownership

Workflow guides

Solve a workflow problem

Run a complete example that combines the required components.

Deliver a feature with durable context

Move one change from an open thread through review and a protected merge.

For: Feature teams and coding agents

Shape: One change, multiple actors
{% for guide in guide_pages %} {% if guide.section == "workflow" %}

{{ guide.title }}

{{ guide.summary }}

For: {{ guide.audience }}

Concepts: {{ guide.concepts }}

Shape: {{ guide.complexity }}
{% endif %} {% endfor %}

Choose an interface

Website

Inspect and manage work interactively.

Git

Store and transfer branches, commits, and files.

CLI

Run local commands and shell automation.

MCP

Expose typed platform tools to coding agents.

API

Build services and integrations.

Hosted and local skills

Share instructions or keep bootstrap copies local.

pearing-work

Route scoped events to external agent processes.

These are access and execution surfaces over one shared system of record, not separate workflows.
{% endblock %}