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