Kumihimo

組紐 — 多线入，一绳出。

Kumihimo 是日本将多根独立线编织成一根绳子的工艺。这个工具的工作方式相同：你将计划布局为纯文本文件的图，Kumihimo 将该图编织成一个单一的、有序的提示词，供 LLM 或编码代理执行。

• 查看它。 kumihimo edit 打开一个实时画布 — 按类型着色的节点、依赖/成员/注释边以不同方式绘制，拖拽排列，点击编辑。画布跟随文件：在 vim 中更改节点（或让 Claude 通过 MCP 更改它），然后观察它移动。

• 编织它。 kumihimo braid 将图编译成一个确定性的提示词：按拓扑排序，按里程碑分节，每个条目都说明其真实前置条件，并嵌入图自身的 Mermaid 图。

• 让 Claude 驱动它。 kumihimo mcp 通过 MCP 提供计划服务 — 十一个工具用于读取、重构、验证和编织 — 因此代理可以维护它执行的计划。本仓库自己的路线图就是一个 Kumihimo 计划（plans/roadmap），其里程碑提示词是编织出来的，而非手写的，下面的画布就是 v0.1 完成那天早晨的路线图 — 每个线程都已完成，发布节点被阻塞在一个持有标签的人身上：

文件是唯一的事实来源 — 带 YAML frontmatter 的 Markdown，在 git 中，干净地 diff。编辑器、CLI 和 MCP 服务器是单一操作层之上的薄客户端；节点位置存放在 view.yaml 侧车文件中，因此排列图永远不会弄脏语义 diff。

十分钟上手

Kumihimo 尚未发布到包索引 — 从源码安装（Python 3.11+；仅当需要画布时才需要 Node 18+）：

git clone https://github.com/tzavislan/kumihimo
cd kumihimo
cd frontend && npm install && npm run build && cd ..
pip install .

npm 行构建实时画布，可以跳过 — 除 kumihimo edit 之外的所有功能仍然可用，kumihimo edit 将提供一个 API 服务，并显示一个诚实的"前端未构建"页面，而不是图。

kumihimo new myplan
kumihimo edit myplan        # live canvas at 127.0.0.1:8720
kumihimo add myplan build --kind task --title "Build the loader" --body "..."
kumihimo check myplan       # cycles named with paths, dangling edges, field breaches
kumihimo braid myplan       # one prompt on stdout — paste into your agent

一个节点就是一个文件：

---
kind: task
title: Rate-limit middleware
needs: [api-endpoints, pick-algorithm]
in: [ship-guarded-api]
effort: M
acceptance:
  - 429 + Retry-After on breach
---
Middleware on every authenticated route. Fail *open* on Redis errors —
availability beats enforcement.

…编织将图编译成一个提示词 — 前言、嵌入的 Mermaid 形状、已定决策作为约束陈述、每个任务都有诚实的 After: 行和 Done when: 检查清单：

核心是领域无关的：它理解身份、散文、顺序（needs）、成员关系（in）和注释（links）— 其他一切都来自你在清单中定义的类型，包括字段和 Jinja2 模板。一个工程包（任务、里程碑、决策、风险、问题）作为默认提供；examples/fieldnotes 是一个研究计划，其类型完全定义在自己的清单中。

文档： https://tzavislan.github.io/kumihimo/ — 教程、概念、自定义类型、MCP 设置、文件格式。

Related MCP server: Executive Cortex MCP

开发

uv sync
uv run pytest -q
uv run python tools/lint.py            # the conventions linter CI runs
cd frontend && npm install && npm run build   # only if you work on the canvas

约定（在 CI 中强制执行）：CONVENTIONS.md。贡献：CONTRIBUTING.md。设计记录：PLAN.md。发布：RELEASING.md。

许可证

MIT