> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automagik.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# /wizard

> Guided onboarding — scaffold workspace, shape agent identity, create first wish, execute, and celebrate.

# /wizard — First-Run Onboarding

`/wizard` is the guided tour through your first Genie session. It walks you through five phases — environment check, agent identity, first wish, execution, and celebration — and hands off to the right loop skill at each step. If you close the tab halfway through, the next `/wizard` invocation picks up where you left off.

<Note>
  **When to reach for `/wizard`**

  * First time running Genie in a new project
  * You just ran the bootstrap script and it pointed you here
  * There's no `.genie/` directory or `AGENTS.md` in the repo yet
  * You want a narrated path through your first wish instead of jumping straight into [`/brainstorm`](/genie/skills/brainstorm)
</Note>

## The five phases

<Steps>
  <Step title="Environment check">
    The wizard verifies your prerequisites and prints a checklist — CLI version, git repo, `.genie/` directory, `AGENTS.md`, and any plugin config. Missing items get fixed inline or flagged with a one-line instruction.

    ```text theme={"dark"}
    Wizard Phase 1/5: Environment Check
      genie CLI    ✅ v4.x.x
      git repo     ✅
      .genie/      ⬜ not found — will scaffold
      AGENTS.md    ⬜ not found — will create
      CLAUDE.md    ✅ found
    ```

    If `genie` isn't installed, the wizard sends you to the [Installation guide](/genie/installation). If you're not inside a git repo, it asks you to `git init` first.
  </Step>

  <Step title="Agent identity">
    The wizard scaffolds `.genie/` if it's missing, then hands off to [`/brainstorm`](/genie/skills/brainstorm) so you can shape what this agent is for. You answer a few questions about the project; the wizard explores the codebase alongside you and crystallizes the result into an `AGENTS.md`.

    Prefer to skip? Ask for the minimal `AGENTS.md` and move on — you can revisit identity later.
  </Step>

  <Step title="First wish">
    The wizard asks, "What's the first thing you'd like to build or fix?" If the idea is fuzzy, it routes you back to [`/brainstorm`](/genie/skills/brainstorm). Once the idea is concrete, it calls [`/wish`](/genie/skills/wish) to produce a structured plan and [`/review`](/genie/skills/review) to validate it before any code gets written.

    ```text theme={"dark"}
    Wizard Phase 3/5: First Wish
      Idea         ✅ "Add dark mode to the settings page"
      Brainstorm   ✅ design crystallized
      Wish plan    ✅ .genie/wishes/add-dark-mode/WISH.md
      Review       ✅ SHIP — plan approved
    ```
  </Step>

  <Step title="Execute">
    You see a summary of the execution groups and how many agents will run. When you confirm, the wizard runs [`/work`](/genie/skills/work) on the approved wish and reports progress as groups land. Final validation goes back through [`/review`](/genie/skills/review); if it comes back `FIX-FIRST`, the wizard loops through [`/fix`](/genie/skills/fix) automatically.
  </Step>

  <Step title="Celebrate">
    The wizard summarizes what shipped and points you at the next thing to try.

    <Frame>
      ```text theme={"dark"}
      Your first wish has been granted!

      Wish:    add-dark-mode
      Status:  COMPLETE
      Files:   12 files changed, 340 insertions
      Review:  SHIP — all criteria met
      ```
    </Frame>

    From here you can open the PR, start a second wish, spin up a team, or hand off to [`/pm`](/genie/skills/pm) to keep watch over longer-running work.
  </Step>
</Steps>

## Resumption

If you close the wizard partway through, the next `/wizard` invocation inspects the repo and skips phases that are already complete:

* `.genie/` exists → skip scaffolding
* `AGENTS.md` exists → skip identity
* An approved wish exists → jump to Phase 4
* A completed wish exists → jump to Phase 5

## What's next

<CardGroup cols={3}>
  <Card title="The Genie Loop" icon="circle-nodes" href="/genie/skills/loop-overview">
    See the canonical plan → review → work → ship → monitor flow in one page.
  </Card>

  <Card title="/brainstorm" icon="lightbulb" href="/genie/skills/brainstorm">
    Explore a fuzzy idea until it's crisp enough to wish on.
  </Card>

  <Card title="/wish" icon="scroll" href="/genie/skills/wish">
    Convert a crystallized idea into an executable wish plan.
  </Card>
</CardGroup>