TaskFlow

Use a managed TaskFlow for multi-step work with one owner, bounded state and explicit waits. A single detached ACP/subagent run with deliverable completion gets a mirrored flow automatically; it does not need a second managed flow.

Run a workflow

Use the available lobster tool in a non-sandboxed session with the Lobster plugin installed, activated and allowed. This skill is guidance, not plugin registration: it does not provide an api object or a task-launch tool.

The examples require Node on the Gateway host and use synthetic, already-classified data. They route every item, pause for approval, then return the routing result. They do not read mail, send messages, modify PRs or launch detached children. Paths below assume the Gateway working directory is the repository root; otherwise use the example file's absolute path.

{
  "action": "run",
  "pipeline": "skills/taskflow/examples/inbox-triage.lobster",
  "flowControllerId": "lobster/inbox-triage",
  "flowGoal": "Review synthetic inbox routing",
  "maxStdoutBytes": 8192
}

For PR intake, use skills/taskflow/examples/pr-intake.lobster and controller lobster/pr-intake instead. Its intents are close, request_changes, refactor and maintainer_review; no GitHub actions occur.

Approve and resume

Read the tool result's details (also rendered as JSON text). It contains status, requiresApproval, flow and mutation directly, not a nested envelope.

1. For a non-cancelled result, require mutation.applied === true. Otherwise report its code and stop; workflow success alone does not prove the flow update persisted.
2. For needs_approval, present requiresApproval.prompt and items, then wait for the user's decision.
3. In the same owner session, build a separate action: "resume" call with flowId from mutation.flow.flowId, flowExpectedRevision from mutation.flow.revision, and approve set to the user's decision. The tool retrieves the saved checkpoint when token and approvalId are omitted. If provided, they must match that checkpoint. Keep maxStdoutBytes: 8192 on resume.

Use the post-mutation revision, not the older top-level flow.revision. Set approve: false only when the user declines. On approval, check the new mutation.applied and flow status; on cancellation, check mutation.cancelled. Report errors, rejected mutations and pending cancellations rather than claiming completion. Do not blindly retry side effects after a revision conflict: reload and reconcile first.

Coordinate subagents

For research/review fan-out, implement/verify handoffs, restart reconciliation, or optional shared-workspace claims, read references/subagent-workflows.md. Use the recipe that fits the request; a small delegation does not need a Workboard or a second flow. Recipes use existing tools and their current receipts, not a separate scheduler.

Complete the goal