feat: skills - render auto-tmux swarm board

skills/auto-tmux/AGENTS.md

@@ -17,6 +17,7 @@ skills/auto-tmux/
 │   ├── swarm-brief.sh
 │   ├── swarm-watch.sh
 │   ├── swarm-archive.sh
+│   ├── swarm-board.sh
 │   ├── safety-check.sh
 │   ├── render-swarm-prompt.sh
 │   ├── swarm-dispatch.sh
@@ -45,6 +46,7 @@ skills/auto-tmux/
 - `scripts/swarm-brief.sh` 是只读交接层，汇总 doctor/topology/scan/report 形成上下文快照。
 - `scripts/swarm-watch.sh` 是有限轮次巡检层，按间隔采集 pane 输出与 swarm report。
 - `scripts/swarm-archive.sh` 是归档层，打包 brief、snapshot 和 swarm state 供复盘交接。
+- `scripts/swarm-board.sh` 是看板层，将任务、依赖、锁和状态日志渲染为 Markdown。
 - `scripts/safety-check.sh` 是安全预检层，检查待发送 payload 的危险命令、敏感信息和大小。
 - `scripts/render-swarm-prompt.sh` 是提示词渲染层，生成 commander/worker/reviewer 协议文本。
 - `scripts/swarm-dispatch.sh` 是提示词下发层，默认写文件，显式 `--send` 后才发送到 pane。
@@ -57,4 +59,4 @@ skills/auto-tmux/
 - 上游来源：`tools/external/.tmux` 与 `tools/external/tmux`。
 - 下游使用：`SKILL.md` 和 `references/` 中的命令示例。
 - 验证入口：`skills/auto-skill/scripts/validate-skill.sh skills/auto-tmux --strict`。
-- 脚本验证：`skills/auto-tmux/scripts/validate-auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/swarm-state.sh`、`bash -n skills/auto-tmux/scripts/swarm-brief.sh`、`bash -n skills/auto-tmux/scripts/swarm-watch.sh`、`bash -n skills/auto-tmux/scripts/swarm-archive.sh`、`bash -n skills/auto-tmux/scripts/safety-check.sh`、`bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh`、`bash -n skills/auto-tmux/scripts/swarm-dispatch.sh`、`skills/auto-tmux/scripts/auto-tmux-smoke-test.sh`。
+- 脚本验证：`skills/auto-tmux/scripts/validate-auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/swarm-state.sh`、`bash -n skills/auto-tmux/scripts/swarm-brief.sh`、`bash -n skills/auto-tmux/scripts/swarm-watch.sh`、`bash -n skills/auto-tmux/scripts/swarm-archive.sh`、`bash -n skills/auto-tmux/scripts/swarm-board.sh`、`bash -n skills/auto-tmux/scripts/safety-check.sh`、`bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh`、`bash -n skills/auto-tmux/scripts/swarm-dispatch.sh`、`skills/auto-tmux/scripts/auto-tmux-smoke-test.sh`。

skills/auto-tmux/README.md

@@ -24,6 +24,7 @@ bash -n skills/auto-tmux/scripts/swarm-state.sh
 bash -n skills/auto-tmux/scripts/swarm-brief.sh
 bash -n skills/auto-tmux/scripts/swarm-watch.sh
 bash -n skills/auto-tmux/scripts/swarm-archive.sh
+bash -n skills/auto-tmux/scripts/swarm-board.sh
 bash -n skills/auto-tmux/scripts/safety-check.sh
 bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh
 bash -n skills/auto-tmux/scripts/swarm-dispatch.sh

skills/auto-tmux/SKILL.md

@@ -38,6 +38,7 @@ bash -n skills/auto-tmux/scripts/swarm-state.sh
 bash -n skills/auto-tmux/scripts/swarm-brief.sh
 bash -n skills/auto-tmux/scripts/swarm-watch.sh
 bash -n skills/auto-tmux/scripts/swarm-archive.sh
+bash -n skills/auto-tmux/scripts/swarm-board.sh
 bash -n skills/auto-tmux/scripts/safety-check.sh
 bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh
 bash -n skills/auto-tmux/scripts/swarm-dispatch.sh
