Example interactions
User: improve: The GraphQL API could have better error messages — users get generic 500s with no actionable detail
Agent: Ensures work/ files exist; backfills any older sections missing **Id:** in the target file; assigns the next IMP-N per assets/id-prefixes.md; adds formatted entry (with **Id:** and **Why:** inferred from the user's rationale) to work/IMPROVEMENTS.md; confirms. No analysis of endpoints or error types.
User: improve: The sidebar could use a search filter
Agent: Adds to work/IMPROVEMENTS.md with **Why:** [Not yet documented] (no rationale supplied); confirms.
User: deferred: Refactor the auth module into smaller GenServers
Agent: Adds to work/DEFERRED.md with Source noted and **Why:** [Not yet documented]; confirms.
User: debt: Duplicate validation logic in two controllers
Agent: Adds to work/TECH_DEBT.md; confirms.
User: feat: Add dark mode support to the settings UI
Agent: Adds formatted entry to work/TODO.md; confirms.
User: add to iteration: [section title from IMPROVEMENTS.md]
Agent: Finds the section in IMPROVEMENTS.md, removes it, formats per iteration template (copying **Why:** verbatim from source), appends to work/ITERATION.md with source
User: work complete: Join Household Button Doesn't Work After Login
Agent: Extracts section from ITERATION.md, commits with that message, confirms with hash
User: pluck: Triple install: Cursor + Claude + Codex... (or /xp_work pluck with a pointer to a queued section)
Agent (turn 1): Resolves section, snapshots the block, commits Pluck status: claim to the base branch, stops — asks only for planning mode (native planning vs superpowers:brainstorming), using AskQuestion if available.
User: Selects an option.
Agent (turn 2+): Follows templates/pluck-planner-brief.md, creates worktree/feature branch, produces a visible plan if native planning, implements; if human verification is still required, appends ACC-N to ACCEPTANCE.md (copying **Why:** from the queue section); yanks the section; commits with block in body; updates CHANGELOG if present.
User: pluck: BUG-3 (or /xp_work pluck pointing at a section in work/BUGS.md)
Agent: Resolves section, snapshots the block, commits Pluck status: claim to the base branch. Detects the BUG prefix — auto-selects superpowers:systematic-debugging (no planning-mode prompt). Creates worktree/feature branch, runs systematic debugging to diagnose root cause, plans the fix, implements, verifies, squash-merges, yanks.
User: accept: ACC-1 — checked on fresh clone (or /xp_work accept with a pointer to one work/ACCEPTANCE.md section)
Agent: Resolves the section in ACCEPTANCE.md only, snapshots the block, removes the section, commits with verification subject + optional note + snapshot in body, does not touch CHANGELOG, confirms with hash.