diff --git a/README.md b/README.md
index f496be07..678605b7 100644
--- a/README.md
+++ b/README.md
@@ -783,9 +783,19 @@ That is the entire interface. No curl, no endpoint names, no session ids. These
| _"Have a claude worker on `refactor-auth` summarize `src/session.ts`, then close it."_ | Spawns, runs the readiness ladder (first-run trust dialog included), send-and-wait, reads the clean transcript answer, deletes. |
| _"Watch session w4 and tell me if it gets stuck on a permission prompt."_ | Blocks on the `blocked` signal and surfaces the question to **you**. It never answers another session's prompt itself. |
+One short line is enough. Here a Claude Code lead gets `use codeman to start 5 claude workers, one per TODO item`, and five real Claude Code workers power on, shown side by side in the tile grid:
+
+
+
+
+
#### Step 3: nothing
-The agent deletes every session it started. Watch the tabs appear and disappear in the dashboard while it works.
+The agent deletes every session it started. Watch the tabs appear and disappear in the dashboard while it works. With eight workers, each one gets its own tab, and a lineage line runs back to the lead that spawned it:
+
+
+
+
#### A real run, start to finish
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 38dd8e25..5c47f989 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -785,9 +785,19 @@ Web UI 仍是主要界面;完整指南见 **[docs/tui.md](docs/tui.md)**(英
| _「让一个 claude 工作会话在 `refactor-auth` 上总结 `src/session.ts`,然后关掉它。」_ | 拉起、走完就绪阶梯(包括首次运行的信任对话框)、发送并等待、读取干净的 transcript 答案、删除。 |
| _「盯着会话 w4,如果它卡在权限提示上就告诉我。」_ | 阻塞在 `blocked` 信号上,并把问题交给**你**。它绝不会替另一个会话回答提示。 |
+一句简短的话就够了。下面这个 Claude Code 主会话收到 `use codeman to start 5 claude workers, one per TODO item`,五个真实的 Claude Code 工作会话依次开机,并排显示在平铺网格里:
+
+
+
+
+
#### 第 3 步:没有了
-智能体会删掉它启动的每一个会话。你可以在仪表盘里看着标签出现又消失。
+智能体会删掉它启动的每一个会话。你可以在仪表盘里看着标签出现又消失。起八个工作会话时,每个都有自己的标签,还有一条派生连线连回启动它的主会话:
+
+
+
+
#### 一次真实的运行,从头到尾
diff --git a/docs/images/codeman-skill-grid-20261015.gif b/docs/images/codeman-skill-grid-20261015.gif
new file mode 100644
index 00000000..65147a02
Binary files /dev/null and b/docs/images/codeman-skill-grid-20261015.gif differ
diff --git a/docs/images/codeman-skill-tabs-20261015.gif b/docs/images/codeman-skill-tabs-20261015.gif
new file mode 100644
index 00000000..f480943f
Binary files /dev/null and b/docs/images/codeman-skill-tabs-20261015.gif differ
diff --git a/docs/media-assets.md b/docs/media-assets.md
index fab60f35..891b5660 100644
--- a/docs/media-assets.md
+++ b/docs/media-assets.md
@@ -27,6 +27,8 @@ A GIF that leaves `docs/images/` stays in git history, so removing it does not s
| `zerolag-demo-20260728.gif` | README, wiki `Input-And-Voice`, `packages/xterm-zerolag-input/README.md`, CHANGELOG, getcodeman.com docs | instant local echo next to slow server echo, on two phones |
| `codeman-tab-states-20261010.gif` | README, Tab Alerts section | annotated tab states: working, blocked on a question, idle |
| `codeman-skill-crt-20261010.gif` | README, agent skill section | one prompt to Claude Code spawning and driving two worker sessions through the skill |
+| `codeman-skill-grid-20261015.gif` | README, agent skill section (Step 2) | one prompt to a Claude Code lead, five Claude Code workers powering on as tiles in the grid |
+| `codeman-skill-tabs-20261015.gif` | README, agent skill section (Step 3) | one prompt to a Claude Code lead, eight worker tabs powering on with lineage lines, then a click into a live worker |
| `subagent-demo-20260724.gif` | the "mission control" article on dev.to, Hashnode and Medium (hotlinked from `master`) | subagent windows fanning out |
Before removing one, search for hotlinks: `README*.md`, `docs/wiki/`, `packages/*/README.md`, `CHANGELOG.md`, the site (`pr/website/`), and published articles, which link `raw.githubusercontent.com/Ark0N/Codeman/master/docs/images/` and break silently.
@@ -36,7 +38,7 @@ On 2026-10-13, seven GIFs that no page embedded left `docs/images/` and moved in
### Adding or replacing a README GIF
1. Keep the master (the lossless MP4 or the full-size GIF) in `pr/media/clips//`, or in the project folder it came from.
-2. Commit only the size the README shows, named `-.gif`, and keep it lean: the current ones are 0.8 to 7 MB.
+2. Commit only the size the README shows, named `-.gif`, and keep it lean: the current ones are 0.8 to 10 MB.
3. A replaced GIF leaves `docs/images/` in the same commit, unless something outside the repo hotlinks it (see above).
## Website media (getcodeman.com)