delegate

Run delegate.py with a tier (grunt, implement, or verify), a working directory, and a self-contained prompt. The wrapper invokes opencode with the tier's configured model and returns a JSON evidence summary with files_changed, tokens, and a transcript path for you to verify.

Pass --dir pointing at the worktree to delegate.py, which forwards it to opencode's own --dir flag. Without it, opencode roots its tools at the main checkout via the shared .git directory, silently redirecting edits into main.

Never delegate architecture or spec judgment, physics-parity review, ABI reachability checks, gate-failure root-cause analysis, merge decisions, or visual PNG inspection, since workers are text-only and their mistakes can ship silently.

No. A status of completed only means the process finished; opencode has documented exit-0-on-error bugs and open models over-claim. The caller must verify via diffs, builds, and tests before accepting any result.

The wrapper launches the worker inside a Windows Job Object with JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE, so all descendant processes inherit membership. On completion, timeout, or cancellation it terminates the Job tree and confirms zero active processes before reporting evidence.

Re-dispatch once for a timeout, since known Windows hang classes exist. For garbage output, retry with the --fallback flag to switch models; after two failures, stop looping the weak model and do the task directly.