finishing-a-development-branch

Verify tests and guide merge, pull request, keep, or discard decisions.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/norrbacka/threejs_codex_base --skill finishing-a-development-branch-norrbacka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: finishing-a-development-branch
Source: https://github.com/norrbacka/threejs_codex_base/tree/main/.codex/superpowers/skills/finishing-a-development-branch
Command: npx skills add https://github.com/norrbacka/threejs_codex_base --skill finishing-a-development-branch-norrbacka

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you complete a finished development branch by validating the work, choosing the right integration path, and safely wrapping up the branch lifecycle.

Core Features & Use Cases

  • Test Verification: Confirms the project test suite passes before any merge or PR step.
  • Branch Integration Choices: Presents clear options to merge locally, create a pull request, keep the branch, or discard the work.
  • Safe Cleanup: Handles confirmation for destructive actions and removes worktrees when appropriate.
  • Use Case: Use it when a feature is done and you need a structured, low-risk way to finish the branch without missing cleanup steps.

Quick Start

Ask the Skill to finish the current development branch by checking tests, presenting the four end-of-branch options, and carrying out your chosen workflow.

Frequently Asked Questions about finishing-a-development-branch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely finish a git branch after completing development?

To safely finish a git branch, you must verify tests pass, choose an integration path like a local merge or pull request, and execute cleanup. This structured workflow enforces test validation and base-branch detection before finalizing the lifecycle.

What should I do with a finished git worktree before merging?

Before merging a finished git worktree, you should validate your test suite and select an integration option. The workflow handles conditional worktree removal and requires explicit confirmation for any destructive cleanup actions.

Does finishing a development branch require running tests first?

Yes, finishing a development branch requires running tests first. The workflow enforces test validation to ensure the project test suite passes before allowing any local merge, pull request creation, or branch discard actions.

What are my options for integrating a completed git branch?

Options for integrating a completed git branch include merging locally, creating a pull request, preserving the branch, or discarding the work. A four-option decision flow guides the final integration choice based on your project needs.

Why do I need confirmation for git branch cleanup and worktree removal?

You need confirmation for git branch cleanup and worktree removal to prevent accidental loss of work. The workflow enforces explicit confirmation for destructive actions and handles conditional worktree removal to ensure safe branch lifecycle completion.