groove

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

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