ambler-walk
Ambler Walk
This skill guides you in creating a complete Ambler walk. A walk is a state-machine program consisting of two files:
walks/<name>.ts— TypeScript file defining the sharedState,initialState, and the wired node graph.specs/<name>.md— Markdown specification describing the shared state and the logic/transitions of each step.
Step 1 — Identify the Walk
- Determine the walk name (lowercase, hyphen-separated, e.g.
my-walk). The file will bewalks/<name>.ts. - Clarify the walk's purpose: what program does it implement?
- Identify the nodes (steps) required and their transitions.
Step 2 — Ensure Nodes Exist
More from argenkiwi/ambler-ts
ambler-init
Initializes a new Ambler state-machine project. Use this whenever a user wants to start a new Ambler project, bootstrap a state-machine app, or set up the Ambler folder structure — even if they just say "new project" or "set up ambler" or "create ambler folder".
13ambler-test
Creates a test file for an Ambler node in the nodes/ directory. Use this whenever the user wants tests for a node — including "test this node", "add tests", "write tests for X", or any time a node is created without a corresponding test file.
12ambler-spec
Creates or updates a Markdown specification file for an Ambler walk in the specs/ directory. Use this whenever a user wants to document, plan, or describe a walk — including "write a spec", "document this walk", or "plan out the nodes" — even before any code exists.
12ambler-util
Creates or extracts utility modules into the utils/ directory of an Ambler project. Use this whenever a node's defaultUtils needs external npm/jsr dependencies, contains logic reusable across multiple nodes, or has implementations too complex to inline — even if the user just says "add a util", "extract this helper", "share this function", "create a utility", or "this code is getting too long for the node". When a user creates a node that imports an npm package or has complex async logic, proactively suggest using this skill.
9ambler-node
Creates a new Ambler node in the nodes/ directory. Use this whenever the user wants to add a node, step, or state to an Ambler project — even if they phrase it as "add a step", "create a handler", or describe the behavior without using the word "node".
8ambler-core
Creates a new Ambler core in the cores/ directory. Use this whenever the user wants to add a core, step, or state to an Ambler project — even if they phrase it as "add a step", "create a handler", or describe the behavior without using the word "core".
4