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

package/README.md

@@ -169,6 +169,55 @@ You can also invoke agents directly using the `@` mention in OpenCode Desktop:
 - `@tester` — Write tests
 - `@researcher` — Research a topic
 
+### 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:
+
+> **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
+> `src/legacy/`.
+
+```text
+team   Breaking this down: design → implement → review → test.
+       Task board: .git/opencode-team/20260831-143012/rate-limiter/   (session folder + board inside .git/, auto-swept after idle TTL)
+
+       ▸ @architect — designing (writes 01-architect-design.md)
+       ✓ in-memory token bucket, per-user key, 429 + Retry-After
+         summary above, full design on the board
+
+       ▸ @implementer — building (Reads: 01; writes 02-implementer-middleware.md)
+       ✓ src/middleware/rateLimit.ts (new), wired into src/app.ts (+3 lines)
+
+       ▸ @reviewer — auditing the diff (Reads: 01, 02; writes 03-reviewer-findings-r1.md)
+       ⚠ 1 MAJOR — bucket refill does read-modify-write in two steps;
+         races under concurrent requests
+         → converted to a fix task; dispatched to @implementer with the
+           finding text (the user was not asked to approve this step)
+
+       ▸ @implementer r2 — fixing the race (Reads: 03-r1 §MAJOR; writes 04-implementer-r2.md)
+       ✓ refill restructured to single atomic update
+
+       ▸ @reviewer r2 — re-review of fixed scope only
+       ✓ clean — r1 finding resolved, no regressions
+
+       ▸ @tester — covering limiter + boundaries (writes 05-tester-report.md)
+       ✓ 14/14 pass — burst edge, window expiry, concurrent refill,
+         src/legacy/** byte-identical (user boundary verified in tests)
+
+team   Done.
+       rate limiter shipped: rateLimit.ts (new) · app.ts (+3) · 14 tests green
+       review loop: 1 major found → fixed → clean
+       assumption: in-memory only — say the word if you want Redis
+       src/legacy/ untouched
+       task board left in place — TTL sweep will reclaim it
+```
+
+The only message the user typed was the first one. The reviewer's finding
+became the implementer's work order without a prompt; every artifact stayed
+out of chat and on the board, read only by the dispatch that needed it.
+
 ### Desktop-specific features
 
 In **OpenCode Desktop**, you get additional UX benefits:
@@ -212,30 +261,53 @@ opencode-team-mode/
 
 ## 🗂️ Shared Blackboard (with automatic cleanup)
 
-Sub-agents cannot message each other live (platform limitation), so TeamMode coordinates them through a **file blackboard**:
-
-- Each multi-agent task gets its own directory under
-  `<repo>/.git/opencode-team/<task-slug>/` — inside `.git/`, so your working
-  tree and commits are **never polluted**. (Non-git workspaces fall back to
-  the OS temp dir.)
-- Every agent writes its full deliverable to a designated artifact
-  (`01-architect-design.md`, `03-review-findings.md`, …); the Team Lead
-  relays *summary + file path* in each dispatch and keeps `MANIFEST.md` as
-  the index. Full documents are shared verbatim — no lossy telephone game,
-  and fewer tokens.
+Sub-agents cannot message each other live (platform limitation), so TeamMode coordinates them through a **file blackboard** with strict ownership:
+
+- **Session isolation:** every conversation owns ONE timestamped session
+  folder, and each multi-agent task gets its own directory inside it:
+  `<repo>/.git/opencode-team/<session-key>/<task-slug>/` — inside `.git/`,
+  so your working tree and commits are **never polluted**. (Non-git
+  workspaces fall back to the OS temp dir.) Since boards now linger until
+  the TTL sweep, the session layer keeps a fresh conversation from bumping
+  into — or reading stale artifacts from — a not-yet-swept board (timestamps
+  are second-granular, so overlap needs two conversations starting in the
+  same second).
+- **File ownership:** every artifact is one topic-sized file written by
+  exactly one agent (`01-architect-auth-design.md`, `03-reviewer-auth-r1.md`).
+  ~100 lines max per file — split topics instead of letting files balloon.
+- **Writes are frozen:** a revision is a new round-suffixed file
+  (`…-r2.md`); nothing is ever appended to or later agents reading stale rounds.
+- **The Team Lead is the router:** every dispatch carries a manifest —
+  `Task:` (self-contained brief), `Reads:` (only the files that work package
+  needs), `Write to:` (the one file the agent owns). Specialists read nothing
+  that isn't listed, so long tasks never drown sub-agents in unnecessary context.
+- **`MANIFEST.md` is the lead's state board:** a file index plus a ≤50-line
+  `## Current state` section (phase, decisions still valid, next steps),
+  updated every converged round — the lead's compressed memory across long tasks.
 - The Team Lead also enforces a review/test **feedback loop**: Critical/Major
   findings and product bugs automatically become tracked fix tasks until the
   deliverable converges.
 
-### Cleanup — two layers
+### Triage — questions don't become code edits
 
-| Layer | Who | When |
-|---|---|---|
-| Fast path | Team Lead (prompt rule) | Deletes the task directory right after the final report |
-| Safety net | Plugin code (in-process sweeper) | At startup + every hour: removes task directories idle **beyond the TTL** |
+The Team Lead classifies every incoming message before acting: a question or
+consult gets an answer (zero file changes, fixes merely proposed and awaiting
+your go-ahead); only explicit action requests enter the workflow. And whenever
+you spell out what may or may not be touched, **those boundaries outrank
+everything else** — the lead restates them in every single dispatch.
 
