orchestrate

A command for running several specialized AI agents in sequence, passing each agent's work to the next. TDD means test-driven development: writing tests before the implementation code.

In plain words
What is it for?
Use it to plan and implement features, investigate bugs, refactor code, or perform security-focused reviews through predefined agent workflows.
Why use it?
It organizes complex feature, bug-fix, refactoring, and security work into repeatable stages with documented handoffs.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/codelably/harmony-claude-code/orchestrate
Clone the repo
git clone --depth 1 https://github.com/codelably/harmony-claude-code
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 1,032 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.01032
Opus 5 $0.00000 $0.00516
Sonnet 5 $0.00000 $0.00206
Haiku 4.5 $0.00000 $0.00103

Measured 2d ago against content hash 3d53d3de9530, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

orchestrate scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

commands/orchestrate.md · 173 lines

How it starts

The opening of the file, as written. The whole thing — 173 lines — stays where its author put it; the contents beside it link to each section on GitHub.

编排(Orchestrate)命令

用于复杂任务的顺序智能体(Agent)工作流。

用法

/orchestrate [workflow-type] [task-description]

工作流类型

feature

完整功能实现工作流:

planner -> tdd-guide -> code-reviewer -> security-reviewer

bugfix

Bug 调查与修复工作流:

explorer -> tdd-guide -> code-reviewer

refactor

安全重构工作流:

architect -> code-reviewer -> tdd-guide

security

侧重安全的评审:

security-reviewer -> code-reviewer -> architect

执行模式

对于工作流中的每个智能体(Agent):

  1. 调用智能体:携带来自上一个智能体的上下文。
  2. 收集输出:将其作为结构化的交接(Handoff)文档。
  3. 传递:交给链条中的下一个智能体。
  4. 汇总结果:生成最终报告。

交接(Handoff)文档格式

在智能体之间创建交接文档:

## HANDOFF: [previous-agent] -> [next-agent]

### Context
[工作总结]

### Findings
[关键发现或决策]

### Files Modified
[涉及的文件列表]

### Open Questions
[留给下一个智能体的未解决事项]

### Recommendations
[建议的后续步骤]

示例:功能开发工作流(Feature Workflow)

/orchestrate feature "添加用户认证功能"

执行流程:

  1. 规划智能体(Planner Agent)

    • 分析需求
    • 创建实现计划
    • 识别依赖项
    • 输出:HANDOFF: planner -> tdd-guide
  2. TDD 指导智能体(TDD Guide Agent)

    • 读取规划智能体(Planner)的交接文档
    • 测试先行(先编写测试)
    • 编写实现代码以通过测试
    • 输出:HANDOFF: tdd-guide -> code-reviewer
  3. 代码评审智能体(Code Reviewer Agent)

    • 评审实现代码
    • 检查潜在问题
    • 提出改进建议
    • 输出:HANDOFF: code-reviewer -> security-reviewer
  4. 安全评审智能体(Security Reviewer Agent)

    • 安全审计
    • 漏洞检查
    • 最终批准
    • 输出:最终报告

最终报告格式

ORCHESTRATION REPORT
====================
Workflow: feature
Task: 添加用户认证功能
Agents: planner -> tdd-guide -> code-reviewer -> security-reviewer

SUMMARY
-------
[一段话总结]

AGENT OUTPUTS
-------------
Planner: [摘要]
TDD Guide: [摘要]
Code Reviewer: [摘要]
Security Reviewer: [摘要]

FILES CHANGED
-------------
[列出所有修改的文件]

TEST RESULTS
------------
[测试通过/失败摘要]

SECURITY STATUS
---------------
[安全发现项]

RECOMMENDATION
--------------
[SHIP / NEEDS WORK / BLOCKED]

并行执行

对于独立的检查项,可以并行运行智能体:

### Parallel Phase
同时运行:
- code-reviewer (质量评审)
- security-reviewer (安全评审)
- architect (设计评审)

### Merge Results
将所有输出汇总到单个报告中

参数

$ARGUMENTS:

  • feature <description> - 完整功能实现工作流
  • bugfix <description> - Bug 修复工作流
  • refactor <description> - 重构工作流
  • security <description> - 安全评审工作流
  • custom <agents> <description> - 自定义智能体序列

Read the full file on GitHub · 173 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 173 lines · 0 tokens per session scan A 3d53d3de9530

Subscribe to this mod's changes

orchestrate is a command published in the GitHub repository codelably/harmony-claude-code (42 stars, last pushed 6mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,032 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.