Merge pull request #727 from umi008/fix/audit-doc-fixes

docs: fix broken links, stale references, and translation drift

AGENTS.md

@@ -74,7 +74,7 @@ oh-my-opencode-slim/
 │   ├── multiplexer/  # Tmux/Zellij pane integration for child sessions
 │   ├── skills/       # Skill definitions (included in package publish)
 │   ├── tools/        # Tool definitions (council, webfetch, AST-grep, etc.)
-│   └── utils/        # Shared utilities (tmux, session helpers)
+│   └── utils/        # Shared utilities (session, task, logger, env, etc.)
 ├── dist/             # Built JavaScript and declarations
 ├── docs/             # User-facing documentation
 ├── biome.json        # Biome configuration
@@ -130,7 +130,7 @@ Session Deleted Externally:
 
 ### Key Implementation Details
 
-**1. Graceful Shutdown (src/utils/tmux.ts)**
+**1. Graceful Shutdown (src/multiplexer/tmux/index.ts)**
 ```typescript
 // Always send Ctrl+C before killing pane
 spawn([tmux, "send-keys", "-t", paneId, "C-c"])
@@ -252,8 +252,8 @@ OpenCode has a built-in `/review` command that automatically performs comprehens
 - Skills are located in `src/skills/` (included in package publish)
 - Multiplexer session management is in `src/multiplexer/`
 - Council manager (multi-LLM orchestration) is in `src/council/`
-- Tmux utilities are in `src/utils/tmux.ts`
-- 468 tests across 35 files - run `bun test` to verify
+- Tmux utilities are in `src/multiplexer/tmux/`
+- 1426 tests across 83 files - run `bun test` to verify
 
 ## Repository Map
 

README.ja-JP.md

@@ -40,20 +40,6 @@ oh-my-opencode-slim は OpenCode 向けのエージェントオーケストレ
 
 デフォルトの [OpenAI プリセット](docs/openai-preset.md) は、Terra を Orchestrator、Sol を Oracle、Luna を高速な専門レーンに割り当てます。
 
-### LazySkills でエージェントスキルを管理
-
-<p align="center">
-  <a href="https://github.com/alvinunreal/lazyskills">
-    <img src="img/lazyskills-wide.svg" alt="LazySkills" width="720">
-  </a>
-</p>
-
-**[LazySkills](https://github.com/alvinunreal/lazyskills)** は、エージェントスキルを管理するためのターミナル UI です。インストール済みのスキル、各スキルを使用できるエージェント、可視性が壊れている理由、次に安全に実行できる操作を 1 か所で確認できます。
-
-<p align="center">
-  <a href="https://github.com/alvinunreal/lazyskills"><b>LazySkills を見る →</b></a>
-</p>
-
 ### ユーザーの声
 
 > “タスク管理は 5/10 から簡単に 8〜9/10 まで上がりました。

README.ko-KR.md

@@ -40,20 +40,6 @@ oh-my-opencode-slim은 OpenCode용 에이전트 오케스트레이션 플러그
 
 기본 [OpenAI 프리셋](docs/openai-preset.md)은 Terra를 Orchestrator에, Sol을 Oracle에, Luna를 빠른 전문 레인에 매핑합니다.
 
-### LazySkills로 에이전트 스킬 관리하기
-
-<p align="center">
-  <a href="https://github.com/alvinunreal/lazyskills">
-    <img src="img/lazyskills-wide.svg" alt="LazySkills" width="720">
-  </a>
-</p>
-
-**[LazySkills](https://github.com/alvinunreal/lazyskills)** 는 에이전트 스킬을 관리하기 위한 터미널 UI입니다. 설치된 스킬, 각 스킬을 사용할 수 있는 에이전트, 가시성이 깨질 수 있는 이유, 다음에 안전하게 실행할 수 있는 작업을 한곳에서 확인할 수 있습니다.
-
-<p align="center">
-  <a href="https://github.com/alvinunreal/lazyskills"><b>LazySkills 살펴보기 →</b></a>
-</p>
-
 ### 사용자들의 말
 
 > “작업 관리가 쉽게 5/10에서 8-9/10으로 올라갔습니다.

README.zh-CN.md

@@ -40,20 +40,6 @@ oh-my-opencode-slim 是一个用于 OpenCode 的智能体编排插件。它内
 
 默认的 [OpenAI 预设](docs/openai-preset.md) 将 Terra 映射为 Orchestrator、Sol 映射为 Oracle、Luna 映射为快速专家通道。
 
-### 用 LazySkills 管理智能体技能
-
-<p align="center">
-  <a href="https://github.com/alvinunreal/lazyskills">
-    <img src="img/lazyskills-wide.svg" alt="LazySkills" width="720">
-  </a>
-</p>
-
-**[LazySkills](https://github.com/alvinunreal/lazyskills)** 是一个用于管理智能体技能的终端 UI。它让你可以在一个地方查看已安装的技能、哪些智能体可以使用每个技能、为什么可见性可能失效，以及接下来可以安全执行哪些操作。
-
-<p align="center">
-  <a href="https://github.com/alvinunreal/lazyskills"><b>探索 LazySkills →</b></a>
-</p>
-
 ### 用户怎么说
 
 > “任务管理轻松从 5/10 提升到了 8-9/10。Orchestrator 会派出

docs/configuration.md

@@ -141,7 +141,7 @@ Presets can also be switched at runtime without restarting using the `/preset` c
 | `tmux.enabled` | boolean | `false` | Legacy alias for `multiplexer.type = "tmux"` |
 | `tmux.layout` | string | `"main-vertical"` | Legacy alias for `multiplexer.layout` |
 | `tmux.main_pane_size` | number | `60` | Legacy alias for `multiplexer.main_pane_size` |
-| `backgroundJobs.maxSessionsPerAgent` | integer | `2` | Maximum completed/reconciled reusable child sessions per specialist type in the current orchestrator session (1–10). See [Session Management](session-management.md) |
+| `backgroundJobs.maxSessionsPerAgent` | integer | `2` | Maximum completed/reconciled reusable child sessions per specialist type in the current orchestrator session (1–10) |
 | `backgroundJobs.readContextMinLines` | integer | `10` | Minimum number of lines read from a file before it appears in reusable background-job context (0–1000) |
 | `backgroundJobs.readContextMaxFiles` | integer | `8` | Maximum number of recent read-context files shown per reusable child session (0–50) |
 | `disabled_mcps` | string[] | `[]` | MCP server IDs to disable globally |
@@ -255,7 +255,7 @@ major is available, the plugin shows a migration command instead.
 Background job management is enabled by default and does not need to be present
 in the starter config. Add `backgroundJobs` only if you want to tune how many
 completed/reconciled child-agent sessions are reusable or how much read context is shown. See
-[Session Management](session-management.md) for the concept, defaults, and
+the [Background Orchestration](background-orchestration.md) guide for the concept, defaults, and
 examples.
 
 ### Agent Display Names

docs/quick-reference.md

@@ -13,7 +13,7 @@
 | Doc | Contents |
 |-----|----------|
 | [Council Agent](council.md) | Multi-LLM consensus, presets, role prompts, timeouts |
-| [Background Orchestration](v2-background-orchestration.md) | Default scheduler-first orchestrator model for native background subagents |
+| [Background Orchestration](background-orchestration.md) | Default scheduler-first orchestrator model for native background subagents |
 | [Interview](interview.md) | `/interview` command, browser UI, dashboard mode, multi-session coordination |
 | [Multiplexer Integration](multiplexer-integration.md) | Real-time pane monitoring, layouts, troubleshooting |
 | [Preset Switching](preset-switching.md) | `/preset` command for runtime agent model switching |

docs/tools.md

@@ -45,8 +45,9 @@ the current orchestrator session, and it does not roll back partial edits. After
 cancelling a write-capable task, inspect and reconcile file changes before
 launching replacement work.
 
-See [Background Job Board Lessons](background-job-board-lessons.md) for the
-session lifecycle and cancellation edge cases behind this tool.
+See the background orchestration concepts in
+[Background Orchestration](background-orchestration.md) for the session
+lifecycle and cancellation edge cases behind this tool.
 
 ---