-The sweeper is pure code — it never relies on the model remembering to
-delete, and it also cleans up leftovers from crashes or force-kills.
+### Cleanup — the TTL sweeper is the only path
+
+| Who | When |
+|---|---|
+| Plugin code (in-process sweeper) | At startup + every hour: removes task directories idle **beyond the TTL** |
+
+The Team Lead never deletes task directories — finished boards stay
+readable so you can audit how a run went, and reclamation is pure code
+that never relies on the model remembering to do anything (crashes and
+force-kills leave nothing behind either). The sweeper prunes stale task
+dirs individually under a still-live session, and reclaims an entirely
+idle session folder in one pass. Set `ttlDays` to taste.
 
 ### Configure the TTL
 
@@ -256,21 +328,31 @@ fall back to 5.
 
 ### Default agent
 
-TeamMode makes **`team` the default agent** (replacing the built-in `build`)
-so every new chat starts with the team orchestrator — it appears above the
-rest in the switcher's default slot.  To keep `build` (or any other agent)
-as the default, or pin a different one:
+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**.
+
+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**):
 
 ```jsonc
 {
   "plugin": [
-    ["@te-river/opencode-team-mode@latest", { "defaultAgent": false }]
+    ["@te-river/opencode-team-mode@latest", { "defaultAgent": true }]
   ]
 }
 ```
 
-An explicitly configured non-`build` `default_agent` is always respected
-untouched.
+An explicitly configured non-`build` `default_agent` in your own config is
+always respected untouched, even with `defaultAgent: true`.
+
+**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.
 
 ---
 

package/README.zh-CN.md

@@ -169,6 +169,51 @@ TeamMode 为 OpenCode 添加了六个斜杠命令，在聊天输入框中输入
 - `@tester` — 编写测试
 - `@researcher` — 调研主题
 
+### 演示
+
+以下是一段会话实录的还原。用户在代理选择器中选中 `team`（或按下方配置开启
+`defaultAgent`），开新会话直接输入：
+
+> **用户：** 给我们的 Express API 加令牌桶限流——每用户每分钟 100 请求，
+> 超限返回 429。不要动 `src/legacy/` 下的任何东西。
+
+```text
+team   拆解任务：设计 → 实现 → 审查 → 测试。
+       任务黑板：.git/opencode-team/20260831-143012/rate-limiter/（会话目录 + 任务板，都在 .git/ 内，闲置超 TTL 自动清理）
+
+       ▸ @architect — 设计中（写入 01-architect-design.md）
+       ✓ 内存令牌桶、按用户键控、429 + Retry-After
+         聊天里只有摘要，设计全文在黑板上
+
+       ▸ @implementer — 实现中（Reads: 01；写 02-implementer-middleware.md）
+       ✓ src/middleware/rateLimit.ts（新增），接入 src/app.ts（+3 行）
+
+       ▸ @reviewer — 审查改动（Reads: 01、02；写 03-reviewer-findings-r1.md）
+       ⚠ 1 个 MAJOR — 桶回充分两步读-改-写，并发下有竞态
+         → 已自动转为修复任务，发现原文随任务书派给 @implementer
+           （这一步没有要求用户拍板）
+
+       ▸ @implementer r2 — 修竞态（Reads: 03-r1 §MAJOR；写 04-implementer-r2.md）
+       ✓ 回充重构为单次原子更新
+
+       ▸ @reviewer r2 — 只复审改动范围
+       ✓ 通过 — r1 发现已解决，无回归
+
+       ▸ @tester — 覆盖限流器与边界（写 05-tester-report.md）
+       ✓ 14/14 通过 — 突发边界、窗口过期、并发回充、
+         src/legacy/** 逐字节未变（用户边界写进了测试断言）
+
+team   完成。
+       限流器已交付：rateLimit.ts（新增）· app.ts（+3）· 14 测试全绿
+       审查闭环：1 个 major → 已修 → 清零
+       假设：仅内存存储——要接 Redis 说一声
+       src/legacy/ 未动
+       任务黑板留在原地，TTL 到期自动回收
+```
+
+用户输入的消息只有第一条。reviewer 的发现直接变成 implementer 的下一张
+工单；每份制品都留在黑板上而不是聊天里，只被需要它的那次派发读取。
+
 ### 桌面版专属特性
 
 在 **OpenCode 桌面版** 中，你还能获得额外的 UX 体验：
@@ -212,24 +257,42 @@ opencode-team-mode/
 
 ## 🗂️ 共享黑板（带自动清理）
 
-子代理之间无法实时互发消息（平台限制），TeamMode 通过**文件黑板**让它们协作：
+子代理之间无法实时互发消息（平台限制），TeamMode 通过**严格所有权的文件黑板**让它们协作：
 
-- 每个多 Agent 任务在 `<repo>/.git/opencode-team/<task-slug>/` 下拥有独立目录 ——
+- **会话隔离：** 每个会话拥有一个时间戳会话目录，多 Agent 任务在其内再各自
+  独立建任务目录：`<repo>/.git/opencode-team/<session-key>/<task-slug>/` ——
   位于 `.git/` 内，**绝不污染**你的工作区和 commit（非 git 工作区自动回退到系统临时目录）。
-- 每个 Agent 把完整产出写入指定文件（`01-architect-design.md`、`03-review-findings.md`
-  等），Team Lead 在派发时传递*摘要 + 文件路径*，并维护 `MANIFEST.md` 索引。
-  全文档原文共享 —— 没有"传话失真"，还省 token。
+  正因为黑板现在会留到 TTL 清扫才消失，会话层让新对话几乎不可能撞上（或误读到）
+  上一场还没被收走的旧黑板 —— 时间戳精确到秒，理论上只有同一秒开跑的两个会话才会重名。
+- **文件所有权**：每个制品是一个"一主题一文件"，只由一个 Agent 写
+  （`01-architect-auth-design.md`、`03-reviewer-auth-r1.md`）。单文件约 ≤100 行，
+  超长就拆主题文件而不是任其膨胀。
+- **写入即冻结**：修订 = 新的轮次后缀文件（`…-r2.md`）；绝不追加旧文件，
+  后续 Agent 也永远读不到过时轮次。
+- **Team Lead 是路由器**：每次 dispatch 携带清单——`Task:`（自包含任务书）、
+  `Reads:`（仅列出该工作包需要的文件）、`Write to:`（该 Agent 本次拥有的唯一文件）。
+  子代理不读清单之外的任何东西，超长任务因此不会把无关上下文灌进子代理。
+- **`MANIFEST.md` 是 lead 的状态板**：文件索引 + 顶部 ≤50 行的 `## Current state`
+  节（阶段、仍然有效的决策、下一步），每轮闭环后更新——lead 跨长任务的压缩记忆。
 - Team Lead 同时强制执行审查/测试**反馈闭环**：Critical/Major 问题和产品 bug
   自动转化为跟踪的修复任务，直到交付物收敛。
 
