Kumihimo

組紐 — 많은 실이 들어가, 하나의 코드가 나온다.

Kumihimo는 여러 개의 실을 하나의 코드로 엮는 일본의 전통 공예입니다. 이 도구도 같은 방식으로 작동합니다: 계획을 일반 텍스트 파일의 그래프로 구성하면, Kumihimo가 그 그래프를 LLM이나 코딩 에이전트가 실행할 수 있는 하나의 잘 정렬된 프롬프트로 엮습니다.

• 보기. kumihimo edit는 라이브 캔버스를 엽니다 — 종류별 색상의 노드, 의존성/멤버십/주석 엣지가 구분되어 그려지며, 드래그로 배치하고 클릭으로 편집합니다. 캔버스는 파일을 따릅니다: vim에서 노드를 변경하면(또는 Claude가 MCP를 통해 변경하게 하면) 움직이는 것을 볼 수 있습니다.

• 엮기. kumihimo braid는 그래프를 하나의 결정적 프롬프트로 컴파일합니다: 위상 정렬되고, 마일스톤별로 구분되며, 모든 항목이 실제 선행 조건을 명시하고, 그래프 자체의 Mermaid 다이어그램이 포함됩니다.

• Claude가 주도하게 하기. kumihimo mcp는 계획을 MCP로 제공합니다 — 읽기, 재구성, 검증, 엮기를 위한 11개의 도구 — 에이전트가 실행하는 계획을 유지할 수 있도록 합니다. 이 저장소의 로드맵 자체가 Kumihimo 계획이며(plans/roadmap), 마일스톤 프롬프트는 손으로 쓰지 않고 엮어서 만든 것입니다. 아래 캔버스는 v0.1이 완성된 날 아침의 그 로드맵입니다 — 모든 스레드가 완료되었고, 릴리스 노드는 태그를 가진 사람을 기다리며 차단되어 있습니다:

파일이 유일한 진실의 원천입니다 — YAML frontmatter가 있는 Markdown, git에 있으며 깔끔하게 diff됩니다. 편집기, CLI, MCP 서버는 하나의 운영 계층 위의 얇은 클라이언트입니다. 노드 위치는 view.yaml 사이드카에 저장되어 그래프를 배치해도 의미론적 diff가 오염되지 않습니다.

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