Orchestration System (meta)
개요: 상황 레시피를 고르고, 만들고, 실행하는 메타 규칙입니다. 이번 작업용 읽을거리 목록이 아닙니다.
This file is not a per-job reading list.
What an orchestration document is
A situation recipe:
Which subagents to assemble + which knowledge-base documents to assemble → for this kind of work.
Stored under orchestrations/. Reused when the same situation recurs.
Master’s real job
User request
↓
CURRENT.md와 이번 작업 문서만
↓
Matching orchestration exists?
├─ YES → reuse it
└─ NO → default path in workflows/implement.md
A new recipe is proposed only when the situation will repeat
Master does not write a recipe for every request. Master does not spawn every role. Curator runs only when the user asks to promote Knowledge or templates.
Two layers
| Layer | Path | Purpose |
|---|---|---|
| Meta (this file) | docs/harness/orchestration.md | Rules for select / gap / author / run |
| Situation orchestration | docs/harness/orchestrations/*.md | Durable recipe: agents + knowledge mix |
Gap feedback (when none fits)
Master must tell the developer, clearly:
- What situation was detected
- That no orchestration covers it (or only a partial match)
- What agents + knowledge pages would be needed
- The run uses the default path unless a recipe already exists.
Do not write a one-off recipe and do not spawn every role.
Authoring a new orchestration
Use orchestrations/template.md.
Must define:
- Situation — when to select this file
- Agents — which roles, in what order (+ model pool)
- Knowledge assembly — exact paths to mix
- Templates / ADR — if required
- Success criteria
Prefer linking small knowledge pages over inlining essays.
Running
Workers receive:
role MD + selected orchestration MD + mission for that role
선택된 레시피가 있으면 그 읽기 목록을 따릅니다. 레시피가 없는 기본 경로에서는 작업 범위, 프로젝트 규칙과 관련 템플릿만 확인합니다. 별도 에이전트를 사용하는 경우에도 필요한 경로와 역할만 전달합니다.
Return schema
## Status
PASS | FAIL | BLOCKED | PARTIAL
## Summary
## Artifacts
## Findings
## Rework Hint
Anti-patterns
- 기본 경로로 충분한 요청에 새 레시피나 불필요한 읽기 목록을 만드는 것
- Hiding “no recipe” gaps from the developer
- One mega orchestration for the whole Archive
- Workers free-browsing
docs/outside the selected recipe