-### 清理 —— 两层防御
+### Triage —— 提问不会变成代码修改
 
-| 层级 | 责任方 | 时机 |
-|---|---|---|
-| 快速路径 | Team Lead（prompt 规则） | 最终报告交付后立即删除任务目录 |
-| 安全网 | 插件代码（进程内清扫器） | 启动时 + 每小时：清除空闲超过 **TTL** 的任务目录 |
+Team Lead 对每条消息先分类再行动：咨询/提问只得到回答（零文件改动，发现缺陷
+仅**提议**修复并等待你放行）；只有明确的行动指令才进入工作流。并且一旦你写明
+了哪些能碰哪些不能碰，**这些边界高于一切规则**——lead 会在每次派发中原样重申。
 
-清扫器是纯代码实现 —— 从不依赖模型"记得删"，还能兜底清理崩溃/强杀留下的残骸。
+### 清理 —— 只有 TTL 清扫器一条路
+
+| 责任方 | 时机 |
+|---|---|
+| 插件代码（进程内清扫器） | 启动时 + 每小时：清除空闲超过 **TTL** 的任务目录 |
+
+Team Lead 不再删除任务目录 —— 跑完的黑板原地留给你回看审计；回收由纯代码
+完成，从不依赖模型"记得删"，崩溃/强杀留下的残骸同样会被清扫。清扫器对活跃
+会话内的过期任务逐个回收，对整个闲置的会话目录一次性收走。TTL 可用
+`ttlDays` 调节。
 
 ### 自定义 TTL
 
@@ -248,18 +311,26 @@ opencode-team-mode/
 
 ### 默认代理
 
-TeamMode 会将 **`team` 设为默认代理**（替代内建 `build`），新会话直接由团队
-调度者接管。若想保持 `build` 或其他代理为默认：
+TeamMode 默认**不再占用默认代理槽**——新会话仍从内建 `build` 开始。这是刻意的
+排序取舍：选择器会把**默认代理钉在第一位**，其余按名称字母升序，因此
+「Team 排默认（首位）」与「Team 显示在 Plan 之后」不可兼得。不占槽时顺序为
+**build, plan, team**。
+
+若希望新会话直接由团队调度者接管（Team 被钉在首位，顺序变为
+**team, build, plan**），开启 `defaultAgent`：
 
 ```jsonc
 {
   "plugin": [
-    ["@te-river/opencode-team-mode@latest", { "defaultAgent": false }]
+    ["@te-river/opencode-team-mode@latest", { "defaultAgent": true }]
   ]
 }
 ```
 
-用户显式配置的非 `build` 默认代理永远原样保留。
+即使用户显式配置了非 `build` 默认代理，也永远原样保留（开启与否都不覆写）。
+
+**升级提示**：自 v1.4.4 起，插件默认不再占用默认代理槽。此前依赖 Team 作为
+默认代理（v1.4.2+）的用户，请在插件选项中添加 `{ "defaultAgent": true }`。
 
 ---
 

package/dist/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAka7C,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAO9C,CAAA"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAqd7C,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAO9C,CAAA"}

package/dist/agents.js

@@ -17,21 +17,25 @@
  *  - Research findings carry confidence tags and critical ones are verified.
  */
 /* ------------------------------------------------------------------ */
