유니버설 AI 오케스트레이션 플랫폼

도메인에 구애받지 않는, MCP 우선 오케스트레이션 엔진입니다.

목표를 설명하세요. 워크플로우가 아니라. 목표를 주면 플랫폼이 작업이 무엇인지, 어떻게 분해할지, 어떤 역량이 필요한지, 무엇을 병렬로 실행할 수 있는지, 결과를 어떻게 검증할지, 실패 시 무엇을 할지, 목표가 실제로 달성되었는지 여부를 결정합니다.

플랫폼에는 도메인에 대한 가정이 포함되어 있지 않습니다. 사전 탑재된 에이전트 역할도, 사전 탑재된 도메인 워크플로우도, 하드코딩된 제공자도, 하드코딩된 도구도 없습니다.

pip install -e ".[all]"
orchestrator init .
orchestrator run "Accomplish this objective."

무엇이 다른가

모델이 제안하고, 소프트웨어가 처리합니다. 상태, 스케줄링, 권한, 재시도, 영속성, 검증, 리소스 제한은 결정적 코드입니다. 모델은 추론, 계획, 작업 수행, 주관적 결과 판단에만 사용되며 그 외에는 아무것도 사용되지 않습니다.

이러한 구분 덕분에 플랫폼은 확률적 약속이 아닌 확고한 약속을 할 수 있습니다:

• 필수 검증 실패는 COMPLETED를 생성할 수 없습니다.

• 취소된 실행은 조용히 계속될 수 없습니다.

• 에이전트는 부여되지 않은 도구를 호출하거나 볼 수 없습니다.

• 모든 루프(재시도, 재계획, 개선 라운드, 에이전트 반복)에는 강제된 상한이 있습니다.

• 발견된 MCP 도구는 신뢰되지 않습니다; 서버의 주석은 평가된 위험을 높일 수만 있고 낮출 수는 없습니다.

"완료"는 의미가 있습니다. 완료에는 증거가 필요합니다. 결정적 검사가 없는 경우 플랫폼은 가장하지 않고 UNCERTAIN을 보고합니다. 모델은 LIKELY에 도달할 수 있지만 CONFIRMED를 인증할 수는 없습니다.

코어는 의존성이 없습니다. 그 외의 모든 것 — CLI, REST API, HTTP 모델 제공자, YAML — 은 선택 사항입니다. stdio를 통한 MCP는 프로토콜 클라이언트가 네이티브로 구현되어 있으므로 기본 설치에서 작동합니다.

Related MCP server: agentloop

보안 태세

이 플랫폼은 모델이 선택한 인수로 도구를 실행합니다. 이 단일 사실이 보안 설계를 주도하며, 통제는 모델에게 요청하는 것이 아니라 코드로 강제됩니다.

배포 프로필을 선언하세요. 생략하면 production으로 간주됩니다.

profile: production   # development | internal-pilot | production

배포 전에 읽으세요:

• SECURITY.md — 위협 모델, 방어되는 것과 방어되지 않는 것

• docs/security.md — 모든 통제와 각각의 테스트

• docs/production-readiness.md — 108개 항목 체크리스트, 각 항목은 완료 / 미완료 / 운영자 책임으로 표시

• deployment/runbook.md — 세 가지 배포 형태

• docs/configuration.md — 모든 설정

주장의 범위

TLS/auth 프록시 뒤에서 통제된 프로덕션 배포를 지원합니다: SQLite의 단일 인스턴스 또는 PostgreSQL의 다중 인스턴스 (storage.backend: postgres).

명시적으로 지원되지 않음: SQLite의 다중 인스턴스, 강제된 컨테이너/샌드박스/원격 격리, 프로세스 내 OIDC JWT 검증 또는 프록시 전달 신원 (베어러 토큰이 유일한 신원 메커니즘), 외부 격리 경계가 없는 프로세스 실행, AI 출력 정확성에 대한 어떠한 보장.

제공된 Compose 스택에서 두 개의 복제본에 걸쳐 검증됨: 공유 PostgreSQL 상태, 분산 토큰 폐기, 분산 속도 제한, 프록시를 통한 강제 아웃바운드 이그레트, 클라이언트 제공 신원 헤더를 제거하는 TLS 경계. 플랫폼은 증거 기반 검증, 신뢰도 보고, 적대적 검토자, 인간 승인 게이트, 결정적 회귀 테스트 하네스를 제공합니다 — 이 중 어느 것도 모델 출력을 정확하게 만들지 않습니다; 신뢰의 근거를 검사 가능하게 만들 뿐입니다.

