oh-my-opencode-slim 2.0.0 → 2.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/README.ja-JP.md +69 -20
  2. package/README.ko-KR.md +66 -19
  3. package/README.md +72 -19
  4. package/README.zh-CN.md +78 -31
  5. package/dist/agents/orchestrator.d.ts +0 -2
  6. package/dist/cli/index.js +50 -37
  7. package/dist/config/agent-mcps.d.ts +0 -4
  8. package/dist/config/constants.d.ts +1 -7
  9. package/dist/config/council-schema.d.ts +0 -15
  10. package/dist/config/runtime-preset.d.ts +0 -1
  11. package/dist/config/schema.d.ts +2 -68
  12. package/dist/hooks/auto-update-checker/skill-sync.d.ts +9 -0
  13. package/dist/hooks/filter-available-skills/index.d.ts +1 -13
  14. package/dist/hooks/foreground-fallback/index.d.ts +1 -1
  15. package/dist/hooks/image-hook.d.ts +1 -13
  16. package/dist/hooks/index.d.ts +3 -2
  17. package/dist/hooks/phase-reminder/index.d.ts +10 -16
  18. package/dist/hooks/reflect/index.d.ts +13 -0
  19. package/dist/hooks/task-session-manager/index.d.ts +2 -16
  20. package/dist/hooks/types.d.ts +23 -0
  21. package/dist/index.js +391 -289
  22. package/dist/tui.js +16 -25
  23. package/dist/utils/agent-variant.d.ts +0 -40
  24. package/dist/utils/compat.d.ts +0 -1
  25. package/dist/utils/guards.d.ts +4 -0
  26. package/dist/utils/index.d.ts +1 -2
  27. package/dist/utils/logger.d.ts +1 -1
  28. package/dist/utils/task.d.ts +0 -2
  29. package/oh-my-opencode-slim.schema.json +2 -249
  30. package/package.json +1 -1
  31. package/src/skills/codemap.md +4 -1
  32. package/src/skills/reflect/SKILL.md +193 -0
  33. package/src/skills/worktrees/SKILL.md +164 -0
  34. package/dist/config/fallback-chains.d.ts +0 -1
  35. package/dist/hooks/apply-patch/patch.d.ts +0 -2
  36. package/dist/hooks/delegate-task-retry/guidance.d.ts +0 -2
  37. package/dist/hooks/delegate-task-retry/index.d.ts +0 -4
  38. package/dist/hooks/json-error-recovery/index.d.ts +0 -1
  39. package/dist/utils/env.d.ts +0 -1
package/README.ja-JP.md CHANGED
@@ -32,6 +32,32 @@ oh-my-opencode-slim は OpenCode 向けのエージェントオーケストレ
32
32
 