-/*  Blackboard write guarantee (appended to every specialist prompt)   */
+/*  Blackboard rules (appended to every specialist prompt)   */
 /* ------------------------------------------------------------------ */
 const BLACKBOARD_GUARANTEE = `
 
-## Blackboard write guarantee
-- Writing your designated blackboard artifact is ALWAYS within your role.
-  Any read-only constraint applies to PROJECT SOURCES and the code under
-  review — NEVER to the blackboard directory. Your tools can write there;
-  do it yourself, in the file the dispatch names.
+## Blackboard rules
+- You own exactly ONE artifact file: the one named in your dispatch under
+  \`Write to:\`.  Create/overwrite only that file — never append to existing
+  artifacts, never edit files owned by other roles, never rewrite history.
+- Read ONLY the files listed in your dispatch's \`Reads:\`.  Do not browse
+  the task directory for "extra context" — the lead scoped your reading
+  deliberately, and unlisted rounds will only pollute your context.  If you
+  believe a needed file is missing from the list, say so in your reply
+  instead of opening files nobody authorized.
+- Writing your artifact is ALWAYS within your role: any read-only
+  constraint applies to PROJECT SOURCES and the code under review — NEVER
+  to the blackboard.  Your tools can write there; do it yourself.
 - NEVER reply "append this verbatim for me" or hand the full deliverable
   back to the dispatcher to transcribe — that defeats the entire point of
-  the blackboard. Reply with your summary + the file path, nothing else.
-- Read ONLY the blackboard files explicitly listed in your dispatch.  Do
-  not browse the task directory for "extra context" — the lead scoped the
-  reading deliberately, and stale rounds will only pollute yours.
+  the blackboard.  Summary + your file path is the only valid reply shape.
 - If a write genuinely fails (permissions, missing directory), start your
   reply with the line \`BLACKBOARD WRITE FAILED: <reason>\` and only then
   include the full content as fallback, so the lead can retry the write
@@ -52,6 +56,24 @@ const teamLead = {
 You orchestrate the team: decompose work, dispatch it to specialist agents
 via the Task tool, integrate their outputs, and enforce quality gates.
 
+## Triage — classify before acting (Step 0, always)
+- Question ≠ work order.  When the user asks, analyzes, or consults
+  ("why does X fail?", "how would we do Y?"), ANSWER it — read code if
+  useful, change nothing.  If answering needs external knowledge, dispatch
+  \`researcher\`; don't grind through it yourself.
+- Before any modification, ask explicitly: "does this request need file
+  changes?"  Anything weaker than a clear yes → touch zero files.
+- Spotted an obvious defect while answering?  Propose the fix and WAIT for
+  the go-ahead — never fix-on-the-sly.
+- Explicit action request ("fix X", "add Y", "refactor Z") → enter the
+  workflow below.
+- Genuinely ambiguous → one targeted question, then act.
+- USER-STATED BOUNDARIES ARE SUPREME: whenever the user details what may
+  be touched and what must not (files, modules, features), those limits
+  outrank every rule in this prompt.  Enforce them in your own work AND
+  restate them inside every dispatch; if a task seems to require crossing
+  one, stop and ask — do not "balance" the conflict yourself.
+
 ## Hard rule — TodoList discipline (non-negotiable)
 Before you touch anything on a medium-or-larger task you MUST create a todo
 list.  A task qualifies as medium-or-larger if ANY of these hold:
@@ -82,8 +104,9 @@ Rules for the list:
 4. **Integrate** — collect outputs, resolve conflicts, synthesize; consult
    blackboard files whenever a summary is not enough.
 5. **Verify** — run the feedback loop below before declaring done.
-6. **Report & clean up** — structured summary with changes, review/test
-   verdict, risks; then delete the task blackboard directory.
+6. **Report** — structured summary with changes, review/test verdict,
+   risks.  Leave the task directory in place: the plugin's TTL sweeper is
+   the only cleanup path (never delete it yourself).
 
 ## When you may edit directly
 Delegation is the default, not a straitjacket.  You MAY make small direct
@@ -91,36 +114,64 @@ edits: config tweaks, typo/format fixes, doc updates, tiny glue code
 (≲ 10 lines).  Anything substantive — feature logic, multi-file changes,
 API design — goes to \`implementer\`.
 
-## Shared blackboard (sub-agent coordination)
-Sub-agents cannot message each other live, so the team coordinates through a
-file blackboard (root path is appended at the end of this prompt):
-- When a task involves 2+ agents, create ONE task directory under the board
-  root: \`<root>/<task-slug>/\`.
-- Every dispatch must state: the task directory, the exact output file the
-  agent should write (e.g. \`01-architect-design.md\`), and which prior files
-  to read first.
-- Keep dispatches self-contained: include a 2–5 line summary of relevant
-  prior work in the text AND point to the blackboard file holding the full
-  content.  Summary-in-prompt + file-path is the belt-and-braces protocol —
-  never rely on an agent "knowing" what another produced.
-- Scope the reading: list ONLY the blackboard files the work package
-  actually needs (latest relevant round of each artifact) — never tell an
-  agent to "read everything in the directory".
-- When an artifact is revised, write a new round-suffixed file
-  (e.g. \`03-review-findings-r2.md\`) and reference only the latest round
-  in dispatches, so stale iterations never enter a sub-agent's context.
+Anti-pattern — the lead's own hands (observed in production): while
+building something, you drift into writing file after file yourself until
+the whole deliverable is done inline.  Guard rails:
+- If the request meets the medium-or-larger bar (see TodoList rule),
+  hand-execution is NOT permitted — every work package on the list gets
+  dispatched, including "small" ones you feel like knocking out.
+- Sunk cost is not a reason to continue: caught yourself mid-inline-build
+  on a multi-file package?  STOP, dispatch the remainder (or the whole
+  package for review), and treat what you wrote as input to the specialist,
+  not as a fait accompli.
+- A complete feature never arrives in the lead's own diffs.  If your final
+  report would say "I wrote X, Y, Z" — that is a triage failure, not
+  efficiency.
+
+## Shared blackboard (file ownership + your dispatch manifest)
+Sub-agents cannot message each other live; the blackboard is their shared
+memory and YOU are the router — you decide who writes what and who reads
+what (root path is appended at the end of this prompt):
+- SESSION ISOLATION: this conversation owns exactly ONE session folder
+  \`<root>/<session-key>/\` (compact clock timestamp, created on your first
+  board write, reused for every later task here — see the resolved-root
+  section).  Never touch or reuse a session folder another conversation
+  created; boards past their TTL stay on disk until the sweeper runs, and
+  the session layer is what keeps a fresh run from bumping into them.
+- One task directory per multi-agent task: \`<root>/<session-key>/<task-slug>/\`.
+- FILE OWNERSHIP — every artifact is one topic-sized file written by
+  exactly one agent: \`NN-<role>-<topic>.md\` (e.g.
+  \`01-architect-auth-design.md\`, \`03-reviewer-auth-r1.md\`).  Keep files
+  ~100 lines or less; when an artifact grows past that, split it into
+  topic files instead of letting it bloat.
+- WRITES ARE FROZEN — a revision is a NEW file with a round suffix
+  (\`02-implementer-auth-r2.md\`).  Never append to an existing artifact,
+  and reference only the latest round in later dispatches, so stale
+  iterations never enter a sub-agent's context.
+- Every dispatch must carry a manifest (all fields required):
+    Task:      self-contained description, with a 2–5 line summary of the
+               prior work it builds on (summary-in-prompt + file paths is
+               the belt-and-braces protocol)
+    Reads:     ONLY the files this work package needs — never "read
+               everything in the directory"
+    Write to:  the one new file this agent owns for this package
+  If the user stated boundaries, restate them in the dispatch text too.
+- MANIFEST.md is yours alone: a file index (one line per artifact — file,
+  owner, status, one-line summary) topped by a \`## Current state\` section
+  of ≤ 50 lines (phase, decisions still valid, next steps).  Update it
+  after every converged round — it is your compressed memory across long
+  tasks.  Do not put it on specialists' Reads lists unless one genuinely
+  needs the index.
 - Sub-agents reply with a summary plus their file path; read the file
   yourself when you need detail, then relay the relevant parts onward.
 - A specialist asking you to transcribe its output verbatim is a protocol
   violation — send it back to write the file itself.  Only if its reply
   contains \`BLACKBOARD WRITE FAILED\` may you write the artifact as a
   fallback; note the failure in MANIFEST.md so it is not silently tolerated.
-- Maintain \`MANIFEST.md\` in the task directory: one line per artifact
-  (file — role — status — one-line summary).
-- After you deliver the final report, DELETE the task directory (use the
-  platform-appropriate command).  The plugin also auto-sweeps directories
-  idle beyond the TTL — your deletion is the fast path, the sweeper is the
-  safety net.
+- Do NOT delete the task directory after your report — TTL sweeping owns
+  reclamation (see Auto-cleanup in the resolved-root section).  Finished
+  boards stay readable so the user can audit the run; leftovers from
+  crashed sessions sweep the same way.
 
 ## Feedback loop (mandatory before "done")
 - Triage reviewer findings: **Critical/Major → spawn fix tasks** on the todo
@@ -214,7 +265,7 @@ When the team lead sends back a design flaw found in review or testing:
 `,
     color: "#38BDF8", // sky blue
     // Read-only on PROJECT sources; the blackboard artifact is explicitly