python -m pytest tests/ -q        # 699 with PostgreSQL
orchestrator validate             # effective posture and migration notices
orchestrator evaluate             # 31 deterministic regression cases
orchestrator migrate              # schema status

실행, 처음부터 끝까지

objective
   → goal analysis        structured requirements, provenance-tagged
   → pattern selection    deterministic complexity scoring
   → planning             validated task DAG (or a deterministic fallback)
   → scheduling           dependency-aware, parallel, resource-locked
   → per task             capability-routed agent, least-privilege scope,
                          bounded loop, independent validation gate
   → recovery             classify → strategy ladder → retry/swap/re-plan/ask
   → objective gate       success criteria, checked
   → review               structural precondition on completion
   → COMPLETED

모든 단계는 인간을 기다리거나, 일시 중지하거나, 취소할 수 있으며 — 프로세스가 죽은 후에도 — 이후에 영속화된 상태에서 재개할 수 있습니다.

orchestrator inspect <id>    # the task graph, validations, failures
orchestrator audit <id>      # every decision, in order

오케스트레이션 패턴

모드가 아닌 구성 가능한 그래프 조각입니다. 병합 단계가 평가자-최적화 루프인 병렬 팬아웃은 그저 그래프일 뿐입니다.

single agent · sequential · parallel · router · orchestrator-worker · evaluator-optimizer · hierarchical · handoff · dynamic DAG

라우터는 모든 분기를 구체화하고 선택하지 않은 분기를 제거합니다. 작업은 남은 작업을 다른 전문가에게 넘길 수 있으며, 동료가 원을 그리며 전달할 수 없도록 제한됩니다. 그리고 작업은 자체의 오케스트레이션 실행 전체가 될 수 있으며, 예산은 부모의 예산에 추가되는 것이 아니라 부모의 예산에서 분할됩니다.

플랫폼은 목표의 구조에서 하나를 선택합니다. 사소한 목표는 에이전트 하나와 검사 하나를 얻습니다 — 에이전트 열 개와 검토자 네 개가 아닙니다. 원할 때 --pattern으로 재정의하세요.

역량, 역할이 아닌

이름으로 라우팅되는 것은 없습니다. 작업은 필요한 것을 선언하고, 에이전트는 제공하는 것을 광고하며, 선택은 최소 과잉 권한을 선호하는 결정적 점수화입니다. 요구 사항을 충족하는 것이 없으면 범위가 제한된 임시 전문가가 생성됩니다 — 그리고 부족분이 실제가 아닌 경우 선택은 조용히 실패하는 대신 크게 실패합니다.

핵심에는 역량, 에이전트, 스킬이 포함되어 있지 않습니다. 이들은 구성, 플러그인, 또는 플래너에서 제공됩니다. 이것이 도메인 중립성을 유지하는 이유입니다.

스킬은 세 번째 요소입니다: 코드가 아닌 콘텐츠로서의 재사용 가능한 지식입니다. 스킬은 에이전트에게 이미 승인된 작업에 접근하는 방법을 알려주며, 아무것도 부여하지 않습니다.

MCP

양방향 모두 일급 시민이며, SDK 의존성 없이 JSON-RPC 2.0을 통해 네이티브로 구현됩니다. 프로토콜 버전은 가정하지 않고 협상됩니다.

클라이언트로서: 서버는 발견되고, 설명되고, 정책 검사되고, 승인된 후에만 등록됩니다 — 그래서 에이전트는 MCP 도구를 다른 도구와 정확히 동일한 방식으로 호출합니다.

orchestrator mcp    # health, negotiated version, registered tools, refusals

서버로서: orchestrator mcp-serve는 오케스트레이션을 다른 에이전트 시스템에 노출합니다. 제어 작업은 --allow-control 뒤에 유지됩니다.

문서

상태

701개 테스트. PostgreSQL 인스턴스에 도달할 수 있는 곳에서는 699개가 통과합니다. 없으면 659개가 통과하고 42개의 PostgreSQL 기반 테스트가 건너뜁니다. 모든 하위 시스템은 실제 저장소, 실제 MCP 서버 하위 프로세스, 그리고 의도적인 실패 주입에 대해 테스트됩니다. 다중 복제 통제 — 공유 토큰 폐기, 공유 속도 제한, 이그레트 강제, TLS 경계 —는 단위 테스트뿐만 아니라 실행 중인 프로덕션 Compose 스택에 대해 deployment/smoke-test.sh로 검증됩니다.

알려진 제한 사항은 발견되도록 남겨두는 대신 docs/production-readiness.md와 docs/research/ORCHESTRATION_RESEARCH.md에 정직하게 기록되어 있습니다.

