Sol Advisor — Codex 네이티브 리스크 게이트 오케스트레이션 플러그인

원문: DannyMac180/sol-advisor · 수집일: 2026-08-23

핵심 요지

Sol Advisor는 Codex 전용 워크플로 플러그인으로, 목표와 제약만 주면 아키텍트 역할인 Sol / High가 계획·구현(또는 위임)·검증·수용을 모두 소유한다. 핵심 규율은 세 가지다:

라우트 선언 선행 — 첫 task tool 호출 전에 SELECTIVE ROUTE 선언(모드 + 위험 근거)을 남긴다.
solo 기본값 — 위험이 통제된 경우 루트가 직접 계획·구현·테스트·자기 리뷰한다. 보조 에이전트는 최대 1개만.
무단 강등 금지 — 에스컬레이션은 새로 관찰된 위험이 정당화할 때만 가능하고, 조용히 라우트를 낮추지 않는다.

왜 사용하는가

무분별한 서브에이전트 스폰 방지 — 대부분의 오케스트레이션 도구는 에이전트를 늘리는 데 초점을 맞추지만, 이 프로젝트는 반대로 “기본은 solo, 예외만 위임”이라 비용과 복잡도를 통제한다.
감사 가능성(auditability) — SELECTIVE ROUTE 선언이 diff로 남기 때문에 세션 로그만으로 “왜 위임했는가”를 사후 검증할 수 있다. 팀 워크플로에서 위임 결정·리뷰 비용 논쟁을 줄이는 장치다.
품질 게이트 — 수정이 생기면 반드시 새로운(fresh) 리뷰를 요구하는 mandatory fresh review와 루트의 전체 diff 검사 후 요청된 검사 재실행 등 ship 전 검증이 구조적으로 강제된다.
안전한 설치 — companion installer가 fail-closed로 role 파일을 검증해 수정·불일치 파일은 건드리지 않는다(상세는 아래 설치·운영 특징).

수집 범위

GitHub 저장소 메인 페이지의 README 전문과 저장소 메타데이터(Stars 2.3k / Forks 180 / Issues 7 / PRs 14 / 커밋 22, MIT 라이선스). 스킬·스크립트 소스 본문과 operations.md 상세 문서는 이번 수집에서 읽지 않았다.

주요 내용

4개 라우트

모드	사용 시점	동작
`solo`	기본. 위험 통제됨	루트(Sol)가 계획·구현·테스트·자기 리뷰
`delegate`	완성도 높은 스펙을 구현자 1명이 실행하기 좋을 때	Luna/Max는 범위 제한 작업, Terra/High는 판단·고위험 작업. 루트가 검증
`audit`	독립적 최종 감식이 위임보다 중요할 때	루트가 구현하고 fresh read-only Sol / High가 리뷰
`full`	명시적 광범위·고위험 예외	구현자 1명 + 루트 검증 + fresh Sol / High 리뷰

역할 구성

Sol / High: 기본 세션. 아키텍처, 분해, 라우트 선택, 부모 검증, 에스컬레이션 판단, 수용을 담당.
Luna / Max: bounded work 위임 레인.
Terra / High: 판단·고위험 위임 레인.
리뷰 포함 라우트에서는 fresh한 Sol / High 리뷰어가 ship / fix-first / rethink를 반환하며, 수정이 생기면 반드시 새 리뷰를 요구한다(mandatory fresh review).

설치·운영 특징

요건: 최신 Codex CLI 또는 plugins 활성 ChatGPT 데스크톱, GPT-5.6 Sol / High, 네이티브 custom-agent 지원, jq. Luna/Terra는 위임 시에만 필요.
companion installer는 fail-closed로 3개 role 파일을 검증한다 — 수정·symlink·불일치 파일은 건드리지 않고 Codex 설정도 편집하지 않는다. 설치 후 새 태스크를 열어 role을 발견시킨다.
보조 작업은 루트 작업을 대체할 뿐 중복하지 않으며, 루트가 전체 diff를 검사하고 요청된 검사를 재실행한다.

해석과 적용 메모

(내 해석) 이 프로젝트의 차별점은 멀티에이전트 확장이 아니라 “기본은 solo, 예외만 위임”의 리스크 게이트 규율이다. 무분별한 서브에이전트 스폰을 막는 선언적 라우트 패턴은 Claude Code·OpenCode 하네스 설계에도 그대로 이식 가능한 아이디어다.
(내 해석) SELECTIVE ROUTE 선언을 diff로 남기면 세션 로그만으로 위임 결정을 사후 감사할 수 있다 — 팀 워크플로에서 리뷰 비용 논쟁을 줄이는 장치로 읽힌다.
수치(Stars 등)는 2026-08-23 기준이며 빠르게 변할 수 있다. README 주장(모델명 GPT-5.6 등)은 원문 발췌이므로 confidence: medium.

누락·접근 제한

plugins/sol-advisor 내부 소스 코드와 operations.md(spawn 방식, runtime evidence, 샌드박스, installer 세부) 미수집 — 필요하면 후속 수집으로 보강.
릴리스 태그 없음(22 commits on main 기준).

description	DannyMac180/sol-advisor는 Codex에서 Sol이 첫 도구 호출 전 SELECTIVE ROUTE를 선언하는 solo 기본·보조 1개 한정 리스크 게이트 오케스트레이션 플러그인.
tags	ai-agents, ai-coding, codex, open-source, automation
aliases	sol-advisor, Sol Advisor

LLM Wiki

탐색기