Fable 오케스트레이터로 라우팅된 코딩 워크플로 구축

Fable이 하는 일

Fable은 Codex를 위한 작고 로컬 우선적인 라우팅 스킬입니다. 계획과 구현을 분리합니다. Claude Fable 5.1은 작업을 계획하고 의사 결정을 조정하며, Codex는 런타임으로 남아 워크스페이스를 제어하고 범위가 제한된 구현 작업을 OpenCode Go 에이전트에 위임합니다.

일반적인 구현은 GPT-5.6 Luna에 할당됩니다. 반복문, 반복적인 작업, 높은 처리량의 구현이 포함된 작업은 DeepSeek V4 Flash에 할당됩니다. Claude Fable 5.1은 구현 그래프 외부에 있으며 코드를 작성하거나 워크스페이스를 소유하지 않습니다.

Fable은 오케스트레이션 스킬이지 독립형 모델 게이트웨이나 개발 대시보드가 아닙니다.

주요 기능

• 로컬 우선 운영: 스킬은 로컬 Codex 스킬 디렉터리에 설치됩니다.
• 명확한 역할 분리: Fable은 계획과 의사 결정을 조정하고, Codex는 작업을 실행하고 검증합니다.
• 범위가 제한된 위임: 구현 노드는 허용된 GPT-5.6 Luna 또는 DeepSeek V4 Flash 경로만 사용합니다.
• 병렬 실행: 필요한 경우 Codex는 실행 가능한 워커를 병렬로 시작할 수 있습니다.
• 증거 기반 검증: Codex는 워커의 증거를 수집하고 워크플로를 완료하기 전에 결과를 검증합니다.
• 안전 장애 라우팅: 허용된 OpenCode Go 경로를 어느 것도 호출할 수 없으면 승인되지 않은 모델로 대체하지 않고 워크플로가 차단 원인을 보고합니다.
• 안전하고 반복 가능한 설치: 설치 프로그램은 드라이 런, 사용자 지정 대상, 멱등적 복사를 지원합니다.

리포지토리 이해하기

리포지토리에는 설치 가능한 스킬, 설치 프로그램, 테스트, 아키텍처 에셋이 포함되어 있습니다.

skill/fable/\n├── SKILL.md\n├── agents/openai.yaml\n└── scripts/ask_fable.sh\nassets/fable-orchestrator.svg\ninstall.sh\ntests/test_skill.sh

skill/fable/ 안의 세 파일이 설치 가능한 스킬을 구성합니다. ask_fable.sh 스크립트는 실행 가능하며 세션을 유지하지 않고 Claude Code의 로컬 fable 별칭을 호출합니다.

사전 요구 사항

스킬을 설치하기 전에 Codex Router를 통해 호출 가능한 opencode-go/ 및 opencode-go-responses/ 에이전트를 구성하세요. Fable은 해당 에이전트를 사용하지만 자체 프록시, 대시보드, 모델 카탈로그, 자격 증명 저장소 또는 API 키를 제공하지 않습니다.

제공자 또는 에이전트 정의를 변경한 후 Codex를 다시 시작하세요. 이렇게 하면 새 작업이 현재 라우팅 구성을 사용하게 됩니다.

Fable 설치

1. 설치 미리 보기

리포지토리 루트에서 설치 프로그램을 드라이 런 모드로 실행합니다.

./install.sh --dry-run

이 명령은 파일을 생성하지 않고 정확한 대상과 복사 작업을 출력합니다. 변경하기 전에 설치 프로그램이 수행할 작업을 확인하려면 사용하세요.

2. 기본 디렉터리에 설치

스킬을 기본 Codex 스킬 위치에 복사합니다.

./install.sh --copy

기본 대상은 ~/.codex/skills/fable입니다. 설치 프로그램은 필요한 디렉터리만 생성하며 반복해서 실행해도 안전합니다.

3. 사용자 지정 스킬 디렉터리 선택

기본 위치가 아닌 곳에 설치하려면 --target을 사용합니다.

./install.sh --copy --target "$PWD/.local/codex/skills"

설치 프로그램은 리포지토리와 대상 경로만 읽습니다. 자격 증명을 읽거나 생성하거나 수정하지 않습니다.

기본 사용법

새 Codex 작업을 시작한 다음 목표와 함께 스킬을 호출합니다.

$fable build the feature