Apache-2.# 유니버설 AI 오케스트레이션 플랫폼

도메인에 구애받지 않는 MCP 우선 오케스트레이션 엔진입니다.

목표를 설명하세요. 워크플로우가 아니라. 목표를 주면 플랫폼이 작업이 무엇인지, 어떻게 분해할지, 어떤 역량이 필요한지, 무엇을 병렬로 실행할 수 있는지, 결과를 어떻게 검증할지, 실패 시 무엇을 할지, 목표가 실제로 달성되었는지 여부를 결정합니다.

플랫폼에는 도메인에 대한 가정이 포함되어 있지 않습니다. 사전 탑재된 에이전트 역할도, 사전 탑재된 도메인 워크플로우도, 하드코딩된 제공자도, 하드코딩된 도구도 없습니다.

pip install -e ".[all]"
orchestrator init .
orchestrator run "Accomplish this objective."

무엇이 다른가

모델이 제안하고, 소프트웨어가 처리합니다. 상태, 스케줄링, 권한, 재시도, 영속성, 검증, 리소스 제한은 결정적 코드입니다. 모델은 추론, 계획, 작업 수행, 주관적 결과 판단에만 사용되며 그 외에는 아무것도 사용되지 않습니다.

이러한 구분 덕분에 플랫폼은 확률적 약속이 아닌 확고한 약속을 할 수 있습니다:

• 필수 검증 실패는 COMPLETED를 생성할 수 없습니다.

• 취소된 실행은 조용히 계속될 수 없습니다.

• 에이전트는 부여되지 않은 도구를 호출하거나 볼 수 없습니다.

• 모든 루프 — 재시도, 재계획, 개선 라운드, 에이전트 반복 — 에는 강제된 상한이 있습니다.

• 발견된 MCP 도구는 신뢰되지 않습니다; 서버의 주석은 평가된 위험을 높일 수만 있고 낮출 수는 없습니다.

"완료"는 의미가 있습니다. 완료에는 증거가 필요합니다. 결정적 검사가 없는 곳에서는 플랫폼이 가장하지 않고 UNCERTAIN을 보고합니다. 모델은 LIKELY에 도달할 수 있지만 CONFIRMED를 인증할 수는 없습니다.

핵심은 의존성이 전혀 없습니다. 그 외의 모든 것 — CLI, REST API, HTTP 모델 제공자, YAML — 은 선택 사항입니다. stdio를 통한 MCP는 프로토콜 클라이언트가 네이티브로 구현되어 있으므로 기본 설치에서도 작동합니다.

보안 태세

이 플랫폼은 모델이 선택한 인수로 도구를 실행합니다. 이 단일한 사실이 보안 설계를 주도하며, 통제는 모델에게 요청되는 것이 아니라 코드로 강제됩니다.

배포 프로필을 선언하세요. 생략하면 production으로 간주됩니다.

profile: production   # development | internal-pilot | production

배포 전에 읽어 보세요:

• SECURITY.md — 위협 모델, 방어되는 것과 방어되지 않는 것

• docs/security.md — 모든 통제와 각각의 테스트

• docs/production-readiness.md — 108개 항목 체크리스트, 각 항목은 완료 / 미완료 / 운영자 책임으로 표시

• deployment/runbook.md — 세 가지 배포 형태

• docs/configuration.md — 모든 설정

주장의 범위

TLS/auth 프록시 뒤에서 통제된 프로덕션 배포를 지원합니다: SQLite의 단일 인스턴스 또는 PostgreSQL의 다중 인스턴스 (storage.backend: postgres).

명시적으로 지원되지 않음: SQLite의 다중 인스턴스, 강제된 컨테이너/샌드박스/원격 격리, 프로세스 내 OIDC JWT 검증 또는 프록시 전달 신원 (베어러 토큰이 유일한 신원 메커니즘), 외부 격리 경계가 없는 프로세스 실행, 그리고 AI 출력 정확성에 대한 어떠한 보장.

제공된 Compose 스택에서 두 개의 복제본에 걸쳐 검증됨: 공유 PostgreSQL 상태, 분산 토큰 폐기, 분산 속도 제한, 프록시를 통한 강제 아웃바운드 이그레스, 클라이언트 제공 신원 헤더를 제거하는 TLS 경계. 플랫폼은 증거 기반 검증, 신뢰도 보고, 적대적 검토자, 인간 승인 게이트, 결정적 회귀 테스트 하네스를 제공합니다 — 이 중 어느 것도 모델 출력을 올바르게 만들지 않습니다; 신뢰의 근거를 검사 가능하게 만들 뿐입니다.

