@te-river/opencode-team-mode 1.4.4 → 1.4.5

package/README.md

@@ -108,6 +108,13 @@ That's it. The plugin automatically injects all team agents and commands when Op
 
 > 💡 **Tip:** After modifying `opencode.json`, **restart OpenCode Desktop** for changes to take effect.
 
+> ⚠️ **Model choice matters.** Every judgment in the workflow — triage,
+> decomposition, dispatch briefs, synthesis, review-loop verdicts — flows
+> through the **Team Lead**. A weak model in that seat degrades the whole
+> pipeline no matter how strong the specialists are. Pin your best
+> reasoning model to the `team` agent (recipe in
+> [Customization](#customization) below).
+
 ### Global install (all projects)
 
 To enable TeamMode in every project, add the plugin to your global config:
@@ -171,9 +178,9 @@ You can also invoke agents directly using the `@` mention in OpenCode Desktop:
 
 ### Demo
 
-A session transcript, recreated from how the flow actually looks. The user
-picks `team` in the agent switcher (or enables `defaultAgent`, see
-Configuration), then just types into a fresh chat:
+A session transcript, recreated from how the flow actually looks. Team is the
+default agent out of the box (see Configuration to opt out), so the user just
+types into a fresh chat:
 
 > **User:** Add token-bucket rate limiting to our Express API — 100 requests
 > per minute per user, return 429 when exceeded. Don't touch anything under
@@ -328,36 +335,64 @@ fall back to 5.
 
 ### Default agent
 
-By default TeamMode **does not** touch the default agent — new chats start
-on the built-in `build` as before.  This is a deliberate ordering trade-off:
-the switcher pins the default agent to the **first slot** and sorts
-everything else alphabetically, so "Team pinned as default (first)" and
-"Team shown after Plan" are mutually exclusive.  Leaving the default slot
-alone gives you the picker order **build, plan, team**.
+By default TeamMode **makes Team your default agent** — new chats open
+directly in the team orchestrator. One side effect comes with the default
+slot: the switcher pins the default agent to the **first position** and
+sorts everything else alphabetically, so the picker order is
+**team, build, plan**. (Want Team below Plan instead? That requires
+giving up the default slot — see the opt-out below; the two are
+mutually exclusive by the server's sort.)
 
-To promote Team as the default agent anyway (new chats start with the team
-orchestrator, and Team is pinned first — order becomes **team, build,
-plan**):
+To opt out (`build` stays the default, picker order **build, plan,
+team**):
 
 ```jsonc
 {
   "plugin": [
-    ["@te-river/opencode-team-mode@latest", { "defaultAgent": true }]
+    ["@te-river/opencode-team-mode@latest", { "defaultAgent": false }]
   ]
 }
 ```
 
 An explicitly configured non-`build` `default_agent` in your own config is
-always respected untouched, even with `defaultAgent: true`.
+always respected untouched — the plugin never clobbers it.
 
-**Upgrade note:** since v1.4.4 the plugin no longer claims the default-agent
-slot by default.  If you relied on Team being your default agent before
-(v1.4.2+), add `{ "defaultAgent": true }` to your plugin options.
+**Upgrade note:** v1.4.4 briefly made this promotion opt-in; v1.4.5 restores
+Team-as-default as the shipped behavior. If you pinned `{ "defaultAgent":
+true }` during v1.4.4, you can drop that option (or switch it to `false` to
+opt out).
 
 ---
 
 ## 🔧 Customization
 
+### The Team Lead's model matters most
+
+The Lead is the orchestrating brain: it classifies every message, cuts the
+work into packages, writes each dispatch manifest, judges reviewer/tester
+findings, and synthesizes the final deliverable. Quality failures there
+**multiply down the pipeline** — a mediocre Lead mis-decomposes, briefs the
+experts vaguely, and waves weak work through; no specialist can rescue an
+assignment it was never correctly given.
+
+So run the strongest model you can afford **in the Lead seat**. The other
+roles tolerate cheaper models — they work from tight briefs with scoped
+reading. Pin models per agent:
+
+```jsonc
+{
+  "agent": {
+    // Team Lead — orchestration earns your best model
+    "team": { "model": "anthropic/claude-opus-4-5" },
+    // specialists — cheaper models are usually fine
+    "implementer": { "model": "anthropic/claude-sonnet-4-6" }
+  }
+}
+```
+
+(Model IDs above are placeholders — use whatever your provider exposes.
+Your own `agent.team` definition always takes precedence over the plugin's.)
+
 ### Override an agent
 
 Add an agent with the same name in your `opencode.json` — your definition takes precedence:

package/README.zh-CN.md

@@ -108,6 +108,11 @@ npm link
 
 > 💡 **提示：** 修改 `opencode.json` 后，请**重启 OpenCode 桌面版**使更改生效。
 
+> ⚠️ **模型选择很重要。** 工作流里的每一个判断——分诊、拆解、派发清单、
+> 整合、审查/测试闭环裁决——都经过 **Team Lead**。这个位置上放弱模型，
+> 专家再强也救不回整条流水线。请给你的 `team` agent 钉上你能负担的最强
+> 推理模型（配方见下方「自定义」节）。
+
 ### 全局安装（所有项目生效）
 
 要在所有项目中启用 TeamMode，将插件添加到全局配置：
@@ -171,8 +176,8 @@ TeamMode 为 OpenCode 添加了六个斜杠命令，在聊天输入框中输入
 
 ### 演示
 
-以下是一段会话实录的还原。用户在代理选择器中选中 `team`（或按下方配置开启
-`defaultAgent`），开新会话直接输入：
+以下是一段会话实录的还原。Team 出厂即默认代理（退出方法见下方配置），
+用户开新会话直接输入：
 
 > **用户：** 给我们的 Express API 加令牌桶限流——每用户每分钟 100 请求，
 > 超限返回 429。不要动 `src/legacy/` 下的任何东西。
@@ -311,31 +316,55 @@ Team Lead 不再删除任务目录 —— 跑完的黑板原地留给你回看
 
 ### 默认代理
 
-TeamMode 默认**不再占用默认代理槽**——新会话仍从内建 `build` 开始。这是刻意的
-排序取舍：选择器会把**默认代理钉在第一位**，其余按名称字母升序，因此
-「Team 排默认（首位）」与「Team 显示在 Plan 之后」不可兼得。不占槽时顺序为
-**build, plan, team**。
+TeamMode 默认**把 Team 设为你的默认代理**——新会话直接由团队调度者接管。
+占默认槽附带一个排序效应：选择器会把**默认代理钉在第一位**、其余按名称
+字母升序，所以顺序为 **team, build, plan**。（想让 Team 排在 Plan 之下？
+那必须放弃默认槽——见下方退出开关；按服务端的排序规则二者不可兼得。）
 
-若希望新会话直接由团队调度者接管（Team 被钉在首位，顺序变为
-**team, build, plan**），开启 `defaultAgent`：
+不想占用默认代理槽（`build` 保持默认，顺序 **build, plan, team**）则退出：
 
 ```jsonc
 {
   "plugin": [
-    ["@te-river/opencode-team-mode@latest", { "defaultAgent": true }]
+    ["@te-river/opencode-team-mode@latest", { "defaultAgent": false }]
   ]
 }
 ```
 
-即使用户显式配置了非 `build` 默认代理，也永远原样保留（开启与否都不覆写）。
+用户显式配置的非 `build` 默认代理永远原样保留——插件从不覆写。
 
-**升级提示**：自 v1.4.4 起，插件默认不再占用默认代理槽。此前依赖 Team 作为
-默认代理（v1.4.2+）的用户，请在插件选项中添加 `{ "defaultAgent": true }`。
+**升级提示**：v1.4.4 曾短暂改为 opt-in（默认不占用）；v1.4.5 恢复
+Team-as-default 出厂行为。若你在 v1.4.4 期间加过 `{ "defaultAgent": true }`，
+现在可以删掉该选项（或改为 `false` 主动退出）。
 
 ---
 
 ## 🔧 自定义
 
+### Team Lead 的模型最关键
+
+Lead 是编排大脑：它给每条消息分类、把工作切成包、写每份派发清单、裁决
+reviewer/tester 的发现、合成最终交付。这里的质量问题会**沿流水线放大**——
+平庸的 Lead 拆错任务、给专家的指令含糊、放走劣质产出；没有任何专家能
+救回一份从一开始就派错的工单。
+
+所以：**Lead 位上请放你负担得起的最强模型**。其他角色可以用便宜模型——
+它们拿到的指令书精确、阅读范围受限，容错更高。按 agent 钉模型：
+
+```jsonc
+{
+  "agent": {
+    // Team Lead —— 编排值得最好的模型
+    "team": { "model": "anthropic/claude-opus-4-5" },
+    // 专家角色 —— 便宜一档通常够用
+    "implementer": { "model": "anthropic/claude-sonnet-4-6" }
+  }
+}
+```
+
+（以上模型 ID 仅为示例，换成你服务商实际提供的即可。你自定义的
+`agent.team` 永远优先于插件注入的版本。）
+
 ### 覆盖某个 Agent
 
 在 `opencode.json` 中添加同名 Agent —— 你的定义会优先生效：

package/dist/index.d.ts

@@ -17,13 +17,12 @@
  * Options (via the tuple plugin form):
  *   "plugin": [["@te-river/opencode-team-mode@latest", { "ttlDays": 7 }]]
  * - `ttlDays`      → blackboard auto-cleanup TTL; default 5.
- * - `defaultAgent` → promote Team as the default agent (opt-in: set `true`
- *                    to enable).  Trade-off when NOT enabled: new chats
- *                    start on the built-in `build` agent, but the picker
- *                    keeps Team in plain alphabetical order — after `plan`
- *                    (the default agent is pinned first; everything else
- *                    sorts by name, so "team first" and "team after plan"
- *                    are mutually exclusive).
+ * - `defaultAgent` → Team is the default agent (opt-out: set `false`).
+ *                    Owning the default slot means the picker pins it
+ *                    FIRST — order becomes team, build, plan.  Set
+ *                    `false` for build-as-default with Team in its
+ *                    alphabetical slot: build, plan, team (the two are
+ *                    mutually exclusive by the server's sort).
  */
 import type { OpenCodePlugin } from "./types.js";
 declare const plugin: OpenCodePlugin;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAA;AA2BhE,QAAA,MAAM,MAAM,EAAE,cAyCb,CAAA;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAA;AA2BhE,QAAA,MAAM,MAAM,EAAE,cAyCb,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/index.js

@@ -17,13 +17,12 @@
  * Options (via the tuple plugin form):
  *   "plugin": [["@te-river/opencode-team-mode@latest", { "ttlDays": 7 }]]
  * - `ttlDays`      → blackboard auto-cleanup TTL; default 5.
- * - `defaultAgent` → promote Team as the default agent (opt-in: set `true`
- *                    to enable).  Trade-off when NOT enabled: new chats
- *                    start on the built-in `build` agent, but the picker
- *                    keeps Team in plain alphabetical order — after `plan`
- *                    (the default agent is pinned first; everything else
- *                    sorts by name, so "team first" and "team after plan"
- *                    are mutually exclusive).
+ * - `defaultAgent` → Team is the default agent (opt-out: set `false`).
+ *                    Owning the default slot means the picker pins it
+ *                    FIRST — order becomes team, build, plan.  Set
+ *                    `false` for build-as-default with Team in its
+ *                    alphabetical slot: build, plan, team (the two are
+ *                    mutually exclusive by the server's sort).
  */
 import { agents } from "./agents.js";
 import { commands } from "./commands.js";
@@ -77,8 +76,8 @@ const plugin = {
                         continue;
                     cfg.command[name] = def;
                 }
-                // ---------- make Team the default agent (opt-in: defaultAgent:true)
-                const promote = options?.defaultAgent === true;
+                // ---------- make Team the default agent (opt-out: defaultAgent:false)
+                const promote = options?.defaultAgent !== false;
                 if (promote && (!cfg.default_agent || cfg.default_agent === "build")) {
                     cfg.default_agent = "team";
                 }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EACL,0BAA0B,EAC1B,YAAY,EACZ,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AAExB,iEAAiE;AACjE,SAAS,cAAc,CAAC,IAAY,EAAE,OAAe;IACnD,OAAO;QACL,EAAE;QACF,EAAE;QACF,kDAAkD;QAClD,qBAAqB,IAAI,IAAI;QAC7B,qFAAqF;QACrF,qFAAqF;QACrF,uFAAuF;QACvF,qFAAqF;QACrF,yDAAyD;QACzD,sGAAsG;QACtG,yEAAyE,OAAO,gCAAgC;QAChH,sFAAsF;KACvF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,MAAM,GAAmB;IAC7B,EAAE,EAAE,WAAW;IAEf,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC/B,wEAAwE;QACxE,MAAM,SAAS,GACb,OAAO,KAAK,EAAE,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;YAChE,CAAC,CAAC,KAAK,CAAC,SAAS;YACjB,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAA;QACnB,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,gBAAgB,CAAA;QAC7E,MAAM,SAAS,GAAG,0BAA0B,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QAC9D,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAE/C,OAAO;YACL,iEAAiE;YACjE,MAAM,CAAC,GAAmB;gBACxB,IAAI,CAAC,GAAG,CAAC,KAAK;oBAAE,GAAG,CAAC,KAAK,GAAG,EAAE,CAAA;gBAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBACjD,mEAAmE;oBACnE,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;wBAAE,SAAQ;oBAC7B,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;wBAChB,GAAG,GAAG;wBACN,MAAM,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM;qBACjE,CAAA;gBACH,CAAC;gBAED,IAAI,CAAC,GAAG,CAAC,OAAO;oBAAE,GAAG,CAAC,OAAO,GAAG,EAAE,CAAA;gBAClC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACnD,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;wBAAE,SAAQ;oBAC/B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAA;gBACzB,CAAC;gBAED,qEAAqE;gBACrE,MAAM,OAAO,GAAG,OAAO,EAAE,YAAY,KAAK,IAAI,CAAA;gBAC9C,IAAI,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,aAAa,KAAK,OAAO,CAAC,EAAE,CAAC;oBACrE,GAAG,CAAC,aAAa,GAAG,MAAM,CAAA;gBAC5B,CAAC;YACH,CAAC;SACF,CAAA;IACH,CAAC;CACF,CAAA;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EACL,0BAA0B,EAC1B,YAAY,EACZ,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AAExB,iEAAiE;AACjE,SAAS,cAAc,CAAC,IAAY,EAAE,OAAe;IACnD,OAAO;QACL,EAAE;QACF,EAAE;QACF,kDAAkD;QAClD,qBAAqB,IAAI,IAAI;QAC7B,qFAAqF;QACrF,qFAAqF;QACrF,uFAAuF;QACvF,qFAAqF;QACrF,yDAAyD;QACzD,sGAAsG;QACtG,yEAAyE,OAAO,gCAAgC;QAChH,sFAAsF;KACvF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAED,MAAM,MAAM,GAAmB;IAC7B,EAAE,EAAE,WAAW;IAEf,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC/B,wEAAwE;QACxE,MAAM,SAAS,GACb,OAAO,KAAK,EAAE,SAAS,KAAK,QAAQ,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;YAChE,CAAC,CAAC,KAAK,CAAC,SAAS;YACjB,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAA;QACnB,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,gBAAgB,CAAA;QAC7E,MAAM,SAAS,GAAG,0BAA0B,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;QAC9D,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAE/C,OAAO;YACL,iEAAiE;YACjE,MAAM,CAAC,GAAmB;gBACxB,IAAI,CAAC,GAAG,CAAC,KAAK;oBAAE,GAAG,CAAC,KAAK,GAAG,EAAE,CAAA;gBAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBACjD,mEAAmE;oBACnE,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;wBAAE,SAAQ;oBAC7B,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG;wBAChB,GAAG,GAAG;wBACN,MAAM,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM;qBACjE,CAAA;gBACH,CAAC;gBAED,IAAI,CAAC,GAAG,CAAC,OAAO;oBAAE,GAAG,CAAC,OAAO,GAAG,EAAE,CAAA;gBAClC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACnD,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;wBAAE,SAAQ;oBAC/B,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAA;gBACzB,CAAC;gBAED,uEAAuE;gBACvE,MAAM,OAAO,GAAG,OAAO,EAAE,YAAY,KAAK,KAAK,CAAA;gBAC/C,IAAI,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,aAAa,KAAK,OAAO,CAAC,EAAE,CAAC;oBACrE,GAAG,CAAC,aAAa,GAAG,MAAM,CAAA;gBAC5B,CAAC;YACH,CAAC;SACF,CAAA;IACH,CAAC;CACF,CAAA;AAED,eAAe,MAAM,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@te-river/opencode-team-mode",
-  "version": "1.4.4",
+  "version": "1.4.5",
   "description": "Team collaboration mode plugin for OpenCode Desktop — injects specialized agents (architect, reviewer, implementer, tester, researcher) and team workflow commands into your OpenCode workspace.",
   "type": "module",
   "main": "dist/index.js",