start git:20260907.38c37c8A

Immutable. This exact content never changes and is served at /api/v1/blob/eca4f0981e6d8c4e.

---
name: start
description: Use when starting a new piece of work under Kraft Lite - materializes the chain's nodes as state records and runs the first node.
---

# Starting a chain

    python3 "$CLAUDE_PLUGIN_ROOT/kl.py" start --title "<the work>"

To run a chain other than the packaged default, add `--chain <path-to-chain.json>`.
The template is frozen against this run, so editing that file later does not
retarget a chain already in flight.

It prints the chain id and which backend holds the state (`bd`, or a JSONL file
under `.kraft-lite/`). Say both, so the human knows where their state lives and
which chain is theirs.

Carry that id. Every later verb in this chain takes `--chain-id <id>`, and a
directory holding two unfinished chains refuses to guess between them.

If `.kraft-lite/registry.yaml` does not exist, run the `init` skill first. Do not
invent bindings.

Then invoke the `next` skill. Starting a chain and stopping before the first node
leaves the human with a state file and nothing running.

`$CLAUDE_PLUGIN_ROOT` is set when this loads as a plugin. If it is unset, `kl.py`
is two directories above this file - use that path instead of an empty one.