Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
chrisbanes avatar

Finishing Grove Workspace

  • 9 installs
  • 20 repo stars
  • Updated February 25, 2026
  • chrisbanes/grove

Resolve or clean up a completed Grove workspace by verifying tests pass and presenting merge or cleanup options.

About

Detects a Grove workspace, runs the auto-detected test command, and presents completion options once tests pass. Used when a developer finishes implementation inside a Grove workspace and needs to wrap it up.

  • Auto-detects and runs the project test command
  • Reads .grove/workspace.json for merge/cleanup

Finishing Grove Workspace by the numbers

  • 9 all-time installs (skills.sh)
  • Ranked #438 of 733 Git & Pull Requests skills by installs in the Skillselion catalog
  • Data as of Jul 31, 2026 (Skillselion catalog sync)
npx skills add https://github.com/chrisbanes/grove --skill finishing-grove-workspace

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs9
repo stars20
Last updatedFebruary 25, 2026
Repositorychrisbanes/grove

What it does

Resolve or clean up a completed Grove workspace by verifying tests pass and presenting merge or cleanup options.

Files

SKILL.mdMarkdownGitHub ↗

I'm using the finishing-grove-workspace skill to wrap up this Grove workspace.

Workflow

Step 1: Detect workspace

test -f "$(git rev-parse --show-toplevel)/.grove/workspace.json"

If .grove/workspace.json is not found: this is not a Grove workspace. Use superpowers:finishing-a-development-branch instead.

Step 2: Verify tests pass

Auto-detect the test command from marker files:

Marker fileTest command
go.modgo test ./...
package.jsonnpm test
Cargo.tomlcargo test
build.gradle / build.gradle.kts./gradlew test
pyproject.toml / requirements.txtpytest
Makefilemake test

If tests fail, stop. Do not present completion options.

Step 3: Read workspace metadata

cat .grove/workspace.json

Extract id, golden_copy, and branch from the JSON output.

Step 4: Present options

Present exactly these four options:

1. Push branch and create a Pull Request 2. Push branch and destroy workspace 3. Keep workspace as-is 4. Discard work and destroy workspace

Step 5: Execute choice

Option 1: Push + PR

Derive the PR title from the branch name and the body from a summary of commits since the golden copy.

git push -u origin <branch>
gh pr create --title "<title>" --body "<body>"
grove destroy <workspace-id>
cd <golden-copy-path>

Option 2: Push + destroy

git push -u origin <branch>
grove destroy <workspace-id>
cd <golden-copy-path>

Option 3: Keep as-is

Report: "Keeping workspace at <path>."

Option 4: Discard

Require the user to type "discard" before proceeding.

grove destroy <workspace-id>
cd <golden-copy-path>

Quick Reference

OptionPush branchCreate PRKeep workspaceCleanup
1. Push + PRyesyesnoyes
2. Push + destroyyesnonoyes
3. Keep as-isnonoyesno
4. Discardnononoyes

Common Mistakes

  • Skipping test verification — never present completion options before confirming tests pass.
  • Open-ended questions — always present the structured four-option list; do not ask "what would you like to do?" in free form.
  • Automatic workspace cleanup — if the user selects option 3, do not run grove destroy. Respect the choice to keep the workspace.
  • No confirmation for discard — option 4 destroys uncommitted work; always require the user to type "discard" before executing.

Red Flags

  • .grove/workspace.json missing but .grove/config.json present — the agent is on the golden copy, not in a workspace. Route to superpowers:finishing-a-development-branch.
  • grove destroy fails — the workspace ID may be stale. Run grove list to confirm the workspace exists before retrying.

Integration

  • Replaces: superpowers:finishing-a-development-branch when in a Grove workspace
  • Called by: superpowers:subagent-driven-development (Step 7), superpowers:executing-plans (Step 5)
  • Pairs with: grove:using-grove

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.