Fable은 범위가 제한된 작업 그래프로 응답합니다. Codex는 해당 그래프를 검증하고, 적절한 경우 실행 가능한 워커를 병렬로 시작하며, 워커의 증거를 수집하고 결과 작업을 검증합니다. 추가 계획 결정이 필요하면 Codex가 Fable에 조정을 요청합니다.

라우팅 작동 방식

1. Fable이 목표를 분석하고 범위가 제한된 계획을 생성합니다.
2. Codex가 실행 전에 제안된 그래프를 검증합니다.
3. 일반적인 구현 노드는 GPT-5.6 Luna로 라우팅됩니다.
4. 반복이 많거나 처리량이 높은 구현 노드는 DeepSeek V4 Flash로 라우팅됩니다.
5. Codex가 증거를 수집하고 최종 결과를 검증합니다.
6. 추가 조정이 필요하면 Fable에 다시 문의합니다.

모든 구현 노드는 허용된 두 OpenCode Go 경로 중 하나를 사용해야 합니다. 두 경로를 모두 사용할 수 없다면 라우팅 정책을 우회하지 말고 보고된 차단 원인을 구성 문제로 처리하세요.

계획 패킷 안전하게 처리하기

ask_fable.sh에 전달하는 패킷에는 결정 사항과 워크스페이스 정보만 포함해야 합니다. 패킷에 자격 증명, API 키, 토큰 또는 기타 비밀을 절대 포함하지 마세요.

스크립트는 세션을 유지하지 않고 로컬 fable 별칭을 호출하므로 각 요청에는 해당 계획 또는 조정 단계에 필요한 관련 정보를 포함해야 합니다.

설치 테스트

리포지토리 루트에서 리포지토리의 종속성이 거의 없는 테스트 모음을 실행합니다.

tests/test_skill.sh

테스트 항목은 다음과 같습니다.

• 셸 구문.
• 설치 프로그램이 복사하는 소스 파일.
• 필수 라우팅 문자열.
• 기본 YAML 구조.
• xmllint를 통한 선택적 XML 검증.
• SVG 안전 제약 조건.
• 임시 홈 디렉터리를 사용한 드라이 런.
• 멱등적 복사 작업.
• 일반적인 자격 증명 형태의 문자열 검사.

테스트에는 PyYAML이나 활성 Claude 로그인이 필요하지 않으므로 가벼운 로컬 검증에 적합합니다.

고급 운영 팁

스킬을 디버깅하기 전에 라우팅 검증

Fable이 호출 가능한 허용 구현 경로가 없다고 보고하면 먼저 opencode-go/ 및 opencode-go-responses/에 대한 Codex Router 정의를 확인하세요. 공급자 또는 에이전트 정의를 변경한 후에는 Codex를 다시 시작하고 새 작업을 시작하세요.

사용자 지정 배포에는 드라이 런 사용

프로젝트 로컬 또는 표준이 아닌 스킬 디렉터리에 설치할 때는 복사하기 전에 --dry-run과 --target을 함께 사용하세요.

./install.sh --dry-run --target "$PWD/.local/codex/skills"
./install.sh --copy --target "$PWD/.local/codex/skills"

이를 통해 선택한 디렉터리를 수정하기 전에 대상 위치와 예정된 파일 작업을 확인할 수 있습니다.

업데이트할 때 설치 다시 실행

복사 작업은 멱등적이므로 저장소에서 설치된 스킬을 새로 고칠 때 안전하게 다시 실행할 수 있습니다. 복사 후 tests/test_skill.sh를 실행하여 저장소 검사를 검증하세요.

책임을 분리하여 유지

Fable을 구현 작업자로 취급하지 마세요. 문서에 명시된 Fable의 책임은 계획 수립과 최종 판정입니다. 런타임 제어, 작업 공간 소유권, 위임, 증거 수집 및 검증은 Codex가 계속 담당합니다.

결론

Fable은 Codex에 제한된 계획 수립과 모델 라우팅을 추가하는 집중적인 방법을 제공합니다. OpenCode Go 에이전트를 구성하고, 스킬을 미리 확인한 후 복사하고, 명확한 목표와 함께 호출하며, 포함된 테스트를 사용하여 설정을 검증하세요. 계획 패킷에 자격 증명을 포함하지 말고 라우팅 정의가 변경될 때마다 Codex를 다시 시작하세요.