omnilane 0.10.1 → 0.10.3

package/README.ko.md

@@ -21,47 +21,29 @@
 
 ---
 
-## 2026-07-25 업데이트
+## 🤔 omnilane 이란?
 
-- 기본 라우팅에 `claude-opus-5`를 추가했습니다. `hard-judgment`와 `taste-final`의 첫 번째 선택이며, 가장 어려운 코딩 작업의 대체 경로로도 사용됩니다.
-- `omnilane configure`를 13개 전체 제공자로 확장했습니다. 선택 가능한 모델은 106개이며 Codex, Claude Code, Grok Build, Antigravity의 최신 카탈로그와 검증된 OpenRouter／OpenCode 바로가기를 포함합니다. `c`를 통한 사용자 지정 모델 ID 입력도 계속 지원합니다.
+**무엇이 문제인가.** 이미 AI 코딩 어시스턴트——**Claude Code, Codex, Cursor,
+Gemini CLI** 같은——를 쓰고 계시죠. 각각은 하나의 모델 계열하고만 대화합니다.
+그래서 맡기는 모든 일이 그 한 모델에서 돌아갑니다, 적합하든 아니든——일회성 파일
+이름 변경이 가장 비싼 모델을 소모하고, 정작 어려운 설계 문제는 마침 열어 둔
+모델에 걸립니다.
 
