2.5 KiB
name, generated-by, description, argument-hint, user-invocable
| name | generated-by | description | argument-hint | user-invocable |
|---|---|---|---|---|
| aidlc-init | aidlc-runner-gen | Start an AI-DLC workflow — run the whole Initialization phase (mint the intent, detect the workspace, build state) in one step, without typing a stage. The engine normally auto-creates the first intent; this is opt-in packaging over that move. Pass `--scope <name>` to seed the initial scope, or a freeform description of what to build. | [--scope <name>] [description] | true |
AI-DLC - start a workflow (create the first intent)
Start a fresh AI-DLC workflow. The workspace shell ships in dist/ (no setup
command), and the engine auto-creates the first intent when you describe what to
build - this skill is opt-in packaging over that creation move. Initialization is a
PHASE, not a single stage — it mints the intent, detects the workspace
(greenfield/brownfield), and builds aidlc-state.md together, in one
deterministic call. There is no per-init-stage runner because an init stage has
no standalone meaning.
Steps
-
Create the intent (run the initialization phase). Parse the user's
$ARGUMENTS: forward any recognized flags (--scope <name>/--depth <level>/--test-strategy <level>) as-is, and pass any freeform description text via--arguments "<text>"(intent-createreads the description from the--argumentsflag, NOT a positional — forwarding it bare would silently drop it). ALSO derive a short--label: a 2-3 word kebab-case essence of what's being built ("I would like to build a simple calculator application"→--label "simple calc"). The label becomes the readable, date-prefixed record dir name (<YYMMDD>-simple-calc); the full--argumentstext is preserved separately in the audit + state. Omit--labelonly when there is no description (the tool then falls back to the scope token):aidlc engine intent create --scope <scope> --arguments "<description>" --label "<2-3 word essence>"Pass the user's
--scope <name>when they named one; otherwise omit--scope— the tool resolves the implicit default itself (AWS_AIDLC_DEFAULT_SCOPE, elseclassic). If the user gave neither a scope nor a description, do not run a bareintent-create: ask what they want to build or which scope to use. When only a scope was supplied, omit--argumentsand--label. Print the tool's output and stop. This does not advance a stage; run/aidlcafterwards to continue.