volition79 GitHub avatar

gpt-5.6-router

volition79

GPT-5.6 Model Router is a Codex skill that routes tasks among three specialist models (Sol, Terra, Luna) based on a chosen profile (PERFORMANCE, BALANCED, TOKEN_SAVER) with a two-step approval process and strict runtime verification to prevent silent model substitution.

Stars

16

7-day growth

No data

Forks

4

Open issues

0

License

MIT

Last updated

2026-07-15

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It introduces a structured, security-conscious model routing system for Codex that enforces explicit user approval, prevents silent model swaps, and preserves design quality by keeping Sol responsible for creative direction while allowing Terra to refine implementation within approved intent.

Who it is for

  • Codex CLI/Desktop users running multi-agent workflows
  • Developers who want to automate model selection without manual team design
  • Design teams working on AI-assisted creative projects
  • Security-conscious AI agents that need to verify model fidelity

Use cases

  • Building a polished analytics dashboard with design and implementation phases
  • Developing a new web service with balanced cost and quality
  • Iterating on token-intensive projects where minimizing API usage is critical
  • Creative projects requiring Sol-led design exploration followed by Terra implementation

Strengths

  • Two-stage approval (profile selection then execution) reducing unauthorized changes
  • Adaptive routing that never reuses the parent model as a child
  • Built-in runtime checks that stop execution if child model assignment mismatches
  • Explicit security principles: no silent model fallback, no credential exposure, no sandbox weakening

Considerations

  • Requires a Codex runtime with multi-agent V2 capabilities and specific model access
  • Skill only activates when explicitly called; no automatic background routing
  • Setup complexity: proper tool_namespace configuration is necessary to avoid spawn_agent conflicts

README quick start

GPT-5.6 Model Router

English

[!IMPORTANT] 일부 Codex CLI 및 Codex Desktop 환경에서는 GPT-5.6 Sol과 Multi-Agent V2의 collaboration.spawn_agent 도구 규격이 충돌해 모든 요청이 모델 실행 전에 실패할 수 있습니다.

hide_spawn_agent_metadata = false만 단독으로 설정하지 마세요. 영향을 받는 환경에서는 tool_namespace = "agents"를 포함한 아래의 전체 설정 블록을 기존 설정에 병합한 뒤, Codex를 완전히 종료하고 새 세션을 시작하세요.

저장소 주소만 전달해 설치하기

다른 Codex 또는 AI 에이전트에는 아래 저장소 주소만 전달해도 설치 절차를 시작할 수 있습니다.

https://github.com/volition79/gpt-5.6-router

저장소 주소와 함께 다음처럼 요청합니다.

이 저장소의 README, SKILL.md, SECURITY.md, runtime-troubleshooting.md를 먼저 검토하고 사용자 전역 스킬로 설치해 주세요. 실제 Codex CLI/Desktop 버전과 Multi-Agent V2 관련 설정만 확인하고, 전체 config.toml이나 비밀값은 출력하지 마세요. 필요한 설정 변경과 백업 계획을 먼저 보여 주고 승인을 받은 뒤 병합하세요. Codex 완전 재시작 후 새 세션에서 Terra 모델 고정을 검증하고, 실제 모델이 다르면 중단하세요.

에이전트는 URL을 받으면 다음 순서로 처리해야 합니다.

  1. 저장소를 읽기 전용으로 검토하고 최신 검토 릴리스 태그를 확인합니다.
  2. 터미널 CLI와 Codex Desktop 내장 런타임을 구분해 버전을 확인합니다.
  3. 사용자 전역 및 프로젝트별 config.toml에서 멀티 에이전트 관련 키만 확인합니다.
  4. 기존 설정을 덮어쓰지 않고, 변경 예정 내용과 백업 위치를 먼저 제시해 승인을 받습니다.
  5. 승인 후 아래의 전체 V2 설정을 기존 TOML 구역에 병합하고 검토 릴리스 스킬을 설치합니다.
  6. Codex를 완전히 종료하도록 안내하고, 기존 대화가 아닌 새 세션에서 Terra 최소 검증을 수행합니다.
  7. 실제 자식 모델·추론 강도·역할이 요청과 다르면 성공으로 처리하지 않고 중단합니다.

이미 모든 GPT-5.6 Sol 요청이 예약 도구 오류로 실패하는 세션은 모델이 URL이나 README를 읽기 전에 거부됩니다. 이 경우 정상 동작하는 다른 모델, 새 터미널, 또는 Codex 외부 셸에서 저장소를 먼저 확인해야 합니다. 설정 변경 승인과 완전 재시작은 저장소 URL만으로 생략할 수 없습니다.

GPT-5.6 Sol, Terra, Luna의 강점을 작업 단계별로 배치하는 Codex 스킬입니다. 사용자가 직접 팀을 설계하지 않아도 PERFORMANCE, BALANCED, TOKEN_SAVER 중 목표를 선택하고, 읽기 전용 조사와 실행 승인을 분리한 뒤 적합한 모델 경로를 제안합니다.

이 스킬은 명시적으로 호출할 때만 활성화됩니다.

주요 특징

  • 2단계 승인: 프로필 선택과 실제 실행 승인을 분리
  • 부모 모델을 중복 사용하지 않는 적응형 라우팅
  • Sol: 아키텍처, 고난도 판단, 제품·UX/UI·시각·상호작용·모션·아트 디렉션
  • Terra: 탐색, 일반 구현, 테스트, 증거 정리
  • Luna: 객관적으로 검증 가능한 반복·변환 작업
  • 디자인 작업은 Sol이 품질 방향과 최종 주관적 승인을 담당
  • Sol의 디자인 초안을 고정 명세로 취급하지 않고 창의적 탐색을 보호
  • Terra가 승인된 의도 안에서 구성, 모션, 반응형 표현, 마이크로인터랙션을 발전시킬 수 있도록 허용
  • 역할 또는 모델 오버라이드가 보이지 않을 때를 위한 런타임 점검 절차 포함

요구 사항

  • Codex에서 스킬을 읽을 수 있는 환경
  • GPT-5.6 Sol, Terra, Luna 모델을 지정할 수 있는 멀티 에이전트 런타임
  • 설치용 git
  • 스킬 검증을 실행하려면 Python 3와 PyYAML

모델 고정 기능이 없는 런타임에서는 다른 모델로 조용히 대체하지 않고 중단하도록 설계되어 있습니다.

설치

Multi-Agent V2 필수 사전 점검

스킬 저장소를 복제하는 것만으로는 Terra와 Luna 모델 지정이 보장되지 않습니다. 먼저 실제 작업에 사용되는 런타임을 확인합니다.

codex --version
codex features list

설정 파일 위치는 다음과 같습니다.

  • Windows: %USERPROFILE%\.codex\config.toml
  • macOS: ~/.codex/config.toml

Description

Adaptive GPT-5.6 Sol, Terra, and Luna routing skill for Codex

Related repositories

Similar projects matched by category, topics, and programming language.

powerycy
Featured
powerycy GitHub avatar

goutoujunshi

An AI relationship coach that provides emotional support, relationship science, and actionable strategies through a multidisciplinary knowledge base.

Python
1,174
makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
mereyabdenbekuly-ctrl
Featured
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI & Machine LearningAI Agents
859