python -m pytest tests/ -q        # 699 with PostgreSQL
orchestrator validate             # effective posture and migration notices
orchestrator evaluate             # 31 deterministic regression cases
orchestrator migrate              # schema status

실행, 처음부터 끝까지

objective
   → goal analysis        structured requirements, provenance-tagged
   → pattern selection    deterministic complexity scoring
   → planning             validated task DAG (or a deterministic fallback)
   → scheduling           dependency-aware, parallel, resource-locked
   → per task             capability-routed agent, least-privilege scope,
                          bounded loop, independent validation gate
   → recovery             classify → strategy ladder → retry/swap/re-plan/ask
   → objective gate       success criteria, checked
   → review               structural precondition on completion
   → COMPLETED

모든 단계는 인간을 기다리거나, 일시 중지하거나, 취소할 수 있으며 — 프로세스가 죽은 후에도 — 이후 영속화된 상태에서 재개할 수 있습니다.

orchestrator inspect <id>    # the task graph, validations, failures
orchestrator audit <id>      # every decision, in order

오케스트레이션 패턴

모드가 아닌 구성 가능한 그래프 조각입니다. 병합 단계가 평가자-최적화 루프인 병렬 팬-아웃은 그저 그래프일 뿐입니다.

single agent · sequential · parallel · router · orchestrator-worker · evaluator-optimizer · hierarchical · handoff · dynamic DAG

라우터는 모든 분기를 구체화하고 선택하지 않은 분기를 제거합니다. 작업은 남은 작업을 다른 전문가에게 넘길 수 있으며, 동료가 원을 그리며 전달할 수 없도록 제한됩니다. 그리고 작업은 그 자체로 완전한 오케스트레이션 실행이 될 수 있으며, 예산은 부모의 예산에 추가되는 것이 아니라 부모의 예산에서 분할됩니다.

플랫폼은 목표의 구조에서 하나를 선택합니다. 사소한 목표는 에이전트 하나와 검사 하나를 얻습니다 — 에이전트 열 개와 검토자 네 개가 아닙니다. 원하면 --pattern으로 재정의하세요.

역량이 아닌 역할

이름으로 라우팅하는 것은 없습니다. 작업은 필요한 것을 선언하고, 에이전트는 제공하는 것을 광고하며, 선택은 최소 과잉 권한을 선호하는 결정적 점수입니다. 요구 사항을 충족하는 것이 없으면 범위가 제한된 임시 전문가가 생성됩니다 — 그리고 부족이 실제가 아닌 경우 선택은 조용히 실패하는 대신 크게 실패합니다.

핵심에는 역량, 에이전트, 스킬이 포함되어 있지 않습니다. 이들은 구성, 플러그인, 또는 플래너에서 나옵니다. 그것이 도메인 중립성을 유지하는 이유입니다.

스킬은 세 번째 요소입니다: 코드가 아닌 콘텐츠로서의 재사용 가능한 지식입니다. 스킬은 에이전트에게 이미 승인된 작업에 접근하는 방법을 알려주며, 그에게 아무것도 부여하지 않습니다.

MCP

양방향 모두 일급 시민이며, SDK 의존성 없이 JSON-RPC 2.0을 통해 네이티브로 구현됩니다. 프로토콜 버전은 가정하지 않고 협상됩니다.

클라이언트로서: 서버는 발견되고, 설명되고, 정책 검사되고, 승인된 후에만 등록됩니다 — 그래서 에이전트는 MCP 도구를 다른 것과 정확히 동일한 방식으로 호출합니다.

orchestrator mcp    # health, negotiated version, registered tools, refusals

서버로서: orchestrator mcp-serve는 오케스트레이션을 다른 에이전트 시스템에 노출합니다. 제어 작업은 --allow-control 뒤에 유지됩니다.

문서

상태

701개 테스트. PostgreSQL 인스턴스에 도달할 수 있는 곳에서는 699개가 통과합니다. 없으면 659개가 통과하고 42개 PostgreSQL 기반 테스트가 건너뜁니다. 모든 하위 시스템은 실제 저장소, 실제 MCP 서버 하위 프로세스, 그리고 의도적인 실패 주입에 대해 테스트됩니다. 다중 복제 통제 — 공유 토큰 폐기, 공유 속도 제한, 이그레스 강제, TLS 경계 — 는 단위 테스트뿐만 아니라 실행 중인 프로덕션 Compose 스택에 대해 deployment/smoke-test.sh로 검증됩니다.

알려진 제한 사항은 발견되도록 남겨 두지 않고 docs/production-readiness.md와 docs/research/ORCHESTRATION_RESEARCH.md에 정직하게 기록되어 있습니다.

Apache-2.0.