---
name: amadeus-init
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 `amadeus-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):

   ```bash
   bun .codex/tools/amadeus-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 `/amadeus` afterwards to continue.