Sol Advisor — 작업 규모·위험도 기반 선택적 위임 Codex 플러그인 (PyTorchKR 11678)

원문: PyTorchKR — Sol Advisor: 작업 규모와 위험도에 따라 서브 에이전트 위임 여부를 결정하는 Codex 플러그인 · 수집일: 2026-08-23

핵심 요지

PyTorchKR 9bow가 정리한 Sol Advisor는 “쪼개는 데도 비용이 든다”는 문제의식을 출발점으로, 작업 규모·위험도를 먼저 판단해 위임 자체를 예외로 두는 OpenAI Codex 전용 오케스트레이션 플러그인이다. 첫 도구 호출 전에 SELECTIVE ROUTE 선언을 강제하고 기본값 solo(보조 최대 1명)를 유지하며, 어떤 경로든 최종 검증과diff 재확인은 주 세션이 소유한다. 제작자 Daniel McAteer(2026-08-23-github-dannymac180-sol-advisor), MIT 라이선스, GPT-5.6 Sol/Terra/Luna 모델 기반 3개 레인 구조가 핵심이다.

수집 범위

• PyTorchKR Discourse 토픽 https://discuss.pytorch.kr/t/sol-advisor-codex/11678 공개 원문 1개(2026-08-21 06:30, 9bow) + 댓글 1개(grayowl) 전체를 webfetch로 수집해 raw source: 2026-08-21-pytorchkr-topic-11678-sol-advisor-codex에 보존. 이미지 2장은 외부 CDN URL로 참조만 기록.
• GitHub 1차 소스(2026-08-23-github-dannymac180-sol-advisor)와 대조 가능 — 본 요약은 2차 정리본 특성상 원문 주장과 GitHub README 사실을 분리 표기.

주요 내용

배경 — 왜 위임 자체를 게이트하는가

보조 에이전트를 늘리는 컬렉션(Awesome Codex Subagents 136종)이나 작업마다 하네스를 새로 짜는 방식(2026-07-27-github-bradautomates-claude-video 유사 병렬 하네스)과 달리, Sol Advisor는 “몇 개로 쪼갤까”가 아니라 “위임할 만한 종류인가”를 먼저 판정한다. 한 세션에서 끝날 일을 쪼개면 명세 작성·결과 독해·재검증 왕복이 낭비가 되고, 위험한 변경은 나눈 것만으로 부족해 독립 검토가 별도로 필요하기 때문이다. 강한 모델=조언자 / 값싼 모델=실행자 조합은 Anthropic Advisor 전략과 유사하지만, Sol Advisor는 매 작업마다 나눌지 말지를 판정해 기록으로 남긴다.

네 가지 라우트

모드	쓰는 상황	진행 방식
solo	기본값, 위험 통제	루트(Sol)가 계획·구현·테스트·자체 검토
delegate	명세 완성, 구현자 1명이 맡는 편이 나음	범위 제한 작업=Luna, 판단 무겁거나 고위험=Terra가 맡고 루트가 검증
audit	위임보다 독립 최종 검토가 중요	루트가 구현, 새로 띄운 읽기 전용 Sol이 검토
full	범위 넓거나 위험 크다고 명시적 판단한 예외	구현자 1명 + 루트 검증 + 새 Sol 검토자 모두 동원

보조 레인 고정: Luna=gpt-5.6-luna/최대 추론 강도(계약 기반 범위 제한 작업), Terra=gpt-5.6-terra/높은 추론 강도(판단·고위험), Sol 검토=gpt-5.6-sol/높은 추론 강도·샌드박스 읽기 전용.

라우트 선언 규율

SELECTIVE ROUTE
mode: solo | delegate | audit | full
risk: <이 작업에 한정된 간결한 판단 근거>

• 첫 task tool 호출 전 1회 선언 강제, 선언보다 앞서는 호출은 금지. 기계 판독 가능 형태로 사후 감사 가능.
• 경로는 새로 관찰된 위험이 있으면 더 무거운 쪽으로만 에스컬레이션, 조용히 낮추기 금지(올릴 때는 근거 기록).
• Luna 결과가 실제로는 판단 무거운 작업임을 드러내면 Terra로 승격; Luna 재시도는 명세 자체 오류로 한정.

주 세션에 남는 책임과 계약

