@automagik/genie 4.260324.9 → 4.260324.11

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
   "plugins": [
     {
       "name": "genie",
-      "version": "4.260324.9",
+      "version": "4.260324.11",
       "source": "./plugins/genie",
       "description": "Human-AI partnership for Claude Code. Share a terminal, orchestrate workers, evolve together. Brainstorm ideas, wish them into plans, make with parallel agents, ship as one team. A coding genie that grows with your project."
     }

package/README.md

@@ -13,275 +13,50 @@
 
 <h2 align="center">Wishes in, PRs out.</h2>
 
-<p align="center">Describe the problem. Genie interviews you, plans the work, dispatches agents, and reviews the code.<br/>You approve and ship.</p>
-
-<p align="center">
-  <a href="#install"><strong>Install</strong></a> &middot;
-  <a href="#quick-start"><strong>Quick Start</strong></a> &middot;
-  <a href="#features"><strong>Features</strong></a> &middot;
-  <a href="https://discord.gg/xcW8c7fF3R"><strong>Discord</strong></a>
-</p>
-
-<br/>
-
 ## What is Genie?
 
-Genie is a CLI that turns vague ideas into shipped PRs through a structured pipeline. Describe what you want — Genie interviews you to capture the full context, builds a plan with acceptance criteria, dispatches specialized agents to execute in parallel, and runs automated review before anything reaches your eyes. You make decisions. Genie does everything else.
-
-## Genie is right for you if
-
-- ✅ You've re-explained your codebase architecture to Claude Code for the third time this week
-- ✅ You have 5+ AI coding tabs open and can't remember which one is doing what
-- ✅ You've watched an AI agent spiral for 20 minutes because it lost the original context
-- ✅ You want AI to ask *you* the right questions before writing code, not the other way around
-- ✅ You want to go to lunch and come back to reviewed PRs, not a stuck terminal
-- ✅ You want a repeatable process that works the same whether you're focused or half-asleep
-<br/>
+Genie is an AI orchestration CLI that turns vague ideas into shipped PRs. You describe the problem — Genie interviews you, plans the work, dispatches parallel agents, and reviews the code. You approve and ship.
 
-## Install
+## Get Started
 
-```bash
-curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash
-```
-
-Sets up everything: Bun, tmux, Claude Code plugin, orchestration config. Update anytime with `genie update`.
-
-<details>
-<summary>Alternative: npm install</summary>
+Paste this into your AI coding agent (Claude Code, Codex, etc.):
 
-```bash
-npm install -g @automagik/genie
 ```
+Install Genie, then run /wizard to set up this project:
 
-> Installs the CLI only. You'll need Bun 1.3.10+, tmux, and `genie setup` for full plugin integration.
-
-</details>
-
-> **Requirements:** macOS or Linux, [Claude Code](https://docs.anthropic.com/en/docs/claude-code)
-
-## Quick Start
-
-**Interactive (you drive):**
-
-| Step | Command |
-|------|---------|
-| **01. Launch** | `genie` |
-| **02. Wish** | `/wish fix the authentication bug in the login flow` |
-| **03. Ship** | Genie asks questions, builds a plan, executes it. You approve the PR. |
-
-**Autonomous (team-lead drives):**
-
-| Step | Command |
-|------|---------|
-| **01. Plan** | `/wish` — define scope, acceptance criteria, execution groups |
-| **02. Launch** | `genie team create auth-fix --repo . --wish auth-bug` |
-| **03. Ship** | Team-lead hires agents, dispatches work, runs review loops. You approve the PR. |
-<br/>
-
-## Features
-
-<table>
-<tr>
-<td align="center" width="33%"><h3>🧞 Wish Pipeline</h3>
-Brainstorm, plan, execute, review, ship — consistent results every time.
-</td>
-<td align="center" width="33%"><h3>🤖 Autonomous Team-Lead</h3>
-<code>genie team create --wish</code> — team-lead hires agents, dispatches work, runs fix loops, and opens the PR. You approve.
-</td>
-<td align="center" width="33%"><h3>🧠 Context Preservation</h3>
-Scoped specialists instead of one bloated window. No context rot.
-</td>
-</tr>
-<tr>
-<td align="center"><h3>💾 Persistent Memory</h3>
-Knowledge vault that agents search before answering. Compounds daily.
-</td>
-<td align="center"><h3>🔍 Automated Review</h3>
-Severity-tagged review. Nothing ships with CRITICAL or HIGH issues.
-</td>
-<td align="center"><h3>🌙 Overnight Execution</h3>
-Queue wishes before bed. Wake up to reviewed PRs.
-</td>
-</tr>
-<tr>
-<td align="center"><h3>👥 10-Critic Council</h3>
-10 specialists critique your design before you commit to anything.
-</td>
-<td align="center"><h3>🎯 Behavioral Learning</h3>
-Genie adapts to your codebase conventions and preferences.
-</td>
-<td align="center"><h3>📦 Portable Context</h3>
-Identity, skills, memory — markdown files you own. Git-versioned.
-</td>
-</tr>
-</table>
-<br/>
-
-## Without Genie vs. With Genie
-
-| ❌ Without Genie | ✅ With Genie |
-|---|---|
-| Re-explain your codebase to Claude every session | Genie interviews you once. Context flows to every agent. |
-| Copy-paste requirements, hope it understood | `/wish` captures scope and acceptance criteria upfront |
-| One Claude tab per task, alt-tab between 5 of them | Parallel agents in live terminal sessions |
-| Eyeball generated code, miss a bug, fix at 2am | Automated `/review` with severity-tagged gaps |
-| 45 min in, Claude forgets your instructions | Scoped specialists — no context window accumulates junk |
-| 10 min of setup before any work starts | `genie team create auth-fix --repo . --wish auth-bug` — team-lead handles the rest |
-<br/>
-
-## The Wish Pipeline
-
-💭 `/brainstorm` → 🧞 `/wish` → ⚙️ `/work` → 🔍 `/review` → 🚀 **ship**
-
-| Stage | What happens |
-|-------|-------------|
-| **Brainstorm** | Think out loud. Genie asks clarifying questions until the idea is concrete. |
-| **Wish** | Crystallize intent into a plan with scope and acceptance criteria. |
-| **Work** | Agents spawn in isolated worktrees, execute in parallel. |
-| **Review** | Automated review with severity gates. Nothing merges without passing. |
-| **Ship** | PR created, checks pass, you merge. |
-<br/>
-
-<details id="cli-reference">
-<summary><strong>CLI Reference</strong></summary>
-
-**Entry point:**
-
-| Command | Description |
-|---------|-------------|
-| `genie` | Persistent session in current directory |
-| `genie --session <name>` | Named/resumed leader session |
-
-**Team (autonomous execution):**
-
-| Command | Description |
-|---------|-------------|
-| `genie team create <name> --repo <path>` | Form team + git worktree |
-| `genie team create <name> --repo <path> --wish <slug>` | Form team and auto-spawn team-lead with wish context |
-| `genie team hire <agent>` | Add agent to team |
-| `genie team hire council` | Hire all 10 council members |
-| `genie team fire <agent>` | Remove agent from team |
-| `genie team ls [<name>]` | List teams or team members |
-| `genie team done <name>` | Mark team done, kill all members |
-| `genie team blocked <name>` | Mark team blocked, kill all members |
-| `genie team disband <name>` | Kill members, remove worktree, delete config |
-
-**Dispatch (lifecycle orchestration):**
-
-| Command | Description |
-|---------|-------------|
-| `genie brainstorm <agent> <slug>` | Spawn agent with brainstorm context |
-| `genie wish <agent> <slug>` | Spawn agent with design for wish creation |
-| `genie work <agent> <slug>#<group>` | Check deps, set in\_progress, spawn with context |
-| `genie review <agent> <slug>#<group>` | Spawn agent with review scope |
-| `genie done <slug>#<group>` | Mark group done, unblock dependents |
-| `genie reset <slug>#<group>` | Reset in-progress group back to ready |
-| `genie status <slug>` | Show wish group states |
-
-**Agent lifecycle:**
-
-| Command | Description |
-|---------|-------------|
-| `genie spawn <name>` | Spawn registered agent or built-in role |
-| `genie kill <name>` | Force kill agent |
-| `genie stop <name>` | Stop current run, keep pane alive |
-| `genie ls` | List agents, teams, state |
-| `genie history <name>` | Compressed session timeline |
-| `genie read <name>` | Tail agent pane output |
-| `genie answer <name> <choice>` | Answer agent prompt |
-
-**Messaging:**
-
-| Command | Description |
-|---------|-------------|
-| `genie send '<msg>' --to <name>` | Direct message (scoped to own team) |
-| `genie broadcast '<msg>'` | Leader to all team members |
-| `genie chat '<msg>'` | Team group channel |
-| `genie chat read` | Read team channel history |
-| `genie inbox [<name>]` | View inbox |
-
-**Directory (agent registry):**
-
-| Command | Description |
-|---------|-------------|
-| `genie dir add <name>` | Register agent (`--dir`, `--prompt-mode`, `--model`, `--roles`) |
-| `genie dir rm <name>` | Remove agent from directory |
-| `genie dir ls [<name>]` | List all or show single entry |
-| `genie dir edit <name>` | Update entry fields |
-
-**Infrastructure:**
-
-| Command | Description |
-|---------|-------------|
-| `genie setup` | Interactive setup wizard |
-| `genie doctor` | Diagnose configuration issues |
-| `genie update` | Update to latest version (`--next` for dev builds, `--stable` for releases) |
-| `genie shortcuts show\|install\|uninstall` | tmux keyboard shortcuts |
-
-</details>
-
-<details id="configuration">
-<summary><strong>Configuration</strong></summary>
-
-### Agent Directory
-
-Register custom agents with a directory path, prompt mode, and optional model. Built-in roles (engineer, reviewer, qa, fix, refactor, trace, docs, learn, council) are available out of the box.
-
-```bash
-genie dir add my-agent --dir /path/to/agent --prompt-mode append
-genie dir ls                          # List all registered agents
-genie dir ls --builtins               # Include built-in roles
-genie dir edit my-agent --model opus  # Update config
-genie dir rm my-agent                 # Remove registration
+curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash
+genie
+/wizard
 ```
 
-### Worktrees
+That's it. The wizard handles everything: project scaffold, identity, first wish, execution, and review.
 
-Teams work in isolated git worktrees so agents never conflict with your working tree.
+## What Happens Next
 
 ```
-~/.genie/worktrees/<project>/<team>/
-```
-
-Configurable via `genie setup --terminal` → `worktreeBase`. Worktrees are created on `genie team create` and cleaned up on `genie team disband`.
-
-### Setup
-
-```bash
-genie setup              # Interactive wizard (hooks, terminal, shortcuts, sessions)
-genie setup --quick      # Recommended defaults
-genie setup --show       # Show current configuration
-genie setup --reset      # Reset to defaults
+ You describe an idea
+  └─ /brainstorm ─── Genie asks clarifying questions until the idea is concrete
+      └─ /wish ───── Crystallizes intent into a plan with scope + acceptance criteria
+          └─ /work ── Agents spawn in isolated worktrees, execute in parallel
+              └─ /review ── Automated severity-gated review. You approve the PR.
 ```
 
-### Config Files
-
-| File | Purpose |
-|------|---------|
-| `~/.genie/config.json` | Terminal settings, session config, worker profiles |
-| `~/.claude/settings.json` | Claude Code settings (hooks registered here) |
-
-</details>
-
-<br/>
-
-## Development
-
-```bash
-bun run build     # Build CLI
-bun run check     # Typecheck + lint + dead-code + test
-bun test          # Run tests
-genie doctor      # Diagnose issues
-```
+## Why Genie?
 
-Uninstall: `curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash -s -- uninstall`
+- **No re-explaining** — Genie captures context once. Every agent inherits it.
+- **Parallel execution** — Multiple agents work simultaneously in isolated worktrees.
+- **Automated review** — Severity-tagged gaps. Nothing ships with CRITICAL issues.
+- **Overnight mode** — Queue wishes before bed. Wake up to reviewed PRs.
+- **10-critic council** — 10 specialists critique your design before you commit.
+- **Portable context** — Identity, skills, memory — markdown files you own, git-versioned.
 
 ---
 
 <p align="center">
-  <a href="https://github.com/automagik-dev/genie">GitHub</a> &middot;
-  <a href="https://discord.gg/xcW8c7fF3R">Discord</a> &middot;
-  <a href="LICENSE">MIT License</a>
+  <a href="https://docs.automagik.dev/genie"><strong>Documentation</strong></a> &middot;
+  <a href="https://github.com/automagik-dev/genie"><strong>GitHub</strong></a> &middot;
+  <a href="https://discord.gg/xcW8c7fF3R"><strong>Discord</strong></a> &middot;
+  <a href="LICENSE"><strong>MIT License</strong></a>
 </p>
 
 <p align="center">

package/dist/genie.js

@@ -839,7 +839,7 @@ ${gitLog}`:"","","Pick up where you left off. Read the wish file for full contex
     WHERE actor_type = ${actor.actorType}
       AND actor_id = ${actor.actorId}
       AND channel = ${channel}
-  `).count>0}async function listTasksForActor(actor,filters={}){let sql=await getConnection(),repo=filters.repoPath??getRepoPath(),conditions=["t.repo_path = $1"],values2=[repo],paramIdx=2;if(conditions.push(`ta.actor_type = $${paramIdx++}`),values2.push(actor.actorType),conditions.push(`ta.actor_id = $${paramIdx++}`),values2.push(actor.actorId),filters.stage)conditions.push(`t.stage = $${paramIdx++}`),values2.push(filters.stage);if(filters.status)conditions.push(`t.status = $${paramIdx++}`),values2.push(filters.status);if(filters.priority)conditions.push(`t.priority = $${paramIdx++}`),values2.push(filters.priority);let limit=filters.limit??100,offset=filters.offset??0;values2.push(limit,offset);let query=`SELECT DISTINCT t.* FROM tasks t JOIN task_actors ta ON ta.task_id = t.id WHERE ${conditions.join(" AND ")} ORDER BY t.created_at DESC LIMIT $${paramIdx++} OFFSET $${paramIdx++}`;return(await sql.unsafe(query,values2)).map(mapTask)}var init_task_service=__esm(()=>{init_db()});import{writeFileSync as writeFileSync7}from"fs";import{join as join33}from"path";function scaffoldAgentFiles(targetDir){writeFileSync7(join33(targetDir,"SOUL.md"),SOUL_TEMPLATE),writeFileSync7(join33(targetDir,"HEARTBEAT.md"),HEARTBEAT_TEMPLATE),writeFileSync7(join33(targetDir,"AGENTS.md"),AGENTS_TEMPLATE)}var SOUL_TEMPLATE=`# Soul
+  `).count>0}async function listTasksForActor(actor,filters={}){let sql=await getConnection(),conditions=[],values2=[],paramIdx=1;if(filters.allProjects);else if(filters.projectName)conditions.push(`t.project_id = (SELECT id FROM projects WHERE name = $${paramIdx++})`),values2.push(filters.projectName);else conditions.push(`t.repo_path = $${paramIdx++}`),values2.push(filters.repoPath??getRepoPath());if(conditions.push(`ta.actor_type = $${paramIdx++}`),values2.push(actor.actorType),conditions.push(`ta.actor_id = $${paramIdx++}`),values2.push(actor.actorId),filters.stage)conditions.push(`t.stage = $${paramIdx++}`),values2.push(filters.stage);if(filters.status)conditions.push(`t.status = $${paramIdx++}`),values2.push(filters.status);if(filters.priority)conditions.push(`t.priority = $${paramIdx++}`),values2.push(filters.priority);let limit=filters.limit??100,offset=filters.offset??0;values2.push(limit,offset);let query=`SELECT DISTINCT t.* FROM tasks t JOIN task_actors ta ON ta.task_id = t.id WHERE ${conditions.join(" AND ")} ORDER BY t.created_at DESC LIMIT $${paramIdx++} OFFSET $${paramIdx++}`;return(await sql.unsafe(query,values2)).map(mapTask)}var init_task_service=__esm(()=>{init_db()});import{writeFileSync as writeFileSync7}from"fs";import{join as join33}from"path";function scaffoldAgentFiles(targetDir){writeFileSync7(join33(targetDir,"SOUL.md"),SOUL_TEMPLATE),writeFileSync7(join33(targetDir,"HEARTBEAT.md"),HEARTBEAT_TEMPLATE),writeFileSync7(join33(targetDir,"AGENTS.md"),AGENTS_TEMPLATE)}var SOUL_TEMPLATE=`# Soul
 
 You are an AI assistant. Define your role, personality, and approach here.
 

package/install.sh

@@ -792,17 +792,23 @@ output_agent_prompt() {
 
 Genie has been installed successfully.
 
-Next steps for the user:
+## Agent Instructions
 
-  genie              Launch genie
+Run `/wizard` now to complete onboarding. The wizard will:
 
-First time? Genie will suggest /onboarding to set up your workspace.
+1. **Check environment** — verify genie CLI, git repo, and project structure
+2. **Shape identity** — define agent roles via `/brainstorm`
+3. **Create first wish** — scope work via `/brainstorm` then `/wish`
+4. **Execute** — build it via `/work`
+5. **Celebrate** — review results and learn next steps
 
-Integrations installed automatically:
+To start: paste `/wizard` in your Claude Code session.
+
+Integrations installed:
 - Claude Code plugin (if claude was found in PATH)
-- Orchestration prompt written to ~/.claude/rules/genie-orchestration.md
-- Default config created at ~/.genie/config.json
-- tmux defaults configured in ~/.tmux.conf
+- Orchestration rules at ~/.claude/rules/genie-orchestration.md
+- Default config at ~/.genie/config.json
+- tmux defaults at ~/.tmux.conf
 AGENT_EOF
 }
 
@@ -855,6 +861,11 @@ run_install() {
 
     offer_codex_skills
 
+    # Agent mode: structured output for piped installs
+    if [[ "$INTERACTIVE" == "false" ]]; then
+        output_agent_prompt
+    fi
+
     print_success
 }
 
@@ -1065,7 +1076,7 @@ print_success() {
     echo -e "  Get started:"
     echo -e "    ${BOLD}genie${NC}              Launch genie"
     echo
-    echo -e "  First time? Genie will suggest ${DIM}/onboarding${NC} to set up your workspace."
+    echo -e "  First time? Run ${DIM}/wizard${NC} to set up your workspace."
     echo
 }
 

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "genie",
   "name": "Genie",
   "description": "Skills, agents, and hooks for the Genie CLI terminal orchestration toolkit",
-  "version": "4.260324.9",
+  "version": "4.260324.11",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automagik/genie",
-  "version": "4.260324.9",
+  "version": "4.260324.11",
   "description": "Collaborative terminal toolkit for human + AI workflows",
   "type": "module",
   "bin": {

package/plugins/genie/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "genie",
-  "version": "4.260324.9",
+  "version": "4.260324.11",
   "description": "Human-AI partnership for Claude Code. Share a terminal, orchestrate workers, evolve together. Brainstorm ideas, turn them into wishes, execute with /work, validate with /review, and ship as one team.",
   "author": {
     "name": "Namastex Labs"

package/plugins/genie/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genie-plugin",
-  "version": "4.260324.9",
+  "version": "4.260324.11",
   "private": true,
   "description": "Runtime dependencies for genie bundled CLIs",
   "type": "module",

package/skills/wizard/SKILL.md

@@ -0,0 +1,160 @@
+---
+name: wizard
+description: "Guided onboarding — scaffold workspace, shape agent identity, create first wish, execute, and celebrate."
+---
+
+# /wizard — First-Run Onboarding
+
+Walk a new user (or their agent) through the complete Genie setup in five phases. Each phase has clear entry/exit criteria so the wizard can be interrupted and resumed.
+
+## When to Use
+- First time running Genie in a new project
+- User explicitly invokes `/wizard`
+- Bootstrap script directed the agent here after install
+- No `.genie/` directory or `AGENTS.md` exists in the current repo
+
+## Flow
+
+### Phase 1: Environment Check
+
+**Entry:** User invokes `/wizard` or agent is directed here after install.
+
+**Steps:**
+1. Verify `genie` CLI is installed and accessible in PATH:
+   ```bash
+   command -v genie && genie --version
+   ```
+2. Check if the current directory is a git repository (`git rev-parse --git-dir`).
+3. Check if `.genie/` directory exists (has Genie been scaffolded?).
+4. Check if `AGENTS.md` exists (has identity been shaped?).
+5. Check if `CLAUDE.md` exists (project instructions present?).
+
+**Exit criteria:** All checks pass, or we know exactly what to set up.
+
+**Display status:**
+```
+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` is not installed, stop and direct the user to install it first:
+```
+genie is not installed. Run:
+  curl -fsSL https://raw.githubusercontent.com/automagik-dev/genie/main/install.sh | bash
+```
+
+If not in a git repo, stop and ask the user to initialize one or navigate to one.
+
+### Phase 2: Agent Identity
+
+**Entry:** Phase 1 complete. Workspace needs scaffolding or identity shaping.
+
+**Steps:**
+1. If `.genie/` does not exist, run `genie` to trigger scaffolding (creates `.genie/` directory structure, default configs).
+2. Delegate to `/brainstorm` with this seed context:
+
+> We're shaping the agent identity for this project. The goal is to create an AGENTS.md that defines who the agents are in this workspace — their roles, responsibilities, communication style, and domain expertise. Look at the codebase to understand the project, then help define the agent team.
+
+3. Let `/brainstorm` run its interactive flow. It will:
+   - Explore the codebase to understand the project
+   - Ask clarifying questions about the team's needs
+   - Track WRS (Wish Readiness Score) for the identity definition
+   - Crystallize into a design when ready
+
+**Exit criteria:** `/brainstorm` completes with a design, or user skips identity shaping.
+
+**Skip option:** If user wants to skip, create a minimal `AGENTS.md`:
+```markdown
+# Agents
+
+This project uses Automagik Genie for orchestration.
+Agent identity will be shaped over time through usage.
+```
+
+### Phase 3: First Wish
+
+**Entry:** Phase 2 complete. Agent identity exists or was skipped.
+
+**Steps:**
+1. Ask the user: "What's the first thing you'd like to build or fix in this project?"
+2. If the idea is fuzzy, delegate to `/brainstorm` to explore it.
+3. Once the idea is concrete, delegate to `/wish` to create a structured wish plan:
+   - `/wish` will create `.genie/wishes/<slug>/WISH.md`
+   - It defines scope, acceptance criteria, and execution groups
+4. Run `/review` on the wish to validate the plan before execution.
+
+**Exit criteria:** A wish exists with status APPROVED (or SHIP from review).
+
+**Display progress:**
+```
+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
+```
+
+### Phase 4: Execute
+
+**Entry:** Phase 3 complete. An approved wish exists.
+
+**Steps:**
+1. Show the user what's about to happen:
+   ```
+   Ready to execute wish: add-dark-mode
+   Groups: 3 execution groups, estimated 2 agents
+   ```
+2. Run `/work` on the wish to begin execution:
+   - `/work` will orchestrate subagents per execution group
+   - Each group runs its fix/review loop
+   - Progress is tracked via genie task system
+3. Monitor progress and report status to the user.
+4. When `/work` completes, run `/review` for final verification.
+
+**Exit criteria:** All work groups complete and pass review.
+
+### Phase 5: Celebrate
+
+**Entry:** Phase 4 complete. Work is done and reviewed.
+
+**Steps:**
+1. Summarize what was accomplished:
+   ```
+   Your first wish has been granted!
+
+   Wish:    add-dark-mode
+   Status:  COMPLETE
+   Files:   12 files changed, 340 insertions
+   Review:  SHIP — all criteria met
+   ```
+2. Show next steps:
+   - **Create a PR:** `genie` can help create a pull request for the changes
+   - **Run another wish:** Use `/brainstorm` or `/wish` to plan the next piece of work
+   - **Set up a team:** For larger work, use `genie team create` for autonomous multi-agent execution
+   - **Explore skills:** Run `/genie` to see all available skills and the wish lifecycle
+3. Close with:
+   ```
+   You're all set! From here, the flow is:
+     /brainstorm → /wish → /work → /review → ship
+
+   Run /genie anytime to see where you are in the lifecycle.
+   ```
+
+## Resumption
+
+If the wizard is interrupted and re-invoked, detect the current state:
+- `.genie/` exists → skip scaffolding in Phase 2
+- `AGENTS.md` exists → skip identity in Phase 2
+- `.genie/wishes/` has an approved wish → skip to Phase 4
+- `.genie/wishes/` has a completed wish → skip to Phase 5
+
+## Error Handling
+
+- If any phase fails, show the error clearly and offer to retry or skip.
+- If `/brainstorm` or `/wish` fails, the wizard can still continue — these are delegated skills.
+- If `/work` fails on a group, show the failure and ask the user how to proceed (retry, skip, or abort).
+- Never leave the user stuck — always offer a path forward.

package/src/lib/task-service.test.ts

@@ -1020,4 +1020,82 @@ describe('Projects', () => {
       expect(t.projectId).toBe(proj!.id);
     }
   });
+
+  it('should round-trip: create virtual project → create task with explicit projectId → list by projectName', async () => {
+    const projName = `test-virtual-roundtrip-${Date.now()}`;
+    const taskRepo = `${REPO}-roundtrip`;
+
+    // 1. Create virtual project (no repoPath) — mimics handleTaskCreate --project flow
+    const project = await createProject({ name: projName });
+    expect(project.id).toMatch(/^proj-/);
+    expect(project.repoPath).toBeNull();
+
+    // 2. Create task with explicit projectId — mimics createTask(input, repoPath, projectId)
+    const task = await createTask({ title: 'Round-trip test task' }, taskRepo, project.id);
+    expect(task.projectId).toBe(project.id);
+    expect(task.repoPath).toBe(taskRepo);
+
+    // 3. List by projectName — mimics genie task list --project <name>
+    const tasks = await listTasks({ projectName: projName });
+    expect(tasks.length).toBeGreaterThanOrEqual(1);
+    const found = tasks.find((t) => t.id === task.id);
+    expect(found).not.toBeUndefined();
+    expect(found!.projectId).toBe(project.id);
+
+    // 4. Verify getProjectByName returns same project
+    const lookedUp = await getProjectByName(projName);
+    expect(lookedUp).not.toBeNull();
+    expect(lookedUp!.id).toBe(project.id);
+
+    // Cleanup
+    await sql`DELETE FROM tasks WHERE repo_path = ${taskRepo}`;
+    await sql`DELETE FROM projects WHERE name = ${projName}`;
+  });
+
+  it('should round-trip with listTasksForActor and --project filter', async () => {
+    const projName = `test-virtual-actor-${Date.now()}`;
+    const taskRepo = `${REPO}-actor-proj`;
+
+    // Create virtual project and task
+    const project = await createProject({ name: projName });
+    const task = await createTask({ title: 'Actor project task' }, taskRepo, project.id);
+    await assignTask(task.id, actor, 'assignee', {}, taskRepo);
+
+    // List via listTasksForActor with projectName filter
+    const tasks = await listTasksForActor(actor, { projectName: projName });
+    expect(tasks.length).toBeGreaterThanOrEqual(1);
+    const found = tasks.find((t) => t.id === task.id);
+    expect(found).not.toBeUndefined();
+    expect(found!.projectId).toBe(project.id);
+
+    // Cleanup
+    await sql`DELETE FROM task_actors WHERE task_id = ${task.id}`;
+    await sql`DELETE FROM tasks WHERE repo_path = ${taskRepo}`;
+    await sql`DELETE FROM projects WHERE name = ${projName}`;
+  });
+
+  it('should find auto-created projects by name in subsequent commands', async () => {
+    const autoRepo = `${REPO}-auto-find`;
+
+    // ensureProject auto-creates with basename
+    const projId = await ensureProject(autoRepo);
+
+    // The auto-created project should be findable by its name (basename of path)
+    const parts = autoRepo.split('/');
+    const expectedName = parts[parts.length - 1];
+    const found = await getProjectByName(expectedName);
+    expect(found).not.toBeNull();
+    expect(found!.id).toBe(projId);
+
+    // Create task and list by project name
+    const task = await createTask({ title: 'Auto-find task' }, autoRepo);
+    expect(task.projectId).toBe(projId);
+
+    const tasks = await listTasks({ projectName: expectedName });
+    expect(tasks.some((t) => t.id === task.id)).toBe(true);
+
+    // Cleanup
+    await sql`DELETE FROM tasks WHERE repo_path = ${autoRepo}`;
+    await sql`DELETE FROM projects WHERE repo_path = ${autoRepo}`;
+  });
 });

package/src/lib/task-service.ts

@@ -1489,11 +1489,21 @@ export async function deletePreference(actor: Actor, channel: string): Promise<b
 /** List tasks assigned to a specific actor. */
 export async function listTasksForActor(actor: Actor, filters: TaskFilters = {}): Promise<TaskRow[]> {
   const sql = await getConnection();
-  const repo = filters.repoPath ?? getRepoPath();
 
-  const conditions: string[] = ['t.repo_path = $1'];
-  const values: unknown[] = [repo];
-  let paramIdx = 2;
+  const conditions: string[] = [];
+  const values: unknown[] = [];
+  let paramIdx = 1;
+
+  // Scope conditions (project/repo/all) — mirrors buildScopeConditions with t. prefix
+  if (filters.allProjects) {
+    // No repo scoping — show all projects
+  } else if (filters.projectName) {
+    conditions.push(`t.project_id = (SELECT id FROM projects WHERE name = $${paramIdx++})`);
+    values.push(filters.projectName);
+  } else {
+    conditions.push(`t.repo_path = $${paramIdx++}`);
+    values.push(filters.repoPath ?? getRepoPath());
+  }
 
   conditions.push(`ta.actor_type = $${paramIdx++}`);
   values.push(actor.actorType);