Knots

Create a knot

Run:

bash
1kno new "<title>" -d "<description>"

Use a short action-oriented title. Write the description with the expected outcome, relevant context, and constraints for the next agent.

Execute a knot

Follow this sequence:

bash
1kno claim <id>

• If you are working inside a git worktree, run Knots commands as kno -C <path_to_repo> ... because Knots is installed for the repo root, not the worktree path.
• Record the current state from the claim output.
• Use the claim output to determine the current state's completion goals.
• Do the work and validate it.
• If the goals were met, advance with a guarded state check:

bash
1kno next <id> --expected-state <current_state>

• If you are blocked, validation fails, or the state's goals were not met, roll back safely:

bash
1kno rollback <id>

If the claimed knot lists children, handle the children first:

• Claim each child knot and follow that child prompt to completion.
• When the child knots are handled, evaluate the outcomes.
• If every child advanced, advance the parent.
• If any child rolled back, roll the parent back too.

Do not invent alternate transition workflows. Prefer claim, next, and rollback over manual state mutation unless the user explicitly asks for it.

Session close behavior

• In an interactive session, briefly say what changed and ask what to do next.
• In a non-interactive session, stop cleanly after the knot workflow is complete.