33
33
  各エージェントについて知りたい場合は **[Meet the Pantheon](#meet-the-pantheon)** を参照してください。機能の全体像は下記の **[Features & Workflows](#features-and-workflows)** をご覧ください。
34
34
 
35
+ ### ユーザーの声
36
+
37
+ > “タスク管理は 5/10 から簡単に 8〜9/10 まで上がりました。
38
+ > Orchestrator が Fixer や Explorer を送り出してくれて、
39
+ > それでも同じセッションで Orchestrator と会話しながら計画できます。
40
+ > 体験がずっとスムーズになりました。”
41
+ >
42
+ > \- `vipor_idk`
43
+
44
+ > “この beta 版の omo-slim のために、自分の harness は全部捨てました。
45
+ > 振り返ることも、何かを恋しく思うこともありません。素晴らしい仕事で、
46
+ > 個人的にはすべて正しい方向に進んでいると思います。”
47
+ >
48
+ > \- `stephanschielke`
49
+
50
+ > “omo-slim が大好きで、これなしで opencode を動かすことは想像できません。
51
+ > いろいろなモデルの Frankenstein を作れるところが気に入っています……
52
+ > セットアップ全体が本当に強力になります。”
53
+ >
54
+ > \- `Capital-One3039`
55
+
56
+ > “私のワークフローは大きく改善されました……今はとてもスムーズに動いていて、
57
+ > とても気に入っています。”
58
+ >
59
+ > \- `xenstar1`
60
+
35
61
  ### クイックスタート
36
62
 
37
63
  以下のプロンプトを LLM エージェント(Claude Code、AmpCode、Cursor など)にコピー&ペーストしてください:
@@ -50,7 +76,9 @@ bunx oh-my-opencode-slim@latest install
50
76
 
51
77
  ### はじめに
52
78
 
53
- インストーラーは OpenAI と OpenCode Go の両方のプリセットを生成し、デフォルトで OpenAI が有効になります。OpenAI はワークフローマネージャー/スケジューラーに `openai/gpt-5.5 (medium)`、Oracle に `openai/gpt-5.5 (high)`、Fixer に `openai/gpt-5.5 (low)`、その他の専門家には `openai/gpt-5.4-mini` 系のバリアントを使用します。インストール時に OpenCode Go を有効にするには `bunx oh-my-opencode-slim@latest install --preset=opencode-go` を実行するか、インストール後に `~/.config/opencode/oh-my-opencode-slim.json` のデフォルトプリセット名を変更してください。
79
+ インストーラーは OpenAI と OpenCode Go の両方のプリセットを生成し、デフォルトでは OpenAI が有効になります。
80
+
81
+ インストール時に OpenCode Go を有効にするには、`bunx oh-my-opencode-slim@latest install --preset=opencode-go` を実行するか、インストール後に `~/.config/opencode/oh-my-opencode-slim.json` のデフォルトプリセット名を変更してください。
54
82
 
55
83
  次に:
56
84
 
@@ -65,14 +93,15 @@ bunx oh-my-opencode-slim@latest install
65
93
  opencode models --refresh
66
94
  ```
67
95
  3. **プラグイン設定**を開きます: `~/.config/opencode/oh-my-opencode-slim.json`
68
- カスタム OpenCode 設定ディレクトリを使っている場合は
69
- `$OPENCODE_CONFIG_DIR/oh-my-opencode-slim.json`
70
96
 
71
97
  4. **各エージェントに使用したいモデルを更新します**
72
98
 
73
99
  > [!TIP]
74
100
  > バックグラウンドオーケストレーションの仕組みを理解しておくことを**推奨**します。**[Orchestrator のプロンプト](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/src/agents/orchestrator.ts#L28)** には、スケジューラーのルール、専門エージェントへのルーティングロジック、作業をバックグラウンドエージェントへ割り当てるしきい値が記述されています。`@agentName <task>` のようにサブエージェントを呼び出すことで、いつでも手動で委譲できます。
75
101
 
102
+ > [!TIP]
103
+ > バックグラウンドエージェントが現在のデフォルトワークフローになっているため、**[Multiplexer Integration](docs/multiplexer-integration.md)** を有効化して設定することを**強く推奨**します。各エージェントが専用の Tmux または Zellij ペインで自動的に開かれるため、Orchestrator がセッションを調整し続けている間も、専門エージェントの作業をリアルタイムで追えます。
104
+
76
105
  デフォルトで生成される設定には `openai` と `opencode-go` の両方のプリセットが含まれます。
77
106
 
78
107
  ```jsonc
@@ -105,11 +134,6 @@ bunx oh-my-opencode-slim@latest install
105
134
 
106
135
  カスタムプロバイダーや複数プロバイダーを組み合わせた構成を使用するには、完全なリファレンスとして **[Configuration](docs/configuration.md)** を参照してください。すぐに使える出発点が欲しい場合は **[Author's Preset](docs/authors-preset.md)** と **[$30 Preset](docs/thirty-dollars-preset.md)** をご覧ください。`$30` プリセットはコスト効率に最も優れたセットアップです。
107
136
 
108
- 設定ガイドでは `agents.<name>` を使用したカスタムサブエージェントについても説明しており、
109
- 通常の `prompt` に加えて委譲用の `orchestratorPrompt` ブロックも定義できます。
110
-
111
- モデルの推奨については、下記の各エージェントの **Recommended Models** をご覧ください。
112
-
113
137
  ### ✅ セットアップの確認
114
138
 
115
139
  インストールと認証を済ませた後、すべてのエージェントが設定済みで応答することを確認してください:
@@ -140,6 +164,8 @@ V2 は oh-my-opencode-slim を、スケジューラー中心のマルチエー
140
164
  - **[バックグラウンドエージェント](#バックグラウンドエージェント)** — Orchestrator は専門家をバックグラウンドタスクとしてディスパッチし、タスク/セッション ID を追跡し、完了イベントを待ってから結果を整合します。
141
165
  - **[Companion](#companion)** — 任意のフローティングデスクトップウィンドウが、並列実行中のバックグラウンド専門家を含め、現在アクティブなエージェントを表示します。
142
166
  - **[Deepwork](#deepwork)** — 大規模、多ファイル、高リスク、または段階的なコーディング作業向けの構造化ワークフローです。永続的な計画ファイルと Oracle レビューゲートを使用します。
167
+ - **[Reflect](#reflect)** — 繰り返される作業パターンを振り返り、再利用可能な skill、エージェント、コマンド、設定ルール、プロンプトルール、プロジェクト playbook を提案します。
168
+ - **[Worktrees](#worktrees)** — 複雑、高リスク、または並列タスク向けに、安全プロトコル付きの隔離されたコーディング lane として Git worktree を管理します。
143
169
  - **[oh-my-opencode-slim Skill](#oh-my-opencode-slim-skill)** — モデル、プロンプト、カスタムエージェント、MCP アクセス、プリセット、プラグイン動作を安全に調整するための同梱設定 skill です。
144
170
 
145
171
  #### バックグラウンドエージェント
@@ -177,6 +203,32 @@ Deepwork は、大規模リファクタリング、多段階機能、高リス
177
203
 
178
204
  いつ使うべきか、ワークフローがどのように動くかは **[Skills](docs/skills.md#deepwork)** を参照してください。
179
205
 
206
+ #### Reflect
207
+
208
+ Reflect は、Orchestrator が繰り返し発生するワークフロー上の摩擦から学ぶのを助けます。最近の作業と既存の資産を確認し、skill、カスタムエージェント、コマンド、設定ルール、プロンプトルール、MCP 権限変更、プロジェクト playbook の中から、最小で有用な改善を提案します。十分な証拠がない場合は、何も作成しないことを推奨します。
209
+
210
+ 直接実行できます。
211
+
212
+ ```text
213
+ /reflect
214
+ /reflect release workflow and checks
215
+ ```
216
+
217
+ 自然なプロンプトでも利用できます。
218
+
219
+ ```text
220
+ reflect on my recent workflows
221
+ find repeated work worth turning into reusable instructions
222
+ ```
223
+
224
+ 完全なワークフローとガードレールは **[Skills](docs/skills.md#reflect)** を参照してください。
225
+
226
+ #### Worktrees
227
+
228
+ Worktrees は、Git worktree を `.slim/worktrees/<slug>/` 配下の安全で隔離されたコーディング lane として管理します。Orchestrator が lane のライフサイクルを管理し、`.slim/worktrees.json` に状態を記録し、専門エージェントを lane 内で実行し、Git の状態を変更する前に明示的な確認を求めます。
229
+
230
+ 安全プロトコルは **[Skills](docs/skills.md#worktrees)** を参照してください。
231
+
180
232
  #### oh-my-opencode-slim Skill
181
233
 
182
234
  同梱の `oh-my-opencode-slim` skill は、Orchestrator がプラグイン自体を設定・改善するのを支援します。モデル調整、カスタムエージェント、プロンプト上書き、skill/MCP 権限、プリセット、任意エージェント、バックグラウンドオーケストレーション、繰り返し発生するワークフロー上の摩擦に利用できます。
@@ -533,13 +585,7 @@ Deepwork は、大規模リファクタリング、多段階機能、高リス
533
585
 
534
586
  ## 📚 ドキュメント
535
587
 
536
- このセクションをマップとしてご活用ください。インストールから始めて、必要に応じて機能、設定、プリセット例へとジャンプしてください。
537
-
538
- ### 🚀 ここから始める
539
-
540
- | Doc | 内容 |
541
- |-----|----------------|
542
- | **[Installation Guide](docs/installation.md)** | プラグインのインストール、CLI フラグの使用、設定のリセット、セットアップのトラブルシューティング |
588
+ このセクションは地図として使ってください。まずインストールから始め、必要に応じて機能、設定、またはプリセット例へ移動できます。
543
589
 
544
590
  <a id="features-and-workflows"></a>
545
591
 
@@ -548,21 +594,24 @@ Deepwork は、大規模リファクタリング、多段階機能、高リス
548
594
  | Doc | 内容 |
549
595
  |-----|----------------|
550
596
  | **[Council](docs/council.md)** | 複数のモデルを並列実行し、`@council` で 1 つの回答に統合します |
551
- | **[Multiplexer Integration](docs/multiplexer-integration.md)** | エージェントの動作を Tmux や Zellij のペインでライブ表示します |
552
- | **[Session Management](docs/session-management.md)** | 短いエイリアスで最近の子エージェントセッションを再利用し、最初からやり直さずに済みます |
553
- | **[Preset Switching](docs/preset-switching.md)** | `/preset` で実行時にエージェントモデルのプリセットを切り替えます |
554
597
  | **[Custom Agents](docs/configuration.md#custom-agents)** | カスタムプロンプト、モデル、MCP アクセス、Orchestrator の委譲ルールを備えた独自の専門エージェントを定義します |
598
+ | **[Multiplexer Integration](docs/multiplexer-integration.md)** | エージェントの動作を Tmux や Zellij のペインでライブ表示します |
555
599
  | **[Codemap](docs/codemap.md)** | 階層的なコードマップを生成し、大規模コードベースを迅速に理解します |
556
600
  | **[Clonedeps](docs/clonedeps.md)** | 選択した依存関係のソースを ignore 済みのローカルワークスペースにクローンし、調査できるようにします |
557
- | **[Interview](docs/interview.md)** | ブラウザベース의 Q&A フローで、ざっくりとしたアイデアを構造化された Markdown 仕様に変換します |
601
+ | **[Worktrees](docs/worktrees.md)** | `.slim/worktrees/` lane を使い、隔離された並列または高リスクなコーディング作業を行います |
602
+ | **[Preset Switching](docs/preset-switching.md)** | `/preset` で実行時にエージェントモデルのプリセットを切り替えます |
603
+ | **[Interview](docs/interview.md)** | ブラウザベースの Q&A フローで、ざっくりとしたアイデアを構造化された Markdown 仕様に変換します |
604
+ | **[Companion](docs/companion.md)** | 解析、ヘルプ、型情報のためのフローティングウィンドウ companion |
558
605
 
559
606
  ### ⚙️ 設定 & リファレンス
560
607
 
561
608
  | Doc | 内容 |
562
609
  |-----|----------------|
610
+ | **[Installation Guide](docs/installation.md)** | プラグインのインストール、CLI フラグの使用、設定のリセット、セットアップのトラブルシューティング |
563
611
  | **[Configuration](docs/configuration.md)** | 設定ファイルの配置場所、JSONC サポート、プロンプトの上書き、全オプションのリファレンス |
612
+ | **[Background Orchestration](docs/background-orchestration.md)** | ネイティブのバックグラウンドサブエージェントを中心にした、スケジューラー優先の Orchestrator モデル |
564
613
  | **[Maintainer Guide](docs/maintainers.md)** | Issue のトリアージルール、ラベルの意味、サポートの振り分け、リポジトリ運用ワークフロー |
565
- | **[Skills](docs/skills.md)** | `simplify`、`codemap`、`clonedeps` などの同梱スキル |
614
+ | **[Skills](docs/skills.md)** | `simplify`、`codemap`、`clonedeps`、`deepwork`、`reflect`、`worktrees`、`oh-my-opencode-slim` などの同梱スキル |
566
615
  | **[MCPs](docs/mcps.md)** | `websearch`、`context7`、`gh_grep`、およびエージェントごとの MCP 権限の仕組み |
567
616
  | **[Tools](docs/tools.md)** | `webfetch`、LSP ツール、コード検索、フォーマッターなどの組み込みツール機能 |
568
617
 
package/README.ko-KR.md CHANGED
@@ -32,6 +32,30 @@ oh-my-opencode-slim은 OpenCode용 에이전트 오케스트레이션 플러그
32
32
 
33
33
  에이전트 자체를 살펴보려면 **[판테온 만나보기](#meet-the-pantheon)** 를 참고하세요. 전체 기능 세트는 아래의 **[기능 & 워크플로우](#features-and-workflows)** 에서 확인할 수 있습니다.
34
34
 
35
+ ### 사용자들의 말
36
+
37
+ > “작업 관리가 쉽게 5/10에서 8-9/10으로 올라갔습니다.
38
+ > Orchestrator가 Fixer와 Explorer를 보내주고, 저는 여전히 같은 세션에서
39
+ > Orchestrator와 대화하고 계획할 수 있습니다. 이제 경험이 훨씬 더 매끄럽습니다.”
40
+ >
41
+ > \- `vipor_idk`
42
+
43
+ > “이 beta 버전의 omo-slim을 쓰면서 제가 쓰던 harness들을 전부 버렸고,
44
+ > 뒤돌아보거나 아쉬워하지 않습니다. 훌륭한 작업이고, 제 생각에는 모두 올바른 방향입니다.”
45
+ >
46
+ > \- `stephanschielke`
47
+
48
+ > “omo-slim을 정말 좋아하고, 이것 없이 opencode를 실행하는 건 상상할 수 없습니다.
49
+ > 여러 모델로 Frankenstein을 만들 수 있다는 점이 좋습니다……
50
+ > 설정 전체를 정말 강력한 괴물로 만들어줍니다.”
51
+ >
52
+ > \- `Capital-One3039`
53
+
54
+ > “제 워크플로우가 크게 개선되었습니다…… 지금은 매우 매끄럽게 작동하고 있고,
55
+ > 정말 마음에 듭니다.”
56
+ >
57
+ > \- `xenstar1`
58
+
35
59
  ### 빠른 시작
36
60
 
37
61
  이 프롬프트를 복사해서 LLM 에이전트(Claude Code, AmpCode, Cursor 등)에 붙여넣으세요:
@@ -50,7 +74,9 @@ bunx oh-my-opencode-slim@latest install
50
74
 
51
75
  ### 시작하기
52
76
 
53
- 인스톨러는 OpenAI와 OpenCode Go 프리셋을 모두 생성하며, 기본적으로 OpenAI가 활성화됩니다. OpenAI는 워크플로 매니저/스케줄러에 `openai/gpt-5.5 (medium)`, Oracle에 `openai/gpt-5.5 (high)`, Fixer에 `openai/gpt-5.5 (low)`, 그 외 전문가에는 `openai/gpt-5.4-mini` 변형을 사용합니다. 설치 중 OpenCode Go를 활성화하려면 `bunx oh-my-opencode-slim@latest install --preset=opencode-go`를 실행하거나, 설치 후 `~/.config/opencode/oh-my-opencode-slim.json`에서 기본 프리셋 이름을 변경하세요.
77
+ 인스톨러는 OpenAI와 OpenCode Go 프리셋을 모두 생성하며, 기본적으로 OpenAI가 활성화됩니다.
78
+
79
+ 설치 중 OpenCode Go를 활성화하려면 `bunx oh-my-opencode-slim@latest install --preset=opencode-go`를 실행하거나, 설치 후 `~/.config/opencode/oh-my-opencode-slim.json`에서 기본 프리셋 이름을 변경하세요.
54
80
 
55
81
  그 다음:
56
82
 
@@ -65,14 +91,15 @@ bunx oh-my-opencode-slim@latest install
65
91
  opencode models --refresh
66
92
  ```
67
93
  3. **플러그인 설정 파일**을 `~/.config/opencode/oh-my-opencode-slim.json`에서 엽니다.
68
- 사용자 지정 OpenCode 설정 디렉터리를 사용한다면
69
- `$OPENCODE_CONFIG_DIR/oh-my-opencode-slim.json`을 엽니다.
70
94
 
71
95
  4. **각 에이전트에 사용할 모델을 업데이트합니다**
72
96
 
73
97
  > [!TIP]
74
98
  > 자동 위임이 어떻게 동작하는지 이해하는 것을 **권장**합니다. **[Orchestrator 프롬프트](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/src/agents/orchestrator.ts#L28)** 에는 위임 규칙, 전문 에이전트 라우팅 로직, 메인 에이전트가 언제 서브에이전트로 작업을 넘겨야 하는지에 대한 임계값이 포함되어 있습니다. 수동으로 위임하려면 `@agentName <task>`로 서브에이전트를 호출하면 됩니다.
75
99
 
100
+ > [!TIP]
101
+ > 이제 백그라운드 에이전트가 기본 워크플로이므로 **[Multiplexer Integration](docs/multiplexer-integration.md)** 을 활성화하고 설정하는 것을 **강력히 권장**합니다. 각 에이전트를 전용 Tmux 또는 Zellij 창에서 자동으로 열어 주기 때문에, Orchestrator가 세션을 계속 조율하는 동안 전문 에이전트들의 작업을 실시간으로 따라볼 수 있습니다.
102
+
76
103
  기본 생성 설정에는 `openai`와 `opencode-go` 프리셋이 모두 포함되어 있습니다.
77
104
 
78
105
  ```jsonc
@@ -105,10 +132,6 @@ bunx oh-my-opencode-slim@latest install
105
132
 
106
133
  커스텀 프로바이더나 여러 프로바이더를 혼합해서 사용하려면, **[Configuration](docs/configuration.md)** 에서 전체 레퍼런스를 확인하세요. 바로 사용할 수 있는 시작점을 찾고 있다면 **[Author's Preset](docs/authors-preset.md)** 과 **[$30 Preset](docs/thirty-dollars-preset.md)** 을 확인해 보세요. `$30` 프리셋이 가장 가성비 좋은 설정입니다.
107
134
 
108
- 설정 가이드에서는 `agents.<name>`을 통한 커스텀 서브에이전트 정의도 다룹니다. 일반 `prompt`와 위임용 `orchestratorPrompt` 블록을 모두 정의할 수 있습니다.
109
-
110
- 모델 추천은 아래 각 에이전트에 나열된 **Recommended Models** 를 참고하세요.
111
-
112
135
  ### ✅ 설정 확인하기
113
136
 
114
137
  설치와 인증이 끝난 후, 모든 에이전트가 올바르게 설정되어 응답하는지 확인합니다:
@@ -139,6 +162,8 @@ V2는 oh-my-opencode-slim을 스케줄러 중심의 멀티 에이전트 워크
139
162
  - **[백그라운드 에이전트](#백그라운드-에이전트)** — Orchestrator가 전문가를 백그라운드 작업으로 디스패치하고, 작업/세션 ID를 추적하며, 완료 이벤트를 기다린 뒤 결과를 조정합니다.
140
163
  - **[Companion](#companion)** — 선택 사항인 플로팅 데스크톱 창이 병렬 백그라운드 전문가를 포함해 현재 활성 에이전트를 보여줍니다.
141
164
  - **[Deepwork](#deepwork)** — 대규모, 다중 파일, 위험도가 높거나 단계적인 코딩 작업을 위한 구조화된 워크플로입니다. 지속적인 계획 파일과 Oracle 리뷰 게이트를 사용합니다.
165
+ - **[Reflect](#reflect)** — 반복되는 작업 패턴을 돌아보고 재사용 가능한 skill, 에이전트, 명령, 설정 규칙, 프롬프트 규칙, 프로젝트 playbook을 제안합니다.
166
+ - **[Worktrees](#worktrees)** — 복잡하거나 위험하거나 병렬로 진행되는 작업을 위해 Git worktree를 안전 프로토콜이 있는 격리된 코딩 lane으로 관리합니다.
142
167
  - **[oh-my-opencode-slim Skill](#oh-my-opencode-slim-skill)** — 모델, 프롬프트, 커스텀 에이전트, MCP 접근, 프리셋, 플러그인 동작을 안전하게 조정하는 번들 설정 skill입니다.
143
168
 
144
169
  #### 백그라운드 에이전트
@@ -176,6 +201,32 @@ Deepwork는 대규모 리팩터링, 다단계 기능, 위험한 아키텍처 변
176
201
 
177
202
  사용 시점과 워크플로 동작 방식은 **[Skills](docs/skills.md#deepwork)** 를 참고하세요.
178
203
 
204
+ #### Reflect
205
+
206
+ Reflect는 Orchestrator가 반복되는 워크플로 마찰에서 배우도록 돕습니다. 최근 작업과 기존 자산을 검토한 뒤 skill, 커스텀 에이전트, 명령, 설정 규칙, 프롬프트 규칙, MCP 권한 변경, 프로젝트 playbook 중 가장 작고 유용한 개선안을 제안합니다. 근거가 부족하면 아무것도 만들지 않는 것을 권장해야 합니다.
207
+
208
+ 직접 실행할 수 있습니다.
209
+
210
+ ```text
211
+ /reflect
212
+ /reflect release workflow and checks
213
+ ```
214
+
215
+ 자연어 프롬프트로도 사용할 수 있습니다.
216
+
217
+ ```text
218
+ reflect on my recent workflows
219
+ find repeated work worth turning into reusable instructions
220
+ ```
221
+
222
+ 전체 워크플로와 가드레일은 **[Skills](docs/skills.md#reflect)** 를 참고하세요.
223
+
224
+ #### Worktrees
225
+
226
+ Worktrees는 Git worktree를 `.slim/worktrees/<slug>/` 아래의 안전하고 격리된 코딩 lane으로 관리합니다. Orchestrator가 lane의 생명주기를 관리하고, `.slim/worktrees.json`에 상태를 추적하며, 전문가 에이전트를 lane 안에서 실행하고, Git 상태를 변경하기 전에 명시적인 확인을 요구합니다.
227
+
228
+ 안전 프로토콜은 **[Skills](docs/skills.md#worktrees)** 를 참고하세요.
229
+
179
230
  #### oh-my-opencode-slim Skill
180
231
 
181
232
  번들된 `oh-my-opencode-slim` skill은 Orchestrator가 플러그인 자체를 설정하고 개선하도록 돕습니다. 모델 튜닝, 커스텀 에이전트, 프롬프트 오버라이드, skill/MCP 권한, 프리셋, 선택적 에이전트, 백그라운드 오케스트레이션, 반복되는 워크플로 마찰에 사용할 수 있습니다.
@@ -532,13 +583,7 @@ Deepwork는 대규모 리팩터링, 다단계 기능, 위험한 아키텍처 변
532
583
 
533
584
  ## 📚 문서
534
585
 
535
- 섹션을 지도로 활용하세요. 설치부터 시작한 뒤, 필요에 따라 기능, 설정, 예시 프리셋으로 이동하세요.
536
-
537
- ### 🚀 시작하기
538
-
539
- | 문서 | 내용 |
540
- |-----|------|
541
- | **[Installation Guide](docs/installation.md)** | 플러그인 설치, CLI 플래그 사용, 설정 초기화, 설치 문제 해결 |
586
+ 섹션은 지도로 활용하세요. 설치부터 시작한 뒤, 필요에 따라 기능, 설정 또는 예시 프리셋으로 이동하면 됩니다.
542
587
 
543
588
  <a id="features-and-workflows"></a>
544
589
 
@@ -547,22 +592,24 @@ Deepwork는 대규모 리팩터링, 다단계 기능, 위험한 아키텍처 변
547
592
  | 문서 | 내용 |
548
593
  |-----|------|
549
594
  | **[Council](docs/council.md)** | `@council`로 여러 모델을 병렬 실행하고 하나의 답변으로 종합 |
550
- | **[Background Orchestration](docs/v2-background-orchestration.md)** | OpenCode 네이티브 백그라운드 서브에이전트를 기반으로 한 스케줄러 우선 오케스트레이터 모델 |
551
- | **[Multiplexer Integration](docs/multiplexer-integration.md)** | Tmux 또는 Zellij 페인에서 에이전트 작업을 실시간으로 확인 |
552
- | **[Session Management](docs/session-management.md)** | 단축 별칭으로 최근 자식 에이전트 세션을 재사용하여 처음부터 다시 시작하지 않기 |
553
- | **[Preset Switching](docs/preset-switching.md)** | `/preset`으로 런타임에 에이전트 모델 프리셋 전환 |
554
595
  | **[Custom Agents](docs/configuration.md#custom-agents)** | 커스텀 프롬프트, 모델, MCP 접근, Orchestrator 위임 규칙으로 커스텀 전문 에이전트 정의 |
596
+ | **[Multiplexer Integration](docs/multiplexer-integration.md)** | Tmux 또는 Zellij 페인에서 에이전트 작업을 실시간으로 확인 |
555
597
  | **[Codemap](docs/codemap.md)** | 계층형 코드맵을 생성하여 대규모 코드베이스를 빠르게 파악 |
556
598
  | **[Clonedeps](docs/clonedeps.md)** | 선택한 의존성 소스를 무시된 로컬 워크스페이스에 복제하여 검사 |
599
+ | **[Worktrees](docs/worktrees.md)** | `.slim/worktrees/` lane을 사용해 격리된 병렬 또는 고위험 코딩 작업 수행 |
600
+ | **[Preset Switching](docs/preset-switching.md)** | `/preset`으로 런타임에 에이전트 모델 프리셋 전환 |
557
601
  | **[Interview](docs/interview.md)** | 브라우저 기반 Q&A 흐름을 통해 거친 아이디어를 구조화된 마크다운 명세로 변환 |
602
+ | **[Companion](docs/companion.md)** | 파싱, 도움말, 타입을 위한 플로팅 창 companion |
558
603
 
559
604
  ### ⚙️ 설정 & 레퍼런스
560
605
 
561
606
  | 문서 | 내용 |
562
607
  |-----|------|
608
+ | **[Installation Guide](docs/installation.md)** | 플러그인 설치, CLI 플래그 사용, 설정 초기화, 설치 문제 해결 |
563
609
  | **[Configuration](docs/configuration.md)** | 설정 파일 위치, JSONC 지원, 프롬프트 오버라이드, 전체 옵션 레퍼런스 |
610
+ | **[Background Orchestration](docs/background-orchestration.md)** | 네이티브 백그라운드 서브에이전트를 기반으로 한 스케줄러 우선 Orchestrator 모델 |
564
611
  | **[Maintainer Guide](docs/maintainers.md)** | 이슈 트리아지 규칙, 라벨 의미, 지원 라우팅, 저장소 유지보수 워크플로우 |
565
- | **[Skills](docs/skills.md)** | `simplify`, `codemap`, `clonedeps`, `deepwork`, `oh-my-opencode-slim` 등 번들된 스킬 |
612
+ | **[Skills](docs/skills.md)** | `simplify`, `codemap`, `clonedeps`, `deepwork`, `reflect`, `worktrees`, `oh-my-opencode-slim` 등 번들된 스킬 |
566
613
  | **[MCPs](docs/mcps.md)** | `websearch`, `context7`, `gh_grep` 및 에이전트별 MCP 권한 동작 방식 |
567
614
  | **[Tools](docs/tools.md)** | `webfetch`, LSP 도구, 코드 검색, 포매터 등 내장 도구 기능 |
568
615
 
package/README.md CHANGED
@@ -30,6 +30,29 @@ The main idea is simple: instead of forcing one model to do everything, the plug
30
30
 
31
31
  To explore the agents themselves, see **[Meet the Pantheon](#meet-the-pantheon)**. For the full feature set, see **[Features & Workflows](#features-and-workflows)** below.
32
32
 
33
+ ### What Users Say
34
+
35
+ > “Task management went from 5/10 to 8-9/10 easily. The Orchestrator sends
36
+ > Fixers and Explorers, and I can still talk and plan with the Orchestrator in
37
+ > the same session. The experience feels way smoother now.”
38
+ >
39
+ > \- `vipor_idk`
40
+
41
+ > “I ditched all my harnesses for this beta version of omo-slim and don't look
42
+ > back or miss anything. Great work and IMHO all in the right direction.”
43
+ >
44
+ > \- `stephanschielke`
45
+
46
+ > “I love omo-slim, and can't imagine running opencode without it. I love that I
47
+ > can create a Frankenstein of models... Makes the setup such a beast.”
48
+ >
49
+ > \- `Capital-One3039`
50
+
51
+ > “It has significantly improved my workflow... Now, it is working very
52
+ > smoothly, and I love it.”
53
+ >
54
+ > \- `xenstar1`
55
+
33
56
  ### Quick Start
34
57
 
35
58
  Copy and paste this prompt to your LLM agent (Claude Code, AmpCode, Cursor, etc.):
@@ -48,7 +71,9 @@ bunx oh-my-opencode-slim@latest install
48
71
 
49
72
  ### Getting Started
50
73
 
51
- The installer generates both OpenAI and OpenCode Go presets, with OpenAI active by default. OpenAI uses `openai/gpt-5.5 (medium)` for the workflow manager/scheduler, `openai/gpt-5.5 (high)` for the Oracle, `openai/gpt-5.5 (low)` for the Fixer, and `openai/gpt-5.4-mini` variants for other specialists. To make OpenCode Go active during install, run `bunx oh-my-opencode-slim@latest install --preset=opencode-go` or change the default preset name in `~/.config/opencode/oh-my-opencode-slim.json` after installation.
74
+ The installer generates both OpenAI and OpenCode Go presets, with OpenAI active by default.
75
+
76
+ To make OpenCode Go active during install, run `bunx oh-my-opencode-slim@latest install --preset=opencode-go` or change the default preset name in `~/.config/opencode/oh-my-opencode-slim.json` after installation.
52
77
 
53
78
  Then:
54
79
 
@@ -63,14 +88,15 @@ Then:
63
88
  opencode models --refresh
64
89
  ```
65
90
  3. **Open your plugin config** at `~/.config/opencode/oh-my-opencode-slim.json`
66
- or `$OPENCODE_CONFIG_DIR/oh-my-opencode-slim.json` if you use a custom
67
- OpenCode config directory
68
91
 
69
92
  4. **Update the models you want for each agent**
70
93
 
71
94
  > [!TIP]
72
95
  > It's **recommended** to understand how background orchestration works. The **[Orchestrator prompt](https://github.com/alvinunreal/oh-my-opencode-slim/blob/master/src/agents/orchestrator.ts#L28)** contains the scheduler rules, specialist routing logic, and thresholds for when work should be assigned to background agents. You can always delegate manually by calling a subagent via: `@agentName <task>`
73
96
 
97
+ > [!TIP]
98
+ > Because background agents are now the default workflow, it is **highly recommended** to enable and configure **[Multiplexer Integration](docs/multiplexer-integration.md)**. It automatically opens each agent in a dedicated Tmux or Zellij pane, so you can watch specialists work live while the Orchestrator continues coordinating the session.
99
+
74
100
  The default generated configuration includes both `openai` and `opencode-go` presets.
75
101
 
76
102
  ```jsonc
@@ -103,10 +129,6 @@ The default generated configuration includes both `openai` and `opencode-go` pre
103
129
 
104
130
  To use custom providers or a mixed-provider setup, use **[Configuration](docs/configuration.md)** for the full reference. If you want a ready-made starting point, check the **[Author's Preset](docs/authors-preset.md)** and **[$30 Preset](docs/thirty-dollars-preset.md)** - the `$30` preset is the best cheap setup.
105
131
 
106
- The configuration guide also covers custom subagents via `agents.<name>`, where
107
- you can define both a normal `prompt` and an `orchestratorPrompt` block for
108
- delegation.
109
-
110
132
  ### ✅ Verify Your Setup
111
133
 
112
134
  After installation and authentication, verify all agents are configured and responding:
@@ -143,6 +165,10 @@ verification while specialists do the work in their own lanes.
143
165
  agents are currently active, including parallel background specialists.
144
166
  - **[Deepwork](#deepwork)** — a structured workflow for large, multi-file, risky,
145
167
  or phased coding work using persistent plan files and Oracle review gates.
168
+ - **[Reflect](#reflect)** — reviews repeated work patterns and suggests reusable skills,
169
+ agents, commands, config rules, prompt rules, or project playbooks.
170
+ - **[Worktrees](#worktrees)** — manages Git worktrees as isolated coding lanes
171
+ with safety protocols for complex, risky, or parallel tasks.
146
172
  - **[oh-my-opencode-slim skill](#oh-my-opencode-slim-skill)** — a bundled
147
173
  configuration skill that helps tune models, prompts, custom agents, MCP access,
148
174
  presets, and plugin behavior safely.
@@ -193,6 +219,36 @@ Start it with:
193
219
  See **[Skills](docs/skills.md#deepwork)** for when to use it and how the workflow
194
220
  runs.
195
221
 
222
+ #### Reflect
223
+
224
+ Reflect helps the Orchestrator learn from repeated workflow friction. It reviews
225
+ recent work and existing assets, then recommends the smallest useful improvement:
226
+ a skill, custom agent, command, config rule, prompt rule, MCP permission change,
227
+ or project playbook. If there is not enough evidence, it should recommend
228
+ creating nothing.
229
+
230
+ Use it directly with:
231
+
232
+ ```text
233
+ /reflect
234
+ /reflect release workflow and checks
235
+ ```
236
+
237
+ Or with natural prompts like:
238
+
239
+ ```text
240
+ reflect on my recent workflows
241
+ find repeated work worth turning into reusable instructions
242
+ ```
243
+
244
+ See **[Skills](docs/skills.md#reflect)** for the full workflow and guardrails.
245
+
246
+ #### Worktrees
247
+
248
+ Worktrees manages Git worktrees as safe, isolated coding lanes under `.slim/worktrees/<slug>/`. The Orchestrator manages the lifecycle of these lanes, tracks state in `.slim/worktrees.json`, dispatches specialist agents inside them, and requires explicit confirmation before mutating git state.
249
+
250
+ See **[Skills](docs/skills.md#worktrees)** for the safety protocol.
251
+
196
252
  #### oh-my-opencode-slim Skill
197
253
 
198
254
  The bundled `oh-my-opencode-slim` skill helps the Orchestrator configure and
@@ -502,7 +558,7 @@ rules.
502
558
  </tr>
503
559
  <tr>
504
560
  <td colspan="2">
505
- <b>Model Guidance:</b> Choose a fast, reliable coding model for routine, scoped implementation work. Fixer usually receives a concrete plan or bounded instructions from Orchestrator, making it a good place for efficient execution tasks such as tests, test updates, and straightforward code changes.
561
+ <b>Model Guidance:</b> Choose a reliable coding model for scoped implementation work. Fixer receives a concrete plan or bounded instructions from Orchestrator, making it a good place for efficient execution tasks and straightforward code changes.
506
562
  </td>
507
563
  </tr>
508
564
  </table>
@@ -555,12 +611,6 @@ rules.
555
611
 
556
612
  Use this section as a map: start with installation, then jump to features, configuration, or example presets depending on what you need.
557
613
 
558
- ### 🚀 Start Here
559
-
560
- | Doc | What it covers |
561
- |-----|----------------|
562
- | **[Installation Guide](docs/installation.md)** | Install the plugin, use CLI flags, reset config, and troubleshoot setup |
563
-
564
614
  <a id="features-and-workflows"></a>
565
615
 
566
616
  ### ✨ Features & Workflows
@@ -568,12 +618,12 @@ Use this section as a map: start with installation, then jump to features, confi
568
618
  | Doc | What it covers |
569
619
  |-----|----------------|
570
620
  | **[Council](docs/council.md)** | Run multiple models in parallel and synthesize a single answer with `@council` |
571
- | **[Background Orchestration](docs/background-orchestration.md)** | Scheduler-first orchestrator model built around native background subagents |
572
- | **[Multiplexer Integration](docs/multiplexer-integration.md)** | Watch agents work live in Tmux or Zellij panes |
573
- | **[Preset Switching](docs/preset-switching.md)** | Switch agent model presets at runtime with `/preset` |
574
621
  | **[Custom Agents](docs/configuration.md#custom-agents)** | Define your own specialists with custom prompts, models, MCP access, and Orchestrator delegation rules |
622
+ | **[Multiplexer Integration](docs/multiplexer-integration.md)** | Watch agents work live in Tmux or Zellij panes |
575
623
  | **[Codemap](docs/codemap.md)** | Generate hierarchical codemaps to understand large codebases faster |
576
624
  | **[Clonedeps](docs/clonedeps.md)** | Clone selected dependency source into an ignored local workspace for inspection |
625
+ | **[Worktrees](docs/worktrees.md)** | Use `.slim/worktrees/` lanes for isolated parallel or risky coding work |
626
+ | **[Preset Switching](docs/preset-switching.md)** | Switch agent model presets at runtime with `/preset` |
577
627
  | **[Interview](docs/interview.md)** | Turn rough ideas into a structured markdown spec through a browser-based Q&A flow |
578
628
  | **[Companion](docs/companion.md)** | Floating window companion for parsing, help, and types |
579
629
 
@@ -581,9 +631,11 @@ Use this section as a map: start with installation, then jump to features, confi
581
631
 
582
632
  | Doc | What it covers |
583
633
  |-----|----------------|
634
+ | **[Installation Guide](docs/installation.md)** | Install the plugin, use CLI flags, reset config, and troubleshoot setup |
584
635
  | **[Configuration](docs/configuration.md)** | Config file locations, JSONC support, prompt overrides, and full option reference |
636
+ | **[Background Orchestration](docs/background-orchestration.md)** | Scheduler-first orchestrator model built around native background subagents |
585
637
  | **[Maintainer Guide](docs/maintainers.md)** | Issue triage rules, label meanings, support routing, and repo maintenance workflow |
586
- | **[Skills](docs/skills.md)** | Bundled skills such as `simplify`, `codemap`, `clonedeps`, `deepwork`, and `oh-my-opencode-slim` |
638
+ | **[Skills](docs/skills.md)** | Bundled skills such as `simplify`, `codemap`, `clonedeps`, `deepwork`, `reflect`, `worktrees`, and `oh-my-opencode-slim` |
587
639
  | **[MCPs](docs/mcps.md)** | `websearch`, `context7`, `gh_grep`, and how MCP permissions work per agent |
588
640
  | **[Tools](docs/tools.md)** | Built-in tool capabilities like `webfetch`, LSP tools, code search, and formatters |
589
641
 
@@ -604,7 +656,7 @@ Use this section as a map: start with installation, then jump to features, confi
604
656
  <p><sub>Every merged contribution leaves a mark on the realm.</sub></p>
605
657
 
606
658
  <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
607
- [![All Contributors](https://img.shields.io/badge/all_contributors-59-orange.svg?style=flat-square)](#contributors-)
659
+ [![All Contributors](https://img.shields.io/badge/all_contributors-60-orange.svg?style=flat-square)](#contributors-)
608
660
  <!-- ALL-CONTRIBUTORS-BADGE:END -->
609
661
  </div>
610
662
 
@@ -693,6 +745,7 @@ Use this section as a map: start with installation, then jump to features, confi
693
745
  <td align="center" valign="top" width="16.66%"><a href="https://github.com/Qesire"><img src="https://avatars.githubusercontent.com/u/102657430?v=4?s=100" width="100px;" alt="Knowingthesea_Qesire"/><br /><sub><b>Knowingthesea_Qesire</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=Qesire" title="Code">💻</a></td>
694
746
  <td align="center" valign="top" width="16.66%"><a href="http://www.flyinghail.net/"><img src="https://avatars.githubusercontent.com/u/157430?v=4?s=100" width="100px;" alt="FENG Hao"/><br /><sub><b>FENG Hao</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=flyinghail" title="Code">💻</a></td>
695
747
  <td align="center" valign="top" width="16.66%"><a href="https://github.com/smatheusblu"><img src="https://avatars.githubusercontent.com/u/5666794?v=4?s=100" width="100px;" alt="Matheus Nogueira Silveira"/><br /><sub><b>Matheus Nogueira Silveira</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=smatheusblu" title="Code">💻</a></td>
748
+ <td align="center" valign="top" width="16.66%"><a href="https://github.com/sktr"><img src="https://avatars.githubusercontent.com/u/44969514?v=4?s=100" width="100px;" alt="sktr"/><br /><sub><b>sktr</b></sub></a><br /><a href="https://github.com/alvinunreal/oh-my-opencode-slim/commits?author=sktr" title="Code">💻</a></td>
696
749
  </tr>
697
750
  </tbody>
698
751
  </table>