Example pipelines
The built-in pipeline (implement, review, verify, deliver) is one shape. These four examples are complete factories built only from custom command steps, `kusaw agent-args`, `kusaw extract`, and effects. They show that the factory is neutral: you copy a shape, you do not have to keep the defaults.
The built-in pipeline (implement, review, verify, deliver) is one shape. These four examples are complete factories built only from custom command steps, kusaw agent-args, kusaw extract, and effects. They show that the factory is neutral: you copy a shape, you do not have to keep the defaults.
Copy an example into your factory folder. ADR 0009: do not build one example on another example's files — each tree is self-contained.
| Shape | What it runs |
|---|---|
| simple-loop | Loop (max 3): implement (agent, edit preset), check (the spec's test command, findings as feedback); then built-in deliver |
| sequential-reviewer | Loop: implement, then review (agent, read_only, findings through kusaw extract); fails the iteration on findings; then deliver |
| parallel-planner | One plan step: the agent returns up to four independent sub-tasks; the step returns them as demo.task_add effects; kusaw add queues them |
| parallel-planner-with-review | The planner; each sub-task spec names the sequential-reviewer pipeline |
Each example also ships as workflows.<shape> so you can copy it into a multi-workflow factory. See Workflows and routing.
Every agent-invoking script calls "$KUSAW_BIN" agent-args ... and never a provider CLI, so the same example follows KUSAW_AGENT_PROVIDER on Claude Code and Cursor. See Use an agent inside your step.
Parallel in the queue
The factory's pipelines are static, so "parallel" means separate tasks in the queue, each with its own run, branch and delivery. There is no merge step (the factory never merges or pushes). Dependent sub-tasks can stack branches with depends_on on the spec. The examples never use secrets: demo.task_add only runs kusaw add on files inside the factory folder.
make e2e-examples runs each example on a demo repo with the fake Claude Code and the fake Cursor.
The step protocol (handshake, request, progress, result) is the same as Write your first step. More examples lists the smaller custom-step programs.