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.
Every genie job moves through five phases. You can jump in at any phase; the skills that implement each phase are listed below.
The five phases
Plan
Shape intent into a scoped wish with acceptance criteria. Driven by /wish (and /brainstorm when the idea is still fuzzy).
Review
Gate the plan (and later the PR) against criteria before work starts. Driven by /review.
Ship
Final
/review pass on the PR, then merge. The same skill that gated the plan gates the shipped change.Monitor
Watch the work land, triage escalations, and orchestrate the next loop. Driven by /pm.
A one-shot lifecycle
Start with an idea
Open /brainstorm if the idea is still fuzzy, or jump straight to /wish if you already know the shape. New to the loop? Run /wizard — it walks you through this sequence end-to-end.
Formalize the plan
/wish produces
.genie/wishes/<slug>/WISH.md with IN/OUT scope, acceptance criteria, and execution groups. This is the artifact every downstream phase reads from.Gate the plan
/review inspects the wish and returns SHIP, FIX-FIRST, or BLOCKED. A SHIP verdict authorizes execution.
Ship the PR
/review runs again against the pull request. Merge only on SHIP.
Monitor and iterate
/pm tracks progress, surfaces blockers, and queues the next wish. The loop repeats.
Entry points
What’s next
Walk through the loop
The 15-minute guided walkthrough uses this loop end-to-end — install, smoke test, first wish, first PR, first monitor.
Understand wishes
Every loop revolves around a wish. Learn the primitive that all five phases operate on.