aidlc-init

name	aidlc-init
generated-by	aidlc-runner-gen
description	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-births the first intent; this is opt-in packaging over that move. Pass `--scope <name>` to seed the initial scope (defaults to poc), or a freeform description of what to build.
argument-hint	[--scope <name>] [description]
user-invocable	true

AI-DLC — start a workflow (birth the first intent)

Start a fresh AI-DLC workflow. The workspace shell ships in dist/ (no setup command), and the engine auto-births the first intent when you describe what to build — this skill is opt-in packaging over that birth 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

1. Birth 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-birth reads the description from the --arguments flag, 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 --arguments text is preserved separately in the audit + state. Omit --label only when there is no description (the tool then falls back to the scope token):

   bun .codex/tools/aidlc-utility.ts intent-birth --scope <name> --arguments "<description>" --label "<2-3 word essence>"
   

   --scope seeds the initial scope (defaults to poc); omit --arguments and --label when the user gave no description. Print the tool's output and stop. This does not advance a stage; run /aidlc afterwards to continue.