Skip to main content

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 — 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.
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

​
The five phases

1

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.
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. If you’re not inside a git repo, it asks you to git init first.
2

Agent identity

The wizard scaffolds .genie/ if it’s missing, then hands off to /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.
3

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. Once the idea is concrete, it calls /wish to produce a structured plan and /review to validate it before any code gets written.
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
4

Execute

You see a summary of the execution groups and how many agents will run. When you confirm, the wizard runs /work on the approved wish and reports progress as groups land. Final validation goes back through /review; if it comes back FIX-FIRST, the wizard loops through /fix automatically.
5

Celebrate

The wizard summarizes what shipped and points you at the next thing to try.
Your first wish has been granted!

Wish:    add-dark-mode
Status:  COMPLETE
Files:   12 files changed, 340 insertions
Review:  SHIP — all criteria met
From here you can open the PR, start a second wish, spin up a team, or hand off to /pm to keep watch over longer-running work.

​
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

The Genie Loop

See the canonical plan → review → work → ship → monitor flow in one page.

/brainstorm

Explore a fuzzy idea until it’s crisp enough to wish on.

/wish

Convert a crystallized idea into an executable wish plan.