用途：把项目工作可视化。它从 JSON 事实来源生成离线、自包含的看板 HTML，不手工编辑生成的 HTML。
主要能力：使用 scripts/kanban.mjs 作为共享渲染器；用 scripts/install-lifecycle.mjs 向项目根目录的 CLAUDE.md（Claude Code）或 AGENTS.md（Codex）安装受管生命周期块，保留原有说明并替换已标记块而非重复；用 workflow 的 planning、active、review、completed 把生命周期事件映射到实际列；提供本地服务器在后台随机端口打开浏览器。
使用方式：先创建或更新 kanban.json，不得虚构卡片、主题、备注、链接或列归属。构建命令：/path/to/kanban/scripts/kanban build kanban.json --out kanban.html。开工时可执行 mkdir -p .kanban、构建到 .kanban/board.html，再运行 node /path/to/kanban/scripts/serve.mjs .kanban/board.html > .kanban/server.log 2>&1 &，读取日志报告 URL，看板变化后重建并刷新同一 URL。校验命令：/path/to/kanban/scripts/kanban validate kanban.json。安装生命周期：scripts/install-lifecycle.mjs <project-directory> --agent claude|codex|both。
数据模型：JSON 必填 columns 与 cards；title、description、headerNote、columnDescriptions、columnColors、workflow、note、link 可选。id 必须唯一，卡片的 theme 和 column 必须已声明，link 用完整 https:// 或项目相对路径。
限制：输出不含外部资源、字体、脚本或数据抓取；相同 JSON 重建结果一致。workflow 缺失时须先确认映射，不得按列名猜测。无相关看板或卡片、状态属推测时不要更新看板。