----
-## 👋 처음이신가요?
-
-이미 AI 코딩 어시스턴트——**Claude Code, Codex, Cursor, Gemini CLI** 같은——를 쓰고
-계시죠. 각각은 한 번에 하나의 AI 모델과 대화하며, "어떤 작업에 어떤 모델이 최선인가"는
-당신 몫으로 남습니다.
-
-**omnilane 이 대신 골라 줍니다.** 모든 작업을 그 일에 가장 강한(그리고 가장 저렴한) 모델로
-자동 라우팅합니다——어려운 코딩은 최고 코더에게, 간단한 확인은 빠르고 싼 모델에게, 긴 문서는
-큰 컨텍스트 모델에게——전부 이미 결제 중인 구독과 API 키로. 기본값 그대로 쓰거나, 작은 설정
-파일 하나만 손보면 됩니다. 새로 관리할 대상이 늘지 않고(기존 도구 뒤에서 동작),
-`./install.sh --uninstall` 로 깔끔히 제거됩니다.
-
-**[⬇ 60초 시작으로](#-60초-시작)**
-
-## v0.10.0 새 기능
+**omnilane 이 하는 일.** 어시스턴트에게 라우팅 표를 줍니다. 작업은 **레인**——
+가장 어려운 코딩, 기계적인 물량, 분류, 어려운 판단, 최종 다듬기——으로 나뉘고,
+각 레인에는 그 일에 가장 강하고(그리고 가장 저렴한) 모델이 지정됩니다.
+어시스턴트는 자신이 잘하는 레인을 직접 처리하고, 나머지는 이미 가진 로그인으로
+다른 벤더의 CLI 에 백그라운드로 넘깁니다.
 
-- **Gemini 3.6 Flash 기본 라우팅** — `fast-agentic`, `triage`,
-  `bulk-mechanical` 의 gemini 후보(그리고 `Gemini Flash` 별칭)를 2026-07-21
-  출시된 Gemini 3.6 Flash 로 변경: 출력 토큰 감소, 출력 단가 인하, Artificial
-  Analysis 측정 출력 속도 1위.
-- **근거 재감사** — 라우팅 주석, 모델 능력 노트, Gemini 가격표를 공식 소스에
-  맞춰 갱신 (2026-07-21/22).
-
-## v0.9.1 새 기능
-
-- **수정**: `configure set` 이 더 이상 `routing.local.yaml` 의 수기 주석을
-  삭제하지 않습니다. 자체 스탬프 줄과 교체 대상 레인만 다시 씁니다.
+**omnilane 이 아닌 것.** 프록시도, 새 구독도, 계속 돌봐야 할 서비스도 아닙니다.
+표 한 장과 디스패치 스크립트 하나가 기존 도구 뒤에서 돌아갈 뿐입니다.
+`./install.sh --uninstall` 로 흔적 없이 제거됩니다.
 
-## v0.9.0 새 기능
+**모든 구독이 필요하지는 않습니다.** 각 레인은 대체 체인이며, 실제로 설치된 첫
+후보가 선택됩니다. CLI 가 하나든 일곱이든 동작하고, 아무것도 없는 레인은 실패
+대신 그냥 꺼집니다. 구독이 하나여도 기본 표는 그 벤더로 수렴합니다.
 
-- **OpenAI 호환 direct-API 벤더 5개 추가** — `deepseek`, `zai` (GLM), `mistral`,
-  `groq`, `cerebras` 가 `openrouter` 처럼 CLI 없는 레인으로 추가(curl 과
-  `<VENDOR>_API_KEY` 만 필요). `lib/common.sh` 레지스트리에 한 줄로 추가되며,
-  모델 능력 비교는 [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md) 참고.
-- **Fish 셸 자동완성** — `omnilane completion fish | source`.
+**[⬇ 60초 시작으로](#-60초-시작)** · **[❓ FAQ 보기](#-faq)**
 
 ## ⚡ 60초 시작
 
@@ -128,10 +110,10 @@ flowchart LR
 
 | 레인 | 1순위 모델 | 백업 | 용도 |
 |---|---|---|---|
-| 🔥 hardest-coding | GPT-5.6 Sol (max) | Claude Opus 5 (max) | 가장 어려운 구현, 근본 원인 디버깅, 정확성이 핵심인 수정 |
+| 🔥 hardest-coding | GPT-5.6 Sol (max) | Claude Opus 5 (xhigh) | 가장 어려운 구현, 근본 원인 디버깅, 정확성이 핵심인 수정 |
 | 🏗️ bulk-mechanical | GPT-5.6 Terra (max) | Claude Sonnet 5 (high) | 리팩터링, 마이그레이션, 테스트, 대량 스윕 |
 | 🧹 triage | GPT-5.6 Luna (medium) | Gemini 3.6 Flash (Low) | 대량 1차 선별 |
-| ⚖️ hard-judgment | Claude Opus 5 (max) | GPT-5.6 Sol (max) | 아키텍처 중재, 깊은 추론, 세컨드 오피니언 |
+| ⚖️ hard-judgment | Claude Opus 5 (xhigh) | GPT-5.6 Sol (max) | 아키텍처 중재, 깊은 추론, 세컨드 오피니언 |
 | ✒️ taste-final | Claude Opus 5 (high) | GPT-5.6 Sol (max) | 대외 문장, prompt/문서 다듬기, 스타일 최종심 |
 | 💬 consult | 명시적으로 지정한 벤더/모델 | —(폴백 없음) | 자연어 직접 상담. `--vendor` 를 반드시 유지 |
 | 🎨 ui-draft | GPT-5.6 Sol (xhigh) | Claude Opus 5 (high) | 디자인 시스템/참고 이미지가 있을 때의 UI 초안 |
@@ -142,15 +124,11 @@ flowchart LR
 | 🗳️ arbitrate | off(옵트인) | — | 내장 의견 패널(중대한 결정용)——기본 비활성. `routing.local.yaml` 에서 활성화;투표자×라운드마다 1콜 소모 |
 
 **백업**은 체인의 다음 후보입니다——1순위 벤더 CLI 가 설치되지 않았을 때
-디스패치가 강등되는 대상입니다.
+디스패치가 강등되는 대상입니다. 모든 레인이 이런 체인이며, 체인에 아무것도
+설치되어 있지 않으면 레인은 `off` 로 강등됩니다.
 
-> **Claude Fable 5 는 어디에?** 의도적으로 기본 테이블에 넣지 않았습니다:
-> Claude 최상위 티어는 보통 *메인 루프 자신*이지 디스패치되는 워커가 아니며,
-> 가격도 Opus 보다 높습니다. 이는 비용/가드레일/메인 루프 정책이며 능력 평가가
-> 아닙니다. Anthropic 은 Fable 5 를 Opus 5 보다 상위에 둡니다. 설정 메뉴의
-> 모델 목록에는 있으니 원하면 직접
-> 라우팅하세요(예: `routing.local.yaml` 에
-> `taste-final: claude claude-fable-5 high`).
+> **Claude Fable 5 는 어디에?** 의도적으로 기본 테이블에 넣지 않았습니다——
+> 이유와 실측 데이터는 [FAQ](#-faq) 에 정리했습니다.
 
 ### 자연어 상담
 
@@ -365,12 +343,136 @@ CLI 를 사용할 수 없음, `5` 1라운드 성공 투표자 부족, `6` 2라
   `jobs.sh status` 가 `dead` 를 보고.
 - **페이로드 상한** — 과대한 태스크 텍스트는 머리/꼬리만 남기고 자동 절단.
 
+## ❓ FAQ
+
+<details>
+<summary><b>이 구독들이 전부 필요한가요?</b></summary>
+
+<br/>
+
+아닙니다. 각 레인은 대체 체인이며 실제로 설치된 첫 후보가 사용됩니다. 구독이
+하나면 표 전체가 그 벤더로 수렴하고, 체인에 아무것도 없는 레인은 오류 대신 그냥
+꺼집니다. `omnilane doctor` 로 이 머신이 지금 실제로 닿을 수 있는 곳을 확인할 수
+있고, `routing.local.yaml.example` 에는 흔한 상황별 시작 프로필(Claude 만,
+Codex 중심, Codex 없음)이 들어 있습니다.
+
+</details>
+
+<details>
+<summary><b>omnilane 이 제 코드를 새로운 곳으로 보내나요?</b></summary>
+
+<br/>
+
+새로운 목적지는 생기지 않습니다. 디스패치는 이미 설치하고 로그인해 둔 벤더 CLI 를
+호출할 뿐이라, 코드가 도달하는 곳은 원래 쓰던 벤더뿐입니다. 러너는 구독형 CLI 를
+호출하기 전에 API 키 환경 변수를 제거하므로, 남아 있던 키 때문에 토큰 종량제로
+조용히 전환되는 일도 없습니다. 유일한 예외는 direct-API 벤더군(`openrouter`,
+`deepseek`, `zai`, `mistral`, `groq`, `cerebras`)으로, 이들은 정의상 당신이 설정한
+키로 해당 제공자의 API 를 호출합니다——모두 advise 전용이며 파일을 수정하지 않습니다.
+
+</details>
+
+<details>
+<summary><b>Claude Fable 5 는 어디에? 왜 기본 테이블에 없나요?</b></summary>
+
+<br/>
+
+**Claude 최상위 티어는 보통 메인 루프 자신이지 디스패치되는 워커가 아니기
+때문입니다.** 레인은 "지금 당신이 몰고 있는 모델 이외"에 작업을 보내려고 존재합니다.
+Fable 5 가 메인 루프라면 판단과 문장을 다시 Fable 5 로 라우팅하는 것은 호출만 한 번
+늘 뿐 얻는 것이 없습니다——그래서 위의 "메인 모델 고르기" 목록에서 Fable 5 는
+**드라이버**로 독립된 줄을 가지며, hard-judgment, taste-final, 정확성이 핵심인
+가장 어려운 수정을 직접 처리합니다.
+
+**측정 데이터도 워커로 쓰는 쪽을 지지하지 않습니다.** Artificial Analysis
+Intelligence Index(2026-07-24)에서 Opus 5(max)는 61점, Fable 5(max)는 60점 ——
+AA 자신이 "사실상 동점"이라 표현했고, Epoch AI 의 Capability Index 는 순위가
+반대입니다(Fable 5 161, Opus 5 159). 종합 지능은 무승부로 보면 됩니다. 실제로
+벌어지는 곳은 에이전트형 전문 산출물이며, 그 격차는 작지 않습니다:
+
+| 벤치마크 | Claude Opus 5 (max) | Claude Fable 5 | |
+|---|---:|---:|---|
+| AA-Briefcase(에이전트형 지식 노동, Elo) | 1720 | 1574 | **+146** |
+| GDPval-AA v2(Elo) | 1861 | 1747 | **+114** |
+| AA-Briefcase 작업당 비용 | $17.79 | $22.30 | **-20%** |
+| API 가격, 입력/출력 1M 당 | $5 / $25 | $10 / $50 | **절반** |
+
+Opus 5 의 max, xhigh, high 세 티어가 AA-Briefcase 상위 세 자리를 차지하며,
+`high` 티어조차 작업당 비용 절반 이하로 Fable 5 를 이깁니다. 즉 Fable 5 는 가격이
+두 배이면서 레인이 중시하는 어떤 축에서도 우위를 사지 못합니다.
+
+**Fable 5 가 실제로 더 나은 지점**: 사실 지식의 폭입니다. AA-Omniscience 에서는
+여전히 Opus 5 를 앞서며(두 모델의 규모 차이를 감안하면 당연), 반대로 Opus 5 는
+확신이 없을 때도 답하는 경향이 있어 환각률이 50%(Opus 4.8 대비 +14 포인트)입니다.
+실행보다 회상이 중심인 작업이라면 명시적으로 지목하세요:
+
+```bash
+dispatch.sh --vendor claude --model claude-fable-5 --effort high consult "…"
+```
+
+**이는 비용과 메인 루프 정책의 선택이지 능력 평가가 아닙니다.** Fable 5 는 설정
+메뉴의 모델 목록에 있으며, `routing.local.yaml` 한 줄로 기본값을 덮어쓸 수 있습니다:
+
+```yaml
+taste-final: claude claude-fable-5 high
+```
+
+</details>
+
+<details>
+<summary><b>Claude 레인은 왜 <code>max</code> 가 아니라 <code>xhigh</code> 인가요?</b></summary>
+
+<br/>
+
+노력 수준이 높을수록 좋은 것이 아니기 때문입니다. Anthropic 은 `xhigh` 를 코딩과
+에이전트 작업의 출발점, `high` 를 그 외 지능이 필요한 작업의 하한, `max` 를
+정확성이 비용보다 중요한 경우의 설정으로 문서화합니다. 제3자 측정도 일치합니다:
+Vals.ai 의 Vibe Code Bench 에서 Opus 5 는 `high` 에서 89.8%, `xhigh` 에서 88.3%,
+`max` 에서 88.4% —— 최상위 티어는 더 복잡한 해법을 내놓고 그만큼 더 자주 실패합니다.
+워크로드가 다르다면 레인 단위로 올리세요:
+
+```bash
+omnilane configure set hard-judgment "claude claude-opus-5 max"
+```
+
+</details>
+
+<details>
+<summary><b>레인의 1순위 CLI 가 없으면 어떻게 되나요?</b></summary>
+
+<br/>
+
+디스패치가 체인을 따라 내려가며 보유한 첫 벤더를 사용합니다. 호출을 쓰지 않고도
+결정을 먼저 확인할 수 있습니다:
+
+```bash
+scripts/dispatch.sh --explain hardest-coding   # 후보별 추적
+scripts/dispatch.sh --list                     # 전체 유효 테이블
+scripts/dispatch.sh --dry-run hardest-coding "…"   # 완전히 해석된 계획, 제공자 호출 없음
+```
+
+</details>
+
+<details>
+<summary><b>디스패치된 워커가 제 파일을 수정할 수 있나요?</b></summary>
+
+<br/>
+
+요청했을 때만 가능합니다. 디스패치의 기본값은 읽기 전용 `advise` 이며 벤더별로
+구현되어 있습니다(읽기 전용 샌드박스, plan 모드, 또는 읽기 전용 도구 집합).
+수정하려면 `--mode work` 와 명시적인 `--workdir` 가 모두 필요합니다. 워커는 다시
+디스패치할 수도 없습니다——깊이 가드가 종료 코드 86 으로 중첩 팬아웃을 거부하므로,
+명령 하나가 에이전트 연쇄로 번져 할당량을 태우는 일은 없습니다.
+
+</details>
+
 ## 📊 기본값과 출처
 
 기본 레인 배치는 Artificial Analysis 2026-07 스냅샷(AA 사이트 원본 레코드와
 각사 공식 가격 페이지로 교차 검증)과 공개 비교 리뷰에 근거합니다.
 이는 의견이지 법칙이 아닙니다——설정 메뉴와 `routing.local.yaml` 이
-그래서 존재합니다.
+그래서 존재합니다. 벤치마크별 단서를 포함한 작업 노트는
+[`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md) 에 있습니다.
 
 ## ⚠️ 알려진 제한
 
@@ -385,8 +487,67 @@ CLI 를 사용할 수 없음, `5` 1라운드 성공 투표자 부족, `6` 2라
 
 ## 📜 릴리스 기록
 
+## v0.10.3 새 기능
+
+- **5개 언어 README 전면 재구성** — 문서 첫머리에서 "이게 무엇이고 왜 필요한가"를
+  먼저 설명하고, 버전 기록은 도입부를 끊지 않도록 맨 아래로 모았습니다. 그리고
+  반복해서 들어온 질문에 답하는 FAQ 를 새로 넣었습니다: 구독이 전부 필요한지,
+  코드가 어디로 가는지, 왜 Fable 5 가 기본 테이블에 없는지, 왜 `max` 가 아니라
+  `xhigh` 인지, CLI 가 없으면 어떻게 되는지, 워커가 파일을 수정할 수 있는지.
+- **수정: 플러그인 매니페스트가 옛 버전을 표시** — `plugin.json` 과
+  `.claude-plugin/plugin.json` 이 0.10.1, 0.10.2 릴리스 후에도 `0.10.0` 으로
+  남아 있어 플러그인 설치 시 잘못된 버전이 표시되었습니다.
+- **수정: `routing.local.yaml.example` 이 퇴역 모델을 가리킴** — 시작 프로필의
+  `claude-opus-4-8` 을 모두 `claude-opus-5`(레인에 맞는 노력 수준 포함)로,
+  Gemini 3.5 Flash 후보를 3.6 Flash 로 바꿔 0.10.0 이후 기본값과 맞췄습니다.
+- **Intelligence Index 수치를 원본과 대조해 정정**
+  (`docs/model-capabilities-2026-07.md`): 퍼센트가 아니라 지수 점수입니다.
+  AA-Briefcase / GDPval-AA v2 비교를 추가하고, 기본값과 반대 방향인 두 결과도
+  기록했습니다: 사실 지식은 Fable 5 가, 표현 품질은 GPT-5.6 Sol 이 앞섭니다.
+
+## v0.10.2 새 기능
+
+- **`hardest-coding` 과 `hard-judgment` 의 Claude 노력 수준을 `max` 에서 `xhigh`
+  로 변경**. Claude Opus 5 에 대한 Anthropic 의 문서화된 지침에 맞췄습니다:
+  코딩과 에이전트 작업은 `xhigh` 에서 시작, 그 외 지능이 필요한 작업의 하한은
+  `high`, `max` 는 정확성이 비용보다 중요한 경우에 한합니다. 되돌리려면
+  `omnilane configure set <lane> "<spec>"` 을 쓰세요.
+- **깨진 CHANGELOG 비교 링크 2건 수정** — 공개된 적 없는 `v0.10.0` 태그를
+  가리키고 있었습니다.
+
+## v0.10.1 새 기능
+
+- **기본 라우팅에 `claude-opus-5` 추가**. `hard-judgment` 와 `taste-final` 의
+  첫 번째 선택이며, 가장 어려운 코딩 작업의 대체 경로로도 사용됩니다.
+- **`omnilane configure` 를 13개 전체 제공자로 확장**. 선택 가능한 모델은
+  106개이며 Codex, Claude Code, Grok Build, Antigravity 의 최신 카탈로그와
+  검증된 OpenRouter／OpenCode 바로가기를 포함합니다. `c` 를 통한 사용자 지정
+  모델 ID 입력도 계속 지원합니다.
+
 <details>
-<summary>이전 릴리스(v0.8.3 이하)</summary>
+<summary>이전 릴리스(v0.10.0 이하)</summary>
+
+## v0.10.0 새 기능
+
+- **Gemini 3.6 Flash 기본 라우팅** — `fast-agentic`, `triage`,
+  `bulk-mechanical` 의 gemini 후보(그리고 `Gemini Flash` 별칭)를 Gemini 3.6
+  Flash 로 변경: 출력 토큰 감소, 출력 단가 인하, Artificial Analysis 측정 출력
+  속도 1위.
+- **근거 재감사** — 라우팅 주석, 모델 능력 노트, Gemini 가격표를 공식 소스에
+  맞춰 갱신.
+
+## v0.9.1 새 기능
+
+- **수정**: `configure set` 이 더 이상 `routing.local.yaml` 의 수기 주석을
+  삭제하지 않습니다. 자체 스탬프 줄과 교체 대상 레인만 다시 씁니다.
+
+## v0.9.0 새 기능
+
+- **OpenAI 호환 direct-API 벤더 5개 추가** — `deepseek`, `zai` (GLM), `mistral`,
+  `groq`, `cerebras` 가 `openrouter` 처럼 CLI 없는 레인으로 추가(curl 과
+  `<VENDOR>_API_KEY` 만 필요). `lib/common.sh` 레지스트리에 한 줄로 추가되며,
+  모델 능력 비교는 [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md) 참고.
+- **Fish 셸 자동완성** — `omnilane completion fish | source`.
 
 ## v0.8.3 새 기능
 

package/README.md

@@ -21,49 +21,30 @@ or any hosted model via OpenRouter — on the subscriptions you already pay for,
 
 ---
 
-## 2026-07-25 update
+## 🤔 What is omnilane?
 
-- Added `claude-opus-5` to default routing: first choice for `hard-judgment` and `taste-final`, plus a fallback for the hardest coding work.
-- Expanded `omnilane configure` across all 13 providers: 106 selectable model entries, complete live catalogs for Codex, Claude Code, Grok Build, and Antigravity, plus verified OpenRouter/OpenCode shortcuts. Custom model IDs remain available through `c`.
+**The problem.** You already drive an AI coding assistant — Claude Code, Codex,
+Cursor, Gemini CLI. Each one talks to a single model family. So every task you
+give it runs on that one model, whether or not it is the right tool: a
+throwaway file rename burns your most expensive model, and a genuinely hard
+architecture question runs on whatever you happened to open.
 
----
-## 👋 New here?
-
-You already drive an AI coding assistant — **Claude Code, Codex, Cursor, Gemini
-CLI**, and the like. Each one talks to a single AI model, and picking the best
-model for each task is left to you.
+**What omnilane does.** It gives your assistant a routing table. Work gets
+sorted into **lanes** — hardest coding, bulk mechanical, triage, hard judgment,
+final polish — and each lane names the model that is best (and cheapest) for
+it. Your assistant keeps the lanes it is already good at and hands the rest to
+another vendor's CLI in the background, using the logins you already have.
 
-**omnilane picks for you.** For every piece of work it routes the task to the
-model that is best (and cheapest) for it — tough coding to a top coder, quick
-checks to a fast cheap model, long documents to a big-context model — all on the
-subscriptions and API keys you already pay for. Use the built-in defaults, or
-tweak one small file. Nothing new to babysit (it runs behind your existing tool),
-and `./install.sh --uninstall` removes it cleanly.
+**What it is not.** Not a proxy, not a new subscription, not another service to
+keep alive. It is a table plus a dispatch script that runs behind the tool you
+already use. `./install.sh --uninstall` removes every trace.
 
-**[⬇ Jump to the 60-second start](#-60-second-start)**
-
-## What's new in v0.10.0
+**You do not need every vendor.** Each lane is a fallback chain. Install one
+CLI or seven — dispatch picks the first candidate you actually have, and a lane
+with nothing available simply turns off. The default table works on a single
+subscription.
 
-- **Gemini 3.6 Flash defaults** — the gemini candidates in `fast-agentic`,
-  `triage`, and `bulk-mechanical` (and the `Gemini Flash` alias) now run
-  Gemini 3.6 Flash (released 2026-07-21): fewer output tokens, a lower output
-  price, and the fastest output speed measured by Artificial Analysis.
-- **Evidence re-audit** — routing comments, model capability notes, and the
-  Gemini price table refreshed against official sources (2026-07-21/22).
-
-## What's new in v0.9.1
-
-- **Fix:** `configure set` no longer deletes hand-written comments from
-  `routing.local.yaml` — it rewrites only its own stamp header and the lane
-  being replaced.
-
-## What's new in v0.9.0
-
-- **Five OpenAI-compatible direct-API vendors** — `deepseek`, `zai` (GLM),
-  `mistral`, `groq`, and `cerebras` join `openrouter` as CLI-free lanes (curl +
-  a `<VENDOR>_API_KEY`). A one-line `lib/common.sh` registry entry adds each;
-  see [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md).
-- **Fish shell completion** — `omnilane completion fish | source`.
+**[⬇ Jump to the 60-second start](#-60-second-start)** · **[❓ Read the FAQ](#-faq)**
 
 ## ⚡ 60-second start
 
@@ -127,14 +108,17 @@ flowchart LR
 
 </div>
 
-## 🛤️ Lanes (defaults — run `scripts/dispatch.sh --list` for your effective table)
+## 🛤️ Lanes
+
+Defaults below — run `scripts/dispatch.sh --list` for the table your machine
+actually resolves.
 
 | Lane | First choice | Backup | When |
 |---|---|---|---|
-| 🔥 hardest-coding | GPT-5.6 Sol (max) | Claude Opus 5 (max) | Hardest implementation, deep root-cause debug, correctness-critical edits |
+| 🔥 hardest-coding | GPT-5.6 Sol (max) | Claude Opus 5 (xhigh) | Hardest implementation, deep root-cause debug, correctness-critical edits |
 | 🏗️ bulk-mechanical | GPT-5.6 Terra (max) | Claude Sonnet 5 (high) | Refactors, migrations, tests, review sweeps — mechanical endurance |
 | 🧹 triage | GPT-5.6 Luna (medium) | Gemini 3.6 Flash (Low) | High-volume scans, first-pass filtering |
-| ⚖️ hard-judgment | Claude Opus 5 (max) | GPT-5.6 Sol (max) | Architecture arbitration, deep reasoning, second opinions |
+| ⚖️ hard-judgment | Claude Opus 5 (xhigh) | GPT-5.6 Sol (max) | Architecture arbitration, deep reasoning, second opinions |
 | ✒️ taste-final | Claude Opus 5 (high) | GPT-5.6 Sol (max) | User-facing prose, prompt/doc polish, style arbitration |
 | 💬 consult | Explicit named vendor/model | — (no fallback) | Direct natural-language consultation; always keep `--vendor` |
 | 🎨 ui-draft | GPT-5.6 Sol (xhigh) | Claude Opus 5 (high) | UI drafts only WITH a design system / reference images |
@@ -148,14 +132,6 @@ The **backup** is the next candidate in the lane's `routing.yaml` chain — what
 dispatch falls back to when the first-choice vendor CLI is not installed. Every
 lane is such a chain; when nothing in it is installed the lane degrades to `off`.
 
-> **Where is Claude Fable 5?** Deliberately not in the defaults: the top
-> Claude tier is usually the *main loop itself*, not a dispatched worker, and
-> it prices above Opus. This is a cost / guardrail / main-loop policy choice,
-> not a capability verdict; Anthropic positions Fable 5 above Opus 5. It is
-> offered in the configurator's model menu —
-> route to it if you disagree (e.g. `taste-final: claude claude-fable-5 high`
-> in `routing.local.yaml`).
-
 ### Natural-language consultation
 
 With the `omnilane` skill or `/route`, you can ask normally:
@@ -238,13 +214,15 @@ optional per-CLI **routing reminder**: a marked, reversible block appended to
 each CLI's instruction file (`~/.claude/CLAUDE.md`, `~/.codex/AGENTS.md`,
 `~/.grok/Agents.md`, `~/.gemini/GEMINI.md` — paths may vary across CLI
 versions) so the main loop remembers to consult the table; non-interactive
-installs can pass `OMNILANE_HOOKS=all|none|claude,codex`. Manual wiring:
+installs can pass `OMNILANE_HOOKS=all|none|claude,codex`.
 
 Use `./install.sh --check` for a read-only drift report. Add `--dry-run` to an
 install or `--uninstall` to preview every checkout-owned file action.
 Rollback the installer-owned links and marked reminders with
 `./install.sh --uninstall`.
 
+Manual wiring:
+
 - **Claude Code**: install as a plugin (ships the skill + `/route`,
   `/route-jobs` commands, and a `SessionStart` hook that auto-injects the
   routing reminder at session open — no CLAUDE.md edit needed), or drop
@@ -394,7 +372,7 @@ code passes through.
   non-Git work running through the existing per-call watchdog path, which emits
   its own warning if no watchdog tool exists.
   Expiry cleans the supervised process group and returns 124. For a deep audit
-  of a fubon-autotrade-sized repository, start around 2–4 hours (7200–14400s)
+  of a large repository, start around 2–4 hours (7200–14400s)
   with a 30-minute per-call watchdog; these are recommendations, not defaults.
 - **Background lifecycle** — `--background` workers run in their own process
   group and survive the caller's exit; killed workers record an exit code, and
@@ -402,12 +380,144 @@ code passes through.
 - **Payload caps** — oversized task text is truncated head+tail before it can
   blow a worker's context.
 
+## ❓ FAQ
+
+<details>
+<summary><b>Do I need all of these subscriptions?</b></summary>
+
+<br/>
+
+No. Every lane is a fallback chain, and dispatch picks the first candidate
+whose CLI is actually installed. With one subscription the whole table collapses
+onto that vendor; lanes with nothing available turn off rather than failing.
+`omnilane doctor` shows exactly what your machine can reach today, and
+`routing.local.yaml.example` ships starter profiles for common situations
+(Claude-only, Codex-heavy, no-Codex).
+
+</details>
+
+<details>
+<summary><b>Does omnilane send my code somewhere new?</b></summary>
+
+<br/>
+
+No new destination. Dispatch shells out to vendor CLIs you already installed
+and logged into, so your code reaches exactly the vendors you already use.
+Runners strip API-key environment variables before invoking a subscription CLI,
+so a stray key cannot silently switch you onto pay-per-token billing. The one
+exception is the direct-API vendor family (`openrouter`, `deepseek`, `zai`,
+`mistral`, `groq`, `cerebras`), which by definition calls that provider's API
+with the key you set — those are advise-only and never edit files.
+
+</details>
+
+<details>
+<summary><b>Where is Claude Fable 5? Why is it not in the default table?</b></summary>
+
+<br/>
+
+**Because the top Claude tier is usually the main loop itself, not a dispatched
+worker.** Lanes exist to send work to a model *other than* the one you are
+driving. If Fable 5 is your main loop, routing judgment and taste back to Fable 5
+just adds a second call for no gain — which is why the "pick your main model"
+list above gives Fable 5 its own row as a **driver**, self-executing
+hard-judgment, taste-final, and the hardest correctness-critical fixes.
+
+**The measurements do not argue for it as a worker either.** On the Artificial
+Analysis Intelligence Index (2026-07-24) Opus 5 (max) scores 61 and Fable 5 (max)
+scores 60 — Artificial Analysis calls them "effectively tied", and Epoch AI's
+Capability Index ranks them the other way (Fable 5 161, Opus 5 159). Call it a
+draw on general intelligence. Where they are not tied is agentic professional
+output, and Opus 5 leads by a wide margin:
+
+| Benchmark | Claude Opus 5 (max) | Claude Fable 5 | |
+|---|---:|---:|---|
+| AA-Briefcase (agentic knowledge work, Elo) | 1720 | 1574 | **+146** |
+| GDPval-AA v2 (Elo) | 1861 | 1747 | **+114** |
+| Cost per AA-Briefcase task | $17.79 | $22.30 | **-20%** |
+| API price, input / output per 1M | $5 / $25 | $10 / $50 | **half** |
+
+Opus 5's max, xhigh and high tiers sweep the top three AA-Briefcase places, and
+its `high` tier still beats Fable 5 at under half the cost per task. So Fable 5
+costs twice as much without buying an advantage on any axis a lane is defined
+around.
+
+**What Fable 5 is genuinely better at**: factual breadth. It stays ahead of
+Opus 5 on AA-Omniscience, as its size class suggests, and Opus 5 answers more
+readily when uncertain — its hallucination rate is 50%, up 14 points from
+Opus 4.8. If your task is recall-heavy rather than execution-heavy, name
+Fable 5 explicitly:
+
+```bash
+dispatch.sh --vendor claude --model claude-fable-5 --effort high consult "…"
+```
+
+**This is a cost / main-loop policy choice, not a capability verdict.** Fable 5
+is in the configurator's model menu, and one line in `routing.local.yaml`
+overrides the default if you disagree:
+
+```yaml
+taste-final: claude claude-fable-5 high
+```
+
+</details>
+
+<details>
+<summary><b>Why do the Claude lanes use <code>xhigh</code> instead of <code>max</code>?</b></summary>
+
+<br/>
+
+Because more effort is not monotonically better. Anthropic documents `xhigh` as
+the starting point for coding and agentic work, `high` as the floor for other
+intelligence-sensitive work, and `max` as the setting for cases where
+correctness outweighs cost. Independent testing agrees: on Vals.ai's Vibe Code
+Bench, Opus 5 scores 89.8% at `high` but only 88.3% at `xhigh` and 88.4% at
+`max` — the top tiers produce more elaborate solutions that fail more often.
+Raise any lane locally if your workload disagrees:
+
+```bash
+omnilane configure set hard-judgment "claude claude-opus-5 max"
+```
+
+</details>
+
+<details>
+<summary><b>What happens when a lane's first-choice CLI is missing?</b></summary>
+
+<br/>
+
+Dispatch walks the chain and uses the first vendor you have. Inspect the
+decision without spending a call:
+
+```bash
+scripts/dispatch.sh --explain hardest-coding   # candidate-by-candidate trace
+scripts/dispatch.sh --list                     # whole effective table
+scripts/dispatch.sh --dry-run hardest-coding "…"   # fully resolved plan, no provider call
+```
+
+</details>
+
+<details>
+<summary><b>Can a dispatched worker edit my files?</b></summary>
+
+<br/>
+
+Only if you ask for it. Dispatch defaults to `advise`, a read-only mode enforced
+per vendor (read-only sandbox, plan mode, or read-only tool set depending on the
+CLI). Editing requires both `--mode work` and an explicit `--workdir`. Workers
+also cannot dispatch again — the depth guard refuses nested fan-out with exit 86,
+so one command can never spiral into a chain of agents spending your quota.
+
+</details>
+
 ## 📊 Defaults and provenance
 
 Default lane assignments follow Artificial Analysis coding/intelligence data
 (2026-07 snapshot, cross-checked against AA site records and vendor pricing
 pages) plus published head-to-head reviews; they are opinions, not laws — the
-configurator and `routing.local.yaml` exist so you can disagree.
+configurator and `routing.local.yaml` exist so you can disagree. The full
+working notes, including per-benchmark caveats, live in
+[`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md).
 
 ## ⚠️ Known limitations
 
@@ -423,8 +533,71 @@ configurator and `routing.local.yaml` exist so you can disagree.
 
 ## 📜 Release history
 
+## What's new in v0.10.3
+
+- **Restructured READMEs in all five languages** — the reader now meets a plain
+  "what is this and why would I want it" section first, version history is
+  consolidated at the bottom instead of interrupting the introduction, and a new
+  FAQ answers the questions that kept coming up: do I need every subscription,
+  where does my code go, why is Fable 5 not in the table, why `xhigh` and not
+  `max`, what happens when a CLI is missing, can a worker edit files.
+- **Fixed: plugin manifests advertised a stale version** — `plugin.json` and
+  `.claude-plugin/plugin.json` still reported `0.10.0` after the 0.10.1 and
+  0.10.2 releases, so plugin installs showed the wrong version.
+- **Fixed: `routing.local.yaml.example` shipped retired models** — the starter
+  profiles still pointed at `claude-opus-4-8` and Gemini 3.5 Flash; they now use
+  Claude Opus 5 (with lane-appropriate effort) and Gemini 3.6 Flash.
+- **Corrected the Intelligence Index figures** in
+  `docs/model-capabilities-2026-07.md` against the Artificial Analysis source
+  (index points, not percentages), added the AA-Briefcase / GDPval-AA v2
+  comparison, and recorded the two results that cut against the defaults:
+  Fable 5's lead on factual knowledge and Sol's lead on presentation quality.
+
+## What's new in v0.10.2
+
+- **Claude effort on `hardest-coding` and `hard-judgment` moved from `max` to
+  `xhigh`**, matching Anthropic's documented guidance for Claude Opus 5: start
+  at `xhigh` for coding and agentic work, keep `high` as the floor for other
+  intelligence-sensitive work, and reserve `max` for cases where correctness
+  outweighs cost. Raise it back per lane with
+  `omnilane configure set <lane> "<spec>"`.
+- **Fixed two dead CHANGELOG compare links** that pointed at a `v0.10.0` tag
+  which was never published.
+
+## What's new in v0.10.1
+
+- **`claude-opus-5` joins the default table** as first choice for
+  `hard-judgment` and `taste-final`, plus a fallback for the hardest coding work.
+- **`omnilane configure` covers all 13 providers** with 106 selectable model
+  entries — current native catalogs for Codex, Claude Code, Grok Build and
+  Antigravity, plus verified OpenRouter/OpenCode shortcuts. Custom model IDs
+  remain available through `c`.
+
 <details>
-<summary>Older releases (v0.8.3 and earlier)</summary>
+<summary>Older releases (v0.10.0 and earlier)</summary>
+
+## What's new in v0.10.0
+
+- **Gemini 3.6 Flash defaults** — the gemini candidates in `fast-agentic`,
+  `triage`, and `bulk-mechanical` (and the `Gemini Flash` alias) now run
+  Gemini 3.6 Flash: fewer output tokens, a lower output price, and the fastest
+  output speed measured by Artificial Analysis.
+- **Evidence re-audit** — routing comments, model capability notes, and the
+  Gemini price table refreshed against official sources.
+
+## What's new in v0.9.1
+
+- **Fix:** `configure set` no longer deletes hand-written comments from
+  `routing.local.yaml` — it rewrites only its own stamp header and the lane
+  being replaced.
+
+## What's new in v0.9.0
+
+- **Five OpenAI-compatible direct-API vendors** — `deepseek`, `zai` (GLM),
+  `mistral`, `groq`, and `cerebras` join `openrouter` as CLI-free lanes (curl +
+  a `<VENDOR>_API_KEY`). A one-line `lib/common.sh` registry entry adds each;
+  see [`docs/model-capabilities-2026-07.md`](docs/model-capabilities-2026-07.md).
+- **Fish shell completion** — `omnilane completion fish | source`.
 
 ## What's new in v0.8.3