Kumihimo

組紐 — viele Fäden hinein, ein Seil heraus.

Kumihimo ist das japanische Handwerk, viele einzelne Fäden zu einem einzigen Seil zu flechten. Dieses Werkzeug funktioniert genauso: Sie legen einen Plan als Graphen aus Klartextdateien an, und Kumihimo flicht diesen Graphen zu einem einzigen, wohlgeordneten Prompt, auf den ein LLM oder Coding-Agent reagieren kann.

• Sehen. kumihimo edit öffnet eine Live-Canvas — nach Art gefärbte Knoten, Abhängigkeits-/Mitgliedschafts-/Annotationskanten deutlich gezeichnet, ziehen zum Anordnen, klicken zum Bearbeiten. Die Canvas folgt den Dateien: Ändern Sie einen Knoten in vim (oder lassen Sie Claude ihn über MCP ändern) und beobachten Sie, wie er sich bewegt.

• Flechten. kumihimo braid kompiliert den Graphen zu einem deterministischen Prompt: topologisch geordnet, nach Meilensteinen gegliedert, jedes Element nennt seine tatsächlichen Voraussetzungen, das eigene Mermaid-Diagramm des Graphen ist eingebettet.

• Claude steuern lassen. kumihimo mcp stellt den Plan über MCP bereit — elf Werkzeuge zum Lesen, Umstrukturieren, Validieren und Flechten — sodass ein Agent den Plan pflegen kann, den er ausführt. Die eigene Roadmap dieses Repos ist ein Kumihimo-Plan (plans/roadmap), seine Meilenstein-Prompts wurden geflochten, nicht handgeschrieben, und die Canvas unten ist diese Roadmap am Morgen, als v0.1 fertig wurde — jeder Faden erledigt, der Release-Knoten blockiert auf einen Menschen mit einem Tag:

Die Dateien sind die einzige Quelle der Wahrheit — Markdown mit YAML-Frontmatter, in git, sauber diffbar. Der Editor, die CLI und der MCP-Server sind dünne Clients über einer gemeinsamen Operationsebene; Knotenpositionen leben in einem view.yaml-Sidecar, sodass das Anordnen des Graphen nie einen semantischen Diff verschmutzt.

Zehn Minuten

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

Ein Knoten ist eine Datei:

---
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.

…und das Flechten kompiliert den Graphen zu einem Prompt — Präambel, eingebettete Mermaid-Form, getroffene Entscheidungen als Einschränkungen formuliert, jede Aufgabe mit einer ehrlichen After: -Zeile und Done when: -Checkliste:

Der Kern ist domänenagnostisch: Er versteht Identität, Prosa, Reihenfolge (needs), Mitgliedschaft (in) und Annotation (links) — alles andere kommt aus Arten, die Sie im Manifest definieren, einschließlich Feldern und Jinja2-Vorlagen. Ein Engineering-Paket (Aufgabe, Meilenstein, Entscheidung, Risiko, Frage) wird als Standard mitgeliefert; examples/fieldnotes ist ein Forschungsplan, dessen Arten vollständig in seinem eigenen Manifest leben.

Dokumentation: https://tzavislan.github.io/kumihimo/ — Tutorial, Konzepte, benutzerdefinierte Arten, MCP-Einrichtung, Dateiformate.

Entwicklung

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

Konventionen (in CI durchgesetzt): CONVENTIONS.md. Beiträge: CONTRIBUTING.md. Design-Dokument: PLAN.md. Releases: RELEASING.md.

Lizenz

MIT