@@ -117,6 +118,7 @@ skills/auto-tmux/scripts/auto-tmux.sh snapshot --session ai-hub --dir /tmp/auto-
 skills/auto-tmux/scripts/swarm-brief.sh --session ai-hub --swarm-dir /tmp/ai_swarm --out /tmp/auto-tmux-brief
 skills/auto-tmux/scripts/swarm-watch.sh --session ai-hub --swarm-dir /tmp/ai_swarm --iterations 3 --interval 10
 skills/auto-tmux/scripts/swarm-archive.sh --session ai-hub --swarm-dir /tmp/ai_swarm --out /tmp/ai-hub-handoff.tar.gz
+skills/auto-tmux/scripts/swarm-board.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-board.md
 ```
 
 **远程救援：发现等待输入即发送 y**
@@ -259,6 +261,7 @@ skills/auto-tmux/scripts/swarm-dispatch.sh --role worker --target <session>:<win
 - `scripts/swarm-brief.sh`: 只读生成 tmux 蜂群交接报告
 - `scripts/swarm-watch.sh`: 有限轮次巡检 tmux 蜂群输出和状态报告
 - `scripts/swarm-archive.sh`: 打包 brief、snapshot 和 swarm state 的交接归档
+- `scripts/swarm-board.sh`: 渲染任务、依赖、锁和状态日志的 Markdown 看板
 - `scripts/safety-check.sh`: 发送/粘贴/分发前检查危险命令、敏感信息和过大 payload
 - `scripts/render-swarm-prompt.sh`: commander/worker/reviewer 提示词渲染脚本
 - `scripts/swarm-dispatch.sh`: 渲染并可选下发 commander/worker/reviewer 提示词
@@ -282,6 +285,6 @@ skills/auto-tmux/scripts/swarm-dispatch.sh --role worker --target <session>:<win
 4. ≥3 个端到端示例，含输入/步骤/验收。
 5. 长文档放在 `references/` 并可导航；无文档堆砌。
 6. 不确定项给出验证路径；禁止虚构 tmux 行为。
-7. `bash -n skills/auto-tmux/scripts/auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/swarm-state.sh`、`bash -n skills/auto-tmux/scripts/swarm-brief.sh`、`bash -n skills/auto-tmux/scripts/swarm-watch.sh`、`bash -n skills/auto-tmux/scripts/swarm-archive.sh`、`bash -n skills/auto-tmux/scripts/safety-check.sh`、`bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh`、`bash -n skills/auto-tmux/scripts/swarm-dispatch.sh` 与 `bash -n skills/auto-tmux/scripts/validate-auto-tmux.sh` 通过。
+7. `bash -n skills/auto-tmux/scripts/auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/swarm-state.sh`、`bash -n skills/auto-tmux/scripts/swarm-brief.sh`、`bash -n skills/auto-tmux/scripts/swarm-watch.sh`、`bash -n skills/auto-tmux/scripts/swarm-archive.sh`、`bash -n skills/auto-tmux/scripts/swarm-board.sh`、`bash -n skills/auto-tmux/scripts/safety-check.sh`、`bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh`、`bash -n skills/auto-tmux/scripts/swarm-dispatch.sh` 与 `bash -n skills/auto-tmux/scripts/validate-auto-tmux.sh` 通过。
 8. `skills/auto-tmux/scripts/auto-tmux-smoke-test.sh` 通过或在无 tmux 环境下明确跳过。
 9. 运行 `skills/auto-tmux/scripts/validate-auto-tmux.sh` 和 `skills/auto-skill/scripts/validate-skill.sh skills/auto-tmux --strict` 通过。

skills/auto-tmux/references/automation.md

@@ -33,6 +33,7 @@
 | `swarm-brief.sh` | 生成只读交接报告 | 不发送按键，只汇总证据 |
 | `swarm-watch.sh` | 有限轮次巡检 pane 输出和状态 | 不默认无限循环 |
 | `swarm-archive.sh` | 打包 brief、snapshot 和 state | 生成可交接 `.tar.gz` |
+| `swarm-board.sh` | 渲染任务、依赖、锁和状态日志 | 只读生成 Markdown 看板 |
 | `swarm-dispatch.sh` | 渲染并可选下发提示词 | 默认只写文件，发送需 `--send` |
 | `validate-auto-tmux.sh` | 执行技能专属质量门禁 | 覆盖脚本、文档索引、strict 和 smoke |
 
@@ -98,6 +99,7 @@ skills/auto-tmux/scripts/swarm-brief.sh --session ai-hub --swarm-dir /tmp/ai_swa
 ```bash
 skills/auto-tmux/scripts/swarm-watch.sh --session ai-hub --swarm-dir /tmp/ai_swarm --iterations 3 --interval 10 -n 80
 skills/auto-tmux/scripts/swarm-archive.sh --session ai-hub --swarm-dir /tmp/ai_swarm --out /tmp/ai-hub-handoff.tar.gz
