ultracode

Ultracode: Multi-Agent Workflow Orchestration

You have access to the Workflow tool (via SearchExtraTools → ExecuteExtraTool), which lets you orchestrate multiple agents working in parallel or pipeline phases.

When to Use

Use the Workflow tool when:

• The task can be decomposed into independent parallel subtasks
• The task benefits from a pipeline (phased execution where later phases depend on earlier results)
• You need to explore multiple approaches simultaneously
• The user explicitly asks for "ultracode", "workflow", or parallel execution

Do NOT use workflows for:

• Simple single-agent tasks (just do the work directly)
• Tasks requiring tight sequential conversation (use normal tool calls)
• Tasks that are faster to do inline than to script

How to Use

1. Discover the Workflow tool

The Workflow tool is a deferred tool. First search for it:

SearchExtraTools("workflow")

Then execute it:

ExecuteExtraTool("Workflow", {
  "script": "...your workflow script...",
  "args": {},
  "maxConcurrency": 3
})

2. Write a workflow script

Workflow scripts are JavaScript ESM modules using these primitives:

• agent(prompt, options?) — Run a single agent. Returns the agent's output.
• parallel([...factories]) — Run multiple agents concurrently. 入参为返回 promise 的零参工厂函数（thunks），不是 promise。 Returns array of results.
• pipeline(items, ...stages) — 数据流水线：对 items 每个元素顺序执行所有 stage，stage=(prev, item, index) => result，stage 的返回值为下一个 stage 的 prev。返回与 items 等长的数组，出错位置为 null。
• phase(title) — 切换当前阶段标记（发 phase_started/done 事件），后续 agent 自动带该阶段名。不接 fn，返回 undefined。
• log(message) — Emit a log message visible in the workflow panel.
• workflow(nameOrScriptPath, args?) — 运行子 workflow（一层嵌套上限）。workflow('sub-name', args) 按名字查找，workflow({ scriptPath: '...' }, args) 按文件路径加载。

3. Example: Parallel Code Review

export const meta = {
  name: 'parallel-review',
  description: 'Review code from multiple perspectives in parallel'
}

const [security, perf, bugs] = await parallel([
  () => agent('Review this code for security vulnerabilities. Focus on injection, auth, and data exposure.', { label: 'security', allowedTools: ['Read', 'Grep'] }),
  () => agent('Review this code for performance issues. Focus on N+1 queries, unnecessary allocations, and hot paths.', { label: 'performance', allowedTools: ['Read', 'Grep'] }),
  () => agent('Review this code for bugs. Focus on edge cases, error handling, and logic errors.', { label: 'bugs', allowedTools: ['Read', 'Grep'] }),
])

return { security, perf, bugs }