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 sidecar 中，因此排列图永远不会弄脏语义 diff。

十分钟

pip install kumihimo

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 设置、文件格式。

开发

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

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

许可证

MIT