+skills/auto-tmux/scripts/swarm-board.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-board.md
 ```
 
 发送前对 payload 做安全预检：
@@ -250,6 +252,7 @@ bash -n skills/auto-tmux/scripts/swarm-state.sh
 bash -n skills/auto-tmux/scripts/swarm-brief.sh
 bash -n skills/auto-tmux/scripts/swarm-watch.sh
 bash -n skills/auto-tmux/scripts/swarm-archive.sh
+bash -n skills/auto-tmux/scripts/swarm-board.sh
 bash -n skills/auto-tmux/scripts/safety-check.sh
 bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh
 bash -n skills/auto-tmux/scripts/swarm-dispatch.sh

skills/auto-tmux/references/iteration-roadmap.md

@@ -24,14 +24,14 @@
 | 16 | `075a803` | session 清理 | `auto-tmux.sh cleanup --session` |
 | 17 | `dc59ee2` | 任务依赖 | `task-depend`、`task-ready` |
 | 18 | `42bca78` | 结果归档 | `swarm-archive.sh` |
-| 19 | `本轮` | 安全策略 | `safety-check.sh`、`safety-policy.md` |
+| 19 | `07ac877` | 安全策略 | `safety-check.sh`、`safety-policy.md` |
+| 20 | `本轮` | 状态可视化 | `swarm-board.sh` |
 
 ## 后续候选方向
 
 | 优先级 | 方向 | 说明 |
 |:---|:---|:---|
 | P2 | worker 分配 | 根据 TODO 队列和空闲 pane 自动生成 dispatch 建议 |
-| P2 | 状态可视化 | 从 `tasks.tsv` 生成 Markdown 看板 |
 | P2 | replay 审计 | 从 record 日志生成复盘摘要 |
 | P3 | 远程 session | SSH 场景下的只读拓扑和安全边界 |
 | P3 | shell completion | 为常用子命令生成补全脚本 |

skills/auto-tmux/references/swarm-state.md

@@ -156,12 +156,15 @@ skills/auto-tmux/scripts/swarm-state.sh task-reopen \
 ```bash
 skills/auto-tmux/scripts/swarm-state.sh metrics
 skills/auto-tmux/scripts/swarm-state.sh validate
