handofflisted

Kraft's tools come from the `kraft` MCP server. If `kraft` is not on PATH, this plugin has been installed without the program it drives: say so and point at https://github.com/itsOmidKarami/kraft#install rather than reporting a connection error. # Handing work to Kraft Kraft runs semi-autonomous work items as chains, with human gates. Hand work off rather than doing it inline when it is large enough to want that structure. 1. `ensure_repo()` - connects the current repo if Kraft has not seen it. Idempotent, so call it every time rather than checking first. 2. `create_work_item(title, description=...)` - files the work. The title is a label; the description is the brief, and it is what the spec node writes its design from. Put the intent in the description rather than packing it into the title. **`create_work_item` does not start anything.** The item lands paused and a person starts it from the board. When you report back, say the work is *filed*, not that it is underway - telling someone their work is running when nothing is running is the one failure this whole surface is built to avoid. ## When the spec and plan already exist If documents were written in this session or already live in the repo, attach them at intake instead of letting Kraft re-run those phases: create_work_item(title, description=..., attachments=[ {"kind": "spec", "path": ".engineering/specs/x.md"}, {"kind": "plan", "path": ".engineering/plans/x.md"}, ]) Kind is