-    // writable (see Blackboard write guarantee).
+    // writable (see Blackboard rules).
     permission: { edit: "allow", bash: "deny", webfetch: "allow" },
 };
 /* ------------------------------------------------------------------ */
@@ -310,7 +361,7 @@ by item (fixed / not fixed / partial).
 `,
     color: "#FB923C", // orange
     // May edit ONLY the blackboard artifact; never the reviewed code
-    // (see Blackboard write guarantee + role rules).
+    // (see Blackboard rules + role rules).
     permission: { edit: "allow", bash: "allow", webfetch: "allow" },
 };
 /* ------------------------------------------------------------------ */
@@ -410,7 +461,7 @@ by the team — flag prominently if that is the case.
     color: "#A78BFA", // violet
     permission: { edit: "allow", bash: "allow", webfetch: "allow", websearch: "allow" },
 };
-/* Append the blackboard write guarantee to every specialist prompt. */
+/* Append the blackboard rules to every specialist prompt. */
 for (const a of [architect, implementer, reviewer, tester, researcher]) {
     a.prompt = (a.prompt ?? "") + BLACKBOARD_GUARANTEE;
 }

package/dist/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"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"}

package/dist/blackboard.d.ts

@@ -2,12 +2,17 @@
  * Shared blackboard for sub-agent coordination + automatic maintenance.
  *
  * Sub-agents cannot message each other live (platform limitation), so
- * TeamMode uses a file blackboard under `<repo>/.git/opencode-team/<task>/`:
+ * TeamMode uses a file blackboard under
+ * `<repo>/.git/opencode-team/<session-key>/<task>/`:
+ *  - <session-key> is a compact timestamp folder, one per conversation —
+ *    a fresh conversation can never collide with a not-yet-swept board
+ *    from an earlier one;
  *  - each agent writes its full deliverable to a designated file;
  *  - the team lead relays summaries + file paths in every dispatch;
- *  - the team lead deletes the task directory when the workflow ends.
+ *  - nobody deletes task directories by hand; the sweeper below reclaims
+ *    them once idle past the TTL (sole cleanup path, by design).
  *
- * This module is the code-level safety net independent of the model:
+ * This module is the code-level reclamation path, independent of the model:
  * a sweeper removes task directories whose last activity is older than
  * the TTL, at plugin startup and hourly in-process.  Placing the board
  * inside `.git/` guarantees the user's working tree and commits are never
@@ -31,8 +36,16 @@ export declare function teamRootFor(directory: string): string;
  */
 export declare function resolveTtlMs(options?: Record<string, unknown>): number;
 /**
- * Remove idle task directories under `root`.
- * Returns the number of directories deleted; never throws.
+ * Remove idle boards under `root`.  Understands both layouts:
+ *  - session-partitioned `<root>/<session-key>/<task>/`: stale tasks are
+ *    pruned individually under a live session; an entirely idle session
+ *    folder goes as a whole;
+ *  - legacy flat `<root>/<task>/`: unchanged semantics — and if such a dir
+ *    unexpectedly contains sub-directories, idle ones are pruned by the
+ *    same rule (harmless hygiene, though counted as task dirs).
+ * Returns the number of task directories reclaimed; a wholesale session
+ * removal counts its task dirs (min 1, so a ghost empty stale session dir
+ * also counts 1).  Never throws.
  */
 export declare function sweepStale(root: string, ttlMs?: number): number;
 /**

package/dist/blackboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blackboard.d.ts","sourceRoot":"","sources":["../src/blackboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,IAAI,CAAA;AACjC,eAAO,MAAM,cAAc,QAAyC,CAAA;AAQpE,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQzD;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,CAM1E;AAoBD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAiB,GAAG,MAAM,CAwBvE;AAID;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,KAAK,SAAiB,GACrB,MAAM,CASR"}
+{"version":3,"file":"blackboard.d.ts","sourceRoot":"","sources":["../src/blackboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAMH,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,IAAI,CAAA;AACjC,eAAO,MAAM,cAAc,QAAyC,CAAA;AAQpE,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQzD;AAED,gDAAgD;AAChD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,CAM1E;AAuCD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAiB,GAAG,MAAM,CA6CvE;AAID;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,KAAK,SAAiB,GACrB,MAAM,CASR"}

package/dist/blackboard.js

@@ -2,12 +2,17 @@
  * Shared blackboard for sub-agent coordination + automatic maintenance.
  *
  * Sub-agents cannot message each other live (platform limitation), so
- * TeamMode uses a file blackboard under `<repo>/.git/opencode-team/<task>/`:
+ * TeamMode uses a file blackboard under
+ * `<repo>/.git/opencode-team/<session-key>/<task>/`:
+ *  - <session-key> is a compact timestamp folder, one per conversation —
+ *    a fresh conversation can never collide with a not-yet-swept board
+ *    from an earlier one;
  *  - each agent writes its full deliverable to a designated file;
  *  - the team lead relays summaries + file paths in every dispatch;
- *  - the team lead deletes the task directory when the workflow ends.
+ *  - nobody deletes task directories by hand; the sweeper below reclaims
+ *    them once idle past the TTL (sole cleanup path, by design).
  *
- * This module is the code-level safety net independent of the model:
+ * This module is the code-level reclamation path, independent of the model:
  * a sweeper removes task directories whose last activity is older than
  * the TTL, at plugin startup and hourly in-process.  Placing the board
  * inside `.git/` guarantees the user's working tree and commits are never
@@ -57,15 +62,21 @@ export function resolveTtlMs(options = {}) {
     }
     return DEFAULT_TTL_MS;
 }
-/** Latest mtime among a directory and its immediate entries. */
-function lastActivity(dir) {
+/**
+ * Latest mtime within `dir`, looking through up to `levels` sub-directory
+ * layers (artifacts live one level below a task dir, so 1 suffices per
+ * task and 2 from the session/root level).
+ */
+function lastActivity(dir, levels = 0) {
     try {
         let latest = fs.statSync(dir).mtimeMs;
         for (const entry of fs.readdirSync(dir)) {
             try {
-                const st = fs.statSync(path.join(dir, entry));
-                if (st.mtimeMs > latest)
-                    latest = st.mtimeMs;
+                const child = path.join(dir, entry);
+                const st = fs.statSync(child);
+                const seen = st.isDirectory() && levels > 0 ? lastActivity(child, levels - 1) : st.mtimeMs;
+                if (seen > latest)
+                    latest = seen;
             }
             catch {
                 /* raced deletion — ignore */
@@ -78,8 +89,27 @@ function lastActivity(dir) {
     }
 }
 /**
- * Remove idle task directories under `root`.
- * Returns the number of directories deleted; never throws.
+ * True when a directory tree shows no activity within the TTL.
+ * `levels` must reach down to the artifact files: 1 for a task directory
+ * (files sit directly inside), 2 for a session directory (task dirs are
+ * one level deeper — depth 1 here would miss in-place rewrites and let a
+ * whole live session be reclaimed; regression-pinned by test fixture).
+ */
+function isStale(dir, now, ttlMs, levels) {
+    const seen = lastActivity(dir, levels);
+    return seen !== 0 && now - seen > ttlMs;
+}
+/**
+ * Remove idle boards under `root`.  Understands both layouts:
+ *  - session-partitioned `<root>/<session-key>/<task>/`: stale tasks are
+ *    pruned individually under a live session; an entirely idle session
+ *    folder goes as a whole;
+ *  - legacy flat `<root>/<task>/`: unchanged semantics — and if such a dir
+ *    unexpectedly contains sub-directories, idle ones are pruned by the
+ *    same rule (harmless hygiene, though counted as task dirs).
+ * Returns the number of task directories reclaimed; a wholesale session
+ * removal counts its task dirs (min 1, so a ghost empty stale session dir
+ * also counts 1).  Never throws.
  */
 export function sweepStale(root, ttlMs = DEFAULT_TTL_MS) {
     let entries;
@@ -96,12 +126,37 @@ export function sweepStale(root, ttlMs = DEFAULT_TTL_MS) {
         try {
             if (!fs.statSync(dir).isDirectory())
                 continue;
-            const seen = lastActivity(dir);
-            if (seen === 0)
-                continue;
-            if (now - seen > ttlMs) {
+            if (isStale(dir, now, ttlMs, 2)) {
+                // Entire tree idle: legacy flat task dir, or a finished session.
+                let tasks = 0;
+                for (const child of fs.readdirSync(dir)) {
+                    try {
+                        if (fs.statSync(path.join(dir, child)).isDirectory())
+                            tasks++;
+                    }
+                    catch {
+                        /* raced — ignore */
+                    }
+                }
                 fs.rmSync(dir, { recursive: true, force: true });
-                removed++;
+                removed += Math.max(1, tasks);
+                continue;
+            }
+            // Live tree: prune per-task dirs (session layout; legacy dirs have
+            // no directory children, so this loop is a no-op for them).
+            for (const child of fs.readdirSync(dir)) {
+                const task = path.join(dir, child);
+                try {
+                    if (!fs.statSync(task).isDirectory())
+                        continue;
+                    if (!isStale(task, now, ttlMs, 1))
+                        continue;
+                    fs.rmSync(task, { recursive: true, force: true });
+                    removed++;
+                }
+                catch {
+                    /* raced — skip this task */
+                }
             }
         }
         catch {

package/dist/blackboard.js.map

@@ -1 +1 @@
-{"version":3,"file":"blackboard.js","sourceRoot":"","sources":["../src/blackboard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"blackboard.js","sourceRoot":"","sources":["../src/blackboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA;AAC7B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAA;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAEpE,gCAAgC;AAChC,MAAM,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;AAExC,4EAA4E;AAC5E,MAAM,SAAS,GAAG,eAAe,CAAA;AAEjC,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7B,SAAS,CAAC;QACR,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAAE,OAAO,GAAG,CAAA;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAChC,IAAI,MAAM,KAAK,GAAG;YAAE,OAAO,IAAI,CAAA;QAC/B,GAAG,GAAG,MAAM,CAAA;IACd,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAA;IACzD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAAmC,EAAE;IAChE,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,iBAAiB,CAAA;IACxD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QAC7E,OAAO,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IAClC,CAAC;IACD,OAAO,cAAc,CAAA;AACvB,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,GAAW,EAAE,MAAM,GAAG,CAAC;IAC3C,IAAI,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,CAAA;QACrC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;gBACnC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;gBAC7B,MAAM,IAAI,GACR,EAAE,CAAC,WAAW,EAAE,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAA;gBAC/E,IAAI,IAAI,GAAG,MAAM;oBAAE,MAAM,GAAG,IAAI,CAAA;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAA;IACV,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,OAAO,CAAC,GAAW,EAAE,GAAW,EAAE,KAAa,EAAE,MAAc;IACtE,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACtC,OAAO,IAAI,KAAK,CAAC,IAAI,GAAG,GAAG,IAAI,GAAG,KAAK,CAAA;AACzC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAK,GAAG,cAAc;IAC7D,IAAI,OAAiB,CAAA;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAA,CAAC,6CAA6C;IACxD,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACtB,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QAClC,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;gBAAE,SAAQ;YAC7C,IAAI,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC;gBAChC,iEAAiE;gBACjE,IAAI,KAAK,GAAG,CAAC,CAAA;gBACb,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxC,IAAI,CAAC;wBACH,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE;4BAAE,KAAK,EAAE,CAAA;oBAC/D,CAAC;oBAAC,MAAM,CAAC;wBACP,oBAAoB;oBACtB,CAAC;gBACH,CAAC;gBACD,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;gBAChD,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;gBAC7B,SAAQ;YACV,CAAC;YACD,mEAAmE;YACnE,4DAA4D;YAC5D,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;gBAClC,IAAI,CAAC;oBACH,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE;wBAAE,SAAQ;oBAC9C,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;wBAAE,SAAQ;oBAC3C,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;oBACjD,OAAO,EAAE,CAAA;gBACX,CAAC;gBAAC,MAAM,CAAC;oBACP,4BAA4B;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,IAAI,kBAAkB,GAAG,KAAK,CAAA;AAE9B;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,SAAiB,EACjB,KAAK,GAAG,cAAc;IAEtB,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,CAAC,CAAA;IACnC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,kBAAkB,GAAG,IAAI,CAAA;QACzB,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACvB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,iBAAiB,CAAC,CAAA;QAC3E,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU;YAAE,KAAK,CAAC,KAAK,EAAE,CAAA;IACtD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAwI/C,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAOlD,CAAA"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AA8I/C,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAOlD,CAAA"}

package/dist/commands.js

@@ -101,27 +101,33 @@ const teamRun = {
 $ARGUMENTS
 
 ## Workflow
-1. Understand the goal and acceptance criteria.
-2. **Create a todo list FIRST** — one item per work package, with checkable
+1. Triage first: if this is a question/consult rather than an action
+   request, answer it without touching files (propose fixes, wait for a
+   go-ahead).  Honor and restate any user-stated boundaries everywhere.
+2. Understand the goal and acceptance criteria.
+3. **Create a todo list FIRST** — one item per work package, with checkable
    done-conditions.  Update statuses live (exactly one in_progress).
-3. Dispatch sub-tasks to the appropriate agents:
+4. Dispatch sub-tasks to the appropriate agents:
    - Design / architecture → architect
    - Implementation → implementer
    - Code review → reviewer
    - Testing → tester
    - Research → researcher
-   Each dispatch must be self-contained (embed relevant prior outputs).
-4. For multi-agent work, coordinate through the shared blackboard: create
-   one task directory, have each agent write its full deliverable there,
-   and relay summary + file path in every dispatch.  Run independent
-   sub-tasks in parallel.
-5. Enforce the feedback loop: reviewer Critical/Major findings and tester
+5. Coordinate through the shared blackboard: this conversation owns one
+   session folder (<root>/<session-key>/ — compact timestamp, created on
+   first board write), one task directory per task inside it; every
+   dispatch carries a manifest (Task / Reads: only the files needed /
+   Write to: one owned artifact file); artifacts are frozen — revisions are
+   new round-suffixed files; keep MANIFEST.md's \`## Current state\` header
+   updated each converged round.  Run independent sub-tasks in parallel.
+6. Enforce the feedback loop: reviewer Critical/Major findings and tester
    product-bugs become fix tasks on the list → implementer fixes → re-review
    affected scope → re-run tests.  Repeat until clean (max 2 loops, then
    escalate).
-6. Collect all outputs, resolve conflicts, synthesize a final result.
-7. Present a structured summary: changes, review/test verdict, remaining
-   assumptions and risks.  Then delete the task blackboard directory.`,
+7. Collect all outputs, resolve conflicts, synthesize a final result.
+8. Present a structured summary: changes, review/test verdict, remaining
+   assumptions and risks.  Leave the task blackboard directory in place —
+   the plugin's TTL sweeper reclaims idle boards; never delete it yourself.`,
 };
 /* ------------------------------------------------------------------ */
 /*  Export all commands keyed by name                                 */

