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분

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

노드는 파일입니다:

---
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 템플릿이 포함됩니다. 엔지니어링 팩(작업, 마일스톤, 결정, 위험, 질문)이 기본값으로 제공됩니다; 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