요구사항·모호함 해소, 아키텍처·인터페이스·분해 결정, 라우트 선택, 구현자에게 줄 명세 작성, 변경분 확인·검증 재실행, 승격 판단, 최종 수용은 주 세션 소유. 명세는 목표·담당 파일/소유권·인터페이스·제약·검증 5부분 + 구조화된 반환 형식을 포함해야 하며(상세 2026-08-23-github-dannymac180-sol-advisor의 role-contracts.md 참조) 파일 소유권을 정확히 적어 동시 편집을 보존한다. 작업자 보고는 주장으로 취급 — 주 세션이 diff 전체·바뀐 파일 범위·요청 검사·실행 증거를 직접 확인한다. 검토 결과는 ship / fix-first / rethink 중 하나, 고치면 이전 검토 무효·새 검토자 재기동.

설치·운영

• 요건: 최신 Codex CLI 또는 플러그인 활성 ChatGPT 데스크톱 + jq. 주 세션은 Sol/High 고정 필요, Luna/Terra 접근은 위임 경로 선택 시에만 필요.
• 설치 3단계: codex plugin marketplace add DannyMac180/sol-advisor --ref main → codex plugin add sol-advisor@sol-advisor → scripts/install-agents.sh로 3개 role 파일 검증. installer는 fail-closed — 수정·symlink·불일치 파일은 그대로 두고 Codex 설정도 편집하지 않음. 설치 후 새 Codex 작업 시작.
• 호출: Use $sol-advisor:orchestration to build this feature and verify it. Declare the selective route before task tools.
• 갱신: marketplace upgrade → plugin add 재추가 → install-agents.sh 재실행 → 새 작업 시작.

누구에게 유용한가 / 제약

Codex에서 위임 판단이 매번 감으로 결정되고 불필요한 왕복을 경험한 팀, 위험 변경에 독립 검토(audit)를 일관되게 붙이고 싶은 팀에 유용. 반면 Codex 미사용 또는 Sol 고정 불가 환경에서는 동작하지 않으며, 모델/추론 강도 미확인 시 위임 전 정지·확인 요청. 규칙이 촘촘해 자유도가 낮아 매번 하네스를 직접 설계하려는 팀에는 제약으로 느껴질 수 있다.

해석과 적용 메모

• (내 해석) 이 플러그인의 핵심 아이디어는 확장보다 절제 — “기본 solo, 예외만 위임”이라는 리스크 게이트를 선언적으로 강제한다는 점이다. codex 하네스가 난립하는 상황에서 위임 결정 자체를 로그에 남기는 패턴은 moc-ai-agents-orchestration의 다른 오케스트레이션(예: 동적 하네스)에도 이식해 볼 만하다.
• (내 해석) SELECTIVE ROUTE 선택을 기계 판독 가능하게 고정해 두면, 사후 회고에서 “왜 이 작업을 위임했는가”를 diff만으로 검증할 수 있다 — 팀의 위임 비용 논쟁을 줄이는 장치로 읽힌다.
• (내 해석) PyTorchKR 요약은 GitHub README의 2차 정리본이며 “GPT 모델로 정리한 초안”이라고 밝힌다. 모델명(GPT-5.6 Sol/Terra/Luna) 같은 세부 팩트는 1차 소스인 2026-08-23-github-dannymac180-sol-advisor 원문·README와 교차 확인이 필요하다. 본 요약은 confidence: medium으로 표기.
• 적용 팁: 위임 명세의 5부분(목표·파일/소유권·인터페이스·제약·검증) 계약은 Codex가 아닌 Claude Code/Opencode 워크플로에도 그대로 차용 가능하다 — 파일 소유권을 명시해 동시 편집 충돌을 막는 조항이 특히 실용적이다.

누락·접근 제한

• 공개 토픽 원문+댓글 1개는 모두 확보했으나, 원문이 2차 정리본이므로 세부 수치·모델명은 GitHub 원문 대조가 필요하다.
• 이미지는 외부 CDN 최적화 URL로만 수집, 로컬 미러 없음. Discourse 로그인 필요 정보(좋아요 사용자 상세)는 미수집.
• 저장소 코드 본문(스킬·스크립트)과 operations.md 상세는 이번 수집 범위 외(2026-08-23-github-dannymac180-sol-advisor에도 미수집으로 명시).

관련 노트

• 2026-08-23-github-dannymac180-sol-advisor — 1차 소스 GitHub README 기반 요약 (동일 플러그인, 상호 보완)
• codex — Codex 생태계 개요
• moc-ai-agents-orchestration — 오케스트레이션 MOC (이 노트 추가 대상)
• moc-ai-coding — AI 코딩 MOC
• 2026-07-27-github-bradautomates-claude-video — 반대 방향의 병렬 하네스 확장 사례와 대비