Cjbuilds/Codex-Orchestration

Codex Orchestration – Codex AI 어시스턴트용 플러그인

무엇인가요 – Codex 플러그인으로, 다른 대규모 언어 모델(LLM) 서비스(예: Anthropic Claude Fable 5, Claude Opus 5, OpenRouter 모델 등)를 Codex 작업에 연결하고 각 모델에 특정 역할을 할당할 수 있습니다:

• 기획자 – 작업 계획을 초안 작성하고 반복적으로 개선합니다.
• 자문가 – 계획을 검토하고 결함을 지적한 후 최종 승인합니다.
• 디자이너 – 제한된 시각/UX/IA 인수 자료를 생성합니다(선택 사항).
• 실행자 – 승인된 계획을 구현합니다(필수).

Codex는 최상위 오케스트레이터로 남아 있으며, 역할 간 작업을 전달하고 모든 결과를 검증한 후 최종 답변을 반환합니다.

왜 사용하고 싶을까

• 각 단계(기획, 검토, 설계, 구현)에 가장 강력한 모델을 사용할 수 있습니다. 단일 모델을 사용하는 것보다 더 나은 결과를 얻을 수 있습니다.
• 코드 변경 전에 더 검증된 계획을 얻을 수 있습니다.
• 독립적인 작업 단계를 병렬로 처리하여 실행 시간을 최대 2배까지 단축할 수 있습니다.
• 무거운 작업이 저렴한 모델들 사이에 분산되므로 프리미엄 모델 사용량을 줄일 수 있습니다.

설치

# Codex 마켓플레이스에서 플러그인 추가
codex plugin marketplace add Cjbuilds/Codex-Orchestration
# 플러그인 자체 설치
codex plugin add codex-orchestration@codex-orchestration

Python 3.11+가 필요합니다.

빠른 시작 – 모든 명령어는 쉘 명령어가 아니라 Codex 채팅 내의 스킬 프롬프트로 입력해야 합니다.

# 전체 워크플로우 설정 (기획자 + 자문가 + 디자이너 + 실행자)
$codex-orchestration:codex-orchestration setup \
    planner: Claude Fable 5 High, \
    advisor: GPT-5.6 Sol High, \
    designer: GPT-5.6 Terra High, \
    executor: GPT-5.6 Luna Extra High

# 최소 워크플로우 설정 (자문가와 실행자만)
$codex-orchestration:codex-orchestration setup \
    advisor: Claude Opus 5 XHigh, \
    executor: GPT-5.6 Luna Extra High

설정 프롬프트 후, 일반적인 Codex 작업을 시작하면 저장된 워크플로우가 자동으로 적용됩니다.

핵심 개념 및 제한 사항

• 기획자 및 자문가는 최대 8회까지 검토 라운드를 반복할 수 있습니다. PLAN_APPROVED가 수신되지 않으면 실행이 중단되고 최신 계획이 표시됩니다.
• 디자이너는 Codex로부터 전달된 디자인 자료만 편집하며, 구현 코드에는 절대 접근하지 않습니다.
• 동시에 구성할 수 있는 Claude 구독 자리(기본 5 또는 Opus 5)는 하나뿐이며, 이는 기획자 또는 자문가로만 사용 가능합니다.
• 외부 모델은 보안된 자격 증명 저장소 기반의 흐름을 통해 역할로 추가되며, 플러그인은 API 키를 채팅에 붙여넣으라고 요청하지 않습니다.
• 플러그인은 루트 모델이나 모델 선택기 변경하지 않습니다. Codex는 최종 권한을 유지합니다.

플러그인 관리

• … status – 현재 활성화된 역할과 준비 상태를 표시합니다.
• … repair – 자격 증명을 건드리지 않고 일치하지 않는 저장된 상태를 복구합니다.
• … disable – 이전 라우팅 구성으로 복원합니다(사용자 정의 역할은 삭제하지 않음).
• … --update – 플러그인이 Codex의 내장 플러그인 매니저를 통해 자체 업데이트를 요청합니다(v0.7.0 이상에서 사용 가능).
• 제거: disable 프롬프트를 실행한 후 codex plugin remove …로 플러그인을 제거합니다.

개발 및 품질

• 표준 Python 개발 스택 사용(requirements‑dev.txt, ruff, unittest).
• 프로덕션 준비도 감사, 보안 정책, 릴리스 프로세스 포함.

라이선스 – MIT.

---

위 모든 세부 정보는 리포지토리의 README에서 직접 가져왔으며, 추가 기능은 추측되지 않았습니다.