package/dist/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wEAAwE;AACxE,MAAM,QAAQ,GAAkB;IAC9B,WAAW,EACT,+FAA+F;IACjG,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE;;;;;;;;;;;;;kDAasC;CACjD,CAAA;AAED,wEAAwE;AACxE,MAAM,aAAa,GAAkB;IACnC,WAAW,EACT,0FAA0F;IAC5F,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE;;;;;;;;4DAQgD;CAC3D,CAAA;AAED,wEAAwE;AACxE,MAAM,UAAU,GAAkB;IAChC,WAAW,EACT,0EAA0E;IAC5E,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE;;;;;;;;;;;;;gEAaoD;CAC/D,CAAA;AAED,wEAAwE;AACxE,MAAM,QAAQ,GAAkB;IAC9B,WAAW,EACT,2EAA2E;IAC7E,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE;;;;;;;;;;;8BAWkB;CAC7B,CAAA;AAED,wEAAwE;AACxE,MAAM,YAAY,GAAkB;IAClC,WAAW,EACT,uEAAuE;IACzE,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE;;;;;;;;;;;0DAW8C;CACzD,CAAA;AAED,wEAAwE;AACxE,MAAM,OAAO,GAAkB;IAC7B,WAAW,EACT,mGAAmG;IACrG,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;sEA0B0D;CACrE,CAAA;AAED,wEAAwE;AACxE,wEAAwE;AACxE,wEAAwE;AAExE,MAAM,CAAC,MAAM,QAAQ,GAAkC;IACrD,WAAW,EAAE,QAAQ;IACrB,gBAAgB,EAAE,aAAa;IAC/B,aAAa,EAAE,UAAU;IACzB,WAAW,EAAE,QAAQ;IACrB,eAAe,EAAE,YAAY;IAC7B,UAAU,EAAE,OAAO;CACpB,CAAA"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,wEAAwE;AACxE,MAAM,QAAQ,GAAkB;IAC9B,WAAW,EACT,+FAA+F;IACjG,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE;;;;;;;;;;;;;kDAasC;CACjD,CAAA;AAED,wEAAwE;AACxE,MAAM,aAAa,GAAkB;IACnC,WAAW,EACT,0FAA0F;IAC5F,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE;;;;;;;;4DAQgD;CAC3D,CAAA;AAED,wEAAwE;AACxE,MAAM,UAAU,GAAkB;IAChC,WAAW,EACT,0EAA0E;IAC5E,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE;;;;;;;;;;;;;gEAaoD;CAC/D,CAAA;AAED,wEAAwE;AACxE,MAAM,QAAQ,GAAkB;IAC9B,WAAW,EACT,2EAA2E;IAC7E,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE;;;;;;;;;;;8BAWkB;CAC7B,CAAA;AAED,wEAAwE;AACxE,MAAM,YAAY,GAAkB;IAClC,WAAW,EACT,uEAAuE;IACzE,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE;;;;;;;;;;;0DAW8C;CACzD,CAAA;AAED,wEAAwE;AACxE,MAAM,OAAO,GAAkB;IAC7B,WAAW,EACT,mGAAmG;IACrG,KAAK,EAAE,MAAM;IACb,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EAgCgE;CAC3E,CAAA;AAED,wEAAwE;AACxE,wEAAwE;AACxE,wEAAwE;AAExE,MAAM,CAAC,MAAM,QAAQ,GAAkC;IACrD,WAAW,EAAE,QAAQ;IACrB,gBAAgB,EAAE,aAAa;IAC/B,aAAa,EAAE,UAAU;IACzB,WAAW,EAAE,QAAQ;IACrB,eAAe,EAAE,YAAY;IAC7B,UAAU,EAAE,OAAO;CACpB,CAAA"}

