v0.x This is the released v0.x line — the version that ships in release tarballs and is dogfooded in this repository. The v1.0 rebuild is documented separately in the v1.x preview.

Processes

Process templates that sequence skills into a repeatable workflow.

A v1 Process was a declarative workflow definition: a sequence of steps, roles, gates, and definition of done. In the SmoothTiger/SmoothRiver v2 direction, processkit does not ship Process as a first-class entity surface. A concrete run is a process-instance WorkItem; a reusable definition is an Artifact; gates and bindings hold the enforceable policy around the run.

processkit still does not execute workflows. Agents, humans, schedulers, or CI systems perform the work and record progress through MCP tools.

Shape

Legacy v1 shape:

---
apiVersion: processkit.projectious.work/v1
kind: Process
metadata:
  id: PROC-code-review
spec:
  name: code-review
  description: "Review a pull request before merge."
  triggers: [pr.opened, pr.review-requested]
  roles: [developer, reviewer]
  steps:
    - name: author-self-check
      role: developer
      uses_skill: code-review
    - name: peer-review
      role: reviewer
      uses_skill: code-review
      gates: [GATE-no-blocking-comments]
    - name: approval
      role: reviewer
      gates: [GATE-code-review-passed]
    - name: merge
      role: developer
      gates: [GATE-ci-passed, GATE-code-review-passed]
  definition_of_done: "PR merged with approval and CI green."
---

v2 shape

For v2 documentation and checks, use:

  • WorkItem with spec.type: process-instance for the run.
  • Artifact for a process definition, referenced from the WorkItem.
  • Gate for pass/fail checkpoints.
  • Binding for policy, budget, scope, and time-window relationships.

pk-doctor’s v2_contracts check verifies that process-instance WorkItems point at a definition.

See also