Kumihimo

組紐 — 多くの糸を編み込み、一本の紐にする。

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

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

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

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

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

10分で始める

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だけは例外で、グラフの代わりに「フロントエンド未ビルド」という正直なページで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

ノードは1つのファイルです：

---
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はグラフを1つのプロンプトにコンパイルします — 前文、埋め込まれたMermaid図、確定した決定事項を制約として明記、各タスクに正直な*After:行とDone when:*チェックリスト：

コアはドメイン非依存です。識別、散文、順序（needs）、所属（in）、注釈（links）を理解します — それ以外はすべて、マニフェストで定義する**種類（kinds）**から来ます。フィールドと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