Orchestrator Mode

자급자족하는 작업을 터미널을 지켜보지 않아도 끝까지 실행하는 헤드리스 Codex 워커에 맡깁니다.

Orchestrator Mode는 MadoAgent가 자급자족하는 작업을 터미널을 지켜보지 않아도 Codex 워커에 넘기는 방법입니다. 인터랙티브 Codex 세션을 열어 타이핑을 지켜보는 대신, MadoAgent는 자체 타일에서 헤드리스, 비인터랙티브 Codex 실행을 시작합니다. 워커는 스스로 끝내거나 샌드박스가 동작을 거부합니다 — 절대 질문을 하느라 멈추지 않으므로 지켜볼 것이 없습니다.

MadoAgent에서 디스패치되는 fire-and-forget 작업에 알맞은 형태입니다: "이 모듈 리팩터", "이 테이블의 마이그레이션 작성", "이 파일의 테스트 생성". 요청하면, 워커가 실행되고, 끝나면 다시 확인합니다.

Orchestrator Mode가 만든 타일은 제목 표시줄에 Worker 배지를 달아, 헤드리스 워커가 손으로 연 터미널과 한눈에 구분되게 합니다. 배지는 앱 재시작에도 유지됩니다.

할 수 있는 일

실행 중 입력이 필요 없는 작업을 MadoAgent에서 헤드리스 Codex 워커로 디스패치.

샌드박스 모드 선택 — 워커가 만질 수 있는 것을 통제:

모드	워커가 할 수 있는 일
read-only	파일을 읽을 수 있지만 수정하거나 부작용이 있는 명령을 실행할 수 없습니다.
workspace-write(기본값)	작업 디렉터리 안에서 읽고 쓰기.
danger-full-access	샌드박스 제한 없음. 명시적으로 선택해야 함 — MadoAgent가 스스로 이것을 고르지 않습니다.

MadoAgent가 진행 감독 — 워커 타일을 지켜보고 실행이 끝났는지, 실패했는지, 아직 실행 중인지 보고합니다.
궤도를 벗어난 워커 취소 — MadoAgent가 실행이 어긋났다고 판단하면.

사용 방법

Cmd+Shift+M(⌘⇧M)으로 MadoAgent를 엽니다.
디스패치 워커를 요청합니다. 예: "auth.ts를 클래스로 리팩터하도록 Codex 워커를 디스패치해줘".
MadoAgent가 Worker 배지가 있는 새 터미널 타일을 열고 그 안에서 헤드리스 Codex 실행을 시작합니다.
MadoAgent가 타일을 폴링하며 워커가 끝났는지, 실패했는지, 아직 실행 중인지 알려줍니다. 언제든 타일을 직접 클릭해 출력을 읽을 수도 있습니다.

기본 샌드박스가 workspace-write인 이유는, 디스패치된 워커가 명시적이고 의도적인 선택 없이는 프로젝트 디렉터리 밖의 무엇도 만질 수 없게 하기 위해서입니다.

일반적인 사용 사례

"새 users 테이블의 마이그레이션을 작성하도록 Codex 워커를 디스패치해줘." 시작해두고, 계속 작업하며, MadoAgent가 끝났다고 보고할 때 타일을 확인합니다.
"payments/가 하는 일을 요약하는 읽기 전용 Codex 워커를 실행해줘." 읽기 전용 샌드박스로 워커가 볼 수는 있되 바꿀 수는 없게 합니다.
"여기서 계속 코딩하는 동안 auth.ts의 테스트를 워커에서 생성해줘." Worker 배지가 헤드리스 실행을 인터랙티브 터미널과 시각적으로 분리합니다.

팁과 모범 사례

분석 작업(요약, 설명, 감사)에는 read-only를 사용하세요 — 바뀔 것이 없다면 쓰기 권한을 줄 이유가 없습니다.
보통 리팩터에는 workspace-write를 유지하세요. danger-full-access는 작업이 진짜로 프로젝트 디렉터리 밖에 닿아야 할 때만, 의도적으로 선택하세요.
MadoAgent가 워커를 "아직 실행 중"이라고 보고하지만 궤도를 벗어나 보이면, 기다리는 대신 MadoAgent에게 취소를 요청하세요.
워커 타일을 무슨 일이 있었는지의 진실 공급원으로 취급하세요 — MadoAgent의 요약은 편의일 뿐, 타일이 전체 출력을 가지고 있습니다.

제한 사항

워커는 승인이 꺼진 채로 실행 — 샌드박스가 허용하지 않는 모든 것은 아무도 답하지 않을 프롬프트에서 막히는 대신 자동 거부됩니다. 그에 맞춰 샌드박스 모드를 계획하세요.
헤드리스 워커는 인터랙티브하지 않습니다. 작업이 실행 중 권한 프롬프트에 답해야 한다면, 대신 인터랙티브 Codex 타일을 사용하세요.
워커는 로컬 Codex CLI에서 실행됩니다; 시작하려면 Codex가 구성되어 있어야 합니다.