+skills/auto-tmux/scripts/swarm-board.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-board.md
 ```
 
 `metrics` 会按任务状态、owner 和当前锁数量输出摘要，适合 commander 快速判断蜂群是否堵塞。
 
 `validate` 会检查 `tasks.tsv` 表头、字段数量、重复任务 ID、非法状态、终态任务结果文件，以及锁目录中的 `owner` / `created_at`。
 
+`swarm-board.sh` 会把 `tasks.tsv`、`deps.tsv`、锁目录和最近状态日志渲染成 Markdown 看板，适合交接给 commander 或 reviewer。
+
 ## 锁管理
 
 锁用于避免多个 worker 同时修改同一文件、目录或服务。

skills/auto-tmux/scripts/AGENTS.md

@@ -13,6 +13,7 @@ scripts/
 ├── swarm-brief.sh  # 只读生成蜂群交接报告
 ├── swarm-watch.sh  # 有限轮次只读巡检和状态采样
 ├── swarm-archive.sh # 打包 brief、snapshot 和 swarm state
+├── swarm-board.sh # 从 swarm state 渲染 Markdown 看板
 ├── safety-check.sh # 发送/粘贴/分发前的 payload 安全预检
 ├── render-swarm-prompt.sh # commander/worker/reviewer 提示词渲染
 ├── swarm-dispatch.sh # 渲染并可选下发蜂群提示词
@@ -32,6 +33,7 @@ scripts/
 - 交接报告脚本只读调用 doctor/topology/scan/report，不直接发送按键。
 - 巡检脚本必须是有限轮次，不允许默认无限循环。
 - 归档脚本只复制状态和只读证据，不修改 tmux pane 或 swarm state。
+- 看板脚本只读 `tasks.tsv`、`deps.tsv`、锁和状态日志，不改写状态目录。
 - 安全预检脚本只能读取文本或文件，不控制 tmux，不写状态目录。
 - 状态脚本只能写入显式状态目录，不保存密钥、Token、密码或私密项目内容。
 - 自测脚本必须创建独立临时 tmux session，并在退出时清理。

skills/auto-tmux/scripts/README.md

@@ -9,6 +9,7 @@
 - [`swarm-brief.sh`](./swarm-brief.sh) - 只读生成蜂群交接报告，汇总 doctor、topology、pane 输出和状态报告。
 - [`swarm-watch.sh`](./swarm-watch.sh) - 有限轮次巡检蜂群 pane 输出和状态报告，形成连续证据。
 - [`swarm-archive.sh`](./swarm-archive.sh) - 打包 brief、snapshot 和 swarm state，生成可交接归档。
+- [`swarm-board.sh`](./swarm-board.sh) - 将 `tasks.tsv`、依赖、锁和状态日志渲染为 Markdown 看板。
 - [`safety-check.sh`](./safety-check.sh) - 发送、粘贴或分发前检查危险命令、敏感信息和过大 payload。
 - [`render-swarm-prompt.sh`](./render-swarm-prompt.sh) - commander、worker、reviewer 提示词渲染。
 - [`swarm-dispatch.sh`](./swarm-dispatch.sh) - 渲染提示词并可选发送到指定 pane，默认只写文件。
@@ -58,6 +59,9 @@ skills/auto-tmux/scripts/swarm-watch.sh --session ai-hub --swarm-dir /tmp/ai_swa
 # 打包交接归档
 skills/auto-tmux/scripts/swarm-archive.sh --session ai-hub --swarm-dir /tmp/ai_swarm --out /tmp/ai-hub-handoff.tar.gz
 
+# 生成任务看板
+skills/auto-tmux/scripts/swarm-board.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-board.md
+
 # 初始化蜂群状态并添加任务
 skills/auto-tmux/scripts/swarm-state.sh init --dir /tmp/ai_swarm
 skills/auto-tmux/scripts/swarm-state.sh task-add --id task-001 --text "检查 README 链接"

skills/auto-tmux/scripts/auto-tmux-smoke-test.sh

@@ -9,6 +9,7 @@ RENDER_PROMPT="$SCRIPT_DIR/render-swarm-prompt.sh"
 SWARM_BRIEF="$SCRIPT_DIR/swarm-brief.sh"
 SWARM_WATCH="$SCRIPT_DIR/swarm-watch.sh"
 SWARM_ARCHIVE="$SCRIPT_DIR/swarm-archive.sh"
+SWARM_BOARD="$SCRIPT_DIR/swarm-board.sh"
 SAFETY_CHECK="$SCRIPT_DIR/safety-check.sh"
 SWARM_DISPATCH="$SCRIPT_DIR/swarm-dispatch.sh"
 SESSION="auto-tmux-smoke-$$"
@@ -18,13 +19,14 @@ RECORD_DIR="/tmp/auto-tmux-smoke-record-$$"
 BRIEF_DIR="/tmp/auto-tmux-smoke-brief-$$"
 WATCH_DIR="/tmp/auto-tmux-smoke-watch-$$"
 ARCHIVE_FILE="/tmp/auto-tmux-smoke-archive-$$.tar.gz"
+BOARD_FILE="/tmp/auto-tmux-smoke-board-$$.md"
 DISPATCH_PROMPT="/tmp/auto-tmux-smoke-dispatch-$$.md"
 TASK_IMPORT_FILE="/tmp/auto-tmux-smoke-tasks-$$.txt"
 PASTE_FILE="/tmp/auto-tmux-smoke-paste-$$.txt"
 
 cleanup() {
   tmux kill-session -t "$SESSION" 2>/dev/null || true
-  rm -rf "$SWARM_DIR" "$SNAPSHOT_DIR" "$RECORD_DIR" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE"
+  rm -rf "$SWARM_DIR" "$SNAPSHOT_DIR" "$RECORD_DIR" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$BOARD_FILE" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE"
 }
 trap cleanup EXIT
 
@@ -39,6 +41,7 @@ bash -n "$RENDER_PROMPT"
 bash -n "$SWARM_BRIEF"
 bash -n "$SWARM_WATCH"
 bash -n "$SWARM_ARCHIVE"
+bash -n "$SWARM_BOARD"
 bash -n "$SAFETY_CHECK"
 bash -n "$SWARM_DISPATCH"
 
@@ -114,6 +117,10 @@ grep -q 'auto-tmux Swarm Brief' "$BRIEF_DIR/brief.md"
 grep -q 'auto-tmux Swarm Watch' "$WATCH_DIR/index.md"
 "$SWARM_ARCHIVE" --session "$SESSION" --swarm-dir "$SWARM_DIR" --out "$ARCHIVE_FILE" -n 10 >/tmp/auto-tmux-smoke-archive.txt
 test -s "$ARCHIVE_FILE"
+"$SWARM_BOARD" --dir "$SWARM_DIR" --out "$BOARD_FILE" --limit 20 >/tmp/auto-tmux-smoke-board.txt
+grep -q 'auto-tmux Swarm Board' "$BOARD_FILE"
+grep -q '## Ready TODO' "$BOARD_FILE"
+grep -q 'smoke-fail' "$BOARD_FILE"
 "$RENDER_PROMPT" commander --session "$SESSION" --swarm-dir "$SWARM_DIR" --task "smoke" >/tmp/auto-tmux-smoke-commander-prompt.md
 "$RENDER_PROMPT" worker --session "$SESSION" --target "$worker_target" --swarm-dir "$SWARM_DIR" --task "smoke" >/tmp/auto-tmux-smoke-worker-prompt.md
 "$SWARM_DISPATCH" --role worker --target "$worker_target" --session "$SESSION" --swarm-dir "$SWARM_DIR" --task "smoke" --out "$DISPATCH_PROMPT" >/tmp/auto-tmux-smoke-dispatch-render.txt

skills/auto-tmux/scripts/auto-tmux.sh

@@ -153,7 +153,7 @@ cmd_doctor() {
     status_line "WARN" "tmux server has no reachable session yet"
   fi
 
-  for script in auto-tmux.sh swarm-state.sh swarm-brief.sh swarm-watch.sh swarm-archive.sh safety-check.sh render-swarm-prompt.sh swarm-dispatch.sh auto-tmux-smoke-test.sh validate-auto-tmux.sh; do
+  for script in auto-tmux.sh swarm-state.sh swarm-brief.sh swarm-watch.sh swarm-archive.sh swarm-board.sh safety-check.sh render-swarm-prompt.sh swarm-dispatch.sh auto-tmux-smoke-test.sh validate-auto-tmux.sh; do
     if [[ -x "$script_dir/$script" ]]; then
       status_line "OK" "script executable: $script"
     else

skills/auto-tmux/scripts/swarm-board.sh

@@ -0,0 +1,189 @@
+#!/usr/bin/env bash
+# swarm-board: render swarm tasks, dependencies and locks as a Markdown board.
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+swarm-board: render an auto-tmux swarm state directory as Markdown
+
+Usage:
+  swarm-board.sh [--dir DIR] [--out FILE] [--limit N]
+
+Defaults:
+  --dir   AUTO_TMUX_SWARM_DIR or /tmp/ai_swarm
+  --out   stdout
+  --limit 50 rows per section
+EOF
+}
+
+die() {
+  printf 'error: %s\n' "$*" >&2
+  exit 1
+}
+
+swarm_dir="${AUTO_TMUX_SWARM_DIR:-/tmp/ai_swarm}"
+out_file=""
+limit=50
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --dir)
+      swarm_dir="${2:-}"
+      shift 2
+      ;;
+    --out)
+      out_file="${2:-}"
+      shift 2
+      ;;
+    --limit)
+      limit="${2:-}"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      die "unknown option: $1"
+      ;;
+  esac
+done
+
+[[ "$limit" =~ ^[0-9]+$ ]] || die "--limit must be a number"
+
+tasks_tsv="$swarm_dir/tasks.tsv"
+deps_tsv="$swarm_dir/deps.tsv"
+locks_dir="$swarm_dir/locks"
+status_log="$swarm_dir/status.log"
+
+[[ -f "$tasks_tsv" ]] || die "tasks file not found: $tasks_tsv"
+[[ -f "$deps_tsv" ]] || die "deps file not found: $deps_tsv"
+
+render_summary() {
+  awk -F '\t' '
+    NR > 1 {count[$2]++}
+    END {
+      print "| status | count |"
+      print "|:---|---:|"
+      n = split("TODO DOING DONE BLOCKED FAIL", order, " ")
+      for (i = 1; i <= n; i++) {
+        status = order[i]
+        print "| `" status "` | " (count[status] + 0) " |"
+      }
+    }
+  ' "$tasks_tsv"
+}
+
+render_ready() {
+  awk -F '\t' -v limit="$limit" '
+    function esc(value) {
+      gsub(/\|/, "\\|", value)
+      return value
+    }
+    FILENAME == ARGV[1] {
+      if (FNR == 1) next
+      status[$1] = $2
+      owner[$1] = $3
+      text[$1] = $4
+      result[$1] = $5
+      order[++n] = $1
+      next
+    }
+    FILENAME == ARGV[2] {
+      if (FNR == 1) next
+      if (status[$2] != "DONE") {
+        blocked[$1] = blocked[$1] ? blocked[$1] ", " $2 : $2
+      }
+      next
+    }
+    END {
+      print "| id | owner | text |"
+      print "|:---|:---|:---|"
+      shown = 0
+      for (i = 1; i <= n; i++) {
+        id = order[i]
+        if (status[id] == "TODO" && blocked[id] == "") {
+          print "| `" esc(id) "` | `" esc(owner[id]) "` | " esc(text[id]) " |"
+          shown++
+          if (shown >= limit) break
+        }
+      }
+      if (shown == 0) print "| - | - | - |"
+    }
+  ' "$tasks_tsv" "$deps_tsv"
+}
+
+render_status_section() {
+  local status="$1"
+  awk -F '\t' -v wanted="$status" -v limit="$limit" '
+    function esc(value) {
+      gsub(/\|/, "\\|", value)
+      return value
+    }
+    BEGIN {
+      print "| id | owner | text | result |"
+      print "|:---|:---|:---|:---|"
+    }
+    NR > 1 && $2 == wanted {
+      print "| `" esc($1) "` | `" esc($3) "` | " esc($4) " | " esc($5) " |"
+      shown++
+      if (shown >= limit) exit
+    }
+    END {
+      if (shown == 0) print "| - | - | - | - |"
+    }
+  ' "$tasks_tsv"
+}
+
+render_locks() {
+  printf '| lock | owner | created_at |\n'
+  printf '|:---|:---|:---|\n'
+  if [[ ! -d "$locks_dir" ]] || ! find "$locks_dir" -mindepth 1 -maxdepth 1 -type d -name '*.lock.d' -print -quit | grep -q .; then
+    printf '| - | - | - |\n'
+    return 0
+  fi
+  find "$locks_dir" -mindepth 1 -maxdepth 1 -type d -name '*.lock.d' -print | sort | while read -r path; do
+    printf '| `%s` | `%s` | %s |\n' \
+      "$(basename "$path" .lock.d)" \
+      "$(cat "$path/owner" 2>/dev/null || printf unknown)" \
+      "$(cat "$path/created_at" 2>/dev/null || printf unknown)"
+  done
+}
+
+render_recent_status() {
+  if [[ -s "$status_log" ]]; then
+    tail -n 20 "$status_log" | sed 's/^/- /'
+  else
+    printf -- '- no status log\n'
+  fi
+}
+
+render_board() {
+  printf '# auto-tmux Swarm Board\n\n'
+  printf -- '- dir: `%s`\n' "$swarm_dir"
+  printf -- '- created_at: `%s`\n\n' "$(date -Is)"
+
+  printf '## Summary\n\n'
+  render_summary
+  printf '\n## Ready TODO\n\n'
+  render_ready
+
+  local status
+  for status in TODO DOING BLOCKED FAIL DONE; do
+    printf '\n## %s\n\n' "$status"
+    render_status_section "$status"
+  done
+
+  printf '\n## Locks\n\n'
+  render_locks
+  printf '\n## Recent Status\n\n'
+  render_recent_status
+}
+
+if [[ -n "$out_file" ]]; then
+  mkdir -p "$(dirname "$out_file")"
+  render_board > "$out_file"
+  printf 'swarm board written: %s\n' "$out_file"
+else
+  render_board
+fi

skills/auto-tmux/scripts/validate-auto-tmux.sh

@@ -82,6 +82,7 @@ scripts=(
   "$script_dir/swarm-brief.sh"
   "$script_dir/swarm-watch.sh"
   "$script_dir/swarm-archive.sh"
+  "$script_dir/swarm-board.sh"
   "$script_dir/safety-check.sh"
   "$script_dir/render-swarm-prompt.sh"
   "$script_dir/swarm-dispatch.sh"
@@ -98,6 +99,7 @@ run_gate "swarm-state help" "$script_dir/swarm-state.sh" help
 run_gate "swarm-brief help" "$script_dir/swarm-brief.sh" --help
 run_gate "swarm-watch help" "$script_dir/swarm-watch.sh" --help
 run_gate "swarm-archive help" "$script_dir/swarm-archive.sh" --help
+run_gate "swarm-board help" "$script_dir/swarm-board.sh" --help
 run_gate "safety-check help" "$script_dir/safety-check.sh" --help
 run_gate "safety-check clean text" "$script_dir/safety-check.sh" --text "make test"
 if "$script_dir/safety-check.sh" --text "rm -rf /tmp/example" >/tmp/auto-tmux-validate-gate.log 2>&1; then
@@ -112,6 +114,7 @@ require_contains "$skill_dir/SKILL.md" "scripts/validate-auto-tmux.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-brief.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-watch.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-archive.sh"
+require_contains "$skill_dir/SKILL.md" "scripts/swarm-board.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/safety-check.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-dispatch.sh"
 require_contains "$skill_dir/references/index.md" "automation.md"
@@ -122,11 +125,13 @@ require_contains "$script_dir/README.md" "validate-auto-tmux.sh"
 require_contains "$script_dir/README.md" "swarm-dispatch.sh"
 require_contains "$script_dir/README.md" "swarm-watch.sh"
 require_contains "$script_dir/README.md" "swarm-archive.sh"
+require_contains "$script_dir/README.md" "swarm-board.sh"
 require_contains "$script_dir/README.md" "safety-check.sh"
 require_contains "$script_dir/AGENTS.md" "validate-auto-tmux.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-dispatch.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-watch.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-archive.sh"
+require_contains "$script_dir/AGENTS.md" "swarm-board.sh"
 require_contains "$script_dir/AGENTS.md" "safety-check.sh"
 
 if [[ -x "$repo_root/skills/auto-skill/scripts/validate-skill.sh" ]]; then