donvito/codex-astra-luna-orchestrator

무엇인가요

Codex Astra/Luna Orchestrator는 Codex CLI 도구에 즉시 사용 가능한 orchestration 구성을 추가하는 도우미 패키지입니다. 특정 GPT-6 모델 변형(Astra, Sol, Luna)에 연결된 일련의 sub-agents(explorer, worker, tester, researcher, reviewer)를 번들로 제공합니다. 제공된 profiles 중 하나를 대상 코드베이스에 설치하면 개발자는 변경 사항을 자동으로 계획, 구현, 테스트 및 검토할 수 있는 사전 구성된 멀티 에이전트 워크플로우를 얻게 됩니다.

대상 사용자

이미 Codex 명령줄 인터페이스를 사용 중이며, 더 큰 코딩 작업(새 기능 구축, 리팩토링, 엔드투엔드 구현 생성 등)을 위해 플러그 앤 플레이 방식의 멀티 에이전트 설정을 원하는 모든 사용자.

핵심 개념

개념	의미
Orchestrator	전체 작업을 조정하는 루트 에이전트(Astra 또는 Sol).
Sub-agents	특정 역할을 수행하는 개별 GPT-6 Luna 에이전트: explorer(문제 매핑), worker(코드 작성), tester(검사 실행), researcher(정보 수집).
Reviewer	병합 전 출력을 검증하는 별도의 에이전트(Astra 또는 Sol).
Profile	`profiles/` 아래의 폴더로, 전체 구성(`.codex/`) 및 기술 파일(`.agents/`)을 포함합니다. 프로필을 선택하면 이 파일들이 대상 저장소로 복사됩니다.
Skill	`astra-orchestrator` 기술 정의(`SKILL.md`)로, Codex에 오케스트레이션된 워크플로우를 호출하는 방법을 알려줍니다.

설치 방법

저장소를 Clone 합니다.
플랫폼별 설치 프로그램(setup.sh 또는 setup.ps1)을 실행합니다.
스크립트가 요청하면 확장하려는 다른 저장소를 지정하고 프로필(1-6)을 선택합니다. 설치 프로그램은 다음을 복사합니다:
- .codex/config.toml 및 각 역할별 .toml 파일을 대상의 .codex/ 디렉토리로.
- 기술 파일을 대상의 .agents/skills/astra-orchestrator/ 로.
- 사용 가능한 에이전트를 문서화하는 AGENTS.md 파일(기존 파일이 있는 경우 추가).

오케스트레이터 사용하기

대상 프로젝트 디렉토리에서 Codex CLI를 실행합니다:

codex

Codex는 설치된 기술을 자동으로 로드합니다. 명시적으로 호출할 수도 있습니다:

$astra-orchestrator
Implement the invoice export endpoint. Use the explorer to map the path, a worker to implement it, and the tester and reviewer to verify it.

오케스트레이터는 4개의 Luna 하위 에이전트를 가동하고 협업하게 한 다음, 최종 결과를 검토자 에이전트에게 전달합니다.

프로필 요약

#	이름	루트 모델	실행 모델	검토자 모델	동시 하위 에이전트
1 (기본값)	`pro`	Astra (medium)	Luna (max)	Astra (low)	4
2	`plus`	Luna (max)	Luna (medium)	Astra (low)	4
3	`pro-max-2-subagents`	Astra (medium)	Luna (max)	Astra (low)	2
4	`plus-max-2-subagents`	Luna (max)	Luna (medium)	Astra (low)	2
5	`GPT6-SolMax-LunaMax`	Sol (max)	Luna (max)	Sol (max)	4
6	`GPT6-SolMedium-LunaMax`	Sol (medium)	Luna (max)	Sol (medium)	4

보유한 모델 액세스 권한(Astra, Sol 또는 Luna)과 원하는 병렬 처리 수준에 맞는 프로필을 선택하세요.

문서 및 도우미

Guides – guides/ 내의 단계별 markdown 파일로, 전체 오케스트레이션, plus-profile 설정, 빠른 반복, 일상적인 코딩, 복잡한 저장소 작업 및 토큰 사용량 측정을 다룹니다.
Scripts – 토큰 소비량을 추적하기 위한 작은 Python 유틸리티(scripts/token_usage.py).
Tests – 프로필 파일과 토큰 사용 로직을 검증하는 단위 테스트(tests/).

라이선스

Apache 2.0 – 자유롭게 사용, 수정 및 재배포 가능.

위의 모든 세부 정보는 저장소의 README에서 직접 가져온 것이며, 추가 기능은 추론되지 않았습니다.