11# Agency Orchestrator
22
3- > ** The YAML-first multi-agent orchestrator โ 186 Chinese AI roles, zero code, any LLM**
3+ > ** The YAML-first multi-agent orchestrator โ 186 ready-to-use AI roles, zero code, any LLM**
4+ >
5+ > ** ไธ็จๅไปฃ็ ็ AI ๅข้ โ 186 ไธช่ง่ฒๅผ็ฎฑๅณ็จ๏ผYAML ็ผๆ๏ผๆฏๆ DeepSeek/Claude/OpenAI/Ollama**
46
57[ ![ CI] ( https://github.com/jnMetaCode/agency-orchestrator/actions/workflows/ci.yml/badge.svg )] ( https://github.com/jnMetaCode/agency-orchestrator/actions )
68[ ![ npm version] ( https://img.shields.io/npm/v/agency-orchestrator )] ( https://www.npmjs.com/package/agency-orchestrator )
79[ ![ License: Apache-2.0] ( https://img.shields.io/badge/License-Apache%202.0-blue.svg )] ( ./LICENSE )
810[ ![ PRs Welcome] ( https://img.shields.io/badge/PRs-welcome-brightgreen.svg )] ( ./CONTRIBUTING.md )
911
10- [ ไธญๆๆๆกฃ] ( ./README.zh-CN.md )
12+ ** English ** | [ ไธญๆๆๆกฃ] ( ./README.zh-CN.md )
1113
1214---
1315
@@ -21,7 +23,7 @@ Agency Orchestrator turns a YAML file into a multi-agent pipeline. No Python. No
2123
2224``` python
2325# CrewAI: ~50 lines of Python, write every role from scratch
24- researcher = Agent(role = " PM" , goal = " ..." , backstory = " ...(ไฝ ่ชๅทฑๅ )..." )
26+ researcher = Agent(role = " PM" , goal = " ..." , backstory = " ...(write it yourself )..." )
2527task = Task(description = " ..." , agent = researcher)
2628crew = Crew(agents = [researcher], tasks = [task])
2729crew.kickoff()
@@ -63,37 +65,41 @@ export DEEPSEEK_API_KEY=your-key # or ANTHROPIC_API_KEY, OPENAI_API_KEY
6365npx ao run workflows/story-creation.yaml --input premise='A time travel story'
6466```
6567
66- ## Demo: 4 AI Roles Writing a Story in 2 Minutes
68+ ## Demo: 3 AI Roles Reviewing a Product in 22 Seconds
6769
6870```
69- $ ao run workflows/story-creation .yaml -i "premise=ไธไธช็จๅบๅๅจๅๆจไธ็นๅ็ฐAIๅผๅงๅๅคไธ่ฏฅ็ฅ้็ไบๆ
"
71+ $ ao run workflows/product-review .yaml -i prd_content="Build an AI-powered code review tool "
7072
71- ๅทฅไฝๆต: ็ญ็ฏๅฐ่ฏดๅไฝ
72- ๆญฅ้ชคๆฐ : 4 | ๅนถๅ : 2 | ๆจกๅ : deepseek-chat
73+ Workflow: Product Review
74+ Steps : 4 | Concurrency : 2 | Model : deepseek-chat
7375โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
7476
75- โโ [1/4] story_structure (academic/academic-narratologist) โโ
76- ๅฎๆ | 14.9s | 1919 tokens
77- ๆ ธๅฟๅฒ็ช๏ผ็จๅบๅไธไธไธชไผผไนๆฅๆ่ถ
่ถๅ
ถไปฃ็ ๆ้็่ชไธปๆ่ฏไน้ด็่ฎค็ฅๅฏนๆ...
77+ โโ [1/4] analyze (product/product-manager) โโ
78+ Done | 8.2s | 2,341 tokens
79+ Key requirements extracted: 1) GitHub/GitLab integration for PR webhooks
80+ 2) Multi-language AST parsing 3) LLM-based review with context window...
7881
79- โโ [2/4] character_design (academic/academic-psychologist) โโ โ parallel
80- ๅฎๆ | 65.5s | 4016 tokens
81- ไบบ็ฉๅฟ็ๆกฃๆก๏ผๆๆทฑโโไธไธชไฟกๅฅ้ป่พไธๆงๅถ็่ตๆทฑAIๅทฅ็จๅธ...
82+ โโ [2/4] tech_review (engineering/engineering-software-architect) โโ โ parallel
83+ Done | 6.8s | 1,892 tokens
84+ Technical feasibility: HIGH. Recommended stack: Node.js + tree-sitter
85+ for parsing, streaming API for real-time review feedback...
8286
83- โโ [3/4] conflict_design (game-development/narrative-designer) โโ โ parallel
84- ๅฎๆ | 65.5s | 3607 tokens
85- ๅๆจไธ็น๏ผๅฑๅน็ๅทๅ
ๆ ็้้ป็ฒๆซ็่ธ...
87+ โโ [3/4] design_review (design/design-ux-researcher) โโ โ parallel
88+ Done | 6.8s | 1,756 tokens
89+ UX risks: inline comments may overwhelm developers. Suggest progressive
90+ disclosure โ show summary first, expand details on click...
8691
87- โโ [4/4] write_story (marketing/marketing-content-creator) โโ
88- ๅฎๆ | 33.9s | 5330 tokens
89- ๅๆจไธ็น๏ผ่ฐ่ฏๆฅๅฟ็่่ฒ่งๅ
ๆฏๆฟ้ด้ๅฏไธ็ๅ
ๆบใ้้ป็ไธไปๆ็ฌฌไธๆฏ้ปๅๅก...
92+ โโ [4/4] summary (product/product-manager) โโ
93+ Done | 5.1s | 2,014 tokens
94+ GO with conditions: strong technical feasibility, address UX concern
95+ about comment density before launch...
9096
9197==================================================
92- ๅฎๆ : 4/4 ๆญฅ | 114.3s | 14,872 tokens
98+ Done : 4/4 steps | 21.9s | 8,003 tokens
9399==================================================
94100```
95101
96- Steps 2 & 3 ran ** in parallel** (auto-detected from DAG). Total: 4 specialized AI roles collaborated to produce a complete short story .
102+ Steps 2 & 3 ran ** in parallel** (auto-detected from DAG). 3 specialized AI roles (PM, Architect, UX Researcher) collaborated to review the product .
97103
98104## How It Works
99105
@@ -231,13 +237,13 @@ console.log(result.totalTokens); // { input: 1234, output: 5678 }
231237Each run saves to ` .ao-output/<name>-<timestamp>/ ` :
232238
233239```
234- .ao-output/็ญ็ฏๅฐ่ฏดๅไฝ- 2026-03-21T16-36-37 /
240+ .ao-output/Product-Review- 2026-03-21T16-30-00 /
235241โโโ summary.md # Final step output
236242โโโ steps/
237- โ โโโ 1-story_structure .md
238- โ โโโ 2-character_design .md
239- โ โโโ 3-conflict_design .md
240- โ โโโ 4-write_story .md
243+ โ โโโ 1-analyze .md
244+ โ โโโ 2-tech_review .md
245+ โ โโโ 3-design_review .md
246+ โ โโโ 4-summary .md
241247โโโ metadata.json # Duration, token usage, step status
242248```
243249
0 commit comments