task

task

Backend-agnostic task management skill for groove. Reads backend config from .groove/index.md and routes all commands to the appropriate CLI or API.

Git Root Detection

Before running any command, detect the git root:

git rev-parse --show-toplevel

All file paths (.groove/index.md, .beans.yml) are relative to git root.

Commands

Command	Description
list	Show active, ready tasks from configured backend
create	Create task with title, type, parent, status
update	Update task status, body, or metadata
archive	Archive all completed/scrapped tasks (user confirms)
analyse	Summarise tasks by status for daily end/daily memory
install	Install configured task backend
config	Show or update task backend configuration

$ARGUMENTS Routing

$ARGUMENTS	Action
help	→ commands/help.md
doctor	→ commands/doctor.md
list	→ commands/list.md
create	→ commands/create.md
update	→ commands/update.md
archive	→ commands/archive.md
analyse	→ commands/analyse.md
install	→ commands/install.md
config	→ commands/config.md
(empty)	→ commands/help.md

Bootstrap

If .groove/index.md does not exist at git root, create it from skills/groove/templates/index.md before proceeding. Ask user to confirm the defaults or provide overrides.

File Structure

.groove/
└── index.md          # shared groove config (frontmatter: tasks, memory, git.*)
.beans.yml            # beans CLI config (at git root, owned by beans)
skills/task/
├── SKILL.md
├── commands/
│   ├── list.md
│   ├── create.md
│   ├── update.md
│   ├── archive.md
│   ├── analyse.md
│   ├── install.md
│   └── config.md
├── references/
│   └── backends.md
└── templates/
    └── beans-config.md