groove

<!-- groove:managed — do not edit; changes will be overwritten by groove update --> # groove Conversational front door to the groove workflow system. Use `$ARGUMENTS` as a natural-language request, figure out which groove skill best serves it, and **invoke that skill** — so the user never has to memorise the ~44 command names. ## No arguments → show the catalog If `$ARGUMENTS` is empty, print the grouped command catalog below and stop (do not route). Hide the **Groovebook** group unless `groovebook:` is set in `.groove/index.md`. ## With arguments → route and invoke 1. Read `$ARGUMENTS` as intent. Pick the single best-matching skill from the **intent map** below. 2. Pass any residual specifics through as that skill's `$ARGUMENTS`. Example: `/groove spec the auth flow` → invoke `/groove-work-spec auth flow`; `/groove stats for the month` → `/groove-utilities-stats month`. 3. **Confidence:** - **Clear single match** → invoke it, prefixed by one line stating what you're running (e.g. "Routing to `/groove-work-plan`…"). - **Several plausible** → use `AskUserQuestion` to offer the top 2–4 matches; invoke the chosen one. - **No good match** → list the 2–3 closest commands from the catalog and ask the user to pick or rephrase; do not guess. 4. **Destructive/outward guard:** for `/groove-admin-install`, `/groove-admin-update`, `/groove-admin-config`, and `/groove-groovebook-publish`, confirm with the user before invoking even on a clear match (these change config, pull/migrate, or publish externally). 5. **Config-aware:** only route to `/groove-groovebook-*` when `groovebook:` is set in `.groove/index.md`. Invoke a skill the same way the rest of groove does — by running `/groove-<skill> <args>`. ## Intent map / catalog <!-- Keep in sync with README.md, groove-admin-help, and groove-utilities-prime. Trigger words are hints, not exhaustive. --> **Daily** | Skill | Purpose | Triggers | |---|---|---| | `/groove-daily-start` | Start the workday | start, morning, begin, kick off, what's today | | `/groove-daily-end` | End the workday | end, wrap up, eod, closeout, done for the day | **Work** | Skill | Purpose | Triggers | |---|---|---| | `/groove-work-brainstorm` | Clarify scope through dialogue | brainstorm, explore, scope, ideas, figure out | | `/groove-work-plan` | Write an implementation plan | plan, design, approach, how should I build | | `/groove-work-exec` | Execute the plan | exec, implement, build, do it, start coding | | `/groove-work-review` | Evaluate output | review, evaluate, check my work, accept/rework | | `/groove-work-compound` | Capture lessons | compound, capture lessons, what did I learn | | `/groove-work-spec` | Create an outcome spec | spec, specify, outcome, requirements | | `/groove-work-audit` | Review branch for blindspots | audit, blindspots, what am I missing | | `/groove-work-doc` | Document how a component works | doc, document, how does X work, explain | **Utilities — Tasks** | Skill | Purpose | Triggers | |---|---|---| | `/groove-utilities-task-list` | List active tasks | tasks, list tasks, what's on my plate | | `/groove-utilities-task-create` | Create a task | new task, add task, todo | | `/groove-utilities-task-update` | Update a task | update task, change task, move task | | `/groove-utilities-task-archive` | Archive a completed task | archive, close out task | | `/groove-utilities-task-analyse` | Analyse task status | analyse tasks, task status, breakdown | | `/groove-utilities-task-install` | Set up task backend | set up tasks, task backend | | `/groove-utilities-task-config` | Configure task backend | configure tasks, task settings | | `/groove-utilities-task-doctor` | Health-check task backend | task health, tasks broken | **Utilities — Memory** | Skill | Purpose | Triggers | |---|---|---| | `/groove-utilities-memory-log-daily` | Write the daily memory log | log today, daily log, record the day | | `/groove-utilities-memory-log-weekly` | Roll up the weekly log | weekly log, week rollup | | `/groove-utilities-memory-log-monthly` | Roll up the monthly log | monthly log, month rollup | | `/groove-utilities-memory-log-git` | Record git activity | log git, git summary | | `/groove-utilities-memory-install` | Set up memory backend | set up memory, memory backend | | `/groove-utilities-memory-doctor` | Health-check memory | memory health, memory broken | | `/groove-utilities-memory-mistakes` | Log & resolve a workflow mistake | mistake, error, went wrong, prevent recurring | | `/groove-utilities-memory-promises` | Capture/resolve deferred items | promise, deferred, come back to, later | | `/groove-utilities-memory-retrospective` | Analyse ratings/mistakes/learnings | retrospective, reflect, trends, patterns | | `/groove-utilities-memory-graduate` | Promote a lesson to AGENTS.md | graduate, make permanent, promote lesson | **Utilities — Session** | Skill | Purpose | Triggers | |---|---|---| | `/groove-utilities-prime` | Load workflow context | prime, load context, catch up | | `/groove-utilities-check` | Check for a newer version | check version, update available | | `/groove-utilities-stats` | Compound-loop metrics dashboard | stats, metrics, dashboard, how are we doing | | `/groove-utilities-onboard` | Generate GROOVE.md onboarding | onboard, onboarding guide, GROOVE.md | **Admin** | Skill | Purpose | Triggers | |---|---|---| | `/groove-admin-help` | Show all commands | help, commands, what can I do | | `/groove-admin-install` | Install backends & bootstrap | install, set up groove | | `/groove-admin-config` | Create/update config | config, settings, configure groove | | `/groove-admin-update` | Pull latest & migrate | update groove, upgrade, migrate | | `/groove-admin-doctor` | Run all health checks | doctor, health check, is groove ok | | `/groove-admin-claude-hooks` | Install Claude Code hooks | claude hooks, native hooks | | `/groove-admin-cursor-hooks` | Install Cursor hooks | cursor hooks | | `/groove-admin-claude-statusline` | Install the statusline | statusline, status line | **Groovebook** *(only if `groovebook:` is set in `.groove/index.md`)* | Skill | Purpose | Triggers | |---|---|---| | `/groove-groovebook-publish` | Publish a learning to the commons | publish learning, share lesson | | `/groove-groovebook-review` | Review open learning PRs | review learnings, groovebook PRs |