Kumihimo

組紐 — 多くの糸を編み込み、一本のコードに。

Kumihimo は、多くの別々の糸を一本のコードに編み上げる日本の伝統技法です。このツールも同じように機能します。プレーンテキストファイルのグラフとして計画を配置し、Kumihimo がそのグラフを、LLM やコーディングエージェントが実行できる単一の整然としたプロンプトに編み上げます。

• 見る。 kumihimo edit はライブキャンバスを開きます — kind ごとに色分けされたノード、依存関係・メンバーシップ・注釈のエッジを区別して描画し、ドラッグで配置、クリックで編集。キャンバスはファイルに追従します。vim でノードを変更するか（または MCP 経由で Claude に変更させる）、その動きを確認できます。

• 編む。 kumihimo braid はグラフを単一の決定論的プロンプトにコンパイルします。トポロジカルに順序付けられ、マイルストーンごとに区分され、各項目が実際の前提条件を明示し、グラフ自身の Mermaid ダイアグラムが埋め込まれます。

• Claude に操作させる。 kumihimo mcp は計画を MCP 経由で提供します — 読み取り、再構築、検証、編み上げのための 11 のツール — エージェントが実行する計画を維持できるようにします。このリポジトリ自身のロードマップは Kumihimo 計画です（plans/roadmap）。そのマイルストーンプロンプトは手書きではなく編み上げられたもので、下のキャンバスは v0.1 が完了した朝のそのロードマップです — すべてのスレッドが完了し、リリースノードはタグを付ける人間を待ってブロックされています：

ファイルだけが唯一の情報源です — YAML frontmatter 付きの Markdown で、git 管理され、クリーンに差分が取れます。エディタ、CLI、MCP サーバーは単一の操作レイヤー上のシンクライアントです。ノードの位置は view.yaml サイドカーに保存されるため、グラフを配置してもセマンティックな差分を汚すことはありません。

10分で始める

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.

…そして braid はグラフを単一のプロンプトにコンパイルします — 前文、埋め込まれた Mermaid 図、確定した決定事項を制約として明記、各タスクに正直な After: 行と Done when: チェックリスト：

コアはドメイン非依存です。アイデンティティ、散文、順序（needs）、メンバーシップ（in）、注釈（links）を理解します — それ以外はすべて、マニフェストで定義するkindsから来ます。フィールドと Jinja2 テンプレートも含みます。エンジニアリングパック（task、milestone、decision、risk、question）がデフォルトとして同梱されます。examples/fieldnotes は、その kinds がすべて独自のマニフェストに存在する研究計画です。

ドキュメント： https://tzavislan.github.io/kumihimo/ — チュートリアル、コンセプト、カスタム kinds、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