package/dist/index.d.ts

@@ -17,8 +17,13 @@
  * 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 (replacing the
- *                    built-in `build`); set `false` to opt out.
+ * - `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).
  */
 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;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,YAAY,CAAA;AAsBhE,QAAA,MAAM,MAAM,EAAE,cAyCb,CAAA;AAED,eAAe,MAAM,CAAA"}
+{"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"}

package/dist/index.js

@@ -17,8 +17,13 @@
  * 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 (replacing the
- *                    built-in `build`); set `false` to opt out.
+ * - `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).
  */
 import { agents } from "./agents.js";
 import { commands } from "./commands.js";
@@ -30,9 +35,14 @@ function blackboardNote(root, ttlDays) {
         "",
         "## Team Blackboard — resolved for this workspace",
         `Root directory: \`${root}\``,
-        `- Create exactly ONE task sub-directory per multi-agent task: \`<root>/<task-slug>/\`.`,
-        `- Auto-cleanup: the plugin sweeps task directories idle for more than ${ttlDays} days.`,
-        `  Your own delete-after-report is the fast path; the sweep is the safety net.`,
+        `- Session isolation: on the FIRST board write of this conversation create a session`,
+        `  folder \`<root>/<session-key>/\` where <session-key> is a compact clock timestamp`,
+        `  (PowerShell: \`Get-Date -Format yyyyMMdd-HHmmss\`; POSIX: \`date +%Y%m%d-%H%M%S\`).`,
+        `  Reuse that folder for every later task in the same conversation; never write into`,
+        `  a session folder created by a different conversation.`,
+        `- Create exactly ONE task sub-directory per multi-agent task: \`<root>/<session-key>/<task-slug>/\`.`,
+        `- Auto-cleanup: the plugin sweeps task directories idle for more than ${ttlDays} days (at startup and hourly).`,
+        `  This is the ONLY cleanup path — never delete task or session directories yourself.`,
     ].join("\n");
 }
 const plugin = {
@@ -67,8 +77,8 @@ const plugin = {
                         continue;
                     cfg.command[name] = def;
                 }
-                // ---------- make Team the default agent (opt-out: defaultAgent:false)
-                const promote = options?.defaultAgent !== false;
+                // ---------- make Team the default agent (opt-in: defaultAgent:true)
+                const promote = options?.defaultAgent === true;
                 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;;;;;;;;;;;;;;;;;;;;;GAqBG;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,wFAAwF;QACxF,yEAAyE,OAAO,QAAQ;QACxF,+EAA+E;KAChF,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@te-river/